6.5.11 BSFILE_EXT structure

The BSFILE_EXT structure is a structure to specify two or more output files.
Files can be divided and output to two or more files as a recovery processing by specifying two or more output files when the output file abnormally terminates. Therefore, set on another file system when two or more files are specified. The recovery processing can be specified at the following files.

System standard file (binary file or text file)

NetCOBOL file uses the high speed access library for a NetCOBOL sequential file (libbscblfast64.so)
NetCOBOL file uses the high speed access library for a NetCOBOL physical sequential file (libbscblpsfast64.so)

The size of the area when the area of BSFILE_EXT structure is secured can be calculated by using BS_OUTTABSIZE(n). BS_OUTTABSIZE(n) is a macro to calculate the size of BSFILE_EXT structure with n pieces of information on output file.

typedef struct {
    unsigned long            entry_no;
    union {
        BSPTR_BSFILE_BASE    ufs;
        BSPTR_BSFILE_BASE    text;
        BSPTR_BSFILE_BASE    cob;
        BSPTR_BSFILE_BASE    cobr;
        BSPTR_BSFILE_INDEX   cobi;
        BSPTR_BSFILE_INDEX   cisam;
        BSPTR_BSFILE_INDEX   rdm;
        BSPTR_BSFILE_BASE    dosfs;
        BSPTR_BSFILE_BASE    ntfs;
        BSPTR_BSFILE_BTRV    btrieve;
        BSPTR_BSFILE_BASE    sfs;
        BSPTR_BSFILE_BASE    mtfs;
        BSPTR_BSFILE_BASE    mtfr;
        BSPTR_BSFILE_BASE    mtfi;
    } outfile_opt[1];
} BSFILE_EXT;

BSFILE_EXT structure member

In the following, it explains about the member of the BSFILE_EXT structure.

entry_no

This specifies number of output file path names.
It is considered that the specification of the output file is omitted when 0 is set.

Member that sets file extension information

These members are defined in a union.

outfile_opt[n].ufs

This specifies the address of BSFILE_BASE structure in binary file of the standard file system of the system.
Specify the number of addresses specified in entry_no.

outfile_opt[n].text

This specifies the address of BSFILE_BASE structure in text file of the standard file system of the system.
Specify the number of addresses specified in entry_no.

outfile_opt[n].cob

This specifies the address of BSFILE_BASE structure in NetCOBOL sequential file or NetCOBOL physical sequential file.
Specify the number of addresses specified in entry_no.

outfile_opt[n].cobr