DBOC/DBIC: Monitoring Local Resources with Operational Commands › INQ=CODES: Displaying Request Totals by Return Code

INQ=CODES: Displaying Request Totals by Return Code

Each request made to CA Datacom CICS Services is tallied by return code. When a request is successfully serviced, the return code is blank. CA Datacom CICS Services tallies blank return codes as 00. A report showing the result of all requests issued since CICS startup (or since the last time the statistics were reset) is written automatically as part of CICS shutdown. This report enables you to monitor the frequency with which error conditions prevent successful servicing of requests and to determine the source of the errors.

As part of the procedure for solving an immediate application program problem, you may view this report online while CICS is in session. To produce this report in its current status, issue the following transaction:

Note: In a multiple MUFs environment, the CODES inquiry displays return code totals for all MUFs defined in the DBCVTPR module.

►►─┬─ DBOC ─┬─ INQuire=CODES ─────────────────────────────────────────────────►◄
   └─ DBIC ─┘

DBOC/DBIC

(Required) Specify a transaction ID valid with Operational commands used to monitor system resources. Select the transaction ID for which you are authorized. Leave a space between the transaction ID and the command.

INQuire=

(Required) Command specifying a status display. You may shorten this command to INQ=.

CODES

(Required) Specifies that CA Datacom CICS Services is to display total CA Datacom/DB requests by return code received. In a multi-MUF environment, this is the total of all requests by return code for all MUFs.

Note: For a description of error conditions producing non-blank return codes, see the CA Datacom/DB Message Reference Guide.

Return code counters are automatically reset to zero as part of CICS shutdown. Counters also can be manually reset while CICS is in session. If the return code counters are not reset periodically at sites generating a large volume of requests, the online report may not display all totals. Totals exceeding six digits are displayed with a leading plus sign (+) to indicate an overflow. For instructions on resetting return code counters, see RESET= Resetting Statistic Counters.