APP - fixed section
The buffer that your program passes to EQQUSIN must contain a fixed section and it must be the first section in the buffer. It identifies the buffer, its size, the default request type, and points to object sections. The buffer must contain only 1 fixed section, even if multiple requests are passed in the same buffer.
The fixed section has this format:
| Offsets | Type | Len | Name | Description | |
|---|---|---|---|---|---|
| Dec | Hex | ||||
| 0 | (0) | STRUCTURE | 80 | APP | APPC BUFFER MAPPING |
| 0 | (0) | CHARACTER | 4 | APPDESC | BLOCK DESCRIPTOR (APP) |
| 4 | (4) | CHARACTER | 2 | APPVER | VERSION NUMBER (02) |
| 6 | (6) | BITSTRING | 2 | * | RESERVED |
| 8 | (8) | CHARACTER | 3 | APPTYPE | EYE CATCHER (DIA) |
| 11 | (B) | BITSTRING | 1 | APPFLAGS | RESERVED |
| 12 |
(C) |
SIGNED |
4 |
APPTOTSZ |
TOTAL SIZE |
| 16 |
(10) |
CHARACTER |
8 |
APP_TYPE | DIALOG DATA TYPE (CREATE for EQQUSIN) |
| 24 |
(18) |
SIGNED |
4 |
APP_RETCODE |
*RETURN CODE |
| 28 |
(1C) |
SIGNED |
4 |
APP_RSNCODE |
*REASON CODE |
| 32 |
(20) |
12 |
APP_OBJ_TRIPLET |
OBJECT SECTION TRIPLET |
|
| 32 |
(20) |
SIGNED |
4 |
APP_OBJ_OFF |
OFFSET TO FIRST OBJECT SECTION |
| 36 |
(24) |
SIGNED |
4 |
APP_OBJ_LEN |
LENGTH OF ALL OBJECT SECTIONS |
| 40 |
(28) |
SIGNED |
4 |
APP_OBJ_NBR |
NUMBER OF OBJECT SECTIONS |
| 44 | (2C) | SIGNED | 4 | APP_ERR_OFF | *OFFSET TO VERIFICATION ERROR |
| 48 | (30) | CHARACTER | 8 | * | RESERVED |
| 56 | (38) | CHARACTER | 16 | APPTOKEN | *TOKEN FIELD |
| 72 | (48) | CHARACTER | 8 | * | RESERVED |
|
|
|||||
In the fixed section:
- APPDESC
- Is the block descriptor and has the value APP.
- APPVER
- Is the version number and has the value 02.
- *
- Offset 6 (X'6'). Set this reserved field to binary zeros (X'00').
- APPTYPE
- Is the eye-catcher and has the value DIA.
- APPFLAGS
- Set this reserved field to binary zeros (X'00').
- APPTOTSZ
- Is the total size of the buffer.
- APP_TYPE
- Is the request type that is the default for all requests. It is used if you do not provide a value for APPOBJ_TYPE in an object section of the buffer. If you set this field to blanks (X'40'), you must specify a request in each object section of the buffer. Only CREATE is valid for EQQUSIN.
- APP_OBJ_TRIPLET
- Contains the offset to the first APPOBJ section, the length of all sections, and the number of sections.
- APP_RETCODE
- Is the return code that is set by EQQUSIN. In the call to EQQUSIN, set this field to binary zeros (X'00'). For more information, see Return codes and reason codes generated by EQQUSIN.
- APP_RSNCODE
- Is the reason code that is set by EQQUSIN. In the call to EQQUSIN, set this field to binary zeros (X'00'). For more information, see Return codes and reason codes generated by EQQUSIN.
- APP_ERR_OFF
- Is set by EQQUSIN when APP_RSNCODE indicates an error that has an offset associated with it. It is the offset in the buffer where a verification error was found. In the call to EQQUSIN, set this field to binary zeros (X'00').
- *
- Offset 48 (X'30'). Set this reserved field to binary zeros (X'00').
- APPTOKEN
- Is a value that your program can set to uniquely identify a buffer. It could be, for example, a time stamp. APPTOKEN can be useful if you invoke EQQUSIN through the API and there is more than one active request from your ATP at a time.
- *
- Offset 72 (X'48'). Set this reserved field to binary zeros (X'00').