DBOC: Controlling Local Resources with Operational Commands › AUTO= Setting URTs for Automatic Opening

AUTO= Setting URTs for Automatic Opening

Except for URTs specified for delayed opening, CA Datacom CICS Services opens all URTs at CA Datacom CICS Services startup. In the DBCVTPR macro, you can identify two lists of URTs for delayed opening:

• A list of URTs each of which is only opened by CA Datacom CICS Services when a CA Datacom/DB application requiring its use begins processing. (AUTO= parameter)
• A list of URTs each of which is only opened when requested by a DBOC/DBEC OPEN= command. (DEFER= parameter)

Note: For more information about specifying the AUTO= and DEFER= parameters of the DBCVTPR macro, see the System Reference Guide.

You can issue a command to add URTs to the AUTO= and DEFER= URT lists which were specified in the DBCVTPR macro. Modifications made through a DBOC transaction remain in effect only for the life of the CICS cycle. For details on modifying the list of URTs to remain closed until a DBOC/DBEC OPEN= command is issued, see DEFER= Setting URTs for Deferred Opening.

Any URTs which you specify for automatic opening using this command are returned to their initial status (as defined in DBCVTPR) if the DBOC GENOPTS transaction is used to change the maximum number of URTs. For more information, see the System Reference Guide.

To add to the list of URTs which open automatically when needed, issue the following transaction:

                  ┌─ , ───┐
►►─ DBOC ─ AUTO= ─▼─ urt ─┴───────────────────────────────────────────────────►◄

DBOC

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

AUTO=

(Required) Specifies that CA Datacom CICS Services is not to open the named URT until a CA Datacom/DB application requiring it begins processing.

urt

(Required) Specify one or more URTs by the four-digit suffix, with or without leading zeros, where the range of valid values is 0001 to the active MAXURTS= value. Use the wildcard symbol (?) to accept any valid value between 0 and 9 for any (or all) of the digits. To specify a series, separate the identifiers with commas.

The total number of URTs specified cannot exceed the value specified for the MAXURTS= parameter of the DBCVTPR macro (described in the System Reference Guide).

Note: A URT defined with SQL=YES is not eligible for AUTO opening.

In a multiple MUF environment, where connections to MUFs are defined using DBCSID macros appended to the DBCVTPR definition, AUTO URTs should refer to a MUF connection that is defined as AUTO or PLT. If an AUTO URT refers to a MUF connection that is of a DEFER type, the manual connection command must be issued for all requests to successfully perform an AUTO open.