Things to consider when using CTBATCH to launch USS programs
through the MVS batch environment include the location of message
logs and the national language for messages.
Start CTGBATCH using a JCL step in the following format:
//CTGBATCH EXEC PGM=CTGBATCH,
PARM='<LE runtime options><fully qualified HFS path to target
executable><parameters>'
where:
- <LE runtime options>
- Is a free-form string of Language Environment® options,
terminated by a slash (/) character. At the very least, the slash
(/) must be included to indicate an empty set of options.
- <fully qualified HFS path to target executable>
- Explicitly represents the target program. For example,
'/usr/lpp/cicstg/ctg700/bin/ctgstart'
- <parameters>
- Is the parameter string to be supplied to the target program.
For example,
'-noinput -x'
Note: There must be a space between the target executable and the <parameters>
string.
Therefore, a JCL step using CTGBATCH to invoke the ctgstart script
is as follows:
//CTGBATCH EXEC PGM=CTGBATCH,
// PARM='//usr/lpp/cicstg/ctg700/bin/ctgstart -noinput'
An important difference between CTGBATCH and BPXBATCH is that the Language Environment options
override was not part of the BPXBATCH PARM string syntax. If a BPXBATCH
PARM string is used, unchanged, with CTGBATCH, everything preceding
and including the first slash (/) character is processed as Language Environment options,
and the rest as CTGBATCH parameters. The likely result is message
"CTG0828E CTGBATCH The target executable 'target-program' does not
exist".
Note: - The PARM parameter in the JCL EXEC PGM= statement is limited to
a string value of 100 characters (this applies to BPXBATCH aswell).
See Environment variables: remote mode for details on using
the CTGSTART_OPTS environment variable to circumvent this limitation
with ctgstart parameters.
- When CTGBATCH is used to start the CICS® Transaction Gateway for z/OS® daemon
via the ctgstart script, the '-noinput' switch must be specified to
enable the TSO-SDSF systems management function
CTGBATCH accepts the following DD statements:
- STDOUT
- STDERR
- STDENV
- CTGDBG
and one of the following national language support DD statements:
- CTGMSGEN
- CTGMSGJA
- CTGMSGZH