ZDMRD: Display get and release information
Use this command to display get and release information for a particular pool file address.
Last updated
Added for PUT05
Requirements and restrictions
- This command displays release information for a file address only if multiple release detection (MRD) is on for the specified processor, pool type, and record ID at the time that the release occurred.
- The information about get file requests and release file requests for the specified file address is stored in the record itself. If the file address is released multiple times, each occurrence is saved in the record until there is no space available. Subsequent releases are not saved in the record.
Format
- fileaddr
- The 4-byte or 8-byte file address of the pool record that you want to display get or release information for.
Additional information
- Online help information is available for this command. To display the help information, enter
one of the following commands:
- ZDMRD HELP
- ZDMRD ?
- Use the UMR0 user exit to add diagnostic information to a record that is being released with the
RELFC macro (
mrd_user_data_user_exit
) or to a record that was just obtained with the GETFC macro (gfi_user_data_user_exit
).
Examples
The following information is provided in the examples:
- FILE ADDR
- Shows the file address of the pool record.
- CURRENT RECID
- Shows the record ID of the record.
- REQUESTED RECID
- Shows the record ID that was requested on a get file request. This is displayed only for records that have the GETFC record ID (X'FC37') that is set during get file initialization (GFI) processing.
- ORIGINAL RECID
- Shows the record ID that was in the record when the first release file request was issued for this file address. This is displayed only for records that have the RELFC record ID (X'FC38') that is set during MRD processing.
- NBR
- Shows the order of the releases for the record since it was first dispensed. For example, 1 indicates the first release, 2 indicates the second release, and so on.
- MM/DD-TIME
- Shows the date and time of the release.
- USER DATA
- Shows any user data that was recorded with user exit UMR0.
- PROGVV
- Shows the name of the program that issued the release file or get file request.
- TRC
- Shows the trace name.
- PROC
- Shows the processor ID.
- DISP
- Shows the object displacement that the release file or get file request was issued from.
- LNIATA
- Shows the terminal address.
- OBJECT
- Shows the object name of the code that issued the release file or get file request. Only the first fifteen characters are displayed.
The following example displays get information for a specific record. This example indicates that
a GETFC macro or equivalent C function was issued for this file address, but the address has not
been released yet and the record contains the GETFC record ID
X'FC37'.
User: zdmrd 100821FF
System: DMRD0002I 15.34.31 DISPLAY OF GET HISTORY
FILE ADDRESS - 00000000100821FF CURRENT RECID FC37/..
REQUESTED RECID D1E3/JT
NBR MM/DD-TIME PROGVV TRC PROC DISP LNIATA OBJECT
USERDATA _
--- ----------- ------ ---- ---- -------- -------- ----------------
1 06/13-15:34 QRELJK QREL B 00000550 010000C2 relstx.cpp
ztest rels comm get idget-jt sleep-2
END OF DISPLAY+
The following example displays the release information for a specific record. This example shows
the number of times that the RELFC macro or equivalent C function was issued for this file
address.
User: zdmrd 100821FF
System: DMRD0001I 15.37.06 DISPLAY OF RELEASE HISTORY
FILE ADDRESS - 00000000100821FF CURRENT RECID FC38/..
ORIGINAL RECID FC37/..
NBR MM/DD-TIME PROGVV TRC PROC DISP LNIATA OBJECT
USERDATA
--- ----------- ------ ---- ---- -------- -------- ----------------
1 06/13-15:35 QRELJK QREL B 00006A56 010000C2 relsa.goff
RELFC by: ztest rels rel fa-100821FF
2 06/13-15:36 QRELJK QREL B 00000BAA 010000C2 relsc.cpp
RELFC by: ztest rels rel fa-100821FF c _
3 06/13-15:37 QRELJK QREL B 000036B6 010000C2 relsa.goff
RELFC by: ztest rels rel fa-100821FF lev-d7
END OF DISPLAY+