CTGBATCH considerations

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:
  1. 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.
  2. 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: and one of the following national language support DD statements:

Information Information

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tgzos_latest/help/topic/com.ibm.cics.tg.zos.doc//ctgzos/logingb.html