Programming notes for VERSION=4

FSTAT VERSION=4 supports files on Net-Storage volumes.

The STOTYPE operand permits selection according to the storage type: files on public volumes or files on Net-Storage volumes.

The FILTYPE operand enables selection according to the file type: BS2000 files or node files.

In the output area the information on the number of files on Net-Storage volumes is also displayed in the output structures OUTPUT=STAT-LONG/STAT-SHORT/ STAT-INFO in the statistical information of MAIN_HEADER, PVSID_HEADER and USERID_HEADER (see "Programming notes (VERSION=2, 3 and 4)"):

• Number of files on Net-Storage (4 bytes)

• Number of free PAM pages on Net-Storage (4 bytes)

In the output area the following information is also displayed in the output structure OUTPUT=CEINFO:

• in the organization block (see BLOCK 4 : FILE ORGANIZATION INFORMATION in Dsect):

  • file type on Net-Storage (FILE_TYPE): BS2000 file or node file

  • file size of node files (NODE_FILE_SIZE)

  • validity indicator for the node file size (NODE_FILE_SIZE_VALID)

• in the allocation block (see BLOCK 6A: FILE ALLOCATION INFORMATION in Dsect):

  • last-byte pointer for PAM files and node files (LAST_BYTE_POINTER): points to the last valid byte on the last logical page of the file. The value is only valid if the validity indicator is set as well.

  • validity indicator for the last-byte pointer (LAST_BYTE_POINTER_VALID)

Further information is provided in the following section "Programming notes (VERSION=2, 3 and 4)".