Update the ctg.ini configuration file

The ctg.ini file is an HFS file defined to the gateway by the CICSCLI= parameter in the environment file.

Update the ctg.ini file as follows:

  • Make sure that APPLID=xxxxxxx is specified in the PRODUCT section so that each CTG has an unique APPLID.

  • Add the name of the MainView for CICS Java exit by using the requestexits parameter in the GATEWAY section.

    The format is requestexits=MVCICSctgMonitor

  • Make sure the port number specified in UBBPARM member CMRBEXnn matches the port number specified in one of the following parameters:
    • statsport= parameter for CTG version 7.1 or later
    • port= parameter on the statistics API protocol handler definition (protocol@statsapi) for CTG version 7.2 or later (required if IPSTACK is specified in CMRBEXnn )

The following figure provides an example of the GATEWAY section in a ctg.ini file for CTG version 7.n.

Sample GATEWAY section in a ctg.ini file for CTG version 7.n

SECTION GATEWAY
   initconnect=1                                                    
   maxconnect=100                                                   
   initworker=1                                                     
   nonames=on                                                    
   statsport=22012                                               
   statint=030000                                                
   stateod=000000                                                
   protocol@tcp.handler=com.ibm.ctg.server.TCPHandler                
   protocol@tcp.parameters=port=22002;/                              
      connecttimeout=2000;/                     
      idletimeout=600000;/                      
      pingfrequency=60000                       
   workertimeout=10000                                               
   closetimeout=10000                                                
   log@info.dest=console                                            
   log@error.dest=console                                           
   requestexits=MVCICSctgMonitor                                      
ENDSECTION

The followinf figure provides an example of the GATEWAY section in a ctg.ini file for CTG version 8.n.

Sample GATEWAY section in a ctg.ini file for CTG version 8.n

SECTION GATEWAY
initconnect=1
maxconnect=100
initworker=1
protocol@statsapi.handler=com.ibm.ctg.server.RestrictedTCPHandler
protocol@statsapi.parameters=connecttimeout=2000;port=2980;bind=;maxconn=5;
statint=030000
stateod=000000
protocol@tcp.handler=com.ibm.ctg.server.TCPHandler
protocol@tcp.parameters=connecttimeout=2000;port=2006;idletimeout=600000;
pingfrequency=60000
workertimeout=10000
closetimeout=10000
log@info.dest=console
log@error.dest=console
requestexits=MVCICSctgMonitor
ENDSECTION

Additional information about setting up the CTG server can be found in the CICS Transaction Gateway: z/OS Administration manual.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*