imqkeytool(1M)						  System Administration Commands					    imqkeytool(1M)

NAME

       imqkeytool - generate a self-signed certificate for secure communication

SYNOPSIS

       /usr/bin/imqkeytool [-broker] [-servlet keystore_location]

       /usr/bin/imqkeytool -h

DESCRIPTION

       The  imqkeytool	utility  generates a self-signed certificate for secure communication. The certificate can be used by a broker instance to
       establish a secure connection with a client, or by a Message Queue-supplied HTTPS servlet to establish a secure connection  with  a  broker
       instance.  An HTTPS servlet is an SSL-enabled varient of the HyperText Transfer Protocol that establishes a secure connection with a broker
       instance.

       Without an option, imqkeytool generates a self-signed certificate for a broker instance.

       imqkeytool uses command line options to specify whether the certificate is used by a broker instance or by a servlet.

OPTIONS

       The following options are supported:

       -broker

	   Generate a self-signed certificate for the broker and places it in the Message Queue keystore. All broker instances running on a system
	   must use the same certificate.

       -h

	   Display usage help. Do not execute anything else on the command line.

       -servlet keystore_location

	   Generate a self-signed certificate for an HTTPS servlet and places it in keystore_location.

	   keystore_location  refers to the location of the keystore. You should move this keystore to a location where it is accessible and read-
	   able by the Message Queue HTTPS servlet to establish a secure connection with a broker.

ENVIRONMENT VARIABLES

       The following environment variables affect the execution of this command:

       IMQ_JAVAHOME    Specify the Java 2 compatible runtime. When this environment variable is not set it defaults to /usr/j2se.

EXIT STATUS

       The following exit values are returned:

       0	Successful completion.

       >0	An error occurred.

FILES

       /etc/imq/keystore       Contains Message Queue keystore in which imqkeytool stores a self-signed certificate for brokers.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWiqu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       imqadmin(1M), imqbrokerd(1M), imqcmd(1M), imqdbmgr(1M), imqobjmgr(1M), imqusermgr(1M), attributes(5)

       Sun Java System Message Queue Administrator's Guide

SunOS 5.10							    11 Mar 2004 						    imqkeytool(1M)