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 port.

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
  [0] : 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 JavaGateway

In the CICS job log you will see this message:

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.789

where 00000006 is the name of the IPCONN automatically generated by the autoinstall template.

If you issue the command CEMT INQ IPCONN, the output is as follows:

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)

The example shows two active IPCONN connections autoinstalled from different Gateway daemons. Note that the IPCONN autoinstall template remains INS REL.

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