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.