•
•
•
• Debug mode — with a regular expression (regexp) describing the functions to debug, for example -d "m_FileLoad" to debug the m_FileLoad function.Log directory if the environment variable MT_LOG is defined, else the log is redirected to TMP directory (without TuxJes).Sysout directory if the environment variable MT_SYSOUT is defined, else the sysout files are redirected to LOG directory and subsequently to TMP directory (without TuxJes).Job name — the name of the script to be launched without the .ksh extension.
Table 3‑2 EJR Return Code No present of JOBID on command line No present of JES2ROOT on command line Access right problem A COBOL runtime, runb, is provided to initialize the execution context of a user COBOL program before the call for its execution. This runtime is used instead of the standard COBOL runtime.
• Initialization: If a COBOL program is executed (m_ProgramExec) using the -b option, the runtime command, runb, connects it to the database according to the MT_DB_LOGIN environment variable . It must have the correct value (user name, password and Oracle instance, at least "/"). It can be used in the TuxJES Security Configuration file and specified when submitting jobs or set as an environment variable. If the configuration file is not specified, the environment variable MT_DB_LOGIN value is used.
• Termination: Depending on the program return code, the Batch Runtime executes a COMMIT (MT_RC_JOB = 0) or a ROLLBACK (MT_RC_JOB != 0), then disconnects from the database.Using the -t argument, it is possible to run the KSH script without executing the internal functions. The -t argument allows a script to be checked (for example a newly-developed script) and verify the chaining of the different phases.
• where name is the name of an executable file and option is a string of one of the following two types: noargletter . . . or argletter optarg [, . . .]
Table 3‑3 Batch Runtime Functions Where <step> is any of the previous steps. If the previous step was not executed, the condition is false. When <step> refers to a previous step, replace it with the step label, e.g. "STEPEC01". When <step> refers to a return code of the step in the procedure, replace it with "STEP_PROCNAME_NUM", where "PROCNAME" indicates the name of procedure, and "NUM" indicates the sequence number of the procedure calls.RC indicates a return code.STEP.RC indicates that the expression tests a return code for a specific STEP.Operator indicates the operator used for the conditional expression (GT, LT, EQ etc.).STEP.RUN indicates that a specific job step started execution or not.ABEND indicates an abend condition occurred.ABENDCC indicates a system or user completion code.
Note: m_DirCreate [-v volume] DirNameWith -b RC0, whether encountering errors or not, all SQL will be executed and then all successful SQL will be committed in the end; however, without -b RC0, if any error is encountered, SQL will rollback when terminating.m_FileAssign assigns a file. If assigning a file triggers the creation of a file, the creation process precedes the assign itself.
• New files (DISP=NEW parameter).
• Override files (file override in the JCL); a specific assign function m_FileOverride is used. This function call is implanted in each STEP required, before the execution of the program.
• In the case where a file assign contains a DISP=NEW,DELETE,DELETE parameter, a delete process is added to the end (normal and abnormal) of the step.
•
• For the DISP=MOD option, the write to the file is made in a temporary intermediary file, then by a copy in Extend on the original file.
• In one step, if a DDNAME is defined more than one time by m_FileAssign, only the first one takes effect. The disposition specified for the former DSNAME is also discarded.
This option indicates what to do with a data set when a step ends normally. The possible values are:
Note: If "all" is specified, all generation files for the corresponding GDG, including all new added GDS, are concatenated to one temporary file, and this temporary file is assigned to DD specified for m_FileAssign. For example, if "all" is specified and <normal-termination-disp> or <abnormal-termination-disp> is specified to DELETE, all generation files are deleted from the corresponding GDG in the end of the current step.
•
• m_FileClrData is used to clear a file. GDG file is not supported.m_FileDelete is used to delete a file.m_FileEmpty is used to check whether a file is empty.m_FileExist is used to check whether a file is present.m_FileListcat -- query the catalog according input.m_FileLoad [-C] [-S] [-v volume] Infile [Infile ...] OutfileIndicates the Outfile volume. This option only works when file catalog is enabled in Batch Runtime.m_FileOverride overrides a file assignment, this assign has priority over a standard assign (m_FileAssign).Only “-s” and one of the two options “-i” and “-d” are mandatory to specify the usage. All other options are optional. See m_FileAssign for other options.m_FileRename is used to rename a file.Indicates the new file volume. This option only works when file catalog is enabled in Batch Runtime.This function defines the GDG file. The execution result depends on the GDG management way defined in MT_GENERATION variable.If -r is specified and the GDG to be defined already exists, only the maximum number of generation files of the GDG is updated with the value specified by -s.The name of the GDG base for which the maximum number of generations is being defined. The maximum length of GDG base name is 1024.m_JobBegin -j jobname [-C cond] [-c class] [-p priority] [-r restart] [-t typrun] -v version -s start_label
•
•
•
• -p priority-r restart-t typrunCOPY – Copy the job directly in an output stream to sysout.HOLD – The system should hold the job.JCLHOLD – JES2 should hold the job.SCAN – Scan JCL for syntax errors only.-v version-s start_labelm_OutputAssign — manages DD SYSOUT statements with the following parameters: CLASS, COPIES, DEST, FORMS and HOLD.At the end of the m_ProgramExec function, submits the contents to TuxJes (hopefully a script shell).-H<Y/N>m_OutputOverride — Overrides an output file.Only “-S” is mandatory, which specifies the step where the assignment is overridden. All other options are optional. See m_OutputAssign for other options.m_OutputSet — manages the "OUTPUT JCL" statement with the following parameters: CLASS, COPIES, DEFAULT, DEST, FORMS, PRIORITY and WRITER.m_Pkzip [-f][-F] -a [-k][-n][-g][-d]m_Pkunzip [-f][-F] -a [-k][-n][-g][-d][-o][-w]Directory (enclosed by single quotes) where files(s) to unzip are to be stored (${DATA} by default).m_ProcBegin ProcedureNameThis option is used to launch EXCI BATCH program. It informs the Batch Runtime to use runbexci but not runb.
• MT_EXCI is set to an non-empty string if EXCI interface exists and needs to use it, otherwise MT_EXCI is empty by default (needs Oracle Tuxedo).In the last case, MT_EXCI must be set to ART KIX objects folder and MT_JESDECRYPT must be set to jesdecrypt object file (for example, /path/to/jesdecrypt.dynamic.linux64.o)To use XA, MT_EXCI_XA must be set with the name of the resource manager for XA and MT_EXCIGRPNAME must be set with the TUXEDO SRVGRP value of ARTDPL server.If MT_EXCI is set to an non-empty string and MT_EXCI_XA and MT_EXCIGRPNAME are set to empty, you will connect to database without using XA.During installation phase MT_EXCI is checked to know if the specific Runtime for EXCI should be linked.During execution phase only MT_EXCIGRPNAME is checked.
Note: When m_ProgramExec invokes nonexistent programs, JOB will continue if those programs are specified in MT_UTILITY_LIST_UNSUPPORT.Another way to use runbexci instead of runb is to configure the program in MT_EXCI_PGM_LIST. By doing this, whether or not -n is set, the program is invoked only by runbexci.For more information about MT_UTILITY_LIST_UNSUPPORT and MT_EXCI_PGM_LIST, please refer to the table of "Oracle Tuxedo Application Runtime for Batch Environment Variables (Optional)" in Using Batch Runtime.PARM=MT5 on z/OS becomes "MT5" on targetPARM=(MT5,MT6) on z/OS becomes "MT5,MT6" on targetPARM='S=MT5' on z/OS becomes "S=MT5" on targetPARM='5 O''CLOCK' becomes "5 O'CLOCK"'&&TEMP' becomes "&TEMP"m_SendMail — Sends an email.m_Smtp — Sends an email using SMTP protocol.m_SymbolDefault — Assigns a value to a symbol.This API is optional; once it is used, it should immediately follow m_JobBegin.If this API is not called in a job, the job will be randomly executed on any server group; on the other hand, if this API is called in job, the job will be executed on the specified server group. If the specified server group does not exist or no ARTJESINITIATOR in that server group is started, the job will be in the waiting queue until the ARTJESINITIATOR in that server group is started.If SvrGrpName is not specified or "" is specified, although no errors are reported, the job will be randomly executed on any server group.The JES server group name. The ARTJESINITIATOR deployed in this server group executes the current job.The job can be submitted on any JES node, but only be executed by the ARTJESINITIATOR which belongs to JES's Tuxedo server group ATLANTA.