CTGBATCH considerations

Things to consider when using CTGBATCH 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 zFS 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 zFS path to target executable>
Explicitly represents the target program. For example, 
'/usr/lpp/cicstg/ctg910/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/ctg910/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:
  1. The PARM parameter in the JCL EXEC PGM= statement is limited to a string value of 100 characters (this also applies to BPXBATCH). See Environment variables: remote mode for details on using the CTGSTART_OPTS environment variable to circumvent this limitation with ctgstart parameters.
  2. When CTGBATCH is used to start the CICS® Transaction Gateway for IBM® 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