Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The following article will instruct you how to install version 1.11 13 of the Transaction Analytics Connector (HTAC) for use with the Splunk server and collector.

...

  1. Download the HTAC installation package by saving the following attachment to your PC: htac_v111v113.zip
  2. Unzip the installation package to a directory on your desktop.
  3. Transfer the unzipped files to the host using FTP as follows:

...

File Name On Desktop

File Name on Host (or create your own names)

Transfer Type

Record Format (RECFM)

Record Length (LRECL)

Block Size (BLKSIZE)

Space Needed (in tracks) 

htac_v111v113_jcl.xmtHTAC.XMITJCLbinaryFB80010
htac_v111v113_library.xmtHTAC.XMITLOADbinaryFB800300
htac_v111v113_parmlib.xmtHTAC.XMITPARMbinaryFB8005
htac_v111v113_source.xmtHTAC.XMITSOURbinaryFB8005

...

  1. From the TSO option 6 panel, issue the following command:  TSO RECEIVE INDSNAME('HTAC.XMITJCL') and press the Enter key.
  2. When prompted for restore options, enter DSNAME('HTAC.V111V113.JCL') and press the Enter key - the PDS will be created.
  3. From the TSO option 6 panel, issue the following command:  TSO RECEIVE INDSNAME('HTAC.XMITLOAD') and press the Enter key.
  4. When prompted for restore options, enter DSNAME('HTAC.V111V113.LIBRARY') and press the Enter key - the library will be created.
  5. From the TSO option 6 panel, issue the following command:  TSO RECEIVE INDSNAME('HTAC.XMITPARM') and press the Enter key.
  6. When prompted for restore options, enter DSNAME('HTAC.V111V113.PARMLIB') and press the Enter key - the PDS will be created.
  7. From the TSO option 6 panel, issue the following command:  TSO RECEIVE INDSNAME('HTAC.XMITSOUR') and press the Enter key.
  8. When prompted for restore options, enter DSNAME('HTAC.V111V113.SOURCE') and press the Enter key - the PDS will be created. 

...

Note

You will need approximately 320 tracks of space for the three PDS's and one library created above.  You do not have to preallocate pre-allocate the space: the RECEIVE command will do it for you.

...

Perform RDO Updates For Your Target CICS

  1. Edit the job HTAC.V111V113.JCL(RDOHTAC), changing the JOB card and RDO definitions to conform to your installation standards (see the comments in the DFHCSDUP control cards).
  2. Submit the job; a return code of zero indicates a successful execution.  If you receive a return code of other than zero, contact our support center.

...

  1. Obtain a license key from HostBridge Technology; it will be supplied to you via email.
  2. Create a member in HTAC.V111V113.PARMLIB named HBR@LICN and insert the license key into it (there should be only one line in the member which contains the license key, starting in column 1).
  3. Save the member.

...

  1. In your CICS startup deck, include the library HTAC.V111V113.LIBRARY in your DFHRPL concatenation.  

    Note

    If you already have HostBridge installed, the library should be included after the existing reference to the HostBridge library in the DFHRPL concatenation.

  2. In your CICS startup deck, include a DD statement as follows: //HBPARMS  DD   DSN=HTAC.V111V113.PARMLIB,DISP=SHR; this PARMLIB will provide HTAC with access to your license key and initiallization initialization member.. 
  3. In your CICS startup deck, include a DD statement as follows: //HBSTART  DD  SYSOUT=*; this will allow for the display of HTAC trace entries if required.
  4. In your SIT, ensure that you are running CICS monitoring.  Sample entries are: 
    • MCT=xx (where xx is the suffix for the assembled monitoring control table)
    • MN=ON
    • MNPER=ON
    • MNRES=ON (optional; you can use the default of OFF) 
  5. In your SIT, ensure that you are pointing to a PLT initialization module that contains a reference to module HBOPINIT (PLTPI=xx).
  6. In your SIT, ensure that you are pointing to a PLT shutdown module that contains a reference to module HBOPTERM (PLTSD=xx).
  7. Recycle your target CICS.

...