gtps4m2pSystem Generation

CRASTB

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:

  1. A maximum of 32 devices can be specified on PRCRS.

  2. 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.

  3. A maximum of 32 addresses can be specified on ALTPC.

  4. 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:

  1. 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.

  2. 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.