RSMDATA RSMREQ subcommand output

The RSM requests report (Figure 1) provides information about the status of asynchronous requests. An asynchronous request is any request for which RSM has suspended the requesting work unit. In general, synchronous requests do not appear in this report. For each request, the report identifies the requester, identifies the RSM function fulfilling the request, lists the status of the request, and identifies the requested pages. The numbers for each active, cross memory, or residual request in the report are hexadecimal.

To determine the type and amount of asynchronous RSM activity in the system or for a particular job, look at the following:

Active requests are listed at the beginning of the report. The requests are sorted by address space identifier (ASID) and the work unit of the requester.
Next, the report repeats any active cross memory requests. These are requests for storage that is not in the requester's private area nor in a data space owned by the requester. Cross memory requests are sorted by the ASID of the owner of the requested page.
Following the cross memory requests, the report lists any residual requests. These are requests that are not currently active. Residual requests are sorted by the order of activity, with the most recently active first.
At the end of each active, cross memory, or residual requests list, the report has totals, in decimal, of requested pages in each state (or STATUS).

Figure 1. Example: RSMDATA RSMREQ subcommand output

R S M   R E Q U E S T S   R E P O R T

 JOBNAME  ASID TCB/SRB   FUNCTION STATUS   OWNG JOB ONAS DSP NAME      PAGE ID      COUNT    R FRM    DG
 -------- ---- --------- -------- -------- -------- ---- -------- ----------------- -------- -------- --------
 *MASTER* 0001 t006E6D78 PGFIX    COMPLETE PAGECOMM -    -        00000000_03B2C000 00000001 00003614 0218153C
 *MASTER* 0001 t006E7B60 PGFIX    COMPLETE PAGECOMM -    -        00000000_02618000 00000001 00003530 021816CC
 *MASTER* 0001 t006E7B60 PGFIX    COMPLETE PAGECOMM -    -        00000000_02616000 00000001 00003542 0218168C
 *MASTER* 0001 t00FC1E90 PGFIX    COMPLETE PAGECOMM -    -        00000000_00B95000 00000001 00000D12 021816DC
 *MASTER* 0001 t00FC1E90 PGFIX    COMPLETE PAGECOMM -    -        00000000_05821000 00000001 00005DB8 0218159C
 TRACE    0004 t006FFBF8 PGFIX    COMPLETE TRACE    0004 -        00000000_06205000 00000001 00005E44 7FFF002C
 GRS      0007 t006FFBF8 PGFIX    COMPLETE GRS      0007 -        00000000_7FFC4000 00000001 00003E01 7FFC7F9C
 GRS      0007 t006FFBF8 PGFIX    COMPLETE GRS      0007 -        00000000_7FFC3000 00000001 00003E2C 7FFC7F90
 VTAM     0018 t006EC9A8 PGFIX    COMPLETE VTAM     0018 -        00000000_006E3000 00000002 000021B3 7FFC3F3C
 VTAM     0018 t006EC9A8 PGFIX    COMPLETE PAGECOMM -    -        00000000_04413000 00000001 00001A06 021816BC
 TBBOTH   001C t006EC4C0 FLTAHPAG PGREAD   TBBOTH   001C -        00000001_01001000 00000001 00002719 020DB5E0
 TBBOTH   001C t006EC4C0 PGFIX    COMPLETE TBBOTH   001C -        00000000_06202000 00000001 00003567 7FFC3F54
 IBMUSER  001D t006DF3B8 PGFIX    COMPLETE IBMUSER  001D -        00000000_006C7000 00000003 00001754 7FFF0068
 IBMUSER  001D t006DF3B8 PGFIX    COMPLETE IBMUSER  001D -        00000000_006CD000 00000004 000015EF 7FFF005C

 Totals for active RSM requests in this report (in decimal):

       PGREAD      PGWRITE      FRAMEAA      FRAMEAB      FRAMEPA
            1            0            0            0            0

      FRAMEPH      FRAMEAH    QUADFRAME
            0            0            0

      FRAMEPB     DBLFRAME      INPROGR     COMPLETE       CANCEL
            0            0            0          248            0

       IOFAIL       XMFAIL         FAIL        TOTAL
            0            0            0          249

 Active cross-memory requests, re-sorted by owning address space:

 JOBNAME  ASID TCB/SRB   FUNCTION STATUS   OWNG JOB ONAS DSP NAME      PAGE ID      COUNT    R FRM    DG
 -------- ---- --------- -------- -------- -------- ---- -------- ----------------- -------- -------- --------
 *MASTER* 0001 t006E6D78 PGFIX    COMPLETE PAGECOMM -    -        00000000_03B2C000 00000001 00003614 0218153C
 *MASTER* 0001 t006E7B60 PGFIX    COMPLETE PAGECOMM -    -        00000000_02618000 00000001 00003530 021816CC
 *MASTER* 0001 t006E7B60 PGFIX    COMPLETE PAGECOMM -    -        00000000_02616000 00000001 00003542 0218168C
 *MASTER* 0001 t00FC1E90 PGFIX    COMPLETE PAGECOMM -    -        00000000_00B95000 00000001 00000D12 021816DC
 *MASTER* 0001 t00FC1E90 PGFIX    COMPLETE PAGECOMM -    -        00000000_05821000 00000001 00005DB8 0218159C
 VTAM     0018 t006EC9A8 PGFIX    COMPLETE PAGECOMM -    -        00000000_04413000 00000001 00001A06 021816BC

 Residual requests, sorted with most recently active first:

 JOBNAME  ASID TCB/SRB   FUNCTION STATUS   OWNG JOB ONAS DSP NAME      PAGE ID      COUNT    R FRM    DG
 -------- ---- --------- -------- -------- -------- ---- -------- ----------------- -------- -------- --------
 TBBOTH   001C t006EC4C0 FLTAHPAG PGREAD   TBBOTH   001C -        00000001_01000000 00000001 00001777 020DAE00
 J273     0014 s006EAA68 PGFIX    INPROGR  J273     0014 -        -                 00000001 -        020DB430
 J273     0014 s006EAA68 PGFIX    INPROGR  J273     0014 -        -                 00000001 -        0225AC50
 J273     0014 s006EAA68 PGFIX    INPROGR  J273     0014 -        -                 00000001 -        020DBCA0
 TBBOTH   001C -         PGOUT    PGWRITE  TBBOTH   001C -        00000000_06207000 00000001 000027D0 020DBA60
 TBBOTH   001C -         PGOUT    PGWRITE  TBBOTH   001C -        00000000_06206000 00000001 00002720 020DBD30
 TBBOTH   001C -         PGOUT    PGWRITE  TBBOTH   001C -        00000000_06205000 00000001 0000271C 0225B310
 IBMUSER  001D t006FF0D0 FLTAEPAG PGREAD   PAGECOMM -    -        00000000_0475B000 00000001 00003F13 020DB8B0

 Totals for residual RSM requests in this report (in decimal):

       PGREAD      PGWRITE      FRAMEAA      FRAMEAB      FRAMEPA
            4           15            0            0            0

      FRAMEPH      FRAMEAH    QUADFRAME
            0            0            0

      FRAMEPB     DBLFRAME      INPROGR     COMPLETE       CANCEL
            0            0           18            0            0

       IOFAIL       XMFAIL         FAIL        TOTAL
            0            0            0           37

JOBNAME

The name of the task or the service request block (SRB) that initiated the request.

ASID

The address space identifier (ASID) of the task or the SRB that initiated the request.

TCB/SRB

The address of the TCB (prefix t) or SRB (prefix s) that initiated the request.

FUNCTION

The RSM function that initiated the request. See the PAGE I/O description for the list of functions.

STATUS

The current state of the request. Multiple entries can appear for some multiple page requests.

PGREAD: Waiting for a page to be read in from a data set.
PGWRITE: Waiting for a page to be written to a data set.
FRAMEAA: Waiting for any type of real frame below 2 gigabytes.
FRAMEAB: Waiting for a real frame that resides below 16 megabytes.
FRAMEPA: Waiting for a real frame that resides in the preferred area.
FRAMEPB: Waiting for a real frame that resides in the preferred area below 16 megabytes.
DBLFRAME: Waiting for a real frame pair.
INPROGR: Request in progress.
COMPLETE: Waiting for a PGSER FREE request. COMPLETE applies only to completed, non-fast path PGSER FIX requests.
CANCEL: The request was cancelled, probably because of an address space abend or data space deletion.
IOFAIL: The I/O initiated by the request failed.
XMFAIL: The request failed because of a cross memory access error.
FAIL: The request failed for an unknown reason.
FRAMEAH: Waiting for any type of real frame. (Only for z/Architecture dumps)
FRAMEPH: Waiting for any real frame that resides in the preferred area. (Only for z/Architecture dumps)
FRAMEQD: Waiting for a quad-frame group. (Only for z/Architecture dumps)

OWNG JOB

The name of the job that owns the requested pages or PAGECOMM for pageable common area pages (including common area disabled reference pages), the pageable link pack area (PLPA), or the modified link pack area (MLPA). If OWNG JOB does not match JOBNAME, the request is a cross memory request.

*SHARED* appears instead of the job name when the RSM request data is shared through the IARVSERV macro.

HVSHARED appears instead of the job name when the RSM request data is high virtual shared through the IARV64 macro.

HVCOMM appears instead of the job name when the RSM request data is high virtual common.

ONAS

The ASID of the address space owning the requested pages A dash (–) indicates that the requested pages are in the common area, are shared pages, or are high virtual shared pages.

DSP NAME

The name of the data space that contains the requested pages. A dash (–) indicates that the requested pages do not reside in a data space.

PAGE ID

The virtual starting address of the first or only requested page. A dash (–) indicates that the request is not related to a specific virtual address. The page ID is the shared page token if *SHARED* appears in the OWNG JOB column. (The shared page token appears the Shared Data Report in the SH TOKEN column.)

COUNT

The number of requested pages that are still waiting for frames to become available or for I/O to complete. For a FIX request in which the STATUS is COMPLETE, COUNT is the number of times the requester fixed the requested page.

R FRM

The real frame number associated with the request. A dash (–) appears if there is no specific frame related to the request.

DG

Diagnostic data useful to IBM®.

Totals for active RSM requests in this report (in decimal):

Totals for residual RSM requests in this report (in decimal):

These totals are located at the end of each active or residual requests list in the report. The total number, in decimal, is recorded for the RSM requests that are in the following states: CANCEL, COMPLETE, DBLFRAME, FAIL, FRAMEAA, FRAMEAB, FRAMEPA, FRAMEPB, INPROGR, IOFAIL, PGREAD, PGWRITE, or XMFAIL. These states are described for the STATUS field. A dash (–) indicates that requests for that STATUS were not selected for the report. The total number, in decimal, of requests evaluated in the report is recorded in the TOTAL field.