CQS log records
You can use Common Queue Server (CQS) log records to diagnose problems related to the CQS address space and generate various reports, such as statistics about the number of requests.
CQS writes records to the z/OS® log stream that contains all CQS log records from all CQSs that are connected to a structure pair. You can use the log records to:
- Diagnose problems related to the CQS address space.
For CQS internal errors, the IBM® support representative will direct you to print the appropriate log records.
You can sometimes use information in the log records to set up a keyword string to search APAR descriptions and compare them to your own problem.
- Generate various reports related to the CQS address space, such
as statistics about the number of requests.
By knowing the content and format of the log records, you can set up a DFSERA10 job to format and print the specific log records you want.
Each CQS log record contains a log record prefix, followed by data that is unique to the record. Macro CQSLGPFX maps the log record prefix.
You can view the CQS log record formats by assembling mapping macro CQSLGREC with TYPE=ALL.
Individual log record DSECTs can be obtained by assembling the ILOGREG macro while including a format statement for the desired log record.
| Type | Subtype | Mapping macro | Conditions for writing the log record |
|---|---|---|---|
| X'03' | X'01' | CQSLGCON | CQSCONN request: The client connect to a structure completed. |
| X'04' | X'01' | CQSLGDSC | CQSDISC request: The client disconnect from a structure completed. |
| X'07' | X'01' | CQSLGPUT | CQSPUT OBJECT request completed. |
| X'02' | CQSPUT COMMIT request completed. | ||
| X'03' | CQSPUT START request completed. | ||
| X'04' | CQSPUT FORGET request completed. | ||
| X'05' | CQSPUT ABORT request completed. | ||
| X'06' | CQSPUT request failed. | ||
| X'07' | CQSPUT system checkpoint record was written. | ||
| X'08' | CQSPUT FORGET request completed. This is a batched log record. | ||
| X'08' | X'01' | CQSLGRD | CQSREAD request completed. |
| X'02' | CQSREAD request failed. | ||
| X'03' | CQSREAD system checkpoint record was written. | ||
| CQSLGCHD | This system checkpoint header record is not a complete log record, but it is used in CQSLGPUT and CQSLGRD system checkpoint log records. | ||
| X'0B' | X'01' | CQSLGMOV | CQSMOVE or CQSUNLCK request completed. |
| X'02' | CQSMOVE or CQSUNLCK request failed. | ||
| X'03' | CQSMOVE or CQSUNLCK request moved an object between the primary and overflow structure. | ||
| X'0D' | X'01' | CQSLGDEL | CQSDEL request: Delete-type 1 (delete by token) completed. |
| X'02' | CQSDEL request: Delete-type 2 (delete by queue name) completed. | ||
| X'03' | CQSDEL request: Delete-type 3 (delete by queue name and UOW) completed. | ||
| X'04' | CQSDEL request: Delete-type 1 (delete by token) completed. This is a batched log record. | ||
| CQSLGBHD | This batched log record header record is not a complete log record, but is used in CQSLGPUT and CQSLGDEL batched log records. | ||
| X'10' | X'01' | CQSLGSHT | CQSSHUT request completed. |
| X'32' | X'01' | CQSLGYCH | System checkpoint started. |
| X'02' | System checkpoint ended. | ||
| X'03' | System checkpoint failed. | ||
| X'40' | X'01' | CQSLGIST | Beginning of log stream. |
| X'42' | X'01' | CQSLGTCH | Structure checkpoint started. |
| X'02' | Structure checkpoint ended. | ||
| X'03' | Structure checkpoint failed. | ||
| X'43' | X'01' | CQSLGRBL | Structure rebuild started. Statistics about |
| X'02' | Structure rebuild ended. Statistics about |
||
| X'03' | Structure rebuild failed. Statistics about |
||
| X'04' | Structure rebuild resulted in a lost UOW list. |
||
| X'44' | X'01' | CQSLGOFL | Overflow threshold began. |
| X'02' | Overflow threshold ended. | ||
| X'03' | Overflow threshold failed. | ||
| X'04' | Overflow mode ended. | ||
| X'05' | Overflow status change. | ||
| X'06' | Qnames were moved to overflow. | ||
| X'07' | Qnames were removed from overflow. | ||
| X'08' | CQSOVERFLOWQNMR, a control list entry containing the list of queue names deleted from overflow, was deleted. | ||
| X'09' | Overflow Scan Begin. | ||
| X'0A' | Overflow Scan End. | ||
| X'0B' | Private Queue Scan Begin. | ||
| X'0C' | Structure to be deleted. | ||
| X'60' | X'01' | CQSLGSTT | Structure statistics were written at the end of system checkpoint. Individual statistics areas are mapped by CQSSSTT1, CQSSSTT2, CQSSSTT3, CQSSSTT4, and CQSSSTT5. |
| X'C0' | Internal BPE service statistics were written at the end of system checkpoint. BPE statistics areas are mapped by macro BPESSTA. |