gtpo1m11Operations

ZACRS-Alter CRAS Status

Use this command to change the contents of the CRAS status table.

Requirements and Restrictions

None.

Format




Notes:

  1. The VAL option is valid only when you specify the FBK parameter.

  2. The ADD and DEL options are valid only when you specify the CHG parameter.

  3. The REST parameter is valid only for input devices.

  4. The SUB parameter is valid only when you specify the FBK parameter and when 3270 native console support is generated.

REP
adds an entry to the CRAS table or replaces an existing entry.

FBK
performs fallback for the current 1052 PRC terminal to the alternate 1052 PRC terminal for 1052 console support, or performs fallback from the current PRC/RO terminal to an alternate PRC/RO terminal for 3270 native console support.

DEL
deletes an entry from the CRAS table.

CHG
modifies the current FSC routing codes or the terminal restrictions of an existing entry.
Note:
The FSC routing codes are defined by the RTCD parameter, and the terminal restrictions are defined by the REST parameter.

PRC
specifies the prime CRAS.

RO
specifies the receive-only CRAS.

Axx
specifies an alternate CRAS, where xx is the 2-digit number of an alternate CRAS.

lniata
is a line, interchange, and terminal address.

leid
is a logical end-point identifier.

TYPE
specifies the terminal type.

CON
specifies a 1052/3215 type device.

CRT
specifies a CRT display device.

PRT
specifies a printer device.

TYP
specifies a teletypewriter.

CPUID-id
is a 1-character alphanumeric CPU ID.

Notes:

  1. When you specify the CPUID parameter with the REP parameter, id is the ID of the emulator program (EP) processor, which owns the device.

  2. When you specify the CPUID parameter with the CHG parameter, id is the ID of the processor from which messages will be routed to the emulator program (EP) processor, which owns the device.

RTCD
adds or deletes a functional support console (FSC).

PRC
specifies a prime CRAS FSC.

RO
specifies a receive-only FSC.

TAPE
specifies a tape FSC.

DASD
specifies a DASD FSC.

AUDT
specifies an audit trail FSC.

COMM
specifies a communications FSC.

RDBS
specifies a real-time database services (RDBS) FSC, which is used by the TPF Application Requester (TPFAR) feature and the recoup utility.

number
specifies the number of an FSC from 1-16.

OPT
specifies optional processing.

VAL
validates the console LNIATA.

In a 1052 environment, a test message is sent to the alternate 1052 prime CRAS and its entry is validated in the line status table.

In a native console support (NCS) environment, line 00 (RO) or line 01 (PRC) is validated in the line status table. This is necessary to recover line 00 or line 01 after a hardware failure occurred on a console and that console automatically fell back to an alternate CRAS device, causing the console to be marked as not valid in the line status table. After the line is validated, you can specify the REP parameter to return the PRC or RO to line 010000 or 000000, respectively.

ADD
adds optional data for the specified CRAS.

DEL
deletes optional data for the specified CRAS.

PRT-Axx
assigns the printer in the specified CRAS slot to the CRT display device in the specified CRAS, where xx is the CRAS slot from 1-99.

REST-
authorizes the CRAS terminal to issue commands that are restricted to the specified FSC.

SUB-address
is a subchannel address that is used for the PRC or RO fallback device.

Additional Information

Examples

An alternate CRAS is assigned in the following example.

+--------------------------------------------------------------------------------+
|User:   ZACRS REP A01 510000 CPUID-B TYPE-PRT                                   |
|                                                                                |
|System: ACRS0000I 14.12.13 COMPLETED                                            |
+--------------------------------------------------------------------------------+

In the following example, an alternate CRT display device is assigned with the printer defined in the previous example.

+--------------------------------------------------------------------------------+
|User:   ZACRS REP A02 4E0000 CPUID-B TYPE-CRT PRT-A01                           |
|                                                                                |
|System: ACRS0000I 14.12.19 COMPLETED                                            |
+--------------------------------------------------------------------------------+

An RO device is replaced in the following example.

+--------------------------------------------------------------------------------+
|User:   ZACRS REP RO 510000 CPUID-B TYPE-PRT                                    |
|                                                                                |
|System: ACRS0000I 14.16.16 COMPLETED                                            |
+--------------------------------------------------------------------------------+

A PRC is replaced with a CRT display device in the following example.

+--------------------------------------------------------------------------------+
|User:   ZACRS REP PRC 4E0000 CPUID-B TYPE-PRT                                   |
|                                                                                |
|System: ACRS0000I 14.19.23 COMPLETED                                            |
+--------------------------------------------------------------------------------+

An alternate CRAS is assigned as a printer device on the emulator program (EP) processor B, and DASD-type messages are routed from processor C to that printer in the following example.

+--------------------------------------------------------------------------------+
|User:   ZACRS REP A01 510000 CPUID-B TYPE-PRT                                   |
|                                                                                |
|System: ACRS0000I 14.12.13 COMPLETED                                            |
|                                                                                |
|User:   ZACRS CHG A01 510000 CPUID-C TYPE-PRT RTCD-DASD OPT-ADD                 |
|                                                                                |
|System: ACRS0000I 14.22.11 COMPLETED                                            |
+--------------------------------------------------------------------------------+

A printer is assigned as a functional support console in the following example.

+--------------------------------------------------------------------------------+
|User:   ZACRS CHG A01 510000 CPUID-B TYPE-PRT RTCD-DASD OPT-ADD                 |
|                                                                                |
|System: ACRS0000I 14.22.11 COMPLETED                                            |
+--------------------------------------------------------------------------------+

A 3270 CRT display device is assigned as a functional support console in the following example.

+--------------------------------------------------------------------------------+
|User:   ZACRS CHG A02 4E0000 CPUID-B TYPE-CRT RTCD-DASD OPT-ADD                 |
|                                                                                |
|System: ACRS0000I 14.23.13 COMPLETED                                            |
+--------------------------------------------------------------------------------+

A 3270 CRT functional support console is deleted in the following example.

+--------------------------------------------------------------------------------+
|User:   ZACRS CHG A02 4E0000 CPUID-B TYPE-CRT RTCD-DASD OPT-DEL                 |
|                                                                                |
|System: ACRS0000I 14.24.10 COMPLETED                                            |
+--------------------------------------------------------------------------------+

A printer functional support console is deleted in the following example.

+--------------------------------------------------------------------------------+
|User:   ZACRS CHG A01 510000 CPUID-B TYPE-PRT RTCD-DASD OPT-DEL                 |
|                                                                                |
|System: ACRS0000I 14.24.46 COMPLETED                                            |
+--------------------------------------------------------------------------------+

A CRAS terminal is given authorization to input DASD commands in the following example.

+--------------------------------------------------------------------------------+
|User:   ZACRS CHG A02 4E0000 CPUID-B TYPE-CRT REST-DASD OPT-ADD                 |
|                                                                                |
|System: ACRS0000I 14.27.01 COMPLETED                                            |
+--------------------------------------------------------------------------------+

The CRAS terminal can no longer input DASD commands in the following example.

+--------------------------------------------------------------------------------+
|User:   ZACRS CHG A02 4E0000 CPUID-B TYPE-CRT REST-DASD OPT-DEL                 |
|                                                                                |
|System: ACRS0000I 14.27.39 COMPLETED                                            |
+--------------------------------------------------------------------------------+

An alternate 1052 PRC is validated in the following example.

+--------------------------------------------------------------------------------+
|User:   ZACRS FBK PRC 010000 CPUID-B TYPE-CON OPT-VAL                           |
|                                                                                |
|System: ACRS0027I 15.42.43 ALT 1052 VALIDATED                                   |
+--------------------------------------------------------------------------------+

A 1052 PRC is defined to fall back to the alternate 1052 PRC in the following example. Note that you must first validate the alternate 1052 PRC before you enter this command.

+---------------------------------------------------------------------------------------------+
|User:   ZACRS FBK PRC 010000 CPUID-B TYPE-CON                                                |
|                                                                                             |
|System: ACRS0045W 14.31.11 CONSOLE ALTERED, 1052 SUB CHANNEL 01F IS NOW THE PRIME CRAS.      |
+---------------------------------------------------------------------------------------------+

An entry is removed from the CRAS table in the following example.

+--------------------------------------------------------------------------------+
|User:   ZACRS DEL A01 510000 CPUID-B TYPE-PRT                                   |
|                                                                                |
|System: ACRS0000I 14.36.05 COMPLETED                                            |
+--------------------------------------------------------------------------------+

A 3270 native console is defined to fall back to the specified fallback console in the following example.

+--------------------------------------------------------------------------------+
|User:   ZACRS FBK PRC 010000 CPUID-B TYPE-CRT SUB-023 OPT-VAL                   |
|                                                                                |
|System: ACRS0045W 14.38.40 CONSOLE ALTERED - THIS IS NOW PRC                    |
+--------------------------------------------------------------------------------+

A 3270 native console is defined to fall back to any fallback alternate console in the following example.

+---------------------------------------------------------------------------------------------+
|User:   ZACRS FBK PRC 010000 CPUID-B TYPE-CRT                                                |
|                                                                                             |
|System: ACRS0045W 14.39.02 CONSOLE ALTERED, 3270 SUB CHANNEL 022 IS NOW THE PRIME CRAS.      |
+---------------------------------------------------------------------------------------------+

Related Information

See TPF Data Communications Services Reference for more information about CRAS support.