DBOC: Controlling Local Resources with Operational Commands › PREFIX= Changing the URT Prefix

PREFIX= Changing the URT Prefix

Invoke the PREFIX command to change the prefix of all URTs from the default prefix, DBURT, to another five-character prefix. A different default URT prefix can be defined for your site in the DBCVTPR macro. For more information, see the System Reference Guide. You can display the current URT prefix with the DBOC/DBIC INQ=GENOPTS command described in INQ=GENOPTS: Displaying System Generation Options.

This command enables you to switch from one set of URTs to another. The change is only valid for the duration of the current CICS cycle.

Note: Changing the prefix does not affect specifications for opening URTs.

Follow these steps to change the URT prefix:

1. Close all URTs with the DBOC CLOSE=???? or DBEC P,CLOSE,URT(????) transaction.
2. Invoke the following command, where xxxxx is the new five-character prefix.

    ►►─ DBOC ─ PREFIX=xxxxx ──────────────────────────────────────────────────────►◄

DBOC

(Required) Specify the transaction ID used with Operational commands to control system resources. Leave a space between the transaction ID and the command.

PREFIX=

(Required) Specifies a new URT prefix.

xxxxx

(Required) A five-character alphanumeric URT prefix.

When looking for a URT, CA Datacom CICS Services forms the module name by appending the URT number to this five-character prefix for URTs 1—999. For URTs 1000—9999, the URT number is appended to the first four characters of the prefix.

Verify that the resulting modules have enabled CICS System Definition data set (CSD) entries.

The URT prefix specification can also be changed using the DBOC GENOPTS command. For more information, see the System Reference Guide.