DBEC: Controlling Remote System Resources with Enhanced Commands › Opening and Closing URTs

Opening and Closing URTs

This section discusses opening and closing URTs.

Invoke the following transaction to open or close URTs in a specified remote CICS system.

►►─ DBEC ─ PERform, ─┬─ OPEN ──┬─ ,URT(nnnn),SYSid(aaaa) ─────────────────────►
                     └─ CLOSE ─┘

 ►─┬──────────────────────┬───────────────────────────────────────────────────►◄
   └─ ,SIDname(xxxxxxxx) ─┘

DBEC

(Required) Specify the transaction ID used with enhanced commands to control URTs and startup/shutdown. 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 URTs in the specified CICS system. PER and P are valid abbreviations.

OPEN

Open specified URTs

CLOSE

Close specified URTs

,URT(nnnn)

(Required) Identifies (with the 4-digit suffix nnnn) the URT on which to perform the action.

nnnn

Specifies that you want to perform the action only on the URT with the specific 4-digit suffix nnnn.

Alternately, instead of using the nnnn suffix to specify only a specific URT, you can use the wildcard symbol ? (a question mark) to accept any digit 0 through 9 for any (or all) of the four digits of the suffix. If wildcard symbols are used, only those URTs that are not open are processed.

See Command Examples.

,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.

,SIDname(xxxxxxxx)

(Optional) Limits the inquiry to a specific MUF by the SID name associated with that MUF (see the DBURSTR macro SIDNAME= parameter in the CA Datacom/DB Database and System Administration Guide and the DBCSID macro SIDNAME= parameter in the System Reference Guide) or limits the inquiry to a range of MUFs by specifying any number of leading characters of the SID name, followed by an asterisk (*). Omitting the SIDname(xxxxxxxx) limiter results in URTs in all MUFs being displayed. (SID is a valid abbreviation.)