gtps1m59System Macros

SWCHC-Set and Test Lethal Utility Switch

Use this system macro to set, reset, and test the bit switches contained in the CK9@SW system control field in keypoint B. These bit switches are interrogated by the state change modules to determine if a state change request can be honored. The bit switches serve the same function formerly provided by the global area set of 32 switches within the area labeled @SWITCH. The switches in @SWITCH are still available but can only be used by user-defined application programs.

All bit positions formerly associated with the system utilities such as capture and restore are now contained in CK9@SW. All bit positions formerly associated with user-defined application programs have been retained in @SWITCH. Bits for all other utilities in @SWITCH are now available for use by user-defined application programs.

All of the switches in CK9@SW and in @SWITCH are checked at cycle change request time.

Format




Notes:

  1. op

label
A symbolic name can be assigned to the macro statement.

op
The operation to be performed on the switch. It must be one of the following:

ON
Turn the switch on

OFF
Turn the switch off

TST
Test the switch

omitted
Test the switch (without issuing a CINFC call for keypoint B addressability, which is valid only when a previous SWCHC with the TST option has been processed).

LIST
Produce only a list of EQU statements defining each bit within CK9@SW.

swname
This is the switch name of the bit switch contained within CK9@SW. Following is the list of valid names:

SW@RECP
Recoup Utility

SW@SFT
Selective File Trace Utility

SW@FIL
Record Cache Subsystem (RCS) File

SW@ENA
Record Cache Subsystem (RCS) Enable

SW@IMP
Record Cache Subsystem (RCS) Implement

SW@DCOL
Data Collection Utility

SW@RTT
Real Time Trace Utility

SW@CAPT
Capture Utility

SW@REST
Restore Utility

SW@SCPY
SON Copy

SW@CCE
3705 Dump

SW@DBR
Database Reorganization Utility

SW@CCP
CCP Trace

SW@LKTR
Link Trace

The 32 remaining bit switches are named for the bit they represent, such as SW@02 or SW@03. If a new utility is to be monitored during cycle change in addition to those currently being monitored, the associated switch should be renamed to reflect the new function symbolically.

REG=R14|Rx
This is the designated register to be loaded with the address of the selected switch bank. If omitted, the register defaults to R14. If present, the register must have been loaded with the appropriate SS/SSU ID.

Entry Requirements

Return Conditions

Programming Considerations

This macro can be run on the main I-stream only. This macro is intended for use on behalf of system utility programs (as distinct from utilities on behalf of user applications).

Examples

None.