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 similar to this:  

HBOXSTRT CWBG  T0000049 HostBridge CICS Transaction Analytics Connector (HTAC) - v1.13
HBOXSTRT CWBG  T0000049 A member of the zBridge family of software products.          
HBOXSTRT CWBG  T0000049 COMPILED 01/06/21 at 17.13                                    
HBOXSTRT CWBG  T0000049 Current parameters:                                           
HBOXSTRT CWBG  T0000049 TRACE=0                                                       
HBOXSTRT CWBG  T0000049 STATS=1                                                       
HBOXSTRT CWBG  T0000049 EVLOG=1                                                       
HBOXSTRT CWBG  T0000049 OHEADER=N                                                     
HBOXSTRT CWBG  T0000049 TERMAID=Y                                                     
HBOXSTRT CWBG  T0000049 VENDOR=HBR                                                    
HBOXSTRT CWBG  T0000049 MOBILE=N                                                      
HBOXSTRT CWBG  T0000049 XHBPARMS=Y                                                    
HBOXSTRT CWBG  T0000049 XOPTS=(1:N,2:N,3:N,4:N)                                       
HBOXSTRT CWBG  T0000049 AUXTRFLG=N                                                    
HBOXSTRT CWBG  T0000049 AUXTRNUM=199                                                  
HBOEMIVI 0490  T0000051 EMITTER  RETRY SUPPORT STARTING                               
HBOEMIVI 0490  T0000051 EMITTER  ROLE=PRIMARY,MODE=SERVER,METHOD=TCP                  
HBOEMIVI 0490  T0000051 SHRM64   STARTING                                             
HBOEMIVI 0490  T0000051 SHRM64   Creating shared memory segment (1GB)                 
HBOEMIVI 0490  T0000051 SHRM64   Creating AVAIL queue                                 
HBOEMIVI 0490  T0000051 SHRM64   Generating 10000 entries on AVAIL queue                                                 

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 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…