File ID record

The file ID record contains the full name of the source file that was processed, and associates an integer with that file name.

Purpose

There is one file ID record for each source file that is processed, including the main source file and any included source units such as COPYLIB members and macros.

Note: If a file is included several times during processing, a file ID record must be written for each inclusion.

Syntax

FILEID version source-id line length filename sourcefile timestamp temp-flag

Parameters

version: The revision of this record, which is used for compatibility. The current version is 1.
source-id: A file identifier that is expressed as an integer. This identifier is used in place of the file name to correlate an error record with the source file in which it occurred, without using the character-based file name. If the input file is unknown, use zero. For example, when the input comes from a user exit.
line: The line number in the source file where a new file is referenced; if the file was not referenced from a file, this value is zero.
length: The length of the file name; the maximum allowable length is 255 characters.
filename: The fully qualified physical file name. If a file name does not exist (for example, getting text from the user) or the name cannot be determined, place a null string here. The name can include a server name. For example, you can set filename to \\hostname\project\dda2\ctpf.cpp.
sourcefile timestamp: The optional timestamp on the source file. Use this field if you are setting the temp-flag.
temp-flag: This field is optional. To indicate that the source is a temporary file, set it to 1. If the source is not a temporary file, set it to 0.
Tip: You can open temporary source files in browse mode only.