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:
- 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
- The bits in CK9@SW can only be used by the system control program (CP) of
the main I-stream.
- R9 must contain the address of the ECB being processed.
- When the request is ON or OFF, part of the generated code includes a CINFC
macro call with the W (write) option. A TST request generates a CINFC
macro call with an R (read) option. If the fast-path form of the macro
is desired, a register preloaded with the appropriate SS/SSU ID must be
specified as the REG parameter.
- If several switches are to be tested, the TST parameter may be omitted
from all but the first macro call.
Return Conditions
- Control is returned to the next sequential instruction (NSI).
- The contents of registers R0 through R13 are preserved across this macro
call.
- The designated register or the default register, R14, points to the
appropriate switch bank.
- The designated bit-switch has been turned ON or OFF, or in the case of
TST, the condition code is set according to the result of a test-under-mask
instruction.
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.