The SYSTEM-FILE-CONTEXT operand of the SET-PROCEDURE-OPTIONS command is used to set the system file environment in which the procedure is to be executed.
The term SYSFILE environment refers to the system files of the BS2000, regardless of whether these files have their primary allocation or are assigned to a BS2000 file.
Procedures can be executed in a separate SYSFILE environment or can adopt the system file environment of the caller. This choice is set by the SYSTEM-FILE-CONTEXT operand.
The operand values which can be specified for SYSTEM-FILE-CONTEXT are *STD, *OWN and *SAME-AS-CALLER.
If *STD is set, the procedure will be allocated a separate SYSFILE environment in which the caller’s assignments are adopted for all system files except SYSDTA. In the default configuration, SYSDTA is assigned to the procedure (i.e. *SYSCMD).
If *SAME-AS-CALLER is set, the procedure adopts the caller’s system file environment, including the SYSDTA assignment. If assignments are modified within the procedure, this has a corresponding effect on the caller’s system file environment.
If *OWN is set, a separate system file environment is set up for the procedure; in this, all the caller’s assignments are adopted, including that for SYSDTA. However, if assignments are changed within the procedure, this does not affect the caller’s system file environment.
The system file environment which is set applies for the entire procedure, and cannot be modified by MODIFY-PROCEDURE-OPTIONS.