[an error occurred while processing this directive]
> developer > web app development
Performance Issues Related to CICS RPC Components
by exteNd Composer Product Team, eBusiness Integration Products, Novell
Date Created: 2001-05-31 08:51:00.000
  Introduction
introduction

When using the CICS Transaction Gateway with xCommerce you want to be sure to tune the gateway for the applications you will be using.  Doing this requires knowledge of how many simultaneous users are expected to be using the xCommerce service.  With this knowledge there are two gateway parameters, which can be set to help tune the connections.  The parameters are: init workers and init connections.  Init workers represents the Initialized number of worker threads.  Init connections represents the Initialized number of connections.  These two parameters can be set as command line parameters on startup of the gateway or in the ctg.ini file for the 3.1.x version of the gateway or in the gateway.properties file for the 3.0 version of the gateway.

As mentioned above, knowledge of the workload for the application is needed to set these parameters appropriately.  For example, if you are expecting 50 concurrent users for the application then you would set both init workers and init connections to 50.  The examples below l demonstrate how to set the parameters via a command line and in the ini files.

To set them as command line parameters use the switches  -initconnect=50 -initworker=50 on startup of the gateway.

For version 3.1.x of the gateway the initconnect and initworker parameters are set in the ctg.ini file.  Below is a sample of the SECTION GATEWAY from the ctg.ini file.  The init lines are highlighted.

SECTION GATEWAY

    closetimeout=20000

    ecigenericreplies=on

    initconnect=50

    initworker=50

    maxconnect=100

    maxworker=100

    noinput=off

    nonames=off

    notime=off

    tfile=ctg.trc

    workertimeout=20000

    protocol@tcp.handler=com.ibm.ctg.server.TCPHandler    
   protocol@tcp.parameters=connecttimeout=5000;idletimeout=600000;pingfrequency=60000;port=2006;solinger=0;sotimeout=1000;

ENDSECTION

For version 3.0 of the gateway the initconnect and initworker are set in the Gateway.properties file.  Below is a sample of the Gateway.properties file showing the init lines.  It is recommended that you upgrade to the version 3.1 since IBM is dropping support for version 3.0.

# Initial number of ConnectionManager threads
# initconnect=50


# Maximum number of ConnectionManager threads
# maxconnect=100

# Initial number of Worker threads
# initworker=50


# Maximum number of Worker threads
# maxworker=100