Use FileCompile to compile (or assemble) a file.
FileCompile may also be entered as FileComp[ile], CompileFile, CompFile, or Comp[ile].
FileCompile is supported for workstation and BIM files only. It is not supported for PDS or VSE files.
Optional Operands
FILE is the BIM or workstation file to be compiled.
Default: last referenced file.
FileCompile is often invoked through the FileProcess command, which in turn is often invoked from the ContextProcess command.
For compiles of BIM files, the type of compile is determined by the TYPE and ATTR fields for the file. The operating system directories to search and/or catalog to are determined by the LIBDEF field for the file. TYPE, ATTR, and LIBDEF should be set for the file prior to using FileCompile by using FileDefine or FileAlter. For information on what to set these values to, contact your System Administrator.
For compiles of workstation files, the type of compile is determined by the TYPE and ATTR fields for the file. TYPE and ATTR should be set for the file prior to using FileCompile by using FileDefine or FileAlter. If TYPE is not set, the file extension (i.e, the last part of the file name) will be used as the TYPE. For information on what to set these values to, contact your System Administrator. (Administrators should refer to OS/2 Compile Procedures.)
For a BIM file, a compilation job is submitted to the operating system spooler (JES or POWER) for processing in batch.
For a workstation file, a subtask is created to perform the compilation. If errors occur, BIM-EDIT/XP will automatically create an edit session of the workstation file and insert any error messages into the session as temporary lines. The session is then qualified such that only error lines and the line immediately preceding any error line are shown. Typically, the source of the errors is then corrected, the session filed, and the FileCompile reissued.
Temporary lines are always discarded when the session is saved.
FileCompile sets the last referenced file.
When Valid
For host files, the user must have LIST access level for the FILE directory.
Return Codes
OK Successful.
ED File is being edited.
NF File not found.
SC Inadequate access level.
Procedure Notes
FileCompile sets the TXM variables to the attributes of FILE.
Examples
Compile the program held in BIM file OMREXIO:
=> comp omrexio
File and compile the current Edit session:
=> file;comp
Compile the C program held in workstation file ApcIssu.C:
=> comp apcissu.c