Format of Resource Recovery Services trace records
z/OS® Resource Recovery Services trace (RRST) records contain standard fields, and all RRS calls are associated with subfunction codes.
Word 0 -- byte 1 One-byte trace ID field. This byte indicates the
type of the trace entry.
byte 2 One-byte trace sub function code.
byte 3-4 Two-byte trace sequence number assigned by the IMS
trace component.
Word 1 -- byte 1 One-byte numeric Resource Recovery Service call code
(see the RRS call table below).
byte 2 One-byte LCREGFLG.
byte 3-4 Two-byte RRS return code.
Word 2 -- byte 1-2 Two-byte PST number - PSTPSTNR.
byte 3-4 Not used.
Word 3 -- byte 1-4 Four-byte LCRERRSF.
Word 4 -- Not used.
Word 5 -- Not used.
Word 6 -- Not used.
Word 7 -- byte 1-4 Bytes 3 through 6 of the system clock (STCK) at
the time the trace entry was created. The
following table shows the RRS calls
that are associated with the subfunction codes:
| Subfunction code | Function |
|---|---|
| X'00' | ATRBACK |
| X'01' | ATRCMIT |
| X'02' | ATRDINT |
| X'03' | ATREINT |
| X'04' | ATREINT5 |
| X'05' | ATREND |
| X'06' | ATRIBRS |
| X'07' | ATRIERS |
| X'08' | ATRIRLN |
| X'09' | ATRIRNI |
| X'0A' | ATRIRRI |
| X'0B' | ATRISLN |
| X'0C' | ATRPDUE |
| X'0D' | ATRREIC |
| X'0E' | ATRRURD |
| X'0F' | ATRRWID |
| X'10' | ATRSROI |
| X'11' | ATRSIT |
| X'12' | ATRSPID |
| X'13' | ATRSUSI2 |
| X'14' | CRGDRM |
| X'15' | CRGGRM |
| X'16' | CRGSEIF |
| X'17' | CRXSEIF |
| X'18' | CTXBEGC |
| X'19' | CTXEINT1 |
| X'1A' | CTXDINT |
| X'1B' | CTXENDC |
| X'1C' | CTXSWCH |
| X'1D' | CTXSCID |
| X'1E' | CTXSDTA |
| X'1F' | IEANTCR |
| X'20' | IEANTCT |
The following table shows the RRS function
routines that are associated with the DFSRRSI function routine codes
(FRCs).
| Function routine codes | Function routine |
|---|---|
| X'01' | Register |
| X'02' | Restart |
| X'03' | End_Restart |
| X'04' | Unregister |
| X'05' | Switch_Context |
| X'06' | Determine_Syncpt_Coord |
| X'07' | Initiate_Syncpt |
| X'08' | End_Context |
| X'09' | Retain_Interest |
| X'0A' | Post_Deferred_UR |
| X'0B' | Disassociate_Context |
| X'0C' | Coordinate_Backout |
| X'0D' | Perform_Syncpt |
| X'0E' | Identify_Context |
| X'0F' | Post_Deferred_Backout |
| X'10' | Unhook_for_Phase2 |
| X'11' | RRS_Validation |
| X'12' | Delete_UR_Interest |
| X'13' | Retrieve_XID |
| X'14' | Determine_Batch_Coord |
| X'15' | Create_Context |
| X'16' | Set_Side_Information |
| X'17' | Create_Cascaded_UR |
| X'18' | Express_UR_Interest |
| X'19' | Commit_UR |
| X'1A' | Backout_UR |
| X'1B' | Associate_Context |
| X'1C' | Application_Abend |
| X'A6' | Enter Commit (DFSRGFS0) |
| X'A7' | Exit Commit (DFSRGFS0) |
| X'A8' | RRS Error Occurred (DFSRGFS0) |
| X'A9' | RRS Abend Occurred (DFSRGFS0) |
| X'AA' | Token Trace |
The following diagrams show the format of the trace records. Each trace record has a trace function code of X'A5' and is X'20' bytes long.
Subfunction Code = X'00'
Description = Resource Recovery Services - ATRBACK
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Words 5-6 - LCURIDNT
Word 7 - Low 4 byte time stamp (STCK) Subfunction Code = X'01'
Description = Resource Recovery Services - ATRCMIT
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Words 5-6 - LCURIDNT
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'02'
Description = Resource Recovery Services - ATRDINT
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFL
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Words 5-6 - LCURIDNT
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'03'
Description = Resource Recovery Services - ATREINT
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Words 5-6 - LCURIDNT
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'04'
Description = Resource Recovery Services - ATREINT5
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Words 5-6 - LCURIDNT
Word 7 - Low 4 byte time stamp (STCK) Subfunction Code = X'05'
Description = Resource Recovery Services - ATREND
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'06'
Description = Resource Recovery Services - ATRIBRS
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'07'
Description = Resource Recovery Services - ATRIERS
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'08'
Description = Resource Recovery Services - ATRIRLN
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'09'
Description = Resource Recovery Services - ATRIRNI
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'0A'
Description = Resource Recovery Services - ATRIRRI
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'0B'
Description = Resource Recovery Services - ATRISLN
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'0C'
Description = Resource Recovery Services - ATRPDUE
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - byte 1-2 - ATRPDUEEXITNUMBER
- byte 3-4 - ATRPDUECOMPLETION
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'0D'
Description = Resource Recovery Services - ATRREIC
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Words 5-6 - LCURCNTX
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'0E'
Description = Resource Recovery Services - ATRRURD
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Words 5-6 - IMS_PCTASK_URI_TOKEN
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'0F'
Description = Resource Recovery Services - ATRRWID
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Words 5-6 - URI_Token
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'10'
Description = Resource Recovery Services - ATRSROI
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Word 5 - Not used
Word 6 - URID
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'11'
Description = Resource Recovery Services - ATRSIT
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'12'
Description = Resource Recovery Services - ATRSPID
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 0 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Words 5-6 - IMS_PCTASK_URI_TOKEN
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'13'
Description = Resource Recovery Services - ATRSUSI2
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Words 5-6 - IMS_PCTASK_RUI_TOKEN
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'14'
Description = RRMS Registration Services - CRGDRM
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'15'
Description = RRMS Registration Services - CRGGRM
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'16'
Description = RRMS Registration Services - CRGSEIF
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'17'
Description = RRMS Registration Services - CRXSEIF
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'18'
Description = RRMS Registration Services - CTXBEGC
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Words 5-6 - LCURCNTX
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'19'
Description = RRMS Context Services - CTXEINT1
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Address(LCRE)
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK) Subfunction Code = X'1A'
Description = RRMS Context Services - CTXDINT
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Address(IMS_PC_CI_Token)
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'1B'
Description = RRMS Context Services - CTXENDC
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 -RRS return code
Word 2 - byte 1-2 -PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Words 5-6 - LCURCNTX
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'1C'
Description = RRMS Context Services - CTXSWCH
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Words 5-6 - LCURCNTX
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'1D'
Description = RRMS Context Services - CTXSCID
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Address(LCRE)
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'1E'
Description = ODBA Set Context Data - CTXSDTA
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'1F'
Description = MVS Name/Token Services - IEANTCR
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)Subfunction Code = X'20'
Description = MVS Name/Token Services - IEANTRT
Word 1 - byte 1 - Numeric DFSRRSI function routine code
- byte 2 - LCREGFLG
- byte 3-4 - RRS return code
Word 2 - byte 1-2 - PSTPSTNR
- byte 3-4 - Not used
Word 3 - LCRERRSF
Word 4 - Not used
Word 5 - Not used
Word 6 - Not used
Word 7 - Low 4 byte time stamp (STCK)