Variable names which begin with the prefix SYS are reserved for the transfer of data from and to system components. Of them, the variable name SYSSWITCH represents a special format.
SYSSWITCH
The variable name SYSSWITCH identifies a complex variable of type array, which can be used to address the job switch.
The SYSSWITCH array is defined as follows:
Data type Scope Number of elements Array index Values | BOOLEAN TASK (in a dialog and procedure environment) 32 0,..., 31 TRUE = switch set to ON, FALSE = switch set to OFF |
Example
Set job switch:
/MODIFY-JOB-SWITCHES ON = 1 /SET-VARIABLE SYSSWITCH#1 = TRUE
These two commands have the same effect.
Example
/DECLARE-VARIABLE SAVED-SYSSWITCH,MULTIPLE-ELEMENTS=*ARRAY /SET-VARIABLE SAVED-SYSSWITCH=SYSSWITCH /MODIFY-JOB-SWITCHES ON =( 1,4,5) /... /SET-VARIABLE SYSSWITCH=SAVED-SYSSWITCH
The array elements can be addressed by the partial names SYSSWITCH#0 to SYSSWITCH#31. Both the read mode and the write mode are permitted.
Neither the SYSSWITCH array nor the array elements can be deleted; i.e. they cannot be specified in a FREE-VARIABLE- or DELETE-VARIABLE command.
The SYSSWITCH array is always implicitly declared in every procedure.
SYSPARAM
The variable name SYSPARAM designates a variable of type string that can be used to access the program parameters passed with the START-/LOAD-EXECUTABLE-PROGRAM commands. In C programs the program parameters are accessed with the getopt function, and assembler programs must read in the SYSPARAM variable and evaluate it themselves using the GETVAR macro call (see "GETVAR ").
Example
/LOAD-EXE FROM-FILE=*LIBRARY-ELEMENT(LIBRARY=ASS.PLAMLIB,
ELEMENT-OR-SYMBOL=NEUWORT4),
PROGRAM-PARAMETERS='INPUT=DATEI-1,OUTPUT=OUT.ERGEBNIS'
% BLS0517 MODULE 'NEUWORT4' LOADED
/SHOW-VARIABLE SYSPARAM,INF=*PAR(VALUE=*C-LIT)
SYSPARAM = 'INPUT=DATEI-1,OUTPUT=OUT.ERGEBNIS'