Start IBM MQ Commands (STRMQMMQSC)
- Where allowed to run
- All environments (*ALL)
- Threadsafe
- Yes
The Start IBM MQ Commands (STRMQMMQSC) command initiates a set of IBM MQ Commands (MQSC) and writes a report to the printer spooler file. Attention: Do not use the QTEMP library as the input library to STRMQMMQSC, as the usage of the QTEMP library is limited. We must use another library as an input file to the command.
Each report consists of the following elements:
- A header identifying MQSC as the source of the report.
- A numbered listing of the input MQSC commands.
- A syntax error message for any commands in error.
- A message indicating the outcome of running each correct command.
- Other messages for general errors running MQSC, as needed.
- A summary report at the end.
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SRCMBR | Member containing input | Name, *FIRST | Required, Positional 1 |
| SRCFILE | Input file | Qualified object name | Optional, Positional 2 |
| Qualifier 1: Input file | Name, QMQSC | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| OPTION | Option | *RUN, *VERIFY, *MVS | Optional, Positional 3 |
| WAIT | Wait time | 1-999999 | Optional, Positional 4 |
| LCLMQMNAME | Local Message Queue Manager | Character value | Optional, Positional 5 |
| MQMNAME | Message Queue Manager name | Character value, *DFT | Optional, Positional 6 |
Member containing input (SRCMBR)
>Specifies the name of the source member, containing the MQSC, to be processed.
The possible values are:
- source-member-name
- Specify the name of the source member.
- *FIRST
- The first member of the file is used.
Input file (SRCFILE)
>Specifies the qualified name of the file, in the form LIBRARY/FILE, that contains the MQSC to be processed.
The possible values are:
- *LIBL
- The library list is searched for the file name.
- *CURLIB
- The current library is used.
- source-library-name
- Specify the name of the library to be used.
The possible values are:
- QMQSC
- QMQSC is used.
- source-file-name
- Specify the name of the source file.
Option (OPTION)
>Specifies how the MQSC commands are to be processed.
The possible values are:
- *RUN
- If this value is specified and a value for the WAIT parameter is not specified the MQSC commands are processed directly by the local queue manager. If this value is specified and a value is also specified for the WAIT parameter the MQSC commands are processed indirectly by a remote queue manager,
- *VERIFY
- The MQSC commands are verified and a report is written, but the commands are not run.
- *MVS
- The MQSC commands are processed indirectly by a remote queue manager running under MVS™/ESA. If you specify this option we must also specify a value for the WAIT parameter.
Wait time (WAIT)
>Specifies the time in seconds that the STRMQMMQSC command waits for replies to indirect MQSC commands. Specifying a value for this parameter indicates that MQSC commands are executed in indirect mode by a remote queue manager. Specifying a value for this parameter is only valid when the OPTION parameter is specified as *RUN or *MVS.
In indirect mode, MQSC commands are queued on the command queue of a remote queue manager. Reports from the commands are then returned to the local queue manager specified in MQMNAME. Any replies received after this time are discarded, however, the MQSC command is still run.
The possible values are:
- 1 - 999999
- Specify the waiting time in seconds.
Local Message Queue Manager (LCLMQMNAME)
>Specifies the name of the local queue manager through which indirect mode operation is to be performed.
Message Queue Manager name (MQMNAME)
>Specifies the name of the message queue manager.
The possible values are:
- *DFT
- Use the default queue manager.
- message-queue-manager-name
- Specify the name of the queue manager.
Examples
>None
Error messages
>Unknown
Parent topic: CL commands reference for IBM i