Get AID (QsnGetAID) API


  Omissible Parameter Group:

1 AID code Output Char(1)
2 Low-level environment handle Input Binary(4)
3 Error code I/O Char(*)

  Returned Value

  AID code Output Char(1)

  Service Default Program: *USE

  Service Program: QSNAPI

  Threadsafe: No

The Get AID (QsnGetAID) API waits for an AID-generating key to be pressed.

This command corresponds indirectly to the 5250 Read Input Fields command. Because the control characters specified on the underlying command are both X'00', this operation will cause the cursor to move to the insert cursor position when the keyboard is unlocked.


Authorities and Locks

None


Omissible Parameter Group

AID code
OUTPUT; CHAR(1)

The variable that contains the AID code when the QsnRtvReadAID API has completed.

Low-level environment handle
INPUT; BINARY(4)

The low-level environment that the operation applies to. If this parameter is omitted or given with a value of zero, the default low-level environment is used.

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

AID code
OUTPUT; CHAR(1)

This API returns the value for the AID code parameter, X'00' if a general error occurs during processing.


Error Messages

Message ID Error Message Text
CPF24B4 E Severe error while addressing parameter list.
CPF3CF1 E Error code parameter not valid.
CPF3CF2 E Error(s) occurred during running of &1 API.
CPFA303 E Error occurred for screen I/O operation.
CPFA304 E Data-stream error &1 reported for screen I/O operation.
CPFA326 E Screen must be redrawn.
CPFA334 E Low level environment handle incorrect.
CPFA343 E Output operation not done.
CPFA344 E The file &2 in library &3 is not valid.
CPFA345 E The invite active flag is not valid.


API introduced: V2R3
Top | Dynamic Screen Manager APIs | APIs by category