REQUEST=DEFLPAWAIT allows you to request that your work unit wait
until processing of LPA statements in the IPL-time PROGxx parmlib
members (deferred LPA) complete.
Environment
The requirements for the caller are:
Environmental factor |
Requirement |
---|
Minimum authorization: |
Any of the following:- Supervisor state
- PKM 0-7
- PSW key 0-7
- APF authorized
|
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). |
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
- Reason code if GPR15 is not 0
- 1
- Used as a work register by the system
- 2–13
- Unchanged
- 14
- Used as a work register by the system
- 15
- Return code
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.
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=DEFLPAWAIT |
|
|
|
,RETCODE=retcode |
retcode: RS-type address or
address in register (2) - (12) or (15), (GPR15) |
|
|
,RSNCODE=rsncode |
rsncode: RS-type address
or address in register (0) or (2) - (12), (00), (GPR) |
|
|
,PLISTVER=IMPLIED_VERSION |
Default: PLISTVER=IMPLIED_VERSION |
,PLISTVER=MAX |
|
,PLISTVER=0 |
|
|
|
,MF=S |
Default: MF=S |
,MF=(L,list addr) |
list addr: RS-type address
or register (1) - (12) |
,MF=(L,list addr,attr) |
|
,MF=(L,list addr,0D) |
|
,MF=(E,list addr) |
|
,MF=(E,list addr,COMPLETE) |
|
|
|
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=DEFLPAWAIT
- A required parameter. REQUEST=DEFLPAWAIT indicates to wait for
processing of LPA statements in the IPL-time PROGxx parmlib members
(deferred LPA) to complete. If deferred LPA is complete, the system
returns control immediately. You can use the QUERYDEFLPA request to
query whether this call is required.
- ,RETCODE=retcode
- An optional output parameter that stores the return code copied
from GPR 15. If you specify 15, GPR15, REG15, or R15 (within or without
parentheses), the value remains in GPR 15.
To code: Specify
the RS-type address of a fullword field, or register (2) - (12) or
(15), (GPR15), (REG15), or (R15).
- ,RSNCODE=rsncode
- An optional output parameter that stores the return code copied
from GPR 0. If you specify 0, 00, GPR0, GPR00, REG0, REG00, or R0
(within or without parentheses), the value remains in GPR 0.
To
code: Specify the RS-type address of a fullword field, or register
(0) or (2) - (12), (00), (GPR0), (GPR00), (REG0), (REG00), or (R0).
- ,PLISTVER=IMPLIED_VERSION
- ,PLISTVER=MAX
- ,PLISTVER=0
- An optional input parameter that specifies the version of the
macro. PLISTVER determines which parameter list the system generates.
PLISTVER is an optional input parameter on all forms of the macro,
including the list form. When using PLISTVER, specify it on all macro
forms used for a request and with the same value on all of the macro
forms. The values are:
- IMPLIED_VERSION, is the lowest version that allows all
parameters specified on the request to be processed. If the PLISTVER
parameter is omitted, IMPLIED_VERSION is the default.
- MAX, allows the parameter list to be the largest size possible.
This size might increase in future releases and affect the amount
of storage that your program needs.
You can specify PLISTVER=MAX
on the list form of the macro to ensure that the list form parameter
list can hold all the parameters you might specify on the execute
form, when both are assembled with the same level of the system. Specifying
PLISTVER=MAX ensures that the parameter list does not overwrite nearby
storage.
- 0, if you use the available parameters.
To code: Specify one of the following: - IMPLIED_VERSION
- MAX
- A decimal value of 0
- ,MF=S
- ,MF=(L,list addr)
- ,MF=(L,list addr,attr)
- ,MF=(L,list addr,0D)
- ,MF=(E,list addr)
- ,MF=(E,list addr,COMPLETE)
- An optional input parameter that specifies the macro form.
Use
MF=S to specify the standard form of the macro, which builds an inline
parameter list and generates the macro invocation to transfer control
to the service. MF=S is the default.
Use MF=L to specify the
list form of the macro. Use the list form together with the execute
form of the macro for applications that require reentrant code. The
list form defines an area of storage that the execute form uses to
store the parameters. Only the PLISTVER parameter can be coded with
the list form of the macro.
Use MF=E to specify the execute
form of the macro. Use the execute form together with the list form
of the macro for applications that require reentrant code. The execute
form of the macro stores the parameters into the storage area defined
by the list form, and generates the macro invocation to transfer control
to the service.
- ,list addr
- The name of a storage area to contain the parameters. For MF=S
and MF=E, this can be an RS-type address or an address in register
(1) - (12).
- ,attr
- An optional 1 - 60 character input string that you can use to
force boundary alignment of the parameter list. Use a value of 0F
to force the parameter list to a word boundary, or 0D to force the
parameter list to a doubleword boundary. If you do not code attr,
the system provides a value of 0D.
- ,COMPLETE
- Specifies that the system is to check for required parameters
and supply defaults for omitted optional parameters.
|