DBEC Controlling Local Resources with Enhanced Commands › Replacing a URT with a New Copy

Replacing a URT with a New Copy

This section discusses replacing a URT with a new copy.

Invoke the following transaction to perform the NEWCOPY function for a specified URT.

►►─ DBEC ─ PERform,NEWcopy,URT(nnnn) ─┬──────────────────────┬────────────────►◄
                                      └─ ,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.

NEWcopy,

(Required) Action is a CICS newcopy on the URT module. The URT must be closed before issuing the NEWCOPY request. It is your responsibility to open the URT once the NEWCOPY request is complete. (If you use the c line command on a DBEC I,URT(nnnn) screen to close the URT, press the PF1 function key to refresh the screen before implementing any overrides.) (NEW is a valid abbreviation.)

Note: A P,NEWCOPY command results in a URT inquiry display, once the perform has been completed. In the resulting display, however, be aware that any URTs in OPEN status were not part of the NEWCOPY. The DBOCPRT file contains errors for the NEWCOPY commands that failed. You can also use the N line command from a URT inquiry display to see specific messages.

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.

,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 having new copies made. (SID is a valid abbreviation.) See the following command example.