Testing your scenario
To test that your scenario is configured correctly, start the CICS® Transaction Gateway and use the CICS TG Java™ sample EciB2 to call CICS server program EC01.
- To test your scenario using a valid user ID and password, issue
the following command from a command prompt on the machine on which CICS TG is running. In this example
command, the Gateway daemon TCP handler is listening on the default
java com.ibm.ctg.samples.eci.EciB2 jgate=localhost server=CICSA prog0=EC01 commarealength=18 userid=USERID password=PASSWORD ebcdic
The ebcdic option is not required if you have set up a definition for EC01 in the DFHCNV data conversion macro on CICS.
The output from the command is as follows:
CICS Transaction Gateway Basic ECI Sample 2 Test Parameters CICS TG address : localhost:2006 Client security : null Server security : null CICS Server : CICSA UserId : USERID Password : PASSWORD Data Conversion : ASCII Commarea : null Commarea length : 18 Number of programs given : 1  : EC01 Connect to Gateway Successfully created JavaGateway CICS servers defined: System : CICSA Call Programs About to call : EC01 Commarea : Extend_Mode : 0 Luw_Token : 0 Commarea : 22/05/09 10:05:18 Return code : ECI_NO_ERROR(0) Abend code : null Successfully closed JavaGatewayIn the CICS job log you will see this message:
where 00000006 is the name of the IPCONN automatically generated by the autoinstall template.
DFHIS3000 ... IPCONN 00000006 with applid .00000006 autoinstalled successfully using autoinstall user program DFHISCIP and template (SECTEMPL) after a connection request was received on tcpipservice 50889 from host 1.23.456.789If you issue the command CEMT INQ IPCONN, the output is as follows:
The example shows two active IPCONN connections autoinstalled from different Gateway daemons. Note that the IPCONN autoinstall template remains INS REL.
CEMT INQ IPCONN STATUS: RESULTS - OVERTYPE TO MODIFY Ipc(SECTEMPL) App(SECTEMPL) Net(GBIBMIYA) Ins Rel Nos Rece(100) Sen(000) Tcp(SRV50889) Ipc(00000001) App(00000001) Ins Acq Nos Rece(100) Sen(000) Tcp(SRV50889) Ipc(00000006) App(00000006) Ins Acq Nos Rece(100) Sen(000) Tcp(SRV50889)
- If you test your scenario using an incorrect user ID and password combination, you receive an ECI_ERR_SECURITY_ERROR RC=27 message. In the CICS job log, the following message is displayed:
DFHIS1027 ... Security violation has been detected using IPCONN 0000006 and transaction id CPMI by userid CICSUSER