Start SMDS Connection on z/OS

Use the Start SMDS Connection (MQCMD_INQUIRE_SMDSCONN) command after connections have been put into the AVAIL(STOPPED) state by a previous STOP SMDSCONN command. It can also be used to signal to the queue manager to retry a connection which is in the AVAIL(ERROR) state after a previous error.

Required parameters

SMDSConn (MQCFST)

Specifies the queue manager name relating to the connection between the shared message data set and the queue manager (parameter identifier: MQCACF_CF_SMDSCONN).

An asterisk value can be used to denote all shared message data sets associated with a specific CFSTRUCT name.

The maximum length of the string is 4 characters.

CFStrucName (MQCFST)

The name of the CF application structure with SMDS connections properties that we want to start (parameter identifier: MQCA_CF_STRUC_NAME).

The maximum length of the string is MQ_CF_STRUC_NAME_LENGTH.

CommandScope (MQCFST)

Command scope (parameter identifier: MQCACF_COMMAND_SCOPE). Specifies how the command is executed when the queue manager is a member of a queue sharing group. We can specify one of the following:

• blank (or omit the parameter altogether). The command is executed on the queue manager on which it was entered.
• a queue manager name. The command is executed on the queue manager you specify, providing it is active within the queue sharing group. If you specify a queue manager name other than the queue manager on which it was entered, we must be using a queue sharing group environment, and the command server must be enabled.
• an asterisk (*). The command is executed on the local queue manager and is also passed to every active queue manager in the queue sharing group.

The maximum length is MQ_QSG_NAME_LENGTH.

Parent topic: Definitions of the Programmable Command Formats