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. You 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 you 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