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


How to Use the DBUTLTY Command

You can execute this command in either Single User or Multi-User mode. Execute the COMM function with the following command format:

►►─ COMM OPTION=STATUS ─┬──────────────────────────┬──────────────────────────►
                        └─ ,DEST= ─┬─ PRINTER ◄ ─┬─┘
                                   └─ CONSOLE ───┘

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

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

Required Keyword

OPTION=STATUS

Requests that the current status of tasks in Multi-User Facility be displayed. COMM OPTION=STATUS in Version 12.0 (see COMM STATUS (Print Status of Multi-User Jobs)) uses the SID where a SID is understood to be a sub-identifier ID, to determine the specific Multi-User Facility to access.

Optional Keywords

,DEST=

Specifies the destination for the status report. CONSOLE causes the report to appear on both the console and SYSLST. PRINTER causes the report to appear on SYSLST only.

Note: When routing print to the console, headings do not appear.

Valid Entries:

CONSOLE (may be abbreviated as CON) or PRINTER (may be abbreviated as PRI)

Default Value:

PRINTER

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