Replacing a URT with a New Copy

This section discusses replacing a URT with a new copy.
cadts
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.)
    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 Specifying DBCSID Macros and the DBURSTR macro SIDNAME= parameter in CA Datacom® Core) 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.
Command Example
Command
Result
DBEC P,NEWCOPY,URT(123)
CA Datacom® CICS Services
replaces URT 123 with a new copy. The URT must be closed before issuing this request.