ctgservice command reference

You can use the ctgservice command on Windows to specify options to override Gateway daemon parameter values specified in the configuration file.

The ctgservice command sets the Gateway daemon override parameters to be used when the IBM CICS Transaction Gateway service is started; it does not start the service. The parameters are validated when the service is started and not when they are set using the ctgservice command. The ctgservice command uses the JVM specified by the ctgjava command.

The syntax of ctgservice is as follows:
ctgservice -?|-T|-R [-ACTGParam1 [-ACTGParam2] [-A-jArgument]...]
where:
-R
Registers the options to be used when starting the Gateway daemon parameter overrides. Setting ctgservice -R with no following parameters removes all overrides. To add startup parameters for the Gateway daemon, use the -R parameter together with the -A parameter.
-A<override>
Specifies a startup override for the Gateway daemon or an argument for the Gateway daemon JVM. This parameter is used together with the -R parameter.
-T
Displays the options that are registered, Gateway daemon parameter overrides.
-?
Displays the command syntax and the list of options that can be used with the -R parameter.
For example:
ctgservice -R -A-x -A-tfile=C:\temp\ctgtrace.txt -A-j-Dgateway.T.setJNITFile=C:\temp\ctgJNItrace.txt

The following Gateway daemon overrides are available to be set using the -R option

Option Description
-port=number Specifies the TCP/IP port number on which the Gateway daemon will listen.
-sslport=number Specifies the TCP/IP port number on which the Gateway daemon will listen for SSL requests.
-keyring=file Specifies the SSL key ring path and file name.
-keyringpw=password Specifies the SSL key ring password. An error message is generated if the keyringpw parameter is used on its own without the corresponding keyring parameter in the ctgstartctgservice- command line.
-adminport=number Specifies the port used to communicate with the Gateway daemon when controlling the Gateway daemon through the ctgadminctgservice command.
-statsport=number Specifies the TCP/IP port number on which the Gateway daemon will listen for statistics API requests.
-initconnect=number Specifies an initial number of connection manager threads. See Tuning the Gateway for performance information.
-maxconnect=number Specifies a maximum number of connection manager threads. If you set this value to -1, no limits are applied to the number of connection manager threads. See Tuning the Gateway for performance information.
-initworker=number Specifies an initial number of worker threads. See Tuning the Gateway for performance information.
-maxworker=number Specifies a maximum number of worker threads. If you set this value to -1, no limits are applied to the number of connection manager threads. See Tuning the Gateway for performance information.
-trace Enables standard tracing (see Tracing). By default, the trace output shows only the first 128 bytes of any data blocks (for example the COMMAREA, or network flows). Other useful information, including the value of the CLASSPATH variable, and the code page, is shown at the top of the trace output.

Trace output is written to stderr, unless you use the -tfile option, or have used the Configuration Tool to define a default trace destination. No trace is written if the Gateway daemon does not have permission to write to the specified file. Each time the Gateway daemon is started with trace enabled, the trace file is overwritten with the new trace.

-quiet Disables the reading of input from the console and disables writing to stdout.
-dnsnames Enables the display of symbolic TCP/IP host names in messages. See Display TCP/IP hostnames for more information.
-tfile=pathname If tracing is enabled, trace output is written to the file specified in pathname. This option overrides the default destination for trace output (see the -trace option).
-x Enables full debug tracing (see Tracing). By default, the trace output shows the whole of any data blocks (for example the COMMAREA, or network flows). It also displays more information about the internal Gateway daemon processing than the standard trace. See the -trace and -tfile options for information on the destination for trace output.

Debug tracing significantly decreases performance.

-tfilesize=number Specifies the maximum size, in kilobytes, of the trace output file.
-truncationsize=number The value number specifies the maximum size of any data blocks that are shown in the trace. You can use this option with either the -trace or -x options to override the default size. Any positive integer is valid. If you specify a value of 0, no data blocks are shown in the trace.
-dumpoffset=number The value number specifies the offset from which displays of any data blocks start. If the offset is greater than the total length of data to be displayed, an offset of 0 is used.
-stack Enables Java™ exception stack tracing (see Tracing). Java exceptions are traced, including those expected during typical operation. Expected exceptions include:
  • An IOException resulting from a Java client application ending or disconnecting from a network protocol.
  • An InterruptedException resulting from a CICS® Transaction Gateway protocol handler timeout such as the idle timeout, or a ping timeout.
No other trace output is created. See the -trace and -tfile options for information on the destination for trace output.
-j Passes an argument to the JVM. For example, -j-D<name>=<value> sets a JVM system property. See the JVM command line interpreter help for guidance in using this option. This option replaces the -X option used in earlier versions of the CICS Transaction Gateway. You can pass multiple arguments to the JVM. Specify the -j option multiple times to pass multiple arguments to the JVM.
-classpath=class path Specifies additional entries to append to JVM class path that are used when launching the JVM. For example, the location of a jar file containing request exits.
-requestExits=exits List of classes to be used for request exit monitoring.

Information Information

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tg_latest/help/topic/com.ibm.cics.tg.doc//ctgunx/ctgservicecmdref.html