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.