GFUGFTRU: vn_ftrunc() — Truncate File

The component identifier is RSN_GFTR. The module ID halfword is X'5B48'.

The global reason codes:

Value Description
  • RSN_GFTR +
  • HFS_RSN_Invalid_File_Type (X'0006')
RSN_GFTR_Invalid_File_Type

A file that is not a data file was passed for truncation.

Cause: The user requested to truncate a file that is not a data file (that is, it is probably a directory).

Action: Make sure the file specified is a data file.

  • RSN_GFTR +
  • HFS_RSN_Invalid_Trunc_Offset (X'0004')
RSN_GFTR_Invalid_Trunc_Offset

The truncation offset requested is either a negative file size (file_length) or larger than the maximum supported file size. Only a positive file size value less than, or equal to, the maximum supported file size X'7FFFFFFF000' can be specified.

Cause: The user requested a truncation to an invalid file size.

Action: Make sure that the offset specified is valid. Check the binary format of the offset (number of bits, signed, and so forth).

  • RSN_GFTR +
  • HFS_RSN_Invalid _PFAR (X'0018')
RSN_GFTR_Invalid_PFAR

Refer to HFS global reason codes.

The local reason codes:

Value Description
RSN_GFTR + X'101' RSN_GFTR_Readonly_File

A truncate was requested for a file that resides in an HFS that was mounted read-only.

Probable cause: The user requested a truncate for a file that resides in an HFS that was mounted read-only.

Action: Make sure the HFS is not mounted read-only; or otherwise, do not truncate the files in it.

RSN_GFTR + X'102' RSN_GFTR_File_Has_Been_Removed

A truncate was requested for a file that has been removed

Probable cause: The user requested a truncate for a file that has been removed (possibly by another process).

Action: Make sure the file still exists when the truncate request is issued.