CICS Transaction Gateway V5 The WebSphere ... - IBM Redbooks

148 CICS Transaction Gateway V5
BPXBATCH is the MVS program that runs a UNIX System Services script as a
batch job. The PARM field specifies that the shell (SH) is to execute the specified
ctgstart command with the -noinput option.
We directed the STDOUT and STDERR files to a location different from the base
CICS TG software. This allowed us to manage the logs in a different directory,
and in this case, an entirely different HFS data set.
The STDENV DD points to a PDS member. You can administer the parameters
from TSO, which is easier for CICS systems programmers. The concatenation
sequence for ctgstart, ctgenvvar, and STDENV DD are noted in 7.2.2, “Defining
CICS TG configuration parameters” on page 153.
PATHOPTS on the HFS file specification is similar to the JCL DISP parameter,
and PATHMODE determines UNIX file permissions for the file.
7.2.1 Defining CICS TG environmental variables
Environment variables passed from BPXBATCH to the Gateway daemon can be
set in one of the following three ways:
► Within the JCL using a partitioned data set (PDS) referenced by the STDENV
DD card.
► Using the ctgenvvar HFS file.
► Within the shell environment of the started task user ID.
The UNIX search order for environment variables used by BPXBATCH is as
follows:
1. Variables found in the /usr/lpp/ctg500/ctg/bin/ctgenvvar file take precedence.
2. Variables are next taken from the UNIX System Services shell environment
(BPXBATCH) in which ctgstart runs. The order of precedence is as follows:
a. Variables taken from the .profile of the started task user ID
b. Variables taken from the default user profile /etc/profile
c. Variables taken from STDENV member passed to BPXBATCH
This is summarized in Figure 7-5.