Job Management
The following table lists actions that you can perform on a job in the Monitoring domain.
To enable Audit Annotations on each job action, contact your Control-M Administrator.
Job Action |
Description |
---|---|
Search for a job defined in the Control-M environment. |
|
Search for a job in a viewpoint. |
|
Stop the job from processing, which enables you to update the job. |
|
Release a job from a Hold state, which enables the job to execute. |
|
Run a job that has already run. |
|
Execute folders |
|
Override the job scheduling criteria and immediately executes the job. |
|
Verify JCL code in an active z/OS job and set custom parameter values and filters for JCL verification. |
|
Restart a z/OS job from a specific step. You can specify a range of steps where the job restarts from and ends. Files from the previous job run are deleted. |
|
Reactivate a z/OS job or task that began execution but now has a status of either Disappeared or Failed Reason Unknown. |
|
Grant user confirmation to a job that is waiting for to be confirmed. This allows the job to begin execution. |
|
Set a job to End OK, which overrides its scheduling criteria and prerequisites |
|
Set a z/OS job to End OK, which overrides its scheduling criteria. Post-processing job actions are not performed. |
|
Forgo job execution and enables one or more successor jobs to begin execution. |
|
Ignore job scheduling criteria, actions, resources, Workload Policies, host restrictions, or post-processing, or runs the job as a Dummy |
|
Apply required events |
|
Delete a Held |
|
Restore a Deleted job. |
|
Terminate a job during its execution. |
|
Edit the job definitions. |
|
Search for a file that was transferred with Control-M MFT (Managed File Transfer |
|
Display the status of all file transfers from a specific job. |
|
Find jobs that are in its neighborhood |
|
View the details of each job tab. |
Finding a JobLink copied to clipboard
This procedure describes how to search for jobs.
If you have a viewpoint that contains the required job, see Finding a Job in a Viewpoint.
Begin
-
From the Monitoring domain click
, and then click Job Search.
A Search tab appears.
-
From the Today drop-down list on the Search toolbar, select the relevant date.
The <Selected_Date> appears as the drop-down list title.
-
In the job search field, type the job name, filename, or run ID
, and then press Enter.
A list of jobs that match the search string appear.
Finding a Job in a ViewpointLink copied to clipboard
This procedure describes how to find a job in a viewpoint.
Before You Begin
-
Create or open a viewpoint, as described in Viewpoints.
Begin
-
From the <Viewpoint_Name> toolbar, click Find.
The Quick Find toolbar appears.
-
Do one of the following:
-
Simple Search: To perform a simple search, do the following:
-
In the Find in job properties field, type the required job attribute.
-
(Optional) Click one of the following drop-down lists to filter the search:
-
Attributes: Filters by job attribute type.
-
All Entities: Filters by job status, as described in Job Status.
-
-
Press Enter.
The search results appear in the Find Results bottom pane.
-
-
Advanced Search: To perform an advanced search, do the following:
-
Click Advanced.
The Advanced Find dialog box appears.
-
In the Advanced Find dialog box, define the required attributes, and then click Find.
The search results appear in the Find Results bottom pane.
Pattern-match strings are supported, as described in Pattern-Matching Strings.
-
-
Holding a JobLink copied to clipboard
This procedure describes how to hold a job, which prevents the job from executing, or pauses the execution of a job that has already started.
Begin
-
From the Monitoring domain, right-click on the job and select Hold.
The job is on hold and you can now update the job.
Releasing a JobLink copied to clipboard
This procedure describes how to release a job from a Hold state, which enables the job to continue executing according to it's defined attributes.
Begin
-
From the Monitoring domain, right-click on the job and select Release.
The job is released and can now continue executing.
Rerunning a JobLink copied to clipboard
This procedure describes how to execute a job again.
Begin
-
From the Monitoring domain, right-click on the job and click Rerun.
You can only rerun a job after it has finished executing.
Running Multiple JobsLink copied to clipboard
This procedure describes how to execute folders, sub-folders, and jobs whether according to the scheduling criteria or not.
Begin
-
From the Monitoring domain, click
and select Run Jobs/Folders.
The Run tab appears, showing 3 steps.
-
In the Step 1 pane, select the jobs that you want to execute as follows:
-
In the Select Folder field, select or type the folder that contains the required jobs.
-
In the Search Job/Sub Folder Name field, type the required job or sub-folder names, separated by commas.
-
-
In the Step 2 pane, determine the run attributes, as described in Run Attributes.
-
In the Step 3 pane, verify the accuracy of your Run Summary, and then click Run.
You can check the status of the execution in the Run Report tab, as described in Viewing the Run Report.
Run AttributesLink copied to clipboard
The following table describes the run attributes in the Run tab in the Monitoring domain, as described in Running Multiple Jobs.
Attribute |
Description |
---|---|
Ignore Scheduling Criteria |
Determines whether the job runs now, and not according the scheduling criteria. |
Run as Independent Flow |
Determines whether the job workflow executes independently from other instances of the same workflow and events. A unique suffix is added to every job event Run as independent flow is supported in SMART folders and sub-folders. |
Hold - Put the Folder/Job on Hold |
Determines whether the job enters a Hold |
Date Selection |
Determines one of the following run dates:
Select Wait for Selected Run Date to Run to cause jobs in different time zones to execute before their scheduled run date. |
Place in Folder |
Determines how a selected job runs and appears in a viewpoint, as follows:
If the job or sub-folder is inserted into an existing folder or sub-folder that has already completed, the status of all parent folders is set to Executing. If it is not possible due to scheduling criteria, then the job remains in a WAIT_SCHEDULING status. This parameter is ignored if the folder that runs is not a SMART folder. |
Create Duplicate |
Determines that for jobs or sub-folders that belong to a folder, when you select Run into > Recent or Run Into > Selected, jobs or sub-folders that already exist with the same name are duplicated instead of overwritten in the folder. This option is selected by default. |
Variables |
(Optional) Defines one or more job or sub-folder user-defined variables For more information, see Variables. |
Viewing the Run ReportLink copied to clipboard
This procedure describes how to view folders, sub-folders, and jobs that you executed in the Monitoring domain. You can only view a report of the jobs that you executed from your current Control-M login session.
Begin
-
From the Monitoring domain, click
and select View Run Report.
The Run Report tab opens and the jobs that you executed appear.
You can view jobs in a folder by clicking
to expand the folder.
Executing a Job NowLink copied to clipboard
This procedure describes how to execute a job immediately, overriding all the prerequisite and submission criteria of the job.
Begin
-
From the Monitoring domain, right-click the job you want to execute and select Run.
The job executes, overriding any submission criteria.
Verifying JCL Code in an Active z/OS JobLink copied to clipboard
This procedure describes how to verify JCL code in an active z/OS job and define custom parameter values and filters for the JCL verification. This enables you to view and correct JCL code such as missing field values or other errors before running the job.
Before You Begin
-
Ensure that Control-M JCL Verify 9.0.22 or higher is installed and enabled on the mainframe, as described in Control-M JCL Verify Documentation. To enable Control-M JCL Verify, contact your Control-M Administrator.
Begin
-
In the viewpoint, click the required z/OS job.
-
Do one of the following:
-
Right-click the job and select
Verify JCL.
-
In the Job Properties pane, on the Script tab, click
(Verify JCL).
-
-
In the Verify JCL dialog box, define custom parameter values and filters for this JCL verification, as described in Verify JCL Parameters.
Changes are saved for future JCL verifications by the same user.
-
Click Verify.
The Verify JCL Report appears in the bottom pane.
Restarting a JobLink copied to clipboard
This procedure describes how to restart a Control-M for z/OS job from a specific step or a range of steps.
Files from a previous job run are deleted when you restart a job.
Begin
-
Select the Control-M/for z/OS job you want to restart.
-
From the Actions drop-down list, select Restart.
The Restart Job pane appears.
-
For each field, type or select the required value, as described in Restart Job Attributes.
-
Click Restart.
The job restart request is submitted and sent to Control-M/for z/OS.
-
To view the job details, click one of the tabs in the right pane, as described in Job Details.
Restart Job AttributesLink copied to clipboard
The following table describes Restart Job attributes for Control-M for z/OS jobs.
Attribute |
Description |
---|---|
Restart Options |
Determines the scope of the restart, as follows:
|
Select Step/Proc |
Determines the step/proc to restart, when you select the One step/proc only option. For details of the available steps, see the list at the top of this pane. |
From Step/Proc |
Determines the step/proc to restart from, when you select From a step/proc to a step/proc. For details of the available steps, see the list at the top of this pane. |
To Step/Proc |
Determines the step/proc at the end of the range to restart, when you select From a step/proc to a step/proc. If a From step/proc value is defined, and the To step/proc field is blank, the job reruns up to and including the last step. For details of the available steps, see the list at the top of this pane. |
Recapture ABEND Codes |
Determines whether to save the ABEND codes from the steps that executed in the original job execution and are, therefore, not executed again when you restart the job. For more information, see Condition Code Recapture and ABEND Code Recapture. |
Recapture COND Codes |
Determines whether to save the event codes from the steps that executed in the original job execution and are, therefore, not executed again when you restart the job. For more information, see Condition Code Recapture and ABEND Code Recapture. |
Step Adjustment |
Determines whether to enable Automatic Step Adjustment in the case of a non-recoverable step. For more details, see Automatic Restart Step Adjustment. |
Restart Parm Member Name |
Defines the name of the member (in the Control-M/Restart PARM library) that contains control attributes for the job to restart, as described in Control-M/Restart Parameter Members. Valid Values: 1–8 characters. Default: The member that contains the JCL of the job. |
Reactivating a JobLink copied to clipboard
This procedure describes how to reactivate a z/OS job or task that was started but now has a job status of either Disappeared or Failed Reason Unknown.
Begin
-
From the Home page, right-click the relevant job and select Reactivate.
The job is reactivated.
-
To view the job details, click one of the tabs in the right pane, as described in Job Details.
Confirming a JobLink copied to clipboard
This procedure describes how to confirm a job that is waiting for user confirmation to enable the job to continue executing. This is relevant only for jobs that are defined to request user confirmation.
Begin
-
From the Monitoring domain, right-click the job with a Wait User status that you want to confirm, and select Confirm.
The job is confirmed and continues to execute.
Setting a Job to OKLink copied to clipboard
This procedure describes how to set a job to end OK by overriding any defined scheduling criteria or other job prerequisites.
Begin
-
From the Monitoring domain, right-click the job and select Set to OK.
The job ends OK.
Setting a Job to OK (No PP)Link copied to clipboard
This procedure describes how to set a Control-M for z/OS job to end OK. This job action overrides any scheduling criteria and post processing job actions are not performed.
Begin
-
From the Monitoring domain, right-click the relevant job and select Set to OK (No PP)
The job ends OK.
-
To view the job details, click one of the tabs in the right pane, as described in Job Details.
Skipping a JobLink copied to clipboard
This procedure describes how to skip over a job within a job flow. The job that you skip is not executed.
Begin
-
From the Monitoring domain, right-click the job and select Skip.
The skipped job does not execute.
Bypassing Options in a JobLink copied to clipboard
This procedure describes how to bypass or ignore job options such as a resource, event, or time limit when you submit a job.
Begin
-
From the Monitoring domain, right-click the job and select Bypass Options.
The Select Options to Bypass pane appears.
-
Select the relevant options, and then click Apply, as described in Run Now Bypass Options
Run Now Bypass OptionsLink copied to clipboard
The following table describes the Run Now Bypass options that appear when you select the Bypass Options option.
Option |
Description |
---|---|
Time Limits |
Determines whether to execute the job regardless of the Time From, Time Until, and Next Time parameter values. The Time Limits bypass does not include the Time Zone parameter, which means jobs that are waiting for a specific date still wait for that date, even if the Time Limit bypass is checked. |
Wait for Events |
Determines whether to execute the job even if the events that the job is waiting for did not happen. |
Resources from a Pool |
Determines whether to execute the job regardless of whether resources are available from the resource pool |
Lock Resources |
Determines whether to execute the job regardless of whether the lock resources |
(z/OS only) Scheduling Environment |
Runs the job regardless of its SCHENV statement. |
(z/OS only) Pipes |
Runs the job regardless of whether other jobs using the same Pipe as that specified in the definition of this job, are ready to run. |
Pause; (z/OS only) Quiesce |
Runs the job even if Control-M is in Quiesce mode, either as a result of QUIESTIME or QUIESQRES commands. |
Run Job as Dummy |
Determines whether to execute the job as a Dummy job |
Run Job without Post-processing |
Determines whether to execute the job without performing any of the job post-processing actions, including the following:
|
Applying Events to a Waiting JobLink copied to clipboard
This procedure describes how to apply events to a waiting job which enables you to force a job to start executing.
Begin
-
From the Monitoring domain, click the job that you want to view.
The Job Properties pane appears.
-
Click the Waiting Info tab.
The Waiting Info
data appears.
-
In the Job Events area, do one of the following:
-
To apply all missing events, click Apply All.
-
To apply an individual event, click
.
The events are added to the Active Events list.
-
Deleting a JobLink copied to clipboard
This procedure describes how to delete a job.
Begin
-
From the Monitoring domain, right-click a job that is in a hold state and select Delete.
The job is deleted.
-
Click OK.
Restoring a JobLink copied to clipboard
This procedure describes how to restore a job in a deleted state.
Before You Begin
-
From the Monitoring domain, select the viewpoint that you want to edit.
-
From the Viewpoint Details pane, click Edit.
The Viewpoint Settings tab opens.
-
Select the Include Deleted Jobs checkbox.
Begin
-
From the Monitoring domain, right-click a job in a deleted state and select Restore.
The job is Restored.
-
Click OK.
Killing a JobLink copied to clipboard
This procedure describes how to kill a job, which cancels a job from executing in the middle of its execution.
Begin
-
From the Monitoring domain, right-click the job in a Hold state, and select Kill.
The job is terminated and no longer continues to execute.
Editing a JobLink copied to clipboard
This procedure describes how to edit a job.
Begin
-
From the Monitoring domain, select the job you want to edit.
-
From the Job Details pane, click Edit.
The Job Settings tab opens.
-
Edit one or more of the following:
-
General tab: Edit the job attributes according to the job type as described in Job Types.
-
-
Click Save.
The job is updated.
The status of the job is unaffected by these changes.
If the job was originally in a Wait status, after you apply the changes, the job remains in a Wait status. If the job Ended OK, then the job is held to update the changes and then released.
Searching for a File TransferLink copied to clipboard
This procedure describes how to search for a file that was transferred with Control-M MFT and view its job properties and transfer status.
Begin
-
From the Managed File Transfer domain, do one of the following:
-
Quick Search: To perform a quick search, do the following:
-
In the Search field, type the filename, application
, or job name.
The asterisk character is not supported for a quick search. However, you can type a partial string that contains characters from the filename.
-
Click
.
-
-
Advanced Search: To perform an advanced search, do the following:
-
Click Advanced Search.
-
For each field, type or select the required value, as described in MFT Connection Profile Additional Parameters and then click Search.
You can use the * wildcard character for advanced searches. You can only place the wildcard after the string.
ab*.
-
To view the previous ten advanced searches, click Recent & Favorites.
The search results appear. You can pin a search so that it remains in a list of up to 10. The list is saved per client.
The yellow bar indicates the search parameters, the number of results found, and the time the search occurred. You can view the transfer details in the General and Job Output tabs in the right pane.
The data does not refresh automatically. To view the latest status, perform the search again.
-
-
-
Do one or more of the following:
-
To filter and sort each column, click the column header and select the required values.
-
To see more search details:
-
In the top right-hand corner of the search results, click Show Column Chooser.
-
Drag and drop the columns you want to see in the search results from the Available Columns to Visible Columns.
-
Group the search results by dragging and dropping the columns into the Group Bsy area.
-
-
To locate the job of each file transfer, in the General tab, click the job name.
A neighborhood tab appears that shows the context of the job. This enables you to perform actions on the job, such as rerunning the job or viewing the output or log
.
-
Viewing File Transfers from a JobLink copied to clipboard
This procedure describes how to view the status of all file transfers from a specific job.
Begin
From the Home page, right-click a Managed File Transfer job and select Show File Transfers.
The associated file transfers from the job appear in the MFT Search window filtered by Run ID and Run Count.
-
If the job is executing, it shows the transfers for the current execution.
-
If job ended, it shows transfers for the last execution.
-
If job has not started (and it is the first execution), the option is disabled.
MFT Advanced Search AttributesLink copied to clipboard
The following table describes MFT Advanced search attributes:
Attribute |
Description |
---|---|
File Name |
Defines the filename of the transfer |
Status |
Determines the status of the transfer:
|
Job Name |
Defines the File Transfer job name that is executing the transfer. |
Application |
Defines the application of the File Transfer job. |
Sub Application |
Defines the sub-application |
Folder |
Defines the folder of the File Transfer job. |
Source |
Determines the source host of the file transfer. |
Destination |
Determines the destination host of the file transfer. |
Source Path |
Defines the location of the file transfer on the source host. |
Destination Path |
Defines the location of the file transfer on the destination host. |
Run ID |
Defines the unique execution instance of the job. |
Job Run Count |
Defines the number of executions of the job. |
Time Frame |
Defines when the files were transferred. |
Finding Neighborhood JobsLink copied to clipboard
This procedure describes how to find the successor and predecessor jobs of the selected job, which enables you to analyze your job flow based on the jobs related to the selected job. For example, you can search for prerequisite jobs, which are the predecessors of the selected job.
If there is a dependency on a folder, the Neighborhood Viewpoints displays the dependent folders as empty without its content.
Begin
-
From the Monitoring domain, right-click the job, and select Neighborhood.
The Open Neighborhood window appears.
-
Set the fields described in Neighborhood Search Fields.
-
Click OK.
The results of the search appear in the Neighborhood results tab.
Neighborhood Search FieldsLink copied to clipboard
The following table describes the Neighborhood search fields:
Neighborhood |
Description |
---|---|
Directions |
Determines the relationship of the search jobs to the selected jobs.
|
Radius |
Defines the number of jobs that branch out from the selected job. Valid Values: 1–99,999 |
Job DetailsLink copied to clipboard
The following table describes the job details of each tab.
For information about SMART folder settings, see Folder General Attributes.
Tab |
Description |
---|---|
Summary |
Shows fields such as, start time and end time, run ID, run date, status, attributes of the selected job, as described in Job Summary Tab. |
Job Settings |
Shows the job properties, as described in Creating a Job. |
Waiting Info |
Shows the reasons why the job did not execute. |
Log |
Shows the activity log of the selected job. |
Output |
Shows the different outputs of the selected job. To view, see Viewing Job Output. |
Statistics |
Shows the statistics of the selected job, as described in Statistics Tab. |
Script |
Shows the script or JCL of the selected job. In the Script tab, you can perform the following actions:
|
Application Plug-in |
Shows the fields and values of the specific plug-in Some plug-ins allow you to refresh, pause, restart and delete a process. |
Documentation |
Shows a description related to the job, and is saved in a defined location. The Documentation area includes information about where to find the Documentation. In a z/OS job, the Documentation is in a Doc Member located in a Doc Library. The Documentation depends on whether the type is File or URL, as follows:
|
Related |
Shows the following:
|
SLA |
Shows the SLA Management
|
Job Summary TabLink copied to clipboard
The following table describes the basic attributes for the selected job.
Attribute |
Description |
---|---|
Run As |
Shows the username that is authorized to execute the job. |
Run Where |
Shows the Agent host ID and host group where the job executes. |
Status |
Shows one of the following possible statuses, as described in Job Status:
|
Start Time |
Shows a timestamp that records when the job began execution. |
End Time |
Shows a timestamp that records when the job ended execution. |
Estimated Start Time |
Shows an estimation of when the job is expected to begin execution, as described in Run Time Estimations. |
Estimated End Time |
Shows an estimation of when the job is expected to end execution, as described in Run Time Estimations. |
Estimated Run Times |
Shows an estimation of future execution times for a cyclic |
Submission Window |
Shows the when the job can execute. |
Run Duration |
Shows the number of seconds that it takes to execute the job. |
Run ID |
Shows the job run ID |
Run Date |
Shows the date that the job executed. |
Description |
Shows the user-defined job description. |
Job Type |
Shows the job type, as described in Job Types. |
Sub Application |
Shows the user-defined sub-application |
Application |
Shows the user-defined application |
Parent Folder |
Shows the folder where the job resides. |
Execution Timezone |
Shows the job execution time zone, as described in Time Zones. |
Cyclic |
Shows whether the job executes at defined cyclic |
Rerun Every |
Shows the time to wait between job reruns or cyclic executions. |
Run Time EstimationsLink copied to clipboard
Control-M Statistics includes start time, end time, execution time (runtime), and standard deviation estimations from records of past job executions, which are saved on Control-M
cyclic jobs and SLA Management jobs enable you to view the following time estimations:
-
Start and End Time Estimations: Appear in the job tile of a viewpoint.
-
Start, End, and Run Time Estimations: Appear in the Run Information area of the job Summary tab.
Viewing Job OutputLink copied to clipboard
This procedure describes how to view the output of a job, which enables you to review the actions of a job to determine if and where the job did not process correctly.
Begin
-
Select a job and click the Output tab.
-
From the drop-down list, select the required output file.
-
Do one or more of the following:
-
To view the latest version of the output, from the drop-down list select the latest output.
-
To view specific characters or words in the output, in the Find field, type the words or characters that you want to view.
-
To view job output in a separate window, click
.
-
(z/OS only) To view the output in Control-D/WebAccess Server, click
.
Control-D/Web Access Server Report List window appears, as described in Control-D/WebAccess Server Web Application Report Management.
Enable access to Control-D/WebAccess Server, as described in Enabling Control-D/WebAccess Server Output in Control-M Web.
-
Statistics TabLink copied to clipboard
The following table describes the statistical for the selected job that is saved in Control-M Statistics.
Attribute |
Description |
---|---|
Average |
Shows the average job start time, runtime, and CPU processing time. |
Projection |
Shows the estimated job start and end times. |
Periodic Statistics |
Shows the server name, periodic calendar name, and period name for the Periodic Statistics rule that is defined for this job. For more information, see Periodic Statistics Rules. |
Dynamic Statistics |
Shows the event prefix and period name for the Dynamic Statistics rule that is defined for this job. For more information, see Periodic Statistics Rules. |