Requirements

The storage map service parameter list is mapped by macro BLSRXMSP. The BLSRXMSP macro defines the following fields:

Field

Description

XMSPID

A standard control block identifier field.

XMSPPFLG

Processing flags.

XMSPNOMS: Indicates that wherever possible, no error or diagnostic messages should be issued.
XMSPV64: Indicates whether the input to the storage map service is in ABITS=31 or ABITS=64 format.

XMSPCODE

Function code that requests the major function to be performed.

XMSPSAR

The address of the storage map record being processed. Points to an area of storage mapped by mapping macro BLSRSASY.

XMSPBUF

The address of a buffer to contain the accessed storage when a storage access function is called.

The following function code constants are declared:

XMSPACC: 1 - requests that the storage described by the storage map record be accessed and copied into the specified buffer location.
XMSPVAL: 2 - requests that the storage described by the storage map record be processed by the appropriate validity check routine. Validity check routines are also known as scan routines and are defined to IPCS in parmlib members embedded in the BLSCECT parmlib member.
XMSPDIAG: 3 - requests that the block described by the storage map record be designated as being in error. IPCS issues message BLS18058I, and also issues message BLS18059I if the address of the locating area for the block is known.

If an incorrect storage map service parameter list is passed to the storage map service, IPCS issues a message and sets a return code of 16.

The storage map service is supported only under IPCS. If the storage map service is requested under SNAP, the return code is zero and field ADPLCODE is set to 4.