DBEC Controlling Local Resources with Enhanced Commands › Connecting and Disconnecting MUFs

Connecting and Disconnecting MUFs

This section discusses connecting and disconnecting MUFs. For more information, see URT Connections Table.

Invoke the following transaction to connect or disconnect MUFs.

►►─ DBEC ─ PERform, ─┬─ CONnect ────┬─ ,MUF(nn) ──────────────────────────────►◄
                     ├─ DISconnect ─┤
                     └─ IMMediate ──┘

DBEC

(Required) Specify the transaction ID used with Enhanced commands to control MUFs. Leave a space between the transaction ID and the command.

PERform,

(Required) The command that requests CA Datacom CICS Services perform the specified action on the specified MUFs in the specified CICS system. PER and P are valid abbreviations.

CONnect

Connect specified MUFs. CON is a valid abbreviation.

DISconnect

Disconnect specified MUFs. DIS is a valid abbreviation.

IMMediate

Immediately disconnect specified MUFs without regard for active tasks. See the command examples on the following page.

Be aware that a disconnect IMMEDIATE puts the MUF into a state in CA Datacom CICS Services such that the MUF automatically reconnects, as if the MUF had abended. For example, in that state the MUF allows transactions to be backed out, if the appropriate return code handling is programmed, and to reconnect when a request requiring that MUF is made. You would typically only use this command when a MUF is hung. In situations where it is desired to terminate the connection to the MUF quickly, we recommend that you consider sending an EOJ to the MUF before issuing an IMMEDIATE disconnect. (IMM is a valid abbreviation.)

,MUF(nn)

(Required) Identifies (with the 2-digit number nn) the MUF, relative to the position of the associated DBCSID macro in the DBCVTPR generation, on which to perform the action.

nn

Specifies that you want to perform the action only on the MUF with the specific 2-digit number nn.

Alternately, instead of using the nn number to specify only a specific MUF, you can use the wildcard symbol ? (a question mark) to accept any digit 0 through 9 for one (or both) of the 2 digits of the number.

,MSIDname(xxxxxxxx)

(Required) Identifies (with the up to 8-characters) the SIDNAME as specified in the DBCSID macro appended to the DBCVTPR.

xxxxxxxx

Specifies that you want to perform the action only on the MUF with the specific SIDNAME.

Alternately, you can use the wildcard symbol * (an asterisk) to specify all MUFs or you can specify a range of MUFs by using a prefix value followed by the asterisk.