Newer version of documentation BMC provides a newer version of the documentation for this version of the product. As a result, BMC no longer accepts comments in this space.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see bao8301.

Issue IBM MQ commands from a BMC AMI Ops Automation terminal session


MQ commands can be issued from the command line in a 

BMC AMI Ops Automation

 terminal session by specifying a special command character followed by the IBM MQ command.

The following list describes the limitation and requirements for issuing IBM MQ commands from the command line:

  • The commands are only valid for z/OS queue managers.
  • A one- to four-character queue manager ID must be specified in the target field. In addition, this means that a queue manager ID must be specified in BBPARM member BBIJNT00 or an error will occur.
  • The command must be prefixed by the at sign (@) character.
  • The command can be a maximum length of 236 characters.
  • The output from the command will be written to the BBI Journal.

The following example shows an example of issuing an IBM MQ command from the command line of the BBI Journal:

BMC Software ------------------ Log Display ------------------ General services
COMMAND ===> @dis qmgr cmdlevel                              TGT ===> JBQ      
Line        2,082  Log  #1   Status  INPUT    Time  20:10:31 INTV===> 3

The following example shows an example of the output from the IBM MQ command:

BMC Software ------------------ Log Display -------------- General services
COMMAND ===>                                                 TGT ===> JBQ   
Line        2,101  Log  #1   Status  INPUT    Time  20:13:45 INTV===> 3     
20:13:31  QA6100I  USERID: BAOJDB4  TIME: 20:13:31  ISSUED FOLLOWING CMD:   
20:13:31  QA6004I  DIS QMGR CMDLEVEL                                    0001
20:13:31  QA6101I  USERID: BAOJDB4  TIME: 20:13:31  CMD RESPONSE FOLLOWS:   
20:13:31  CSQN205I   COUNT=       3, RETURN=00000000, REASON=00000000       
20:13:31  CSQM409I @JBQ QMNAME(JBQ                    ) CMDLE               
20:13:31  VEL(       700)                                                   
20:13:31  CSQ9022I @JBQ CSQMDRTS ' DIS QMGR' NORMAL COMPLETION

In the above example, 0001 to the right of the QA6004I message is a number used to correlate the command with the output in the BBI journal. If you scroll the screen to the left as follows you will see the correlation number for the output, along with the queue manager ID (in this case the queue manager ID is JBQ). See the example below.

Output from issuing an IBM MQ command from the BBI Journal (scrolled left)

BMC Software ------------------ Log Display ---------------  COLUMNS 001-070   
COMMAND ===>                                                 TGT ===> JBQ      
Line        2,101  Log  #1   Status  INPUT    Time  20:18:41 INTV===> 3        
20:13:31 10/02/26 JBQ      QA6100I  USERID: BAOJDB4  TIME: 20:13:31  ISSUED
20:13:31 10/02/26 JBQ      QA6004I  DIS QMGR CMDLEVEL                          
20:13:31 10/02/26     0001 QA6101I  USERID: BAOJDB4  TIME: 20:13:31  CMD
20:13:31 10/02/26     0001 CSQN205I   COUNT=       3, RETURN=00000000,
20:13:31 10/02/26     0001 CSQM409I @JBQ QMNAME(JBQ                            
20:13:31 10/02/26     0001 VEL(       700)                                     
20:13:31 10/02/26     0001 CSQ9022I @JBQ CSQMDRTS ' DIS QMGR' NORMAL

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*