DBOC: Controlling Local Resources with Operational Commands › TRACE= Using the Trace Facility › Adding/Deleting Trace Criteria

Adding/Deleting Trace Criteria

You can display the current trace criteria using a DBOC/DBIC TRACE command. If you have not specified any trace criteria, the Trace Facility traces all CA Datacom/DB requests. For more information, see TRACE: Displaying Trace Criteria List.

To modify the current trace criteria, issue one or more of the following transactions:

                                              ┌─ , ───────┐ 
►►─ DBOC ─ TRACE, ─┬───────────┬─┬─ COMMAND= ─▼─ command ─┴─┬─────────────────►◄
                   └─ DELETE, ─┘ │         ┌─ , ────┐       │
                                 ├─ DBID= ─▼─ dbid ─┴───────┤
                                 │             ┌─ , ──┐     │
                                 ├─ RCBYPASS= ─▼─ rc ─┴─────┤
                                 │          ┌─ , ─────┐     │
                                 ├─ TABLE= ─▼─ table ─┴─────┤
                                 │           ┌─ , ──────┐   │
                                 ├─ TERMID= ─▼─ termid ─┴───┤
                                 │            ┌─ , ───────┐ │
                                 └─ TRANSID= ─▼─ transid ─┴─┘

DBOC

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

TRACE,

(Required) Specifies modification of the existing trace criteria. If specified without the DELETE parameter, specifies that the following trace criteria are to be added to the existing trace criteria.

DELETE,

(Optional) Specifies that the following trace criteria are to be deleted from the existing trace criteria.

COMMAND=command1,command2 . . . ,commandn

Adds or deletes one or more named CA Datacom/DB commands. The Trace Facility only views tasks issuing CA Datacom/DB commands included in the Trace Criteria list.

Note: OPEN and CLOSE commands are always traced when Trace Facility is active; adding or deleting these commands in the Trace Criteria list has no effect.

DBID=dbid1,dbid2 . . . ,dbidn

Adds or deletes one or more named database IDs. The Trace Facility only views tasks accessing CA Datacom/DB databases included in the Trace Criteria list.

RCBYPASS=rc1,rc2 . . . ,rcn

Adds or deletes one or more named CA Datacom/DB return codes. The Trace Facility only views tasks not returning CA Datacom/DB return codes included in the Trace Criteria list.

Note: To specify a return code of blanks, enter RCBYPASS=00. CA Datacom CICS Services translates 00 into blanks.

TABLE=table1,table2 . . . ,tablebn

Adds or deletes one or more named CA Datacom/DB tables. The Trace Facility only views tasks accessing CA Datacom/DB tables included in the Trace Criteria list.

TERMID=termid1,termid2 . . . ,termidn

Adds or deletes one or more named terminal IDs. The Trace Facility only views tasks initiated at terminals included in the Trace Criteria list.

TRANSID=transid1,transid2 . . . ,transidn

Adds or deletes one or more named transaction IDs. The Trace Facility only views tasks associated with transactions included in the Trace Criteria list.