Format of Common Service Layer trace records
The Common Service Layer trace function and subfunction codes are listed, and the trace (low level) record format these functions with these subfunction codes (SC) are shown.
| Subfunction codes (SC) | Function |
|---|---|
| X'01' | Process flow |
| X'02' | Storage error |
| X'03' | Load or delete error |
| X'05' | Parameter validation error |
| X'09' | AWE error |
| X'0A' | Latch error |
| X'0F' | Miscellaneous MVS service error |
| X'11' | CQS service error |
| X'12' | SCI service error |
| X'13' | RM service error |
| X'14' | OM service error |
| X'15' | Unknown function |
| X'16' | Parameter list version error |
| X'50' | SCI Input exit |
| X'51' | SCI Notify exit |
| X'80' | Terminal logon |
| X'81' | Terminal logoff |
| X'82' | User signon |
| X'83' | User signoff |
| X'84' | DFSRMAM0 query interface |
| X'85' | DFSRMUP0 update interface |
| X'86' | RM resource entry |
| X'90' | Miscellaneous RM directive processing errors |
Subfunction code trace record format
The
following diagram shows the format of the trace records for each of
the subfunction codes listed above. Each trace record has a trace
function code of X'A2' and is X'20' bytes long.
Word 0 - byte 1 - Trace function code
- byte 2 - Trace function subcode
- byte 3-4 - Trace record sequence number
Words 1-5 - Contains information about the activity being traced.
The information recorded in this part of the trace record
depends on the trace function subcode of the trace record.
Words 6-7 - Timestamp (STCK value)The data in words 1-5, which is specific to each trace entry, is described in the following diagrams:
Trace function subcode = X'01'
Description: Process flow (Begin Process and Normal Process)
Word 1 - byte 1 - Service code
- byte 2 - Object type
- bytes 3-4 - Module identifier
Word 2 - Not used
Word 3 - Not used
Word 4 - Not used
Word 5 - Thread ECB address Trace function subcode = X'01'
Description: Process flow (End Process)
Word 1 - byte 1 - Service code
- byte 2 - Object type
- bytes 3-4 - Module identifier
Word 2 - Not used
Word 3 - Not used
Word 4 - Return code
Word 5 - Reason code Trace function subcode = X'02'
Description: Storage Request Error
Word 1 - byte 1 - Service code
- byte 2 - Object type
- bytes 3-4 - Module identifier
Word 2 - Return code
Word 3 - Storage length
Word 4 - Storage address
Word 5 - Thread ECB address Trace function subcode = X'03'
Description: Module LOAD/DELETE Error
Word 1 - byte 1 - Service code
- byte 2 - Object type
- bytes 3-4 - Module identifier
Word 2 - Return code
Word 3 - bytes 1-2 - Target module identifier
- bytes 3-4 - Not used
Word 4 - Not used
Word 5 - Thread ECB address Trace function subcode = X'04'
Description: Proclib/Execute Parameter Error
Word 1 - byte 1 - Service code
- byte 2 - Object type
- bytes 3-4 - Module identifier
Word 2 - Return code
Word 3 - Not used
Word 4 - Not used
Word 5 - Thread ECB address Trace function subcode = X'05'
Description: Parameter Validation Error
Word 1 - byte 1 - Not used
- byte 2 - Object type
Words 2-5 - Parameter Value Trace function subcode = X'07'
Description: TCB/Thread Error
Word 1 - byte 1 - Service code
- byte 2 - Object type
- bytes 3-4 - Module identifier
Word 2 - Return code
Word 3 - Not used
Word 4 - Not used
Word 5 - Thread ECB address Trace function subcode = X'09'
Description: AWE Error (Create AWE Queue Server, Get AWE, Enq AWE)
Word 1 - byte 1 - Service code
- byte 2 - Object type
- bytes 3-4 - Module identifier
Word 2 - Return code
Word 3 - Not used
Word 4 - Not used
Word 5 - Thread ECB address Trace function subcode = X'09'
Description: AWE Error (Invalid AWE)
Word 1 - byte 1 - Service code
- byte 2 - Object type
- bytes 3-4 - Module identifier
Word 2 - byte 1 - Function code
- bytes 2-4 - Not used
Word 3 - Address of invalid AWE
Word 4 - Enqueuer's ECB
Word 5 - Thread ECB address Trace function subcode = X'0A'
Description: LATCH Error
Word 1 - byte 1 - Service code
- byte 2 - Object type
- bytes 3-4 - Module identifier
Word 2 - Return code
Word 3 - Not used
Word 4 - Not used
Word 5 - Thread ECB address Trace function subcode = X'0F'
Description: Miscellaneous MVS Service Error
Word 1 - byte 1 - Service code
- byte 2 - Object type
- bytes 3-4 - Module identifier
Word 2 - Return code
Word 3 - Reason code
Word 4 - Not used
Word 5 - Thread ECB address Trace function subcode = X'11'
Description: CQS Service Error
Word 1 - byte 1 - Service code
- byte 2 - Object type
- bytes 3-4 - Module identifier
Word 2 - Return code
Word 3 - Reason code
Word 4 - Not used
Word 5 - Thread ECB address Trace function subcode = X'12'
Description: SCI Service Error
Word 1 - byte 1 - Service code
- byte 2 - Object type
- bytes 3-4 - Module identifier
Word 2 - Return code
Word 3 - Reason code
Word 4 - Not used
Words 4-5 - Target member name or zero Trace function subcode = X'13'
Description: RM Service Error
Word 1 - byte 1 - Service code
- byte 2 - Object type
- bytes 3-4 - Module identifier
Word 2 - Return code
Word 3 - Reason code
Word 4 - Not used
Words 4-5 - Target member name or zero Trace function subcode = X'14'
Description: OM Service Error
Word 1 - byte 1 - Service code
- byte 2 - Object type
- bytes 3-4 - Module identifier
Word 2 - Return code
Word 3 - Reason code
Word 4 - Not used
Words 4-5 - Target member name or zero There are two formats used for Trace Subcode X'15':
Trace function subcode = X'15'
Description: Unknown Function Exit Errors
Word 1 - bytes 1-2 - Function Code
- bytes 3-4 - Module identifier
Words 2-5 - SCI Token Trace function subcode = X'15'
Description: Unknown Function Exit Errors
Word 1 - bytes 1-2 - Function Code
- bytes 3-4 - Module identifier
Words 2-3 - Subject member name
Words 4-5 - Subject member type and subtype Trace function subcode = X'16'
Description: Parameter list version errors
Word 1 - byte 1 - Not used
- byte 2 - Object type
- bytes 3-4 - Module identifier
Words 2 - Parameter version
Words 3-4 - Member name
Word 5 - - Member version Trace function subcode = X'50'
Description: SCI Input Exit
Word 1 - byte 1 - Service code
- byte 2 - Flag
- bytes 3-4 - Source member type
Word 2 - Function code
Word 3 - Subfunction code
Words 4-5 - Source member name Trace function subcode = X'51'
Description: SCI Notify Exit
Word 1 - byte 1 - Service code
- byte 2 - Flag
- bytes 3-4 - Source member type
Word 2 - Source member type
Word 3 - Event
Words 4-5 - Source member name Trace function subcode = X'80'
Description: Logon Process
Word 1 - bytes 1-2 - Return code
- byte 3 - CLBSRM1
- byte 4 - CLBSRM2
Words 2-3 - Node name
Word 4 - Not used
Word 5 - Thread ECB address Trace function subcode = X'81'
Description: Logoff Process
Word 1 - bytes 1-2 - Return code
- byte 3 - CLBSRM1
- byte 4 - CLBSRM2
Words 2-3 - Node name
Word 4 - Not used
Word 5 - Thread ECB address Trace function subcode = X'82'
Description: Signon Process
Word 1 - bytes 1-2 - Return code
- byte 3 - CLBSRM1
- byte 4 - CLBSRM2
Words 2-3 - User structure name
Word 4 - Not used
Word 5 - Thread ECB address Trace function subcode = X'83'
Description: Signoff Process
Word 1 - bytes 1-2 - Return code
- byte 3 - CLBSRM1
- byte 4 - CLBSRM2
Words 2-3 - User structure name
Word 4 - Not used
Word 5 - Thread ECB address Trace function subcode = X'84'
Description: DFSRMAM0 query interface
Word 1 - byte 1 - RMAP flag 1
- byte 2 - RMAPE flag 1
- byte 3 - RMAPE flag 2
- byte 4 - RMAPE flag 3
Words 2-3 - Resource name
Word 4 - Data pointer
Word 5 - Return code Trace function subcode = X'85'
Description: DFSRMUP0 update interface
Word 1 - byte 1 - RMAP flag 1
- byte 2 - RMAPE flag 1
- byte 3 - RMAPE flag 2
- byte 4 - RMAPE flag 3
Word 2 - Resource pointer
Word 3 - Not used
Word 4 - Data pointer
Word 5 - Return code Trace function subcode = X'86'
Description: RM Resource Entry trace
Word 1 - byte 1 - Service code
- byte 2 - Condition code
- bytes 3-4 - Module identifier
Words 2-3 - Resource name
Word 4 - byte 1 - Resource Type
- byte 2 - Not used
- byte 3 - Input version number (last byte)
- byte 4 - Output version number (last byte)
Word 5 - Thread ECB address Trace function subcode = X'90'
Description: Miscellaneous Directive Processing errors
Word 1 - byte 1 - Service code
- byte 2 - Not used
- bytes 3-4 - Module identifier
Words 2-3 - Process name
Word 4 - Process type
Word 5 - Not used