Installing the Software

You can use the members that are located in the <USERHLQ>.INSTALL data set to install the CICS components for the TIBCO EMS Client for z/OS (CICS).

Edit the selected members indicated in the following steps, substitute the variables, follow any instructions contained in the member, and then submit the JCL for execution.

Prerequisites

This software supports only DFSMSdss sites.

Procedure

  1. Make CLIST temporary file
    Change the #JOBNAME, #USERHLQ, #USERVOL statement variables according to your sites requirements.

    Member: S7M$1MKT

    The following table defines the user substitution variables for the installation JCL.

    File Tailoring Variables for Installation JCL
    Variable Default and Structure User Value
    USERHLQ TIBCO.S7M.VxRxMx
    VOLSER Volume Serial TIB999
    JOBNAME S7MEMS

    First 6 characters

  2. Execute file tailoring CLIST for installation JCL
    If an error is made during input, press the attention key (PA1) and execute starting at Step 1 again.

    Member: S7M$2EX1 (EX member)

  3. Upload the TIBCO EMS Client for z/OS (CICS) installation files to your host
    Use FTP to upload the files to your host.

    Member: S7M$3FT

  4. Define and allocate the TIBCO EMS Client for z/OS (CICS) product libraries
    Only to be performed on initial installation

    Member: S7M$4ALL

  5. Convert the TIBCO EMS Client for z/OS (CICS) installation files to DFSMS dump format
    Member: S7M$5RC
    The following table defines the user substitution variables within JCL and parameter members that are required during the file tailoring process. Ensure that you have all the necessary information before executing Step 6.
    File Tailoring Variables
    Variable Default and Structure User Value
    IBM Assembler Libraries HLQ ASM

    *.SASMMAC2

    COBOL for MVS Libraries HLQ IGY

    *.SIGYCOMP

    TIBCO EMS Server Location hostname: 7222
    CICSHLQ

    CICS System Libraries HLQ

    		CICSTS51.CICS

    *.CICS.SDFHLOAD

    CCSDHLQ

    CICS DFHCSD HLQ

    		CICSTS51.REGION

    *.DFHCSD

  6. Execute file tailoring CLIST to update the product supplied variables
    Note: If an error is made during input, press the attention key (PA1), correct and execute the CLIST again.

    Member: S7M$6EX2 (EX member)

  7. Populate the TIBCO EMS Client for z/OS (CICS) product data sets with all the updates
    Member: S7M$7UPD

    After completing this step, you have finished using the INSTALL library. Most of the subsequent steps are located within the <USERHLQ>.JCL library.

  8. CICS: Update CICS interface resource definitions
    This member updates the CICS System Definition (CSD) file with the Resource definitions necessary for TIBCO EMS Client for z/OS (CICS) to operate.

    Data Set: <USERHLQ>.JCL

    Member: S7MTSCSD

  9. CICS: Update startup procedure
    The <USERHLQ>.AUTH library that is installed as part of TIBCO EMS Client for z/OS (CICS) must be concatenated in the STEPLIB DDNAME of your CICS startup procedures.

    Data Set: <Your CICS startup procedure data set>

    Member: <Your CICS startup procedure>

  10. CICS: Setup startup and shutdown PLTs
    Data Set: <USERHLQ>.ASM

    Member: DFHPLTXI and DFHPLTXD

    See PLTs Setup for more details.
  11. CICS: Setup error program exit
    CICS programs that use the TIBCO EMS Client for z/OS (CICS) must use the DFHPEP exit to analyze CICS transaction abends and to provide recovery of the CICS transaction. If you are already using DFHPEP, you must merge DFHPEP of TIBCO with your code. If you are not using DFHPEP (or using the IBM default), compile the TIBCO DFHPEP (C program) into a loadlib concatenated in the CICS DFHRPL.

    Submit the JCL S7M3JCPL to assemble the DFHPEP program. The load module is put into the load library. Make sure this is the first DSN in the DFHRPL, or replace DFHPEP in the DFHRPL concatenation list so this version of DFHPEP is used by CICS.

    Data Set: <USERHLQ>.C

    Member: DFHPEP

  12. CICS: Setup default CEET parameters
    Review the default parameters for starting the CEET.
    • HOSTPAGE
    • NETWORK
    • MAXCONN
    • MAXWORK
    • TRACE
    • URL
    • USERID
    • PASSWORD

    For details, see S7MACURT.

    The CICS program sets up the CEET startup default parameters. Submit the JCL S7MASMLK to assemble the S7MACURT program in <USERHLQ>.ASM. The load module is put into the load library.

    Data Set: <USERHLQ>.JCL

    Member: S7MASMLK

  13. Add DD JCL to CICS JCL for CEET Log 
    //TIBUOS7M DD SYSOUT=*

    If you specify a CEEOPTS parameter then specify a matching DD name for the CEET log. For details, see Optional CEEOPTS Definitions.