Skip to end of metadata
Go to start of metadata

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 like this:  

HBOMGRVI B488  T0000040 HostBridge CICS Transaction Analytics Connector (HTAC) - v1.8
HBOMGRVI B488  T0000040 A member of the zBridge family of software products.
HBOMGRVI B488  T0000040 Environment initialization beginning
HBOMGRVI B488  T0000040 CICS Monitoring Status:
HBOMGRVI B488  T0000040   Status( ON )
HBOMGRVI B488  T0000040   Perfclass( PERF )
HBOMGRVI B488  T0000040   Exceptclass( EXCEPT )
HBOMGRVI B488  T0000040   Resrceclass( RESRCE )
HBOMGRVI B488  T0000040   Idntyclass( NOIDNTY )
HBOMGRVI B488  T0000040   Conversest( CONVERSE )
HBOMGRVI B488  T0000040   Syncpointst( NOSYNCPOINT )
HBOMGRVI B488  T0000040   Compressst( COMPRESS )
HBOMGRVI B488  T0000040   Dpllimit( 0 )
HBOMGRVI B488  T0000040   Filelimit( 8 )
HBOMGRVI B488  T0000040   Tsqueuelimit( 8 )
HBOMGRVI B488  T0000040   Frequency( 000000 )
HBOMGRVI B488  T0000040   Applnamest( NOAPPLNAME )
HBOMGRVI B488  T0000040   Rmist( RMI )
HBOMGRVI B488  T0000040   Time( GMT )
HBOMGRVI B488  T0000040 CICS monitoring is active
HBOMGRVI B488  T0000040 CICS performance class monitoring is active
HBOMGRVI B488  T0000040 Loading parameters from parmlib member HBO@INIT
HBOMGRVI B488  T0000040 CONFIG   DOCTEMPLATE for global parms included (HBO@INIT)
HBOMGRVI B488  T0000040 Evaluating HBR license key(s)
HBOMGRVI B488  T0000040 HBR license key accepted
HBOMGRVI B488  T0000040 Program HBOANN55 has been loaded and published: LP=25340700,EP=A5340700
HBOMGRVI B488  T0000040 Program HBODIF55 has been loaded and published: LP=245FDC00,EP=A45FDC00
HBOMGRVI B488  T0000040 Environment initialization complete
HBOMGRVI B488  T0000040 Current parameters:
HBOMGRVI B488  T0000040 ...General...
…

(more messages)

…
HBOMGRVI B488  T0000040 Performing ENABLE function (ENABLE=Y specified)
HBOMGRVI B488  T0000040 Extractor exit is DISABLED
HBOMGRVI B488  T0000040 Extractor exit being ENABLED
HBOMGRVI B488  T0000040 Extractor exit is ENABLED and STOPPED
HBOMGRVI B488  T0000040 Extractor exit parameters are set
HBOMGRVI B488  T0000040 Extractor exit being STARTED
HBOMGRVI B488  T0000040 Extractor exit is ENABLED and STARTED

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 emit a JSON document for a supplied test transaction.  This can be done as follows:

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,EPRNT=Y

HBNL

HTAC SET,EPRNT=N

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

HBOEMIVI B488  T0002647 JSON_DOC (LEN=2547):                                                             
HBOEMIVI B488  T0002647 {"time":1590505102.826191,"MFSOURCETYPE":"SMF110","SUBTYPE":"1","SUBSYSTEM":"CIC 
HBOEMIVI B488  T0002647 S","CLASS":"3","VERSION":"0720","generated_by":"HBOFSI55:04/28/20 09.11","DATETI 
HBOEMIVI B488  T0002647 ME":"2020-05-26 08:58:22.83 -0600","JOBNAME":"CICSA","JOBDATE":"2020-05-25","JOB 
HBOEMIVI B488  T0002647 TIME":"12:01:06.72","GAPPLID":"CICSA","SAPPLID":"CICSA","TSLEVEL":"050500","DURA 
HBOEMIVI B488  T0002647 TION":0.003035,"TRAN":"HBNL","TERM":"0021","USERID":"CICSA","TTYPE":"TO","START"       <------ 1
HBOEMIVI B488  T0002647 :"2020-05-26 08:58:22.823156","STOP":"2020-05-26 08:58:22.826191","TRANNUM":"000 
HBOEMIVI B488  T0002647 2648","TRANPRI":1,"TCLSNAME":"","LUNAME":"TCP00021","PGMNAME":"HBR$NOOP","NETUOW 
HBOEMIVI B488  T0002647 PX":"NETD.TCP00021","NETUOWSX":"F9E9C6770E580001","RSYSID":"","PERRECNT":1,"RMUO 
HBOEMIVI B488  T0002647 WID":"D7F9E9C6770E5880","SRVCLSNM":"SRVHIM","RPTCLSNM":"","FCTYNAME":"0021","TRA 
HBOEMIVI B488  T0002647 NFLAG":"0100000000000000100000000000000000000010100000000000000000000000","TERMI 
HBOEMIVI B488  T0002647 NFO":16777617,"TERMINFO_NATURE":"TERMINAL","TERMINFO_ACCMETH":"VTAM","TERMINFO_D 
HBOEMIVI B488  T0002647 EVTYPE":"91","TERMCNNM":"","BRDGTRAN":"","RRMSURID":"","CLIPADDR":"10.0.25.2","T 
HBOEMIVI B488  T0002647 RNGRPID":"160DD5C5E3C44BE3C3D7F0F0F0F2F1D7F9E9C6770F73C00000000000","NETID":"NET 
HBOEMIVI B488  T0002647 D","RLUNAME":"TCP00021","TCPSRVCE":"","OTSTID":"","CLIPPORT":58213,"ISIPICNM":"" 
HBOEMIVI B488  T0002647 ,"ONETWKID":"NETD","OAPPLID":"CICSA","OSTART":"2020-05-26 08:58:22.823156","OTRA 
HBOEMIVI B488  T0002647 NNUM":"0002648","OTRAN":"HBNL","OUSERID":"CICSA","OUSERCOR":"","OTCPSVCE":"","OC 
HBOEMIVI B488  T0002647 LIPADR":"10.0.25.2","OCLIPORT":58213,"OTRANFLG":"0100000000000000100000000000000 
HBOEMIVI B488  T0002647 000000010100000000000000000000000","OMOBILE":false,"OFCTYNME":"0021","WBURIMNM": 
HBOEMIVI B488  T0002647 "","WBPIPLNM":"","WBATMSNM":"","WBSVCENM":"","WBSVOPNM":"","NJSAPPNM":"","WBPROG 
HBOEMIVI B488  T0002647 NM":"","PHNTWKID":"","PHAPPLID":"","PHSTART":"0000-00-00 00:00:00.000000","PHTRA 
HBOEMIVI B488  T0002647 NNO":"0000000","PHTRAN":"","PHCOUNT":0,"OADID":"","OADATA1":"","OADATA2":"AID=EN       <------ 2 
HBOEMIVI B488  T0002647 TER","OADATA3":"","CECMCHTP":"1090","CECMDLID":"306","LPARID":"IBMSYS2","MAXTASK 
HBOEMIVI B488  T0002647 S":250,"CURTASKS":4,"PTSTART":"0000-00-00 00:00:00.000000","PTTRANNO":"0000000", 
HBOEMIVI B488  T0002647 "PTTRAN":"","PTCOUNT":0,"TASKFLAG":"00000000000000000000000000000000","ABCODEO": 
HBOEMIVI B488  T0002647 "","ABCODEC":"","RTYPE":"T","TCMSGIN1":1,"TCCHRIN1":4,"SC31UGCT":3,"SC31UHWM":11 
HBOEMIVI B488  T0002647 744,"SC31UOCC":8724,"PCSTGHWM":1520,"PC31AHWM":1520,"PC31RHWM":1520,"PCLINKCT":1 
HBOEMIVI B488  T0002647 ,"SPSYNCCT":1,"EICTOTCT":2,"SOCONMSG":"","USRDISPT_MICROSEC":2780,"USRDISPT_COUN 
HBOEMIVI B488  T0002647 T":1,"USRCPUT_MICROSEC":1932,"USRCPUT_COUNT":1,"CPUTONCP_MICROSEC":1932,"CPUTONC 
HBOEMIVI B488  T0002647 P_COUNT":1,"OFFLCPUT_MICROSEC":0,"OFFLCPUT_COUNT":1,"SUSPTIME_MICROSEC":254,"SUS 
HBOEMIVI B488  T0002647 PTIME_COUNT":1,"QRDISPT_MICROSEC":2780,"QRDISPT_COUNT":1,"QRCPUT_MICROSEC":1932, 
HBOEMIVI B488  T0002647 "QRCPUT_COUNT":1,"DSPDELAY_MICROSEC":254,"DSPDELAY_COUNT":1,"RMITIME_MICROSEC":4 
HBOEMIVI B488  T0002647 57,"RMITIME_COUNT":1,"SYNCTIME_MICROSEC":1495,"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, spanning 2 lines).  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 HBOXSTRT and HBOANNxx like the following:

HBOXSTRT HTAC  T0000104 ENTRY    TCB,008FC578,A=31,PROB:80,SKEY=80(23303D30),PKEY=00,TKEY=80,AUTH=0,MSK=****,XM=0
HBOXSTRT HTAC  T0000104 GWA      PTR=233B4B00,LEN=256
HBOXSTRT HTAC  T0000104 LWA      PTR=00000000,LEN=0
HBOXSTRT HTAC  T0000104 TASK     START,TRANID=HTAC,TASKNO=0000104,STARTCD=TO,TERMID=0016,PROGRAM=HBOMGRVI
HBOXSTRT HTAC  T0000104 TASK     CONTEXT,FACILITYTYPE=234(TERM),FACILITY=0016,BRIDGE=
HBOXSTRT HTAC  T0000104 TASK     CONTEXT,NATURE=TERMINAL,ACCESSMETHOD=SNA/VTAM
HBOXSTRT HTAC  T0000104 TASK     CONTEXT,AID=ENTER
HBOXSTRT HTAC  T0000104 IEANTRT  CALL,LEVEL=2,NAME=HTAC____HBOANNXX
HBOXSTRT HTAC  T0000104 IEANTRT  OUTPUT,TOKEN=C8C2D6C1,D5D5F5F5,25340700,A5340700
HBOXSTRT 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
HBOXSTRT HTAC  T0000104 HBOANN55 RETURN,RC=0
HBOXSTRT 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.   



  • No labels
Write a comment…