![]() |
![]() |
![]() |
![]() |
![]() |
•
•
•
• Debug mode — with a regular expression (regexp) describing the functions to debug, for example -d "m_FileLoad" to debug the m_FileLoad function.The name of the script to be launched without the .ksh extension.
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 [, . . .]
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 --nb_occurs <GDG base name>The name of the GDG base for which the maximum number of generations is being defined.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 ProcedureNamePARM=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.