Open feedback area

 

The open feedback area is the part of the open data path (ODP) that contains general information about the file after it has been opened. It also contains file-specific information, depending on the file type, plus information about each device or communications session defined for the file. This information is set during open processing and can be updated as other operations are performed.

Table 1. Open feedback area
Offset Data type Length Contents File type
0 Character 2 Open data path (ODP) type:

DS

Display, tape, ICF, save, printer file not being spooled, or diskette file not being spooled.

DB

Database member.

SP

Printer or diskette file being spooled or inline data file.
All
2 Character 10 Name of the file being opened. If the ODP type is DS, this is the name of the device file or save file. If the ODP type is SP, this is the name of the device file or the inline data file. If the ODP type is DB, this is the name of the database file that the member belongs to. All
12 Character 10 Name of the library containing the file. For an inline data file, the value is *N. All
22 Character 10 Name of the spooled file. The name of a database file containing the spooled input or output records. Printer or diskette being spooled or inline data
32 Character 10 Name of the library in which the spooled file is located. Printer or diskette being spooled or inline data
42 Binary 2 Spooled file number. Printer or diskette being spooled
44 Binary 2 Maximum record length. All
46 Binary 2 Maximum key length. Database
48 Character 10 Member name:

  • If ODP type DB, the member name in the file named at offset 2. If file is overridden to MBR(*ALL), the member name that supplied the last record.

  • If ODP type SP, the member name in the file named at offset 22.
Database, printer, diskette, and inline data
58 Binary 4 Reserved.  
62 Binary 4 Reserved.  
66 Binary 2 File type:

1

Display

2

Printer

4

Diskette

5

Tape

9

Save

10

DDM

11

ICF

20

Inline data

21

Database
All
68 Character 3 Reserved.  
71 Binary 2 Number of lines on a display screen or number of lines on a printed page. Display, printer
      Length of the null field byte map. Database
73 Binary 2 Number of positions on a display screen or number of characters on a printed line. Display, printer
      Length of the null key field byte map. Database
75 Binary 4 Number of records in the member at open time. For a join logical file, the number of records in the primary. Supplied only if the file is being opened for input. Database, inline data
79 Character 2 Access type:

AR

Arrival sequence.

KC

Keyed with duplicate keys allowed. Duplicate keys are accessed in first-changed-first-out (FCFO) order.

KF

Keyed with duplicate keys allowed. Duplicate keys are accessed in first-in-first-out (FIFO) order.

KL

Keyed with duplicate keys allowed. Duplicate keys are accessed in last-in-first-out (LIFO) order.

KN

Keyed with duplicate keys allowed. The duplicate keys can be accessed in one of the following orders:

  • First-in-first-out (FIFO)

  • Last-in-first-out (LIFO)

  • First-changed-first-out (FCFO)

KU

Keyed, unique.
Database
81 Character 1 Duplicate key indication. Set only if the access path is KC, KF, KL, KN, or KU:

D

Duplicate keys allowed if the access path is KF or KL.

U

Duplicate keys are not allowed; all keys are unique and the access path is KU.
Database
82 Character 1 Source file indication.

Y

File is a source file.

N

File is not a source file.
Database, tape, diskette, and inline data
83 Character 10 Reserved.  
93 Character 10 Reserved.  
103 Binary 2 Offset to volume label fields of open feedback area. Diskette, tape
105 Binary 2 Maximum number of records that can be read or written in a block when using blocked record I/O. All
107 Binary 2 Overflow line number. Printer
109 Binary 2 Blocked record I/O record increment. Number of bytes that must be added to the start of each record in a block to address the next record in the block. All
111 Binary 4 Reserved.  
115 Character 1 Miscellaneous flags.

Bit 1:

Reserved.
 
     

Bit 2:

File shareable

0

File was not opened shareable.

1

File was opened shareable (SHARE(*YES)).
All
     

Bit 3:

Commitment control

0

File is not under commitment control.

1

File is under commitment control.
Database
     

Bit 4:

Commitment lock level

0

Only changed records are locked (LCKLVL (*CHG)).

If this bit is zero and bit 8 of the character at offset 132 is one, then all records accessed are locked, but the locks are released when the current position in the file changes (LCKLVL (*CS)).

1

All records accessed are locked (LCKLVL (*ALL)).
Database
     

Bit 5:

Member type

0

Member is a physical file member.

1

Member is a logical file member.
Database
     

Bit 6:

Field-level descriptions

0

File does not contain field-level descriptions.

1

File contains field-level descriptions.
All, except database
     

Bit 7:

DBCS or graphic-capable file

0

File does not contain DBCS or graphic-capable fields.

1

File does contain DBCS or graphic-capable fields.
Database, display, printer, tape, diskette, and ICF
     

Bit 8:

End-of-file delay

0

End-of-file delay processing is not being done.

1

End-of-file delay processing is being done.
Database
116 Character 10 Name of the requester device. For display files, this is the name of the display device description that is the requester device. For ICF files, this is the program device name associated with the remote location of *REQUESTER.

This field is supplied only when either a device or remote location name of *REQUESTER is being attached to the file by an open or acquire operation. Otherwise, this field contains *N.

Display, ICF
126 Binary 2 File open count. If the file has not been opened shareable, this field contains a 1. If the file has been opened shareable, this field contains the number of programs currently attached to this file. All
128 Binary 2 Reserved.  
130 Binary 2 Number of based-on physical members opened. For logical members, this is the number of physical members over which the logical member was opened. For physical members, this field is always set to 1. Database
132 Character 1 Miscellaneous flags.  
     

Bit 1:

Multiple member processing

0

Only the member specified will be processed.

1

All members will be processed.
Database
     

Bit 2:

Join logical file

0

File is not a join logical file.

1

File is a join logical file.
Database
     

Bit 3:

Local or remote data (DDM files)

0

Data is stored on local system.

1

Data is stored on remote system.
Database
     

Bit 4:

Remote System/38™ or i5/OS® data (DDM files). Applicable only if the value of Bit 3 is 1.

0

Data is on a remote System/38 or System i™ product.

1

Data is not on a remote System/38 or System i product.
Database
     

Bit 5:

Separate indicator area

0

Indicators are in the I/O buffer of the program.

1

Indicators are not in the I/O buffer of the program. The DDS keyword, INDARA, was used when the file was created.
Printer, display, and ICF
     

Bit 6:

User buffers

0

The system creates I/O buffers for the program.

1

User program supplies I/O buffers.
All
     

Bit 7:

Reserved.
 
     

Bit 8:

Additional commitment lock level indicator. This is only valid if bit 3 of the character at offset 115 is one. If bit 4 of the character at offset 115 is zero:

0

Only changed records are locked (LCKLVL(*CHG)).

1

All records accessed are locked, but the locks are released when the current position in the file changes (LCKLVL(*CS)).
If bit 4 of the character at offset 115 is one:

0

All records accessed are locked (LCKLVL(*ALL)).

1

Reserved.
Database
133 Character 2 Open identifier. This value is unique for a full open operation (SHARE(*NO)) or the first open of a file that is opened with SHARE(*YES). This is used for display and ICF files, but is set up for all file types. It allows you to match this file to an entry on the associated data queue. All
135 Binary 2 The field value is the maximum record format length, including both data and file-specific information such as first-character forms control, option indicators, response indicators, source sequence numbers, and program-to-system data. If the value is zero, then use the field at offset 44. Printer, diskette, tape, and ICF
137 Binary 2 Coded character set identifier (CCSID) of the character data in the buffer. Database
139 Character 1 Miscellaneous flags.

Bit 1:

Null-capable field file.

0

File does not contain null-capable fields.

1

File contains null-capable fields.
Database
     

Bit 2:

Variable length fields file.

0

File does not contain any variable length fields.

1

File contains variable length fields.
Database
     

Bit 3:

Variable length record processing

0

Variable length record processing will not be done.

1

Variable length record processing will be done.
Database
     

Bit 4:

CCSID character substitution

0

No substitution characters will be used during CCSID data conversion.

1

Substitution characters can be used during CCSID data conversion.
Database, Display
     

Bit 5:

Job Level Open Indicator

0

This ODP is not scoped to the job level.

1

This ODP is scoped to the job level.
All
     

Bits 6-8:

Reserved.
 
140 Character 6 Reserved.  
146 Binary 2 Number of devices defined for this ODP. For displays, this is determined by the number of devices defined on the DEV parameter of the Create Display File (CRTDSPF) command. For ICF, this is determined by the number of program devices defined or acquired with the Add ICF Device Entry (ADDICFDEVE) or the Override ICF Device Entry (OVRICFDEVE) command. For all other files, it has the value of 1. All
148 Character   Device name definition list. All

 

Parent topic:

Feedback area layouts

 

Related concepts


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