Options on the ctgstart command

To override the startup defaults, from the command line enter ctgstart at the command line, followed by the required startup options.

Option Purpose
-applid The Gateway daemon applid.
-applidqualifier The Gateway daemon applid qualifier.
-classpath=classpath Additional classpath entries to use when launching the JVM. For example, the location of a jar file containing request exits.
-dnsnames Displays symbolic TCP/IP host names in messages.
-dumpoffset=offset The offset from which displays of any data blocks start. If the specified offset is greater than the total length of data, the data is dumped as if the offset were 0.
-initconnect=number The initial number of connection manager threads.
-initworker=number The initial number of worker threads.
-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 switch.
-keyring=keyring The SSL key ring path and file name.
-keyringpw=keyringpw The SSL key ring password. For example:
ctgstart -sslport=port_number -keyring=keyring -keyringpw=keyringpw
An error message is generated if the keyringpw parameter is used on its own without the corresponding keyring parameter in the ctgstart - command line.
-maxconnect=number The maximum number of connection manager threads. If this value is set to -1, no limits are applied to the number of connection manager threads.
-maxworker=number The maximum number of worker threads. If this value is set to -1, no limit is applied to the number of worker threads.
-noinput Disables the reading of input from the console. If this option is selected you cannot stop the Gateway by input to the console session. See Stopping the CICS Transaction Gateway.
-port=port_number The TCP/IP port number assigned to the CICS Transaction Gateway
-stack Enables exception stack tracing but no other type of tracing. All checked Java™ exceptions are traced, including exceptions that are expected during typical operation of the CICS Transaction Gateway.
-start=cold Ensures that CICS® Transaction Gateway issues a call to RRS to forget each unit of recovery associated with the Gateway daemon which is in 'in-forget' state in RRS. If you specify this value, the forget calls are completed before any requests are processed by the Gateway daemon. If this option is not specified, the default CICS Transaction Gateway startup logic is used and the forget calls are not issued to RRS. For more information see Cold start.
-statsport=port_number The TCP/IP port on which the Gateway daemon listens for statistics API requests.
-sslport=port_number The TCP/IP port on which the Gateway daemon listens for SSL requests.
-trace The standard trace option . If this option is selected the first 80 bytes of the COMMAREA are traced by default. For more information see Tracing.

Trace output is written to stderr.

-truncationsize=nnn The maximum size of any data blocks shown in the trace, where nnn is any positive integer. You can use this option in addition to either -trace or -x to override the default size set by these options. For example, to switch on standard tracing and dump a maximum of 20,000 bytes:
ctgstart -trace -truncationsize=20000
If you specify a value of 0, no data blocks are shown in the trace.
-tfile=pathname Writes trace messages to the file specified in pathname if tracing is enabled. This option overrides the default destination for trace output (see the -trace option).
-tfilesize=number The maximum size of the trace text file in KB.
-x Enables full debug tracing. Full debug tracing includes everything traced by the -trace option, with additional information including information about the internal workings of the CICS Transaction Gateway. This option traces the entire COMMAREA by default.

This option significantly decreases performance.


Information Information

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tgzos_latest/help/topic/com.ibm.cics.tg.zos.doc//ctgzos/dfhtlab.html