Previous Topic: Command ExampleNext Topic: Command Examples


Connecting and Disconnecting Multi-User Facilities

This section discusses connecting and disconnecting MUFs.

Invoke the following transaction to connect or disconnect MUFs.

►►─ DBEC ─ PERform, ─┬─ CONnect ────┬─ ,MUF(nn),SYSid(aaaa) ──────────────────►◄
                     ├─ 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) Specifies the inquiry is to invoke the MUF-level display. The value within the parentheses identifies the MUFs identified by the SIDNAME specified in the DBCSID macros appended to the DBCVTPR macro, if multiple MUFs are defined. The MUFs that meet the qualification of your request are presented in the order that they are defined in the DBCSID macros of the DBCVTPR. The MSIDNAME(xxxxxxxx) qualifier should not be used with the MUF(nn) qualifier. If it is used with the MUF(nn) qualifier then the MUF(nn) qualifier takes precedence and the MSIDNAME(xxxxxxxx) qualifier is ignored.

xxxxxxxx

Specifies that you want to display only the MUF with the SIDNAME specified as defined for the DBSIDPR module name xxxxxxxx for this MUF.

Alternately, instead of using the xxxxxxxx name to specify only a specific MUF, you can use the wildcard symbol * (asterisk) to accept SIDNAMEs that begin with a specific value. The asterisk represents any trailing characters in the SIDNAME.

For more information, see Command Examples.

Note: MUF(nn) and MSIDname(xxxxxxxx) should not both be used. Use the one that meets your needs to qualify the MUF inquiry. If both qualifiers are specified, then MUF(nn) takes precedence and MSIDNAME(xxxxxxxx) is ignored.

,SYSid(aaaa)

(Required) For an MRO environment, the value within the parentheses determines whether the action applies to a single remote CICS system or to all CICS systems. Valid values follow:

aaaa

Four-character CICS identifier for a single remote CICS system, as defined in the CICS connection table.

*

All attached CICS systems, beginning with the local system.

SYS is a valid abbreviation.