BLSRNAMP — Map the name service parameter list

Description

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

The name service is used to convert an STOKEN or real address of a data space ASTE into:

An ASID for an address space
A data space or hiperspace name and owning ASID
A common data space (CADS)

See z/OS MVS IPCS Customization for information about the name 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 BLSRNAMP data area.

Environment

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

Programming requirements

None.

Restrictions

None.

Register information

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

Performance implications

None.

Syntax

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

Syntax	Description

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

␢	One or more blanks must precede BLSRNAMP.

BLSRNAMP

␢	One or more blanks must follow BLSRNAMP.

DSECT=YES	Default: DSECT=YES
DSECT=NO

Note: Users must supply a label (name), and start it in column 1 of the BLSRNAMP macro. When the BLSRNAMP 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 name service parameter list is mapped with a DSECT (DSECT=YES) or a name service parameter list is mapped, but no DSECT is generated (DSECT=NO).

Example

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

NAMP   BLSRNAMP DSECT=NO