Conversion Parameters

Determines the method of conversion for the ESP JOB_ANCESTOR_WAIT(ANY|LAST) on the APPL statement.

Valid values are C or I.

Default: I

For details, see 43. APPL WAIT, JOB_ANCESTOR_WAIT, POST_OLDEST, NOPOST_UNTIL_READY.

Name of the calendar that will be used in the Control-M job definitions for every job that was scheduled according to the CA ESP default calendar.

Default: SYSTEM

Parameter group: ESP FUNCTIONALITY SETTINGS

Indicates whether CA ESP comments (text beginning with '/*') are to be converted to Control-M DESC parameters or ignored.

• A (All) – Convert CA ESP comments and TAGs to DESC parameters.

• Y (Yes) – Convert CA ESP comment to DESC parameters

• T (Tag) – Convert CA ESP TAGs to DESC parameters

• N (No) – Ignore CA ESP comments

For more information, see 53. /* (Comments).

Default: Y

Parameter group: CONVERSION FUNCTIONALITY SETTINGS

Condition name connectors (2 characters): The first character specifies the connector between the table-name and jobname. The 2nd character specifies the connector between the "from" and "to" portion of the condition-name.

Valid character combinations consist of any 2 of the following characters in any order: -_:;

Default: -_

The format of the predecessor/successor IN/OUT condition names.

• S(hort): to-tablename-jobname

• L(ong): to-jobname_from-jobname

• V(erylong): to-tablename-jobname[.qual]_from[-tablename]-jobname[.qual]
  The from tablename is omitted when it is the same as the to-tablename.

• W (very long) – same as V, except that the from-tablename is never omitted.

If the resultant condition name exceeds 39 characters, the condition name is truncated to 36 characters, and a 3-character index number is appended to assure the uniqueness of the name.

Default: S

Name of the Control-M as defined in EM where distributed systems jobs are run.

The XML file generated for distributed systems jobs uses this value as its Control-M name.

Parameter group: CONTROL-M FUNCTIONALITY SETTINGS

Name of the Control-M as defined in EM where mainframe jobs are run.

The XML file generated for mainframe jobs uses this value as its Control-M name.

Parameter group: CONTROL-M FUNCTIONALITY SETTINGS

Specifies whether IN conditions are deleted from the IOA Conditions file at successful end-of-job.

Valid values are

• Y – OUT conditions are added for deleting IN conditions

• N – OUT conditions are not added for deleting IN conditions

Default: N

Parameter group: CONTROL-M FUNCTIONALITY SETTINGS

Determines the method of conversion for statements such as DELAYSUB or EARLYSUB that do not specify the NOW subparameter.

Valid values are 0-9.

Default: 0

For details, see 3. DELAYSUB, EARLYSUB, AT, RESUME.

Maximum number of members in a CA ESP JCL Library.

Default: 10000

Parameter group: CONVERSION SIZES SETTINGS

Determines which predecessor/successor jobs should be converted into ‘Maybe’ conditions. The values of this option are:

• C – append the ‘maybe’ prefix (see option MAYBEPF) only to conditions associated with jobs that have the CONDITIONAL attribute. Default.

• X – append the ‘maybe’ prefix to all cross-table conditions (and all jobs with the CONDITIONAL attribute).

• A – append the ‘maybe’ prefix to all conditions.

When Control-M/Restart is installed, whether to reschedule a job automatically following an unsuccessful job run.

• Y (Yes) – the default

• N (No)

Parameter group: CONTROL-M FUNCTIONALITY SETTINGS

Controls the DS Cyclic File Watcher process.

• Y - Both file watchers, event-based and file-trigger type, run in a cyclic manner. Cyclic jobs stop before New Day.

• E - Only event-based file watchers run in a cyclic manner. Cyclic jobs stop before New Day.

• N - Both file watchers, event-based and file-trigger type, run a single time and are not cyclic.

The two types of file watchers have the following behavior:

• For event-based (WOBTRIG-based) DS file dependency, where a folder is forced to handle the newly arrived file:

  • DSFWCYC=N – File Watcher single occurrence is detected. File watching stops just before New Day.

  • DSFWCYC=E or DSFWCYC=Y – MFT File Watcher job is cyclic, recycled every minute. File watching stops just before New Day, and then the file is moved and a new folder is triggered.

• For File Trigger job type, where a condition is added:

  • DSFWCYC=N or DSFWCYC=E – File Watcher single occurrence is detected. File watching stops just before New Day. A state condition is added when the file is detected.

  • DSFWCYC=Y – File Watcher job is cyclic, recycled every minute, and it stops watching just before New Day.

    • If the file is not found (return code = C0007), a state condition and an ONPGM line with an output condition to stop the cyclic job are added.

    • If the file is found (return code = C0000), an ONPGM line with two output conditions is added — one condition to remove the input condition for all connected jobs, and another condition to produce a new output condition to continue on the next day.

Whether to treat DUMMY mainframe jobs with long job names (greater than 8 characters) as distributed jobs.

• Y (Yes)

• N (No) – the default

Which of the held sysout clauses must be requeued. Specify (blank) if all held sysouts must be requeued.

Default: Blank

When TOCLS is (Blank), this parameter is ignored.

Parameter group: CONTROL-M FUNCTIONALITY SETTINGS

Determines how to display an unsupported IF block in the CTMESP01-03W warning message:

• A (All): All lines of the unsupported IF block are displayed in the message.

• F (First): Only the first line of the unsupported IF block is displayed.

Default: A

When Control-M/Restart is installed, whether to require manual confirmation for job restart.

• Y (Yes) – the default – Manual confirmation is required

• N (No)

Parameter group: CONTROL-M FUNCTIONALITY SETTINGS

Whether to ignore all scheduling criteria that follow the STARTING parameter in an Event SCHEDULE statement.

Valid values are Y or N.

Default: Y

Whether to ignore jobs with an EXTERNAL job attribute, either Y (yes) or N (no).

When set to Y, any job dependencies involving the EXTERNAL job will be established using the HOME job instead. Note that any job attributes or parameters contained in the EXTERNAL job will also be ignored, except for RELEASE statements.

In such a case, the RELEASE is promoted to the ‘home’ job (for how home jobs are determined , see 45. EXTERNAL, APPLID) and the RELEASE is processed as if it were coded there and the requisite IN/OUT statements are created accordingly.

Default: N

Whether to ignore job statements 'RUN REF jobname', either Y (yes) or N (no).

Do not specify a value of Y without consulting BMC Technical Support.

Default: N

Determines how to convert JCL members.

Valid values:

• Y – convert JCL members in the same library at the same place.

• N – copy JCL members before conversion to prefix.CNVJCLO library and the modified JCL member to prefix.CNVJCLN library.

Default: N

Parameter group: CONVERSION FUNCTIONALITY SETTINGS

Default character to convert '/' or '\' in distributed jobnames.

Default: _

Parameter group: CONVERSION FUNCTIONALITY SETTINGS

Determines how to convert JCL members.

Valid values:

• Y – Any JCL ESP utility steps (PGM=ESP) in the original JCL members are kept intact, followed by the equivalent Control-M CTMUTIL steps, and the converted member is saved into prefix.CNVJCL2N library.

  To use this value, ensure that JCLIPLCE is set to N.
  

• N – The conversion does not keep the JCL ESP utility steps.

Default: N

Parameter group: CONVERSION FUNCTIONALITY SETTINGS

Control-M Scheduling Table library name.

Default: CTM.ESP.SCHEDULE

Parameter group: CONTROL-M FUNCTIONALITY SETTINGS

Maximum number of lines in a JCL member.

Default: 5000

Parameter group: CONVERSION SIZES SETTINGS

Name of the local ESP subsystem name.

A warning message is issued when the value of a SYBSYS parameter specified in a converted JCL member is not equal to the LOCLESP name.

Default: ESPP

Parameter group: ESP FUNCTIONALITY SETTINGS

Maximum number of unique job names specified by the CA ESP DSTRIG parameter.

Default: 1000

Parameter group: CONVERSION SIZES SETTINGS

Maximum number of number of CA ESP applications or procedures.

Default: 5000

Parameter group: CONVERSION SIZES SETTINGS

Maximum number of reruns allowed for non-cyclic jobs when rerun is required (3 digits).

Default: 001

Parameter group: CONTROL-M FUNCTIONALITY SETTINGS

A prefix for condition names that is used to indicate Maybe job processing for CA ESP jobs. For the type of conditions to which this option applies, see Conversion option DOMAYBE (above). For further information, see item 20. AFTER, RELEASE, POSTREQ, PREREQ

Default: #

Parameter group: CONVERSION FUNCTIONALITY SETTINGS

Determines how conversion messages are produced.

Valid values:

• Y – All messages produced during the conversion run are analyzed and reformatted into an Excel Spreadsheet output report (CSV format).

  The report includes the following message components:

  • MSGID

  • Product name

  • Type

  • Severity

  • Step name

  • Header message

  • Tail message

  • Jobname connector

  • Member name connector

  • Dataset proc

  • Jobname

  • Folder name

  • JCL member name

  • JCL library name

  • Description

• N - The conversion writes the messages to a standard SYSOUT file.

Default: N

Parameter group: CONVERSION FUNCTIONALITY SETTINGS

A REXX exec to use in the DO TSO action of the Control-O rule or CMEM rule, to perform the CTMAPI ORDER process.

Values include:

• Blank – Use DO FORCEJOB. Default

• CTMORD – Sample REXX in the CLIST library, to use in DO TSO

Process Non-Instream Batch ESP Utility SYSIN Data indicator.

Whether to convert ESP Batch commands that are not contained in-stream in the SYSIN DD statement of a Batch ESP Step (that is, are pointed to by a sequential file or a member of a PDS).

Valid values:

• Y (Yes) – Convert the commands.

• N (No) – Do not convert the commands. Default

For sites where references to Batch ESP commands are made from within JCL procedures (that is, the SYSIN DD statement does not appear in the JCL member being converted), you can run the JCL conversion (JOB3) against the affected procedure library.

Specifies whether the job sysouts are released for printing after they are analyzed by Control-M. Valid values are:

• N or (blank) – Ignore this parameter

• R – Release sysouts

• D – Delete sysouts

Default: R

Parameter group: CONTROL-M FUNCTIONALITY SETTINGS

Specifies whether all jobs should be treated as DUMMY jobs upon conversion.

Valid values:

• Y (Yes) – Treat jobs as DUMMY jobs.

• N (No) – Do not treat jobs as DUMMY jobs. Default.

When RUNDUMMY (Run as Dummy) is set to Yes, the Job statuses of all jobs change to ENDED OK immediately when the pre-submission criteria of the jobs are satisfied.

When RUNDUMMY is set to Y, Control-M auto-edit variables %%$BMCWAIORIGTYPE %%$BMCWAIORIGUSEISJCL=Y are added to the job definition and the Control-M parameter OVERLIB is set to DUMMY.

For distributed jobs, it causes the defined command or script that is defined in the What area to be bypassed.

In Control-M/EM, when RUNDUMMY is set to Y, the Run as dummy check box is selected for all jobs.

If you choose to clear the Run as dummy check box, the job is restored to its original job type. For Mainframe jobs, the job is restored to its original Override Path and UseInstreamJCL.

Job ended SHOUT message. Specify a text for the SHOUT WHENNOTOK message that is sent when a job ends either successfully or unsuccessfully.

Default: %%JOBNAME J%%JOBID ENDED (NOT)OK!

Parameter group: SHOUT PARAMETERS SETTINGS

Job ended late SHOUT message. Specify the text for the SHOUT WHEN LATESUB message that is sent when a job ends late.

Default: JOB %%JOBNAME IS LATE!

Parameter group: SHOUT PARAMETERS SETTINGS

Job ended NOTOK SHOUT message. Specify the text for the NOTOK SHOUT message that is sent when a job ends unsuccessfully.

Default: %%JOBNAME J%%JOBID ENDED NOTOK!

Parameter group: SHOUT PARAMETERS SETTINGS

Job ended prematurely message. Specify the text for the SHOUT WHEN EXECTIME <nnn message, which is sent when the job's execution time is less than the ESP MINRUNTIME variable.

Default: %%JOBNAME J%%JOBID ENDED PREMATURELY!

Parameter group: SHOUT PARAMETERS SETTINGS

SHOUTR Job rerun message. Specify the text for the SHOUT WHEN RERUN message that is sent when the job is rerun.

Default: %%JOBNAME J%%JOBID RESUBMITTED

Parameter group: SHOUT PARAMETERS SETTINGS

Job started SHOUT message. Specify a text for the SHOUT WHEN EXECTIME >000 message that is sent when an external job starts. (For distributed jobs, the EXECTIME is specified as >001)

Default: JOB %%JOBNAME HAS STARTED

Parameter group: SHOUT PARAMETERS SETTINGS

Job not submitted on time message. Specify the text for the SHOUTWHEN LATESUB * message that is sent when the expected execution time of the job will exceed its DUE OUT time.

Default: %%JOBNAME J%%JOBID NOT SUBMITTED ON TIME!

Parameter group: SHOUT PARAMETERS SETTINGS

Whether to include

       ON TABLE-END NOTOK

       DO STOPCYCL

in cyclic SMART tables definitions

Valid values: Y, N (default)

Parameter group: CONTROL-M FUNCTIONALITY SETTINGS

Identifies a dataset (PROC LIB) that can be used instead of the data set specified in the INVOKE command of an EVENT to provide partial support. The search is processed only in the EVENTS file.

Valid values:

• N (No): Ignore the TEMPPROC command.

• Y (Yes): Use the TEMPPROC DSN instead of the DSN in the INVOKE for processing of the INVOKE.

  In case the DSN specified in the TEMPPROC command does not exist in the DSNXLT file, the conversion tool issues a warning message and replaces the DSN with the DSN in the INVOKE command.

Default: N

New output class to which Control-M is to requeue the JCL MSGCLASS sysouts of the job. Options:

• (blank) – reroute is not required. Default.

• * – the MSGCLASS sysouts of the job must be requeued to the original MSGCLASS of the job after they are analyzed by Control-M.

Parameter group: CONTROL-M FUNCTIONALITY SETTINGS

Sets the default Urgency for all the SHOUT statements produced by the conversion except when a descriptor code is specified in the ESP NOTIFY statement (see 31. NOTIFY).