This general macro is used to determine which system options were included
in this installation at system generation. System options are defined
in the SYSTG macro and user options are defined in the SYSUG macro.
They are maintained as a string of bit switches in the control program.
Subsystem-dependent SYSET values must be accessed with the CONKC table.
(Refer to OPT parameter below.) The sysop positional parameter
of SYSTC is mutually exclusive with the OPT, UOPT, LIST, KEYWT, and UKEYWT
parameters.
Format
- label
- A symbolic name may be assigned to the macro statement.
- sysop1,2
- The symbolic name for the system option in question. The symbolic
name is the SYSET global variable without the preceding ampersand
(&). The sysop positional parameter is mutually exclusive
with the OPT, UOPT, LIST, KEYWT, and UKEYWT options.
- IFANY=goto_on
- If the system option bit specified by sysop1 is on,
then branch to the goto_on label, which can be any valid label in the
program segment.
- IFNONE=goto_off
- If the system option bit specified by sysop1 is off,
then branch to the goto_off label, which can be any valid label in
the program segment.
- IFON=goto_on
- If the subsystem option bit specified by sysop2 is on,
then branch to the goto_on label, which can be any valid label in the
program segment.
- IFOFF=goto_off
- If the subsystem option bit specified by sysop2 is
off, then branch to the goto_off label, which can be any valid label
in the program segment.
- OPT=Y
- Defines IBM's set of system option bytes when called from the CP,
copy segment CAPT. The OPT parameter is mutually exclusive with all
other parameters.
- UOPT=Y
- Defines the user's set of system option bytes when called from the
CP, copy segment CAPT, and the user's set of subsystem option bytes when
called from real-time segment CVNT. The UOPT parameter is mutually
exclusive with all other parameters.
- LIST=Y
- Generates a set of equates used by the ZSYSG command handler. The
LIST parameter is mutually exclusive with all other parameters.
- KEYWT=Y
- IBM's section of the ZSYSG keyword table is generated. The
KEYWT parameter is mutually exclusive with all other parameters.
- UKEYWT=Y
- The user's section of the ZSYSG keyword table is generated.
The UKEYWT parameter is mutually exclusive with all other parameters.
Entry Requirements
When a subsystem option is requested, SYSTC will call the CINFC macro to
access the CONKC table. Registers R14 and R15 are used for this and
must be available for use.
Return Conditions
When a sysop is coded:
- The condition code is set.
- The requested branch is taken as indicated by the new condition
code. Otherwise, control is returned to the next sequential instruction
(NSI).
- The contents of R14 and R15 are unknown. The contents of all other
registers are preserved across this macro call.
When OPT=Y is coded:
- IBM's system option bit string is initialized in main storage within
CAPT, and IBM's subsystem option bit string is initialized within
CVNT.
When UOPT=Y is coded:
- The user's system option bit string is initialized in main storage in
CAPT, and the user's subsystem option bit string is initialized in
CVNT.
When LIST=Y is coded:
- The equates used by the ZSYSG command processor are generated.
When KEYWT=Y is coded:
- IBM's section of the ZSYSG keyword table is generated in program
CSY2.
When UKEYWT=Y is coded:
- The user's section of the ZSYSG keyword table is generated within
program CSY2.
Programming Considerations
- This macro, using the sysop parameter, can be executed on any
I-stream.
- This macro is created by SIP.
- If a subsystem-dependent option bit is specified, this macro requires 16
bytes of storage if one keyword parameter is coded and 20 bytes if both
keyword parameters are coded.
- If a system option bit is specified, this macro requires 8 bytes if one
parameter is coded and 12 bytes if two are coded.
The following options for coding this macro are restricted to specific
programs requiring particular output.
- If OPT=Y is coded, this macro requires 1 byte of storage for each 8 system
options. The system option bit switches will be generated by specifying
the SYSTC macro with the OPT=Y parameter in program CAPT. The
subsystem-dependent options bit switches will be generated by specifying SYSTC
with the OPT=Y parameter in program CVNT.
- If UOPT=Y is coded, this macro requires 1 byte of storage for each 8
system options. The system option bit switches will be generated by
specifying the SYSTC macro with the UOPT=Y parameter in program CAPT.
The subsystem-dependent options bit switches will be generated by specifying
SYSTC with the UOPT=Y parameter in program CVNT.
- If LIST=Y is coded, this macro generates equates, but it does not generate
any storage. The equates are generated by specifying the SYSTC macro
with the LIST=Y parameter in programs CSY0 and CSY1.
- If KEYWT=Y is coded, the amount of storage generated depends on the number
of IBM SYSTC bytes defined in the SYSTG macro. The number of bytes
generated is 64 times the number of IBM SYSTC bytes defined. The table
is generated by specifying the SYSTC macro with the KEYWT=Y parameter in
program CSY2.
- If UKEYWT=Y is coded, the amount of storage generated depends on the
number of user SYSTC bytes defined (see the SYSUG macro code). The
number of bytes generated is 64 times the number of user SYSTC bytes
defined. The table is generated by specifying the SYSTC macro with the
UKEYWT=Y parameter in program CSY2.
Examples