Environment variables

This section explains about the environment variables.

The workload manager uses the following environment variables. On Multiplatforms, specify them as system level environment variables and re-boot the machine to ensure that the IBM CICS Transaction Gateway service picks them up. Unix/Linux users typically define environment variables through their CTGD service configuration, ctgd.conf.

  • CTG_HACONFIG - Location of the HA configuration file. Failure to set this variable will throw an exception that will cause the Gateway to fail to start. This must be set to the location of a file (HA configuration file).
  • CTG_HAINTERVAL - Retry interval in seconds used to retry requests to failed servers, defaults to 60 seconds.
  • CTG_HAAUTOSWAP - Auto swap interval in seconds used to swap back to the primary HA configuration file. If CTG_HAAUTOSWAP is zero, the autoswap function is disabled and defaults to 60 seconds.
  • CTG_HACOUNT - Maximum request count when retrying failed requests. It defaults to the length of the longest server alias rule in the HA configuration file. The minimum value is 1.
  • CTG_HAVALIDATION: The validation style is "INCLUSIVE" (default) or "EXCLUSIVE."In INCLUSIVE mode, validation rules define those requests that will be processed. In EXCLUSIVE mode, validation rules define those requests that will be rejected.