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  an MQ-supplied HTTPS servlet to establish a
     secure connection with a broker instance.  An  HTTPS  is  an
     SSL-enabled  varient of the HyperText Transfer Protocol that
     establishes a secure connection with a broker instance.

     Without an option, imqkeytool operates a self-signed  certi-
     ficate 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  MQ 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  key-
           store.  You  should  move  this keystore to a location
           where it is accessible and readable by  the  MQ  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 MQ keystore  in  which  imqkeytool  stores  a
           self-signed certificate for brokers.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWiqu                     |
    |_____________________________|_____________________________|

SEE ALSO

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

     Sun ONE Message Queue Administrator's Guide