User and job switches

Macro	Brief description
SWITCH	Reads or changes the 32 job switches associated with the job or the 32 user switches associated with the user' s own or another user' s user ID.

The SWITCH macro replaces the GETSW, GETUS, SETSW and SETUS macros.
These macros are still supported for reasons of compatibility only and are described in the appendix on "GETSW - Get switch".

Use of job switches in BS2000

When using job switches the user must bear in mind that some system components and software products alter the status of certain job switches or are controlled by them. The following table shows which software products and system components normally utilize job switches, listing them in the order in which they are subsequently described:

System component/software product	Switches
ARCHIVE	30, 31
BCAMDEF	0, 4, 5, 31
DAMP	5, 30
DBL/ELDE (binder/loader)	4
EDT	4 - 7
STEP/SET-JOB-STEP command	16 - 31
TSOSLNK	4

The following applies:
The loader message BLS0500 is suppressed by setting switch 4.

After execution of the SET-JOB-STEP command, all job switches over 15 are reset.

The effect of switch usage on the system components and software products listed above is described in the following pages.

ARCHIVE

The software product ARCHIVE can be called both in procedures and in ENTER jobs. Information about program execution can be obtained from the switches set by ARCHIVE during or after execution.

Switch 30 set by ARCHIVE: warning message in procedures.
Switch 30 is set by ARCHIVE when the ARCHIVE statement has been executed but a warning message has been issued.

Switch 31 set by ARCHIVE: error in procedures.
Switch 31 is set by ARCHIVE if the ARCHIVE statement has been executed even though an error has been detected.

BCAMDEF
Switches 0, 4, 5, 31 are used:
Switches 0, 4, 5 and 31 are set and reset during the BCAMDEF procedure.

DAMP

Switch 5 set for DAMP

Before the DAMP program is called, task switch 5 must be set in the procedure.
If, in procedure mode, a DAMP statement is followed by a system command that is not permitted at the DAMP program level, DAMP switches from procedure mode to interactive mode and resets task switch 5. The last DAMP output screen is then displayed on the screen. In batch mode, a system command which is not permitted causes the job to be aborted.

Switch 30 set for DAMP

If task switch 30 is set and DAMP is executing in interactive mode, a message is issued asking whether a dump should be generated.
If task switch 30 is set and DAMP is executing in batch mode, no dump is generated.

DBL/ELDE (binder/loader)
Switch 4 set: system messages concerning the loading of a module (BLS0500, BLS0517,...) are suppressed.

EDT

Switch 4 set for EDT: EDT suppresses start/end message

• Interactive jobs, batch jobs:
  If this switch is set before loading EDT, load message BLS0500 and, on termination of EDT, message EDT800 are suppressed. The message

  EDITED FILE(S) NOT SAVED! TERMINATE (Y/N)?

  is also suppressed.

• Batch jobs:
  If job switch 4 is set, no log is written during the EDT run (corresponds to @LOG=NONE).

Switch 5 set for EDT: EDT operates in L mode
Input is read line by line from SYSDTA. When output to the screen, the current line number is replaced by '*'. The @EDIT FULL SCREEN statement switches over to F mode. Activating/deactivating switch 5 during the EDT run has no effect on the mode set.

Switch 6 set for EDT: EDT outputs 160 characters
If this switch is set, EDT writes 160 characters in a SYSLST record and any overflow to the next record. Use of this option is recommended if the SYSLST (system) file is to be output to a printer with a maximum line length of 160 characters. The switch must be set before calling EDT.
EDT usually outputs only 132 print positions and writes any overflow to the next record.

Switch 7 set for EDT: superfluous memory space is not released
If switch 7 is set, the superfluous memory space assigned is not automatically released by EDT. EDT usually releases unoccupied memory space (negative specification in SPACE operand of FILE macro, see the “DMS Macros” manual [7 (Related publications)]). This switch can also be set while EDT is executing.

SET-JOB-STEP command
Switches 16 through 31 are reset:
Job switches 16 through 31 are reset when the user issues a SET-JOB-STEP command.

TSOSLNK
Switch 4 set for TSOSLNK: page feed suppressed
Setting job switch 4 causes all page feeds in linkage editor listings to be ignored on output to SYSLST.