Installing MVS Components

After uploading and receiving the installation file, you can start your installation.

1. Make the CLIST temporary file.
   Change the #JOBNAME, #USERHLQ, #USERVOL statement variables according to your site requirements.
   Member: SXN$1MKT
2. Execute the File Tailoring CLIST for the installation JCL.
   If you make an error during input, press the attention key (PA1) and execute the File Tailoring CLIST again, starting at Step 1.
   Member: SXN$2EX1 (EX member)

   File Tailoring Variables for Installation JCL

   Variable	Default and Structure
   USERHLQ	TIBCO.SXN.VxRxMx
   VOLSER Volume Serial	TIB999
   JOBNAME	SXNPI The first six characters are used.

3. Upload the installation files to z/OS MVS.
   Member: For DFSMSdss sites, use SXN$3FT.

                    For non-DFSMSdss site, use SXN$3FT@.

4. Define and allocate the plug-in product libraries.
   Perform this step during initial installation only.
   Member: SXN$4ALL
5. Convert the product installation files to the appropriate datasets.
   You can restart the installation multiple times in this step, if required.
   Member: For DFSMSdss sites, use SXN$5RC.

                    For non-DFSMSdss site, use SXN$5RC@.

   The following table defines the user substitution variables within the JCL and the parameter members that are required during the file-tailoring process. Ensure that you have all the necessary information before performing Step 6.

   File-tailoring Variables

   Variable	Default and Structure	Your Value
   IBM Assembler Libraries HLQ	ASM *.SASMMAC2
   COBOL for MVS Libraries HLQ	IGY *.SIGYCOMP
   CICS TS HLQ	CICSTS31.CICS
   HLQ of CICS CSD file	CICSTS31.REGION
   CICS generic APPLID	DBDCCICS

6. Execute the File Tailoring CLIST to update the product-supplied variables.
   If you make an error during input, press the attention key (PA1) and perform the CLIST again.
   Member: SXN$6EX2 (EX member)
7. Populate the plug-in datasets with all the updated and downloaded members.
   Member: SXN$7UPD

   Note: You have now completed the activities in the USERHLQ.INSTALL dataset. All further steps reference the dataset that is specified in the step.
8. Update CICS with the CICS Resource Definitions.
   This member updates the CICS System Definition (CSD) file with the Resource definitions necessary for the plug-in to operate and Resource definitions for IBM's CICS TCP/IP Socket interface.

   It includes all the CSD definitions for the IBM CICS Socket Listener. Group TCPGROUP is created and updated and added to List TIBLIST.

   Dataset: USERHLQ.JCL

   Member: SXNCSDUP

9. Optional: Assemble and link the plug-in CICS PLT entries.
   The plug-in uses the suffixes XD and XI for its program list table (PLT) entries. If your CICS Region already uses these suffixes, change the suffixes in the DFHPLTXD and DFHPLTXI members in the USERHLQ.ASM dataset before performing the assembly.

   To view the current suffixes in the CICS Region, run either of these two commands:

   CEMT I PROG CLASS(XD)

   CEMT I PROG CLASS(XI)

   Dataset: USERHLQ.JCL

   Member: SXNASMLK

10. Define and populate CICS TCP/IP Socket File.
    This member defines and populates the plug-in configuration VSAM file for CICS TCP Sockets support.

    The default is NO security. Two optional security modes can be enabled by modifying USERHLQ.JCL(SXNEZADF).

    To add simple user ID and password based security, un-comment the line:

    *** SECEXIT=SXNSECUR, Security exit for Listener program
    and editing the previous line by adding a comma after
    MINMSGL=4 and a "X" in column 72

    To enable run-time security to be IDENTIY, un-comment the preceding line and set SECEXIT=SXNSECID.

    Dataset: USERHLQ.JCL

    Member: SXNEZADF

11. Update the CICS region startup procedure.
    The USERHLQ.LOAD library installed as part of the plug-in must be concatenated in the DFHRPL DDName of your CICS startup procedure(s).

    The new group list members TIBLIST and TCPLIST must be included in the GRPLIST of CICS System Initialization Parameter.

    If Step 9 is performed, add the following Startup and Shutdown PLT parameters to the CICS SIP member: PLTPI=XI and PLTSD=XD.

12. Optional: Enable the IBM CICS TCP/IP Socket Interface.
    If you do not use the Auto Startup in Step 9, you can manually start IBM CICS Sockets from a blank CICS 3270 screen by running the following command: EZAO,START,CICS.

    A formatted 3270 screen displays the message: CICS Sockets Interface Startup Complete.