# Customizing RED Interface

To install the RED components in CICS for Substation ES, you have to customize the RED interface by editing the data sets and selected members listed in the following steps. Also, you must select to use the correct version of the CICS load library that was included with your Substation ES installation.

## Procedure

1. Update CICS with the RED Interface resource definitions.
   This member updates the CICS System Definition (CSD) file with the resource definitions necessary for Substation ES to operate. This JCL includes:
   - Definitions for Substation ES RED components
   - Definitions for the 3270 Bridge facility

   If you are updating definitions for the 3270 Bridge facility, update DSNAME (TIBCO.DFHBRNSF) in `USERHLQ.CNTL`(CSD3270A) and `USERHLQ.CNTL` (CSD3270U) to match your site,.

   To execute SHOW,RED,"XTUV" and other commands for the console or WebUI, install the 3270 Bridge.

   Data Set: `USERHLQ.JCL`

   Member: `SXXCSDUP`

2. Optional: Update the RED Interface SIP member.
   The file-tailoring process has updated the Substation ES Interface SIP member for RED. If you are not sure whether the correct CICS generic APPLID has been supplied, edit and correct the member accordingly.

   Data Set: `USERHLQ.PARM`

   Member: `SXCIRED1`

3. Update the RED interface directives in the SIP member.
   1. Modify the RED Group member name and HUB name that Substation ES is going to communicate with.
   2. Update the admin member name that will be used by RED Interface to process administration activities in the CICS region.
   Data Set: `USERHLQ.PARM`

   Member: `SXCIRED1`

4. Activate RED Interface.
   Activate the interface by uncommenting the `INTF-MEMBER` keyword in the SIP member.
   Data Set: `USERHLQ.PARM`

   Member: `SXSSIP$1`

5. Assemble and link the Substation ES CICS RED PLT entries.
   Substation ES uses the suffixes RD and RI for its program list table (PLT) entries. If your CICS region already uses these suffixes, change the suffixes in the `DFHPLTRD` and `DFHPLTRI` members in the `USERHLQ.ASM` data set before executing the assembly.
   To view the current suffixes in the CICS region, type either of these two commands:
   - CEMT I PROG CLASS(RD)
   - CEMT I PROG CLASS(RI)

   Before executing the assembly, comment out the appropriate statements for CICS PLT if it is not in use:

   Data Set: `USERHLQ.JCL`

   Member: `SXXASMLK`

6. Update the Substation ES startup.
   - Add the `CICSHLQ.SDFHEXCI` and `REDHLQ.AUTH` libraries to the Substation ES `STEPLIB` concatenation.
   - Remove the comment for the `CICSHLQ SET` statement. Ensure that the `CICSHLQ.SDFHEXCI` library is also APF-authorized because it is part of the `STEPLIB` concatenation.
   - Remove the comment for the `REDHLQ SET` statement. Ensure that the RED installed product `REDHLQ.AUTH` library is also APF-authorized because it is part of the `STEPLIB` concatenation.

     Data Set: `USERHLQ.JCL`

     Member: `TIBSSES`

7. Optional.Set up requirements for the 3270 Bridge facility.

   To use Substation ES to communicate with the 3270 Bridge facility, ensure that the CICS GRPLIST definition includes either:

   - All three groups: DFHBR, DFHTERM, DFHTYPE
   - One group: DFHLIST.

   For example, GRPLIST=(DFHLIST,TIBLIST) or GRPLIST=(DFHBR, DFHTERM, DFHTYPE, TIBLIST).

   Note:

   It is assumed that you have a working installation of the IBM 3270 Bridge facility. If not, ensure that the following IBM CICS groups are installed in all CICS regions using the 3270 Bridge facility:

   - DFHTYPE
   - DFHTERM
   - DFHBR
   Substation ES provides a definition of the DFHBRNSF file. For more details, see Step 1. If the installation needs another configuration, you must review the following IBM CICS groups, which describes the other ways of implementing the DFHBRNSF file:
   - DFHBRCF
   - DFHBRUT
   - DFHBRVR
   - DFHBRVSL
   - DFHBRVSR
   Note:

   If the CICS 3270 Bridge facility is not installed and set up, the Substation ES Console Command feature does not work correctly. For example, if the setup is correct and you run the SHOW,RED,"XTUV" command through the Substation admin interface, the Substation RED CICS information is sent back.

Copyright © TIBCO Software Inc. All rights reserved.