Issuing commands from a z/OS console or its equivalent

 

+

Search Tips   |   Advanced Search

 

We can issue all WebSphere MQ commands from a z/OS console or its equivalent. This means we can also issue WebSphere MQ commands from anywhere where we can issue z/OS commands, such as SDSF or by a program using the MGCRE macro.

The maximum amount of data that can be displayed as a result of a command typed in at the console is 32 KB.

We cannot issue WebSphere MQ commands using the IMS/SSR command format from an IMS terminal. This function is not supported by the IMS adapter.

The input field provided by SDSF might not be long enough for some commands, particularly those for channels.

 

Command prefix strings

Each WebSphere MQ command must be prefixed with a command prefix string (CPF), as shown in Figure 1.

Because more than one WebSphere MQ subsystem can run under z/OS, the CPF is used to indicate which WebSphere MQ subsystem processes the command. For example, to start the queue manager for a subsystem called CSQ1, whose CPF is '

+CSQ1', you issue the command +CSQ1 START QMGR from the operator console. This CPF must be defined in the subsystem name table (for the subsystem CSQ1). This is described in the WebSphere MQ for z/OS System Setup Guide. In the examples, the string '

+CSQ1' is used as the command prefix.

 

Using the z/OS console to issue commands

We can type simple commands from the z/OS console, for example, the DISPLAY command in Figure 1. However, for complex commands or for sets of commands that you issue frequently, the other methods of issuing commands are better.

Figure 1. Issuing a DISPLAY command from the z/OS console

+CSQ1 DISPLAY QUEUE(TRANSMIT.QUEUE.PROD) TYPE(QLOCAL)

 

 

Command responses

Direct responses to commands are sent to the console that issued the command. WebSphere MQ supports the Extended Console Support (EMCS) function available in z/OS, and therefore consoles with 4-byte IDs can be used. Additionally, all commands except START QMGR and STOP QMGR support the use of Command and Response Tokens (CARTs) when the command is issued by a program using the MGCRE macro.