gtps4m2p | System Generation |
The CRASTB macro is used to specify the console device that is to be
initially used as the control program operator terminal (also referred to as
Prime CRAS set, or PRC). This device may be a locally attached 3270
(including the 3270 native console), a 1052, or a 3215. If a 3270 is
selected, a 3270-type printer must be specified in the ROCRS operand unless
the no RO parameter specifies no RO is desired in the system. If a 1052
or 3215 is selected, an alternate console device to be used as a fallback
device for the operator's terminal may also be specified.
In addition a terminal address may be specified to designate the terminal
to which the control program outputs noncritical error messages (referred to
as Receive only CRAS set--ROCRS).
After the system has been cycled to 1052 state, the PRC and ROCRS addresses
can be altered by issuing commands. However, the IPL program and the
in-core dump formatter program (ICDF) will continue to use the console device
address specified by this macro for communications with the operator.
This macro provides input to keypoint record C (CTKC). Refer to data
macro CK8KE.
The CRASTB macro is only to be coded when generating a base only system or
when generating the basic subsystem in a multiple database function (MDBF)
environment.
Format
Notes:
- A maximum of 32 devices can be specified on PRCRS.
- If using native console support, 32 values can be coded on ROCRS.
If using 3215/1052 console support, a maximum of 16 values can be
coded.
- A maximum of 32 addresses can be specified on ALTPC.
- This parameter is only valid if using 3215/1052 console support and more
than 16 ROCRS entries are required. Sixteen additional ROCRS entries
may be coded using the ROCRS16 parameter.
- PRCRS=n
- Two-digit subchannel address (in hex) of the console device to be assigned
as the primary CRAS operator terminal. The subchannel address must be
between x'01' and x'FF'. The device must be a 1052,
a 3215, or a locally attached 3270-type terminal (this includes the 3270-type
native console). Regardless of actual device characteristics, the 3270
PRC will be supported as a 3270 Model 2. A maximum of eight devices are
allowed. The following device types are supported as a 3270 type
PRC:
3278 models 2, 3, 4.
Notes:
- When PRCRS is a locally-attached 3270, ROCRS format 2 must be specified
(if the NOROCRS parameter is coded as YES, this parameter is not required),
and the NCONSL parameter must be coded as YES. All subchannel addresses
coded will be available to all processors serving as fallback devices.
All processors start at the top of the PRCRS list and search for the first
available terminal. This is assigned as the primary CRAS operator
terminal of the system.
- In native console systems fallback consoles are coded with the PRCRS
parameter instead of the ALTPC parameter. There may be more consoles
coded than there are processors being generated, according to the SYSID
parameter of the CONFIG macro. This is not true in non-native console
systems. In non-native console systems the number of system consoles
must exactly equal the number of processors being generated because fallback
consoles are coded with the ALTPC parameter.
- ROCRS=(ta,tt,a,ta,tt,a,....ta,tt,a)
-
- ta
- The line, interchange and terminal address of the receive-only CRAS device
in the format LNIATA where:
- LN
- The two-digit symbolic line address in hex.
- IA
- The two-digit interchange address in hex.
- TA
- The two-digit terminal address in hex.
All CRASTB line numbers must be within LC (local 3270) ALC or 3270 SDLC
line range as obtained from LINES macro (HSALC+1).
Must be the first parameter of the triplet (ta,tt,a). See
above.
- tt
- The device type of receive-only CRAS set. Must be one of the
following keywords:
- 1977
- A 1977
- 97UN
- A 1977 with unsolicited message light
- 97WT
- A 1977 with TAB feature
- 97UT
- A 1977 with unsolicited message light and TAB
- 8021
- A 1980-21
- 8024
- A 1980-24
- 1052
- A 1052 or 3215
- 84L1
- A 3284/3286 model 1 on an LC line.
- 84L2
- A 3284/3286 model 2 on an LC line.
Must be the second parameter of the triplet (ta,tt,a). See
above.
- a
- A character (A-Z or 0-9) to identify the system in a message routing
network to which the CRAS set is attached. If omitted, the default is
the corresponding TPF system ID coded in CONFIG(SYSID).
Must be the third parameter of the triplet (ta,tt,a). See
above.
A maximum of 32 devices is permitted.
- Note:
- If you want to use the same console device as specified for the PRC for the
ROCRS device, code the device as 1052.
If the device is 1052, the LNIATA is set to a default value of 010002 and
can be omitted.
If the ROCRS parameter is omitted there will be a default entry, consisting
of an LNIATA of 010002 and a device type of 1052, created for every PRCRS
entry. If any pair (ta,tt) of entries is defaulted, the default for
that entry will be an LNIATA of 010002 and a device type of 1052.
- ROCRS=(n,n,....n)
- This format must be used when the PRC is a locally-attached 3270, unless
the NOROCRS parameter is coded as YES.
- n
- Two-digit subchannel address (in hex) of the locally attached ROCRS 3270
printer. The subchannel address must be between x'01' and
x'FF'. Regardless of the actual device characteristics, the
device will be supported as a 84L2 (reference format 1). Although each
processor's RO is positionally determined, all subchannel addresses coded
will be available to all processors serving as fallback devices.
A maximum of 32 devices is permitted.
- Note:
- In a system with 3270 native console support, the number of PRCRS entries
must be equal to the number of ROCRS entries defined. If the NOROCRS
parameter specifies YES, then the ROCRS parameter does not need to be
coded.
- ROCRS16=(ta,tt,a,ta,tt,a,....ta,tt,a)
- Only use this parameter if more than 16 ROCRS entries are required when
using 3215/1052 console support. Code the ta,tt,a value sets
using the same rules as for the ROCRS parameter.
- NCONSL=NO|YES
- Specifies 3270 native console support. If this parameter is YES,
then ROCRS format 2 must be specified, and the ALTPC parameter must be
defaulted or zero. If the NOROCRS parameter specifies YES, then the
ROCRS parameter does not need to be coded.
- Note:
- Inclusion of native console causes 3272 local support to be included in the
system.
- MORE=30|n
- Specifies, in decimal, the number of seconds before
MORE.... is cleared from the 3270 local screen,
allowing queued messages to be printed. This parameter is valid for
both native and non-native console support.
- ALTPC=00|(n,n,....n)
- Two-digit subchannel address (in hex) of an alternate 1052 or 3215 console
to be used if the 1052 or 3215 PRC device is not functioning. When a
3270 console is selected as PRC, no alternate is provided and this value must
be (and can be defaulted to) zero (00). Association with a prime CRAS
is positionally determined.
A maximum of 32 alternate consoles is permitted.
- NOROCRS
- Specifies whether or not a 3270 RO printer will be attached to each
processor.
- YES
- The TPF system will bypass checks for an RO printer, and will not allow
operators to specify the RO parameter on any ZACRS commands. Prime CRAS
output will not be echoed to the RO printer, even if the RO device is
physically attached to the TPF system. If no RO device is attached to
the system, then the IPLB0032I NO 328X PRINTER IS OPERATIONAL - RESTART
CONTINUES message will not appear on the Prime CRAS.
- NO
- TPF processing of the 3270 RO will continue as usual. This
parameter is only relevant for a 3270 (native) console environment.
- CTKC32LC
- This parameter specifies whether CTKC should be in 32-way loosely coupled
format.
- YES
- CTKC is generated with the 32-way loosely coupled processor support flag
(CK8LC32) set on, indicating that CTKC is in 32-way loosely coupled
format. YES must be coded if one of the following is true:
- This is an existing loosely coupled complex and the ZMIGR command with the
CTKC and CONVERT parameters specified has been completed successfully.
- This is a new complex with 32-way loosely coupled processor support on all
processors.
- NO
- CTKC is generated with the 32-way loosely coupled processor support flag
(CK8LC32) set off, indicating that CTKC is not in 32-way loosely coupled
format. NO must be coded if one of the following is true:
- This is an existing loosely coupled complex and the ZMIGR command with the
CTKC and CONVERT parameters specified has not been completed
successfully.
- The ZMIGR command with the CTKC and FALLBACK parameters specified has been
completed and CTKC is not in 32-way loosely coupled format.
Examples
Example 1: The system being generated has two 3215 type
console devices with addresses of X'09' and X'1F'.
Device X'09' is to be the PRC device and X'1F' is to be the
fallback console device. The PRC device is to be also used as the ROCRS
device.
CRASTB PRCRS=09,ALTPC=1F,NCONSL=NO
Example 2: The system being generated has three 3215 type
console devices with addresses of X'09', X'0A', and
X'1F'. Devices X'09' and X'0A' are to be the
PRC devices and X'1F' will be the fallback console device for
X'0A'. X'09' has no fallback console device. The
ROCRS device for X'09' will be LNIATA of 010003 and device type of
8021. For PRC X'0A' the PRC will also be used as the ROCRS
device.
CRASTB PRCRS=(09,0A),ALTPC=(,1F),ROCRS=(010003,8021,B)
Example 3: The same as the example immediately above
except: for PRC X'09' the PRC will also be used as the ROCRS
device. The ROCRS device for X'0A' will be an LNIATA of 010003
and device type of 8021. All subchannel addresses coded will be
available to all processors serving as fallback devices. A maximum of
eight is permitted.
CRASTB PRCRS=(09,0A),ALTPC=(,1F), *
ROCRS=(,,A,010003,8021,B)
Example 4: The system being generated has two locally
attached 3270-type console devices with subchannel addresses of X'91'
and X'94' to be used as the PRC devices. The corresponding
locally-attached ROCRS devices have subchannel addresses X'93' and
X'92'. Subchannel address X'95' defines an additional
PRC fallback device and subchannel address X'96' defines an additional
RO fallback device. MORE.... is cleared
from the screen every 35 seconds.
CRASTB PRCRS=(91,94,95),ROCRS=(93,92,96), *
NCONSL=YES,MORE=35
If two processors exist in this system, the first is defined as having its
PRC on subchannel 91 with subchannels 94 and 95 as alternates and its RO on
subchannel 93 with subchannels 92 and 96 as alternates. The second
processor is defined as having its PRC on subchannel 94 with subchannels 91
and 95 as alternates and its RO on subchannel 92 with subchannels 93 and 96 as
alternates.
Example 5: The same example 4 above EXCEPT both processors
have PRCs on subchannel 91 and alternate PRCs on subchannels 94 and 99.
Additionally, both processors have their ROs on subchannel 96 and alternate
ROs on subchannels 92 and 95.
CRASTB PRCRS=(91,91,94,99),ROCRS=(96,96,92,95), *
NCONSL=YES,MORE=35
- Note:
- The number of ROCRS devices specified must equal the number of PRCRS devices
specified. Therefore, to specify additional PRC (or RO) fallback
devices with no additional RO (or PRC) devices, duplicate ROCRS (or PRCRS)
devices must be coded (see following example).
Example 6: The same example 5 above EXCEPT subchannels 84
and 85 are additional PRC fallback devices. (Note that subchannel 95 is
duplicated on the ROCRS parameter to correspond to the additional PRCRS
devices.)
CRASTB PRCRS=(91,91,94,99,84,85), *
ROCRS=(96,96,92,95,95,95),NCONSL=YES,MORE=35
References
None.