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