REQUEST=QUERYDYN option of CSVDYLPA

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

REQUEST=QUERYDYN option of CSVDYLPA

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

REQUEST=QUERYDYN allows you to query whether the ADD and DELETE functions are available.

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/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 via the DYNFUNC 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=QUERYDYN

,DYNFUNC=`dynfunc`	`dynfunc:` 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=QUERYDYN: A required parameter. REQUEST=QUERYDYN indicates to return an indication of whether modules can be added to or deleted from LPA.
,DYNFUNC=dynfunc: A required output parameter that will contain the availability of the ADD and DELETE functions. If 0 (symbol CsvdylpaDynNotAvailable in macro CSVLPRET) the functions are not available. If 1 (symbol CsvdylpaDynAvailable) the functions are available.
To code: Specify the RS-type address, or address in register (2)-(12), of an one-byte field.

ABEND codes

None.

Return codes

None.

Examples

None.