Retrieve Low-Level Environment User Data (QsnRtvEnvDta) API
Required Parameter:
1 | Low-level environment handle | Input | Binary(4) |
Omissible Parameter Group:
2 | User data pointer | Output | PTR(SPP) |
3 | Error code | I/O | Char(*) |
Returned Value:
User data pointer | Output | PTR(SPP) |
Default Public Authority: *USE
Service Program: QSNAPI
Threadsafe: No
The Retrieve Low-Level Environment User Data (QsnRtvEnvDta) API returns a pointer to the user data for the given low-level environment.
Authorities and Locks
None.
Required Parameter
- Low-level environment handle
- INPUT; BINARY(4)
A handle for the low-level environment for which the user data should be returned. If this parameter is omitted or specified as 0, the default low-level environment is used.
Omissible Parameter Group
- User data pointer
- OUTPUT; PTR(SPP)
A pointer to the user data, as specified on the low-level environment description, for the given low-level environment.
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter. If this parameter is omitted, diagnostic and escape messages are issued to the application.
Returned Value
- User data pointer
- OUTPUT; PTR(SPP)
This API returns the value for the user data pointer parameter, or the null pointer if an error occurs.
Error Messages
Message ID | Error Message Text |
---|---|
CPF24B4 E | Severe error while addressing parameter list. |
CPF3C1F E | Pointer is not on a 16 byte boundary. |
CPF3CF1 E | Error code parameter not valid. |
CPF3CF2 E | Error(s) occurred during running of &1 API. |
CPFA31E E | Required parameter &1 omitted. |
CPFA334 E | Low level environment handle incorrect. |
API introduced: V2R3
[ Back to top | Dynamic Screen Manager APIs | APIs by category ]