z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


REQUEST=QUERYDYN option of CSVDYNL

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

REQUEST=QUERYDYN queries to determine if the DEFINE, ADD, DELETE, UNDEFINE, TEST, and UPDATE 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 CSVDLAA 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 CSVDYNL macro, the caller does not have to place any information into any general purpose register (GPR) unless using it in register notation for a particular parameter, or using it as a base register.

Before issuing the CSVDYNL macro, the caller does not have to place any information into any 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 CSVDYNL macro is written as follows:

Syntax Description
   
   name name: symbol. Begin name in column 1.
   
One or more blanks must precede CSVDYNL.
   
CSVDYNL  
   
One or more blanks must follow CSVDYNL.
   
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 CSVDYNL macro invocation. The name must conform to the rules for an ordinary assembler language symbol.
REQUEST=QUERYDYN
A required parameter. REQUEST is required even when MF=(E,label,NOCHECK) is specified. REQUEST=QUERYDYN indicates to return an indication of whether LNKLST sets can be defined or changed. Those functions are available if the required DFSMS support is present. The RETCODE, RSNCODE, and MF keys cannot be specified.
,DYNFUNC=dynfunc
A required output parameter that will contain the availability of the DEFINE, ADD, DELETE, UNDEFINE, TEST, and UPDATE functions. If 0 (symbol CsvdynlDynNotAvailable in mapping macro CSVDLAA), the functions are not available. If 1 (symbol CsvdynlDynAvailable), 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.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014