Environment variables available for use with remote mode topologies.
Specifies whether or not all processes involved in starting the Gateway daemon run in a single address space. Set this variable to YES to specify that all processes involved in starting the Gateway daemon run in a single address space. Set this variable to NO to allow multiple address spaces.
You must set _BPX_SHAREAS=YES when xasupport=on is set.
The default value is YES.
Specifies the location of the CICS® Transaction Gateway configuration to be used at startup. The value must be one of the following:
/u/userid/myconfig.ini
CICSCLI=//'HLQ.QUAL.PDS(MEMBER)'
Use the double forward slash symbol // to denote that the configuration is held in an MVS data set, not a file. A sample configuration on MVS is provided in data set member CTGCONF, in the CTGSAMP data set which is installed as part of the product.
The maximum field length is 100 characters.
The CICS Transaction Gateway startup messages indicate the location of the configuration file. CICS Transaction Gateway does not start if a configuration cannot be found.
Specifies the maximum width of the STDENV output from the ctgconvenv script. If the variable is not set, the width is set to 80 columns. The minimum width is 40 columns. The maximum possible width is 160 columns.
This variable requires a numeric entry.
CICS Transaction Gateway allocates an amount of additional storage on startup equivalent to 200 times the value of CTG_XA_MAX_TRAN KB. For example, if the value of CTG_XA_MAX_TRAN is 1024, CICS Transaction Gateway allocates approximately 200 KB of additional storage on startup. This storage is also used during start to process heuristically completed units of recovery from the Gateway and any others in the same HA Group. For more information, see Highly available Gateway group and Cold start. Set the value of CTG_XA_MAX_TRAN to the default, 1000, or a value greater than the number of configured connection managers, which ever is the larger.
If CTGENVVAR is not defined, the ctgstart script looks for the ctgenvvar script in the product bin directory (for compatibility with previous versions). If no script is found in either location, ctgstart still attempts to initialize the Gateway daemon, on the assumption that the required environment variables are already in place.
Use this environment variable when starting the Gateway daemon from the USS shell, rather than through CTGBATCH.
CTGSTART_OPTS=-j-Dgateway.T=on
TZ=standardHH[:MM[:SS]] [daylight[HH[:MM[:SS:]]]
[,startdate[/starttime],enddate[/endtime]]]
An example
for the United Kingdom is TZ=GMT0BST,M3.5.0,M10.4.0.
An example for United States Eastern Standard time is TZ=EST5EDTFor further information on time zones, see z/OS® UNIX System Services Command Reference.
//CTG EXEC PGM=CTGBATCH,
// PARM=('ENVAR("RESOLVER_CONFIG=//'SYS1.TCPPARMS(TCPIP1LB)'")',
// '&LEOPTS.&CTGHOME./bin/ctgstart -noinput ')
//STEPLIB DD DSN=&CTGHLQ..SCTGLOAD,DISP=SHR
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//STDENV DD DSN=&CTGUSR.,DISP=SHR
//* Define CTGDBG DD DUMMY to enable CTGBATCH debug mode
//CTGDBG DD DUMMY
.
.
.
The following shows the RESOLVER_CONFIG variable set to pick up the TCPIP.DATA information from a file /etc/resolv.conf_new in the HFS:
//CTG EXEC PGM=CTGBATCH,
// PARM=('ENVAR("RESOLVER_CONFIG=/etc/resolv.conf_new")',
// '&LEOPTS.&CTGHOME./bin/ctgstart -noinput ')
//STEPLIB DD DSN=&CTGHLQ..SCTGLOAD,DISP=SHR
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//STDENV DD DSN=&CTGUSR.,DISP=SHR
//* Define CTGDBG DD DUMMY to enable CTGBATCH debug mode
//CTGDBG DD DUMMY
.
.
.