Obtain address space classification information (REQASCL)

z/OS MVS Programming: Authorized Assembler Services Reference SET-WTO

Obtain address space classification information (REQASCL)

z/OS MVS Programming: Authorized Assembler Services Reference SET-WTO
SA23-1375-00

The REQASCL SYSEVENT provides information about an address space's classification information. You must specify the address space id (ASID) with either the ASID=register or the ASIDL=asid parameter.

The user must supply the address of a storage area large enough to hold the requested data.

REQASCL: Returns classification information about an address space.

The name is in EBCDIC format, left-justified, and padded with blanks.

Input register information

Register 1 must point to a parameter list. The parameter list for REQASCL must be non-pageable and addressable via the caller's primary address space. To map the parameter list for REQASCL, use the IRARASC mapping macro described in z/OS MVS Data Areas in z/OS Internet Library at http://www.ibm.com/systems/z/os/zos/bkserv/. The caller must set the RASC_ACRO, RASC_VERSION, and RASC_LENGTH fields. The IRARASC macro defines constants for this purpose. The following table lists the constants which contain the correct values for each field:

Table 1. Fields and constants
Field	Constant
RASC_ACRO	RASC_ID_CONSTANT
RASC_VERSION	RASC_CURRENTVERSION
RASC_LENGTH	RASC_CURRENTVERSION_LEN

Return and reason codes

When processing is complete for the REQASCL, the last byte of register 15 contains one of the following hexadecimal return codes:

Table 2. Return Codes for REQASCL
Return Code	Meaning
00	Successful completion.
04	Classification information returned may not reflect how the address space is being managed.
08	Input parameter list is not properly initialized (eyecatcher, version or size specified is too small).
12	Classification information is not available.

Input register information