•
•
•
• 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.).ABEND indicates an abend condition occurred.ABENDCC indicates a system or user completion code.
Note: 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.
This option indicates what to do with a data set when a step ends normally. The possible values are:m_FileBuild [-t][-r][-k][-K] [-S]<filename> dsnamem_FileClrData is used to clear a file.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_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.m_GenCommit commits a generation file. During the job execution, all created generations stay temporarily until the end of the job in which these generations are committed. This function permits an explicit commit of temporary generations before the job ends.m_GenDefine -s [-r] --nb_occurs <GDG base name>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_GenRollback [GDG base name]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.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.