BLSRPWHS — Map the WHERE service parameter list

Description

BLSRPWHS maps the WHERE service parameter list. Use this parameter list when calling the WHERE service from within an installation-written interactive problem control system (IPCS) exit routine.

The WHERE service fills in the WHERE service parameter list with information describing the system area in which the passed address resides.

See z/OS MVS IPCS Customization for information about the WHERE service. See z/OS MVS Data Areas in z/OS Internet Library at http://www.ibm.com/systems/z/os/zos/bkserv/ for a mapping of the BLSRPWHS data area.

Environment

Because BLSRPWHS is not an executable macro, there are no specific environment requirements.

Programming requirements

None.

Restrictions

None.

Register information

Because BLSRPWHS is not an executable macro, there is no need to save and restore register contents.

Performance implications

None.

Syntax

The standard form of the BLSRPWHS macro is written as follows:

Syntax	Description

`name`	`name`: Symbol. Begin `name` in column 1.

␢	One or more blanks must precede BLSRPWHS.

BLSRPWHS

␢	One or more blanks must follow BLSRPWHS.

DSECT=YES	Default: DSECT=YES
DSECT=NO
ABITS=31	Default: ABITS=31
ABITS=64

Note: Users must supply a label (name), and start it in column 1 of the BLSRPWHS macro. When the BLSRPWHS macro is processed, the label becomes the record name and the prefix to the name of each field in the record.

Parameters

The parameters are explained as follows:

DSECT=YES
DSECT=NO: A WHERE service parameter list is mapped with a DSECT (DSECT=YES) or a WHERE service parameter list is mapped, but no DSECT is generated (DSECT=NO).
ABITS=31
ABITS=64: Either a 31-bit or a 64-bit storage map is to be referenced.

Example

Code the following to map the WHERE service parameter list, but not as a DSECT. All fields will appear with the prefix PWHS.

PWHS   BLSRPWHS DSECT=NO