[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Content starts here 1.4 ACP-QIO Record Attributes Area
HP OpenVMS I/O User’s Reference Manual: OpenVMS Version 8.4 > Chapter 1 ACP-QIO Interface

1.4 ACP-QIO Record Attributes Area

Figure 1-5 shows the format of the record attributes area.

Figure 1-5 ACP-QIO Record Attributes Area

ACP-QIO Record Attributes Area

Table 1-9 lists the record attributes values and their meanings.

Table 1-9 ACP Record Attributes Values

Field Value

Meaning

FAT$B_TYPERecord type. Contains FAT$V_RTYPE and FAT$V_FILEORG.
FAT$V_RTYPERecord type. The following bit values are defined:
 

FAT$C_FIXED

Fixed-length record

 

FAT$C_VARIABLE

Variable-length record

 FAT$C_VFCVariable-length record with fixed control
 

FAT$C_UNDEFINED

Undefined record format (stream binary)
 FAT$C_STREAM

RMS stream format

 

FAT$C_STREAMLF

Stream terminated by LF

 

FAT$C_STREAMCR

Stream terminated by CR

FAT$V_FILEORGFile organization. The following bit values are defined:
 

FAT$C_DIRECT

Direct file organization[1]

 

FAT$C_INDEXED

Indexed file organization

 

FAT$C_RELATIVE

Relative file organization

 

FAT$C_SEQUENTIAL

Sequential file organization

FAT$B_RATTRIB

Record attributes. The following bit values are defined:

 

FAT$M_FORTRANCC

Fortran carriage control
 FAT$M_IMPLIEDCC

Implied carriage control

 

FAT$M_PRINTCC

Print file carriage control

 

FAT$M_NOSPAN

No spanned records

 

FAT$M_MSBRCW[2]

Record count word (RCW) is MSB formatted

FAT$W_RSIZE

Record size in bytes.

FAT$L_HIBLK[3]

Highest allocated VBN. The ACP maintains this field when the file is extended or truncated. Attempts to modify this field in a write attributes operation are ignored.

 

FAT$W_HIBLKH

High-order 16 bits

 

FAT$W_HIBLKL

Low-order 16 bits

FAT$L_EFBLK[3] [4]

End of file VBN

 

FAT$W_EFBLKH

High-order 16 bits

 

FAT$W_EFBLKL

Low-order 16 bits

FAT$W_FFBYTE

First free byte in FAT$L_EFBLK.

FAT$B_BKTSIZE

Bucket size, in blocks.

FAT$B_VFCSIZE

Size in bytes of fixed-length control for VFC records.

FAT$W_MAXREC

Maximum record size, in bytes.

FAT$W_DEFEXT

Default extend quantity.

FAT$W_GBC

Global buffer count.

FAT$W_VERSIONS

Default version limit; valid only if the file is a directory

FAT$L_GBC32

Enhanced longword global buffer count.

FAT$B_RECATTR_FLAGS

Record attributes flags. The following bit values are defined:

 

FAT$M_GBC_PERCENT

Interpret value in FAT$L_GBC32 as a percent instead of count.

 

FAT$M_GBC_DEFAULT

RMS should set default for global buffer count and ignore any values in FAT$W_GBC or FAT$L_GBC32.

[1] Defined but not implemented.

[2] Variable-length record format (FAT$C_VARIABLE) only.

[3] Inverted format field. The high- and low-order 16 bits are transposed for compatibility with PDP-11 software.

[4] When the end-of-file position corresponds to a block boundary; by convention, FAT$L_EFBLK contains the end-of-file VBN plus 1 and FAT$W_FFBYTE contains 0.