DBEC: Controlling Remote System Resources with Enhanced Commands › Changing/Restoring Open Options for URTs

Changing/Restoring Open Options for URTs

Issue the following enhanced command to modify current when to open specifications on URTs in a specified remote CICS system.

►►─ DBEC ─ PERform, ─┬─ AUTO ────┬─ ,URT(nnnn),SYSid(aaaa) ───────────────────►
                     ├─ DEFer ───┤
                     └─ REStart ─┘

 ►─┬──────────────────────┬───────────────────────────────────────────────────►◄
   └─ ,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 URT in the specified CICS system. (PER and P are valid abbreviations.)

AUTO

Set specified URTs to be opened automatically when first required by an executing application.

DEFer

Set specified URTs for deferred opening, where opening is deferred until explicitly opened by a DBEC or DBOC OPEN= command. (DEF is a valid abbreviation.)

REStart

Reset specified URTs to their original STATUS. (RES is a valid abbreviation.)

Resetting specified URTs to their original STATUS means to reset the URT STATUS to OPEN or UNOPENED from CLOSED. If TYPE is AUTO, the STATUS becomes UNOPENED. If TYPE is PLT, CA Datacom CICS Services tries to OPEN the URT and, if successful, the STATUS changes to OPEN. If TYPE is DEFER, RESTART has no impact on the STATUS of 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.)