System i: I/O feedback area for ICF and display files

I/O feedback area for ICF and display files

The table in this topic shows the I/O feedback area for ICF and display files.

Table 1. I/O feedback area for ICF and display files
Offset Data type Length Contents File type

0 Character 2 Flag bits.

Bit 1:

Cancel-read indicator.

0

The cancel-read operation did not cancel the read request.

1

The cancel-read operation canceled the read request.

Bit 2:

Data-returned indicator.

0

The cancel-read operation did not change the contents of the input buffer.

1

The cancel-read operation placed the data from the read-with-no-wait operation into the input buffer.

Bit 3:

Command key indicator.

0

Conditions for setting this indicator did not occur.

1

The Print, Help, Home, Roll Up, Roll Down, or Clear key was pressed. The key is enabled with a DDS keyword, but without a response indicator specified.

Bits 4-16:

Reserved.

Display
2 Character 1 Attention indicator byte (AIB). This field identifies which function key was pressed.
For ICF files, this field will always contain the value hex F1 to imitate the Enter key being pressed on a display device. For display files, this field will contain the 1-byte hexadecimal value returned from the device.

Hex codes

Function keys

hex 31

1

hex 32

2

hex 33

3

hex 34

4

hex 35

5

hex 36

6

hex 37

7

hex 38

8

hex 39

9

hex 3A

10

hex 3B

11

hex 3C

12

hex B1

13

hex B2

14

hex B3

15

hex B4

16

hex B5

17

hex B6

18

hex B7

19

hex B8

20

hex B9

21

hex BA

22

hex BB

23

hex BC

24

hex BD

Clear

hex F1

Enter/Rec Adv

hex F3

Help (not in operator-error mode)

hex F4

Roll Down

hex F5

Roll Up

hex F6

Print

hex F8

Record Backspace

hex 3F

Auto Enter (for Selector Light Pen)

Display, ICF
3 Character 2 Cursor location (line and position). Updated on input operations that are not subfile operations that return data to the program. For example, hex 0102 means line 1, position 2. Line 10, position 33 would be hex 0A21. Display
5 Binary 4 Actual data length. For an ICF file, see the ICF Programming
book for additional information. For a display file, this is the length of the record format processed by the I/O operation.
Display, ICF
9 Binary 2 Relative record number of a subfile record. Updated for a subfile record operation. For input operations, updated only if data is returned to the program. If multiple subfiles are on the display, this offset will contain the relative record number for the last subfile updated. Display
11 Binary 2 Lowest subfile. ndicates the lowest subfile relative record number currently displayed in the uppermost subfile display area if the last write operation was done to the subfile control record with SFLDSP specified. Updated for roll up and roll down operations. Reset to 0 on a write operation to another record. Not set for message subfiles. Display
13 Binary 2 Total number of records in a subfile. Updated on a put-relative operation to any subfile record. The number is set to zero on a write or write-read operation to any subfile control record with the SFLINZ keyword optioned on. If records are put to multiple subfiles on the display, this offset will contain the total number of records for all subfiles assuming that no write or write-read operations were performed to any subfile control record with the SFLINZ keyword optioned on. Display
15 Character 2 Cursor location (line and position) within active window. Updated on input operations that are not subfile operations that return data to the program. For example, hex 0203 means line 2, position 3 relative to the upper-left corner of the active window. Display
17 Character 17 Reserved.
34 Character 2 Major return code.

00

Operation completed successfully.

02

Input operation completed successfully, but job is being canceled (controlled).

03

Input operation completed successfully, but no data received.

04

Output exception.

08

Device already acquired.

11

Read from invited devices was not successful.

34

Input exception.

80

Permanent system or file error.

81

Permanent session or device error.

82

Acquire or open operation failed.

83

Recoverable session or device error.

Display, ICF
36 Character 2 Minor return code. For the values for a display file, see the Application Display Programming
book. For the values for an ICF file, see the ICF Programming
book and the appropriate communications-type programmer's guide.
Display, ICF
38 Character 8 Systems Network Architecture (SNA) sense return code. For some return codes, this field might contain more detailed information about the reason for the error. For a description of the SNA sense codes, see the appropriate SNA book. ICF
46 Character 1 Safe indicator:

0

An end-of-text (ETX) control character has not been received.

1

An ETX control character has been received.

ICF
47 Character 1 Reserved.
48 Character 1 Request Write (RQSWRT) command from remote system/application.

0

RQSWRT not received

1

RQSWRT received

ICF
49 Character 10 Record format name received from the remote system. ICF
59 Character 4 Reserved.
63 Character 8 Mode name. ICF
71 Character 9 Reserved.

Parent topic:
I/O feedback area

Related concepts

Monitoring file status with the open and I/O feedback area

Offset	Data type	Length	Contents	File type
0	Character	2	Flag bits. Bit 1: Cancel-read indicator. 0 The cancel-read operation did not cancel the read request. 1 The cancel-read operation canceled the read request. Bit 2: Data-returned indicator. 0 The cancel-read operation did not change the contents of the input buffer. 1 The cancel-read operation placed the data from the read-with-no-wait operation into the input buffer. Bit 3: Command key indicator. 0 Conditions for setting this indicator did not occur. 1 The Print, Help, Home, Roll Up, Roll Down, or Clear key was pressed. The key is enabled with a DDS keyword, but without a response indicator specified. Bits 4-16: Reserved.	Display
2	Character	1	Attention indicator byte (AIB). This field identifies which function key was pressed. For ICF files, this field will always contain the value hex F1 to imitate the Enter key being pressed on a display device. For display files, this field will contain the 1-byte hexadecimal value returned from the device. Hex codes Function keys hex 31 1 hex 32 2 hex 33 3 hex 34 4 hex 35 5 hex 36 6 hex 37 7 hex 38 8 hex 39 9 hex 3A 10 hex 3B 11 hex 3C 12 hex B1 13 hex B2 14 hex B3 15 hex B4 16 hex B5 17
			hex B6 18 hex B7 19 hex B8 20 hex B9 21 hex BA 22 hex BB 23 hex BC 24 hex BD Clear hex F1 Enter/Rec Adv hex F3 Help (not in operator-error mode) hex F4 Roll Down hex F5 Roll Up hex F6 Print hex F8 Record Backspace hex 3F Auto Enter (for Selector Light Pen)	Display, ICF
3	Character	2	Cursor location (line and position). Updated on input operations that are not subfile operations that return data to the program. For example, hex 0102 means line 1, position 2. Line 10, position 33 would be hex 0A21.	Display
5	Binary	4	Actual data length. For an ICF file, see the ICF Programming book for additional information. For a display file, this is the length of the record format processed by the I/O operation.	Display, ICF
9	Binary	2	Relative record number of a subfile record. Updated for a subfile record operation. For input operations, updated only if data is returned to the program. If multiple subfiles are on the display, this offset will contain the relative record number for the last subfile updated.	Display
11	Binary	2	Lowest subfile. ndicates the lowest subfile relative record number currently displayed in the uppermost subfile display area if the last write operation was done to the subfile control record with SFLDSP specified. Updated for roll up and roll down operations. Reset to 0 on a write operation to another record. Not set for message subfiles.	Display
13	Binary	2	Total number of records in a subfile. Updated on a put-relative operation to any subfile record. The number is set to zero on a write or write-read operation to any subfile control record with the SFLINZ keyword optioned on. If records are put to multiple subfiles on the display, this offset will contain the total number of records for all subfiles assuming that no write or write-read operations were performed to any subfile control record with the SFLINZ keyword optioned on.	Display
15	Character	2	Cursor location (line and position) within active window. Updated on input operations that are not subfile operations that return data to the program. For example, hex 0203 means line 2, position 3 relative to the upper-left corner of the active window.	Display
17	Character	17	Reserved.
34	Character	2	Major return code. 00 Operation completed successfully. 02 Input operation completed successfully, but job is being canceled (controlled). 03 Input operation completed successfully, but no data received. 04 Output exception. 08 Device already acquired. 11 Read from invited devices was not successful. 34 Input exception. 80 Permanent system or file error. 81 Permanent session or device error. 82 Acquire or open operation failed. 83 Recoverable session or device error.	Display, ICF
36	Character	2	Minor return code. For the values for a display file, see the Application Display Programming book. For the values for an ICF file, see the ICF Programming book and the appropriate communications-type programmer's guide.	Display, ICF
38	Character	8	Systems Network Architecture (SNA) sense return code. For some return codes, this field might contain more detailed information about the reason for the error. For a description of the SNA sense codes, see the appropriate SNA book.	ICF
46	Character	1	Safe indicator: 0 An end-of-text (ETX) control character has not been received. 1 An ETX control character has been received.	ICF
47	Character	1	Reserved.
48	Character	1	Request Write (RQSWRT) command from remote system/application. 0 RQSWRT not received 1 RQSWRT received	ICF
49	Character	10	Record format name received from the remote system.	ICF
59	Character	4	Reserved.
63	Character	8	Mode name.	ICF
71	Character	9	Reserved.