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


How to Use the DBUTLTY Command

To execute the REQABORT function using DBUTLTY:

  1. Perform a STATUS command to determine the sequence number of the request causing the problem.
  2. Issue the following command to terminate the request.

Multi-User mode is required to execute this command.

►►─ COMM OPTION=REQABORT,REQSEQNO=nnnnnn ─┬──────────────────────┬────────────►◄
                                          └─ ,IGN68= ─┬─ NO ◄ ─┬─┘
                                                      └─ YES ──┘

Command

COMM

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

Required Keywords

OPTION=REQABORT

Requests the Multi-User Facility to abort a particular request.

,REQSEQNO=

Indicates the internal request number for the request to be terminated.

Optional Keyword

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