KK ProcInclude command;Session, to Include in Proc (ProcInclude)">Use ProcInclude to incorporate lines from another source during processing.
ProcInclude may also be entered as Include.
Required Operands
FILE is the workstation file to be included. If specified without a directory name, BIM-EDIT/XP will retrieve FILE from the directory for the file containing the cmdh., not the currently attached directory.
An included file can itself include from another file. This nesting process is limited to 6 deep.
ProcIncludes are often used while submitting a job for processing. In this usage it is necessary to prefix the ProcInclude command with either a right parenthesis ")" or a slash "/" so that BIM-EDIT/XP can distinguish it as a command rather than normal text. (The right parenthesis, otherwise known as the TRAP character, can only be used if the predefined variable PPDTRAP has a value of either "1" or "2".
If the member is currently being edited, ProcInclude will retrieve the text of the member ignoring any changes made in edit session.
Return Codes
OK Successful.
Examples
Quite often a number of programs need access to the same record descriptions. Rather than duplicate the record description in each program, each record description is held in a unique member. Each program, then, has an include line for each record description it will need. The following program is such a case. The first few lines of the program are presented:
------------------------------------------------------------------------
OMCRSEQ: PROC;
/INCLUDE OMBSIB
/INCLUDE OMBSSED
SSEDPTR = SIBSESSP;
/INCLUDE OMBRRH
RRHPTR = SIBRRHP;
------------------------------------------------------------------------