MODIFY-JOB-SWITCHES

Toggle job switches

Component:	BS2000
Functional area:	Job processing
Domain:	JOB
Privileges:	STD-PROCESSING HARDWARE-MAINTENANCE SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION

Function

With the MODIFY-JOB-SWITCHES command, users can set (ON), clear (OFF) or invert (INVERT) their job switches.
For every job there are 32 job switches available (numbered 0 to 31). At the beginning of the job they are cleared and can be changed while the job is running:

• explicitly, with the MODIFY-JOB-SWITCHES command,

• implicitly, with the SET-JOB-STEP command (clears switches 16 to 31), or by means of utility routines (see section "Job switches").

At the end of a job, all job switches are again cleared.

The current settings of the job switches can be queried using SHOW-JOB-SWITCHES.

Format

MODIFY-JOB-SWITCHES	Alias: MDJSW
ON = *UNCHANGED / list-poss(32): <integer 0..31> ,OFF = *UNCHANGED / *ALL / list-poss(32): <integer 0..31> ,INVERT = *UNCHANGED / list-poss(32): <integer 0..31>

Operands

ON = *UNCHANGED / list-poss(32): <integer 0..31>
Job switches to be set to ON.

OFF = *UNCHANGED / *ALL / list-poss(32): <integer 0..31>
Job switches to be set to OFF. Specifying OFF=*ALL sets all job switches to OFF.

INVERT = *UNCHANGED / list-poss(32): <integer 0..31>
Job switches to be inverted.
The job switches specified are set from ON to OFF, or from OFF to ON. 

In one MODIFY-JOB-SWITCHES command, a job switch cannot be explicitly modified, i.e. switched on or off or inverted, more than once.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed
	1	CMD0202	Contradictory entries
	32	EXC0041	System error

Examples

/show-job-sw

    ALL TASK SWITCHES SET OFF

/mod-job-sw on=(4,5) ——————————————————————————————————————————————————  (1)
/show-job-sw

    TASK SWITCHES ON EQUAL-
    4, 5

/mod-job-sw on=10,off=4,invert=1 ——————————————————————————————————————  (2)
/show-job-sw

    TASK SWITCHES ON EQUAL-
    1, 5, 10

(1)	Job switches 4 and 5 are set to one.
(2)	Job switch 10 is set to one, 4 is cleared, and 1 is inverted, i.e. changed from OFF to ON.