Previous Topic: How to Use the Console CommandNext Topic: Example JCL


How to Use the DBUTLTY Command

Multi-User mode is required to execute this command. Execute DBUTLTY with the command:

►►─ COMM OPTION=SNAP ─┬────────────────┬─┬──────────────────────┬─────────────►◄
                      └─ ,BUFFERS=YES ─┘ └─ ,IGN68= ─┬─ NO ◄ ─┬─┘
                                                     └─ YES ──┘

Command

COMM

Invokes the function to pass communication to the Multi-User Facility.

Required Keyword

OPTION=SNAP

Requests that the Master List be written to the Statistics and Diagnostics Area (PXX).

Optional Keywords

,BUFFERS=YES

Requests that the standard CA Datacom/DB buffer area be included.

IGN68=

Specify IGN68=YES to ignore a return code 68. IGN68= is allowed for every ACCESS and COMM function. By ignoring return code 68, you can set up and run JCL that incorporates a stack of DBUTLTY functions without requiring that the MUF be enabled. IGN68= would therefore be useful, for example, if you wanted to load a database without first enabling the MUF, perhaps to allow restart to properly occur. Following is an example showing a stack of DBUTLTY functions that use IGN68=.

 ACCESS STATUS=UTLTY,DBID=997,USERS=WAIT,IGN68=YES
 COMM   OPTION=CLOSE,DBID=997,IGN68=YES
 INIT   AREA=IXX,DBID=997
 INIT   AREA=A01,DBID=997
 LOAD   AREA=A01,DBID=997,FORMAT=NONE,KBYTES=9999,SORT=1
 ACCESS STATUS=WRITE,DBID=997,IGN68=YES

Note: If the CXX is externally secured, the INIT and LOAD functions do not execute without the MUF being available, and IGN68=YES is therefore not recommended.

A function or functions specified with IGN68=YES generates message DB13001E to note that the function did not occur. Because no error was recognized, however, other functions in the stack continue to execute, and the DBUTLTY step ends without a recognizable error. Message DB13001E signals that the MUF was not enabled For details about DB13001E, see the CA Datacom/DB Message Reference Guide.

Valid Entries:

NO or YES

Default Value:

NO