REQUEST=QUERYDEFLPA option of CSVDYLPA

z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN

REQUEST=QUERYDEFLPA option of CSVDYLPA

z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN
SA23-1372-00

REQUEST=DEFLPAWAIT allows you to query whether processing of LPA statements in the IPL-time PROGxx parmlib members (deferred LPA) is complete.

Environment

The requirements for the caller are:

Environmental factor	Requirement
Minimum authorization:	Problem state and PSW key 8 - 15
Dispatchable unit mode:	Task
Cross memory mode:	PASN=HASN=SASN
AMODE:	31-bit
ASC mode:	Primary or access register (AR)
Interrupt status:	Enabled for I/O and external interrupts
Locks:	The caller must not be locked.
Control parameters:	Control parameters must be in the primary address space or, for AR-mode callers, must be in an address space or data space that is addressable through a public entry on the caller's dispatchable unit access list (DU-AL).

Programming requirements

The caller must include the CSVLPRET macro to get equates for the information returned by the DEFLPASTATE parameter.

Restrictions

The caller must not have functional recovery routines (FRRs) established.

Input register information

Before issuing the CSVDYLPA macro, the caller does not need to place any information into any general purpose register (GPR) or access register (AR) unless using it in register notation for a particular parameter, or using it as a base register.

Output register information

When control returns to the caller, the GPRs contain:

Register: Contents
0–1: Used as work registers by the system
2–13: Unchanged
14–15: Used as work registers by the system

When control returns to the caller, the ARs contain:

Register: Contents
0-1: Used as work registers by the system
2-13: Unchanged
14-15: Used as work registers by the system

Some callers depend on register contents remaining the same before and after issuing a service. If the system changes the contents of registers on which the caller depends, the caller must save them before issuing the service, and restore them after the system returns control.

Performance implications

None.

Syntax

The CSVDYLPA macro is written as follows:

Syntax	Description

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

␢	One or more blanks must precede CSVDYLPA.

CSVDYLPA

␢	One or more blanks must follow CSVDYLPA.

REQUEST=QUERYDEFLPA

,DEFLPASTATE=`deflpastate`	`deflpastate:` RS-type address or address in register (2) - (12)

Parameters

The parameters are explained as follows:

name

An optional symbol, starting in column 1, that is the name on the CSVDYLPA macro invocation. The name must conform to the rules for an ordinary assembler language symbol.

REQUEST=QUERYDEFLPA

A required parameter. REQUEST=QUERYDEFLPA indicates whether processing of LPA statements in the IPL-time PROGxx parmlib members (deferred LPA) is complete.

,DEFLPASTATE=deflpastate

A required output parameter that is to contain the deferred LPA completion state.

If the value of DEFLPASTATE is 0 (symbol CsvdylpaDefLPA_INCOMPLETE in macro CSVLPRET), processing is not complete. You can issue CSVDYLPA REQUEST=DEFLPAWAIT to wait for completion. If you are not authorized to issue CSVDYLPA REQUEST=DEFLPAWAIT, you can use the CSVDLPAW routine.

If the value of DEFLPASTATE is 1 (symbol CsvdylpaDefLPA_COMPLETE in macro CSVLPRET), processing is complete. In this case, you do not have to issue CSVDYLPA REQUEST=DEFLPAWAIT or use the CSVDLPAW routine.

From a program, you can issue LINK EP=CSVDLPAW to wait for completion. You can also have a JCL step with EXEC PGM=CSVDLPAW prior to the step with your program, and then when your program gets control, deferred LPA processing will be complete.

To code: Specify the RS-type address, or register (2) - (12) of a one-byte field.

ABEND codes

None.

Return codes

None.

Examples

See Example 2 for an example.