OPEN (FILELIST)

PLBCMP Only

A file must be created or opened prior to any attempt to process data against it. The OPEN instruction initializes each file in the FILELIST for later access by the program.

Where:

label

Optional. A Program Execution Label.

filelist

Required. A previously defined FILELIST variable identifying the files that are opened.

mode

Optional. A File Access Mode parameter defining the OPEN mode for each file in the list.

Flags Affected: NONE

Note the following:

1. When an OPEN FILELIST instruction is executed, each file in the list must be declared with a NAME parameter.

2. The instruction uses each file’s NAME parameter to determine the actual ISAM or AAM disk file name to open.

3. All other aspects of the file opens are described in the OPEN AFILE or OPEN IFILE topics.

4. When a file variable is opened using a Linux OS PL/B runtime, the current SETMODE *LINUXREADLOCK={0|1} value determines whether Linux OS read locks may be used for PL/B read statements using this file variable opened for record locking. Also, note that the Linux OS read locks are only allowed for a file variable opened the LOCKAUTO, SINGLE, and NOWAIT parameters. See the '*LINUXREADLOCK (SETMODE) description for more information.
    

When a file variable is opened to use Linux OS PL/B read locks, the read locks are only used for these PL/B read statements:

 

FILE	READ
AFILE	READ, READKG, READKGP
IFILE	READ, READKS, READKP

See Also: Example Code, CLOSE, Disk I/O Instructions