Transaction Analytics Connector Installation Verification Procedure (IVP)

Basic Installation Verification Procedure 

From a cleared CICS screen, type in the transaction HTAC and press the Enter key.  You should see a screen similar to this:

This will give you a list of all valid HTAC commands.

When you press the Enter key, the following will be displayed:

Now, type in the following HTAC command:

HTAC HELP,STAR

Press the Enter key, and you should see:


When you type in HTAC HELP, followed by a command name, you will display a description of how the command works.

Pressing the Enter key again will take you back to the prior screen:

Now we will display the current HTAC status and parameter settings by issuing the following command:

HTAC DISP


Press the Enter key.  The following (or similar) will be displayed:


Continuing to press the enter key will keep displaying the HTAC parameter settings until they are all displayed, and then redisplay the HTAC DISP command on the screen. 

If at any time you receive a response other than the one indicated in the example output above, check the syntax of the commands that you entered and try again.  If the problem persists, you should contact our support center.

You can stop here if you wish, or perform one or both of the additional installation procedures that follow.

Additional Installation Verification Procedures

When you start a region that can execute HTAC, HTAC will write messages to the HBSTART log to indicate its status.  They will look similar to this:  

HBOMGRVI CWBG  T0000049 HostBridge CICS Transaction Analytics Connector (HTAC) - v1.14
HBOMGRVI CWBG  T0000049 A member of the zBridge family of software products.          
........                                    
HBOMGRVI CWBG  T0000049 Current parameters:                                           
HBOMGRVI CWBG  T0000049 TRACE=0                                                       
HBOMGRVI CWBG  T0000049 STATS=1                                                       
HBOMGRVI CWBG  T0000049 EVLOG=1                                                       
HBOMGRVI CWBG  T0000049 OHEADER=N 
HBOMGRVI CWBG  T0000049 VENDOR=HBR                                                    
HBOMGRVI CWBG  T0000049 MOBILE=N                                                      
HBOMGRVI CWBG  T0000049 XHBPARMS=Y                                                    
HBOMGRVI CWBG  T0000049 XOPTS=(1:N,2:N,3:N,4:N)                                       
HBOMGRVI CWBG  T0000049 AUXTRFLG=N                                                    
HBOMGRVI CWBG  T0000049 AUXTRNUM=199 

Assuming that there are no errors indicated in the log, you can logon to CICS and use the HTAC transaction to control it.  For example, HTAC STATUS will display the status of HTAC in the region.  HTAC HELP will show you the list of options.

One way to check to see if HTAC is working is to turn on the printing of the JSON documents for a moment and check the log.  This can be done as follows:

Enter the following commands on a CICS cleared screen:

HTAC SET,EPRINT=Y

HBNL

HTAC SET,EPRINT=N

Then, go to the HBSTART and you should see an emitted JSON document that looks like this:

HBOEMIVI 0490  T0000051 JSON_DOC (LEN=2135):                                                            
HBOEMIVI 0490  T0000051 {"time":1610386684.520611,"MFSOURCETYPE":"SMF110","SUBTYPE":"1","SUBSYSTEM":"CIC
HBOEMIVI 0490  T0000051 S","CLASS":"3","VERSION":"0720","SYSID":"S0W1","generated_by":"HBOFSI55:01/06/21
HBOEMIVI 0490  T0000051  17.11","DATETIME":"2021-01-11 11:38:04.52 -0600","JOBNAME":"CICSE","JOBDATE":"2
HBOEMIVI 0490  T0000051 021-01-11","JOBTIME":"11:20:52.40","GAPPLID":"CICSE","SAPPLID":"CICSE","TSLEVEL"
HBOEMIVI 0490  T0000051 :"050500","DURATION":0.001428,"TRAN":"HBNL","TERM":"0014","USERID":"JOHN","TTYPE     <------ 1
HBOEMIVI 0490  T0000051 ":"TO","START":"2021-01-11 11:38:04.519183","STOP":"2021-01-11 11:38:04.520611",
HBOEMIVI 0490  T0000051 "TRANNUM":"0000070","TRANPRI":1,"LUNAME":"TCP00014","PGMNAME":"HBR$NOOP","NETUOW
HBOEMIVI 0490  T0000051 PX":"NETD.TCP00014","NETUOWSX":"1B3A704C40DE0001","PERRECNT":1,"RMUOWID":"D91B3A
HBOEMIVI 0490  T0000051 704C40DE00","SRVCLSNM":"SRVHIM","FCTYNAME":"0014","TRANFLAG":"4000800002800000",
HBOEMIVI 0490  T0000051 "TRANFLAG_OFACTYPE":"TERMINAL+SURROGATE","TRANFLAG_IDENT":"OTHER","TRANFLAG_OTYP
HBOEMIVI 0490  T0000051 E":"TERMINAL","TRANFLAG_ISORIGIN":1,"TERMINFO":"01000191","TERMINFO_NATURE":"TER
HBOEMIVI 0490  T0000051 MINAL","TERMINFO_ACCMETH":"VTAM","TERMINFO_DEVTYPE":"91","CLIPADDR":"10.0.10.54"
HBOEMIVI 0490  T0000051 ,"TRNGRPID":"160DD5C5E3C44BE3C3D7F0F0F0F1F4D91B3A704C41EF000000000000","NETID":"
HBOEMIVI 0490  T0000051 NETD","RLUNAME":"TCP00014","CLIPPORT":56349,"ONETWKID":"NETD","OAPPLID":"CICSE",
HBOEMIVI 0490  T0000051 "OSTART":"2021-01-11 11:38:04.519183","OTRANNUM":"0000070","OTRAN":"HBNL","OUSER
HBOEMIVI 0490  T0000051 ID":"JOHN","OUSERCOR":"","OCLIPADR":"10.0.10.54","OCLIPORT":56349,"OTRANFLG":"40
HBOEMIVI 0490  T0000051 00800002800000","OMOBILE":false,"OFCTYNME":"0014","PHCOUNT":0,"OADID":"","OADATA
HBOEMIVI 0490  T0000051 1":"","OADATA2":"AID=ENTER","OADATA3":"","CECMCHTP":"1090","CECMDLID":"306","LPA     <------ 2
HBOEMIVI 0490  T0000051 RID":"IBMSYS2","MAXTASKS":20,"CURTASKS":2,"PTCOUNT":0,"TASKFLAG":"00000000000000
HBOEMIVI 0490  T0000051 000000000000000000","RTYPE":"T","TCMSGIN1":1,"TCCHRIN1":25,"SC31UGCT":3,"SC31UHW
HBOEMIVI 0490  T0000051 M":11824,"SC31UOCC":4576,"PCSTGHWM":1520,"PC31AHWM":1520,"PC31RHWM":1520,"PCLINK
HBOEMIVI 0490  T0000051 CT":1,"SPSYNCCT":1,"EICTOTCT":3,"USRDISPT_MICROSEC":1359,"USRDISPT_COUNT":1,"USR
HBOEMIVI 0490  T0000051 CPUT_MICROSEC":1125,"USRCPUT_COUNT":1,"CPUTONCP_MICROSEC":1125,"CPUTONCP_COUNT":
HBOEMIVI 0490  T0000051 1,"OFFLCPUT_MICROSEC":0,"OFFLCPUT_COUNT":1,"SUSPTIME_MICROSEC":69,"SUSPTIME_COUN
HBOEMIVI 0490  T0000051 T":1,"QRDISPT_MICROSEC":1359,"QRDISPT_COUNT":1,"QRCPUT_MICROSEC":1125,"QRCPUT_CO
HBOEMIVI 0490  T0000051 UNT":1,"DSPDELAY_MICROSEC":69,"DSPDELAY_COUNT":1,"RMITIME_MICROSEC":273,"RMITIME
HBOEMIVI 0490  T0000051 _COUNT":1,"SYNCTIME_MICROSEC":525,"SYNCTIME_COUNT":1}                           

Look in the JSON document for the name/value pairs "TRAN":HBNL" (note 1 above) and "OADATA2":"AID=ENTER" (note 2 above).  If you see both of these pairs, the IVP is successful.

Another way to check to see if HTAC is working is to turn on tracing for a moment and check the log.  This can be done as follows:

Enter the following commands on a CICS cleared screen:

HTAC SET,TRACE=1

HTAC STATUS

HTAC SET,TRACE=0

What that does is turn tracing on, do something, and turn tracing off. 

Next, go to the HBSTART log and you should see messages from HBOXTASK and HBOANNxx like the following:

HBOXTASK HTAC  T0000104 ENTRY    TCB,008FC578,A=31,PROB:80,SKEY=80(23303D30),PKEY=00,TKEY=80,AUTH=0,MSK=****,XM=0
HBOXTASK HTAC  T0000104 GWA      PTR=233B4B00,LEN=256
HBOXTASK HTAC  T0000104 LWA      PTR=00000000,LEN=0
HBOXTASK HTAC  T0000104 TASK     START,TRANID=HTAC,TASKNO=0000104,STARTCD=TO,TERMID=0016,PROGRAM=HBOMGRVI
HBOXTASK HTAC  T0000104 TASK     CONTEXT,FACILITYTYPE=234(TERM),FACILITY=0016,BRIDGE=
HBOXTASK HTAC  T0000104 TASK     CONTEXT,NATURE=TERMINAL,ACCESSMETHOD=SNA/VTAM
HBOXTASK HTAC  T0000104 TASK     CONTEXT,AID=ENTER
HBOXTASK HTAC  T0000104 IEANTRT  CALL,LEVEL=2,NAME=HTAC____HBOANNXX
HBOXTASK HTAC  T0000104 IEANTRT  OUTPUT,TOKEN=C8C2D6C1,D5D5F5F5,25340700,A5340700
HBOXTASK HTAC  T0000104 HBOANN55 CALL,EP=A5340700
HBOANN55 HTAC  T0000104 ENTRY    TCB,008FC578,A=31,PROB:80,SKEY=80(23305268),PKEY=00,TKEY=80,AUTH=0,MSK=****,XM=0
HBOANN55 HTAC  T0000104 COMPILED ON 04/28/20 AT 09.13
HBOANN55 HTAC  T0000104 CICSKEYS OURS=80,USER=80,CICS=80
HBOANN55 HTAC  T0000104 ODR-ADATA2 OLD=(null)
HBOANN55 HTAC  T0000104 ODR-ADATA2 NEW=AID=ENTER               <------3 
HBOANN55 HTAC  T0000104 TMRADPD2 OLD=(null)
HBOANN55 HTAC  T0000104 TMRADPD2 NEW=AID=ENTER                 <------4 
HBOANN55 HTAC  T0000104 EXIT     RC=0
HBOXTASK HTAC  T0000104 HBOANN55 RETURN,RC=0
HBOXTASK HTAC  T0000104 EXIT                                                       

You should see a message near the end of the above block of code indicating that the AID was saved as CICS Origin Data (notes 3 and 4 above).  If you see theses messages, the IVP is successful.