DBEC: Controlling Remote System 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 in a specific remote CICS system or all remote CICS systems.

►►─ DBEC ─ PERform,NEWcopy,URT(nnnn),SYSid(aaaa) ─────────────────────────────►

 ►─┬──────────────────────┬───────────────────────────────────────────────────►◄
   └─ ,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 the user's responsibility to open the URT once the NEWCOPY request is complete. 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.

See the Command Example.

,SYSid(aaaa)

(Required) Identifies the remote CICS system with the 4-character identifier defined in the CICS Connection table.

SYSID(*) is not valid for this function.

,SIDname(xxxxxxxx)

(Optional) Limits the inquiry to a specific MUF by the SID name associated with that MUF 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. For more information, 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.