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 (AID). 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 Link to
PDF 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 server 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 Link to PDF book. For the values for an ICF file, see the ICF Programming Link to
PDF 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 server. ICF
59 Character 4 Reserved.  
63 Character 8 Mode name. ICF
71 Character 9 Reserved.  
Related concepts
Monitor file status with the open and I/O feedback area