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

Read syntax diagramSkip visual syntax diagramZDMRD fileaddr
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+