UPDATE TRACETABLE command

The following diagram shows the syntax for the UPDATE TRACETABLE command:

The following list describes the parameters of UPDATE TRACETABLE:

UPDATE | UPD

A required parameter that specifies that the action against the trace table is to update its attributes.

TRACETABLE | TRTAB

A required parameter that specifies that the resource type being acted upon is an IMS Database Recovery Facility BPE-managed trace table.

NAME(trace_table_name)

A required parameter that specifies the name of the trace table type or types that you want to update. You can specify a single trace table name or a list of trace table names separated by commas. Trace table names can contain wildcard characters. Trace table names can be IMS Database Recovery Facility BPE-defined trace tables or IMS Database Recovery Facility-defined trace tables.

The following IMS Database Recovery Facility BPE-defined trace table types are available:

AWE

Asynchronous work element (AWE) trace table

CBS

Control block services trace table

CMD

Command trace table

DISP

Dispatcher trace table

ERR

IMS Database Recovery Facility BPE Error trace table

LATC

Latch trace table

MISC

Miscellaneous trace table that is used only by IMS Service for trap traces

SSRV

System services trace table

STG

Storage service trace table

USRX

User exit routine trace table

You can update IMS Database Recovery Facility-defined trace tables only for IMS Database Recovery Facility address spaces.

OWNER(BPE | DRF)

An optional parameter that specifies the owner of the trace table type or types that you want to update. You can specify one of the following values:

BPE

For IMS Database Recovery Facility BPE-defined trace table types

DRF

For IMS Database Recovery Facility-defined trace table types

The OWNER parameter acts as a filter to help you select the trace tables that you want to update. For example, you could specify NAME(*) OWNER(DRF) to update all of the IMS Database Recovery Facility-defined trace table types.

You could specify NAME(*) OWNER(BPE) to update all of the IMS Database Recovery Facility-defined trace table types.

If OWNER is omitted, then both IMS Database Recovery Facility BPE and IMS Database Recovery Facility trace tables might be updated (depending on the tables specified on NAME).

LEVEL(level)

An optional parameter that sets the new tracing level for the specified trace tables. If LEVEL is omitted, the level of the specified trace tables is not changed. These levels are possible:

NONE

No tracing is being done into the table.

ERROR

Only traces for error or exception conditions are being made into the table.

LOW

Only major event trace entries are made into the table.

MEDIUM

Major event trace entries and some minor event trace entries are made into the table.

HIGH

All trace entries are made into the table.

Important: You cannot change the level for the trace table type ERR. IMS Database Recovery Facility BPE forces the level to HIGH to ensure that error diagnostics are captured. Any level that you specify for the ERR trace table is ignored.