Versions Compared

Key

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

...

Note
This product currently requires you to be running CICS TS 4.2 or later.   Contact our support center if you want to run HTAC using a release of CICS prior to 4.2.


Note

In any of the data set names that are shown as having a qualifier of HTAC.V1xx, the xx should be replaced with the current HTAC sub-release level (currently 20).


Note

If you are planning to use HTAC with CTG, you will need either CICS TS 5.2 or later, or CICS TS 5.1 with APAR PM78624 applied.

...

  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.V120V1xx.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.V120V1xx.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.V120V1xx.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.V120V1xx.SOURCE') and press the Enter key - the PDS will be created. 

...

Note

If you are upgrading from a version of HTAC prior to 1.14, please take note that there have been a number of program name changes in release 1.14 and subsequent releases.  Therefore, you should do a complete replacement of your existing RDO definitions. 

  1. Edit the job HTAC.V120V1xx.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.V120V1xx.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.

...

Note

If you are running version 5.5 or later of CICS TS, the PLT entries will be a member in a parameter library, and the (re)assembly will therefore be irrelevant.  

Add Names to TSQ Deletion Exclusion Tables 

There are a number of vendor software products that allow you to sweep the TSQs being used in (a) CICS region(s) and delete those TSQs that have not been updated and/or accessed for a given time period.   HTAC has a number of TSQs that must be excluded from this sweeping process in order for it to work properly.

The list of TSQs to exclude from the sweeping process is:   (asterisk at the end of the TSQ name indicates that all queues starting with the string before it should be excluded)

  • HBRQINTU*
  • HBRQLICN
  • HBRQLICR
  • HBRQMFST
  • HBRQSITP
  • HBRQSTAT
  • HBRQTA2E
  • HBZQANCH
  • HEMI____T*

Update Your Target CICS Startup JCL and System Initialization Table (SIT) and Recycle CICS

  1. In your CICS startup deck, include the library HTAC.V120V1xx.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.V120V1xx.PARMLIB,DISP=SHR; this PARMLIB will provide HTAC with access to your license key and 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; optional)
    • MN=ON
    • MNPER=ON
    • MNFREQ=nnnnnn (optional), where nnnnnn is a number of minutes between creating an SMF 110 performance record for a long-running transaction; for example, MNFREQ=001500 is fifteen minutes.  This parameter should be specified if you are running socket listener transactions on the region(s) where HTAC is installed.
    • MNSYNC=ON (optional; to be used if you wish to create an SMF 110 performance record whenever a syncpoint is taken)
    • 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.

...