The requirements for the caller are:
Environmental factor | Requirement |
---|---|
Minimum authorization: | Supervisor state and system PSW key. |
Dispatchable unit mode: | Task mode |
Cross Memory Mode: | PASN=HASN=SASN |
AMODE: | 31-bit |
ASC mode: | Primary or access register (AR) |
Interrupt status: | Enabled or disabled for I/O and external interrupts |
Locks: | No locks held |
Control parameters: | Control parameters must be in the primary address space. |
None.
None.
There are no input register requirements for issuing the IFAQUERY macro.
None.
The standard form of the IFAQUERY macro is written as follows:
Syntax | Description |
---|---|
name | name: symbol. Begin name in column 1. |
␢ | One or more blanks must precede IFAQUERY. |
IFAQUERY | |
␢ | One or more blanks must follow IFAQUERY. |
[,xlabel] | An optional symbol, starting in column 1, that is the name on the IFAQUERY macro invocation. DEFAULT: No name |
RETRIEVE | |
,STATUS | |
,OUTAREA=outarea | xoutarea: RS-type address or register (2) - (12). |
,OUTLEN=outlen | outlen: RS-type address or register (2) - (12). |
[,DETAILS=LOGSTREAM] | Default: ALL |
[,RETCODE=retcode] | retcode: RS-type address or register (2) - (12). |
[,RSNCODE=rsncode] | rsncode: RS-type address or register (2) - (12). |
[,PLISTVER=plistver|IMPLIED_VERSION] | Default: IMPLIED_VERSION |
[,MF=S] | Default: MF=S |
[,MF=(L,mfctrl,mfattr, 0D)] | |
[,MF=(E,mfctrl,COMPLETE)] | |
To code: Specify the RS-type address of a character field, or register (2) - (12) (ASM only).
To code: Specify the RS-type address of a fullword field, or register (2) - (12) (ASM only).
DEFAULT: LOGSTREAM.
To code: Specify the RS-type address of a fullword field, or register (2) - (12) (ASM only).
To code: Specify the RS-type address of a fullword field, or address in register (2) - (12) (ASM only).
If you can tolerate the size change, IBM® suggests that you always specify PLISTVER=MAX on the list form of the macro. Specifying MAX ensures that the list-form parameter list is always long enough to hold all the parameters you might specify on the execute form, when both are assembled with the same level of the system. In this way, MAX ensures that the parameter list does not overwrite nearby storage.
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 servIice. 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 may 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.
None.
The following table contains hexadecimal return and reason codes, the equate symbols associated with each reason code, and the meaning for each return and reason code.
Return Code | Reason Code | Meaning and Action |
---|---|---|
00 | None | Explanation: IFAQUERY request successful. |
04 | Explanation: Warning. Refer to the action provided with the specific reason code. |
|
04 | xxxxxx01 | Explanation: OUTAREA is too small to contain all the requested data. The results in the OUTAREA were truncated. QUAHLEN specifies the amount of storage that is required to return a complete result. Action: Try the request again with a larger OUTAREA. |
04 | xxxxxx03 | Explanation: DETAILS=LOGSTREAM was requested but no log stream information exists. The QUAHDR is filled in appropriately. No records are returned. Action: None. |
08 | Explanation: Incorrect input parameter. Refer to the action provided with the specific reason code. |
|
08 | xxxxxx01 | Explanation: Caller was not running as a task. Action: Move the invocation of IFAQUERY under a task. |
08 | xxxxxx02 | Explanation: The input parmlist cannot be accessed. Action: Check
for one of the following possible errors:
|
08 | xxxxxx03 | Explanation: The QUAA area could not be accessed. Action: Check for one of the following
possible errors:
|
08 | xxxxxx05 | Explanation: The OUTAREA length is too small for a QUAA header. Action: Increase the size of the OUTAREA. The length must be greater than or equal to 16 bytes. |
08 | xxxxxx06 | Explanation: QUAA has invalid ALET. |
0C | Explanation: Environmental error. Refer to the action provided with the specific reason code. |
|
0C | xxxxxx01 | Explanation: SMF recording is not active. No records are returned. Action: None. |
0C | xxxxxx02 | Explanation: Storage for local area was not obtained. Action: None. |
10 | None | Explanation: Unexpected error. The state of the request is unpredictable. |