System Administration Commands                     imqkeytool(1M)



NAME
     imqkeytool - generate a self-signed certificate  for  secure
     communication

SYNOPSIS
     /usr/bin/imqkeytool [-broker] [-servlet keystorelocation]


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


     Without an option, imqkeytool generates 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  certi-
                                   ficate   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 keystorelocation    Generate a self-signed  certi-
                                   ficate  for  an  HTPS servlet
                                   and     places      it      in
                                   keystorelocation.

                                   keystorelocation  refers   to
                                   the  location of the keystore.



SunOS 5.11          Last change: 11 Mar 2004                    1






System Administration Commands                     imqkeytool(1M)



                                   You should move this  keystore
                                   to  a  location  where  it  is
                                   accessible and readable by the
                                   Message Queue HTPS servlet to
                                   establish a secure  connection
                                   with a broker.


ENVIRONMENT VARIABLES
     The following environment variables affect the execution  of
     this command:

     IMQJAVAHOME    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.


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



     
           ATRIBUTE TYPE               ATRIBUTE 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.11          Last change: 11 Mar 2004                    2