Creating a Sub-folder
This procedure describes how to create a sub-folder in a Workspace A working area in the Planning domain where you define and edit new jobs and SMART folders.. Sub-folders and jobs inherit the parameters that you define at the SMART folder level.
You can only create a sub-folder in a SMART folder.
Begin
-
From the Center Pane Toolbar, click Add Job and from the drop-down list, drag and drop a Folder into the Workspace.
The Create New Folder pane appears.
-
From the Folder Type drop-down list, select SMART folder and click Create.
A SMART folder appears in the Workspace. -
From the Add Job drop-down list, drag and drop another folder into the SMART folder you just created.
A sub-folder appears inside the SMART folder you just created. -
From the General tab in the right pane, define one or more of the following properties:
-
General: Defines the sub-folder general parameters, as described in Sub-folder General Parameters.
-
Scheduling: Defines the sub-folder scheduling parameters, as described in Sub-folder Scheduling Attributes.
-
Prerequisites: Defines the prerequisites
The part of the job definition that controls the flow of your jobs, such as an event that controls flow sequence or a resource that controls load balancing. that must be met before the sub-folder executes, as described in Prerequisites.
-
Actions: Defines the actions that Control-M performs after the sub-folder executes, as described in Actions.
-
Sub-folder General Parameters
The following table describes the sub-folder general parameters in the General tab in the right pane.
Parameter |
Description |
---|---|
Folder Type |
Defines the folder type as a sub-folder. |
Folder Name |
Defines the name of the folder. Rules:
If you rename a sub-folder, note the following:
|
Description |
Defines a free-text description of the sub-folder. Rules:
|
Reference |
Defines the sub-folder as a reference sub-folder, as described in Reference Sub-folder. You cannot reference a sub-folder that contains jobs. |
Reference Path |
Defines the full pathname for the SMART folder or job that is referenced, such as Folder_2/Job_7.
Rules:
|
Server |
Defines the name of the Server that processes the sub-folder. |
Run As |
Defines the username with the authorization to execute jobs in the sub-folder. Rules:
|
Parent Folder |
Defines the name of the folder where the sub-folder is nested. |
Application |
Defines a descriptive name for related job groups. The jobs in these groups do not have to run at the same time. Rules:
|
Sub-application |
Defines a logical name for the Sub-application. Rules:
|
Variables |
Determines variable types, names, and values, as described in Variables. Rules:
Control-M recognizes fields that you define with %% as variables |
Created By |
Defines the Control-M user who created the sub-folder. Rules:
|
Documentation |
Defines the location of the folder documentation. |
Type |
Determines whether the documentation for the sub-folder is in a file or URL, as follows:
|
Priority |
Determines the order that Control-M processes jobs. A higher priority forces Control-M to reserve resources from the Resource Pool |
Reference Sub-folder
A reference sub-folder is an empty sub-folder that points to another SMART folder or job, and which enables you to run one or more of those entities when you run the reference sub-folder. This eliminates the need to replicate and manage defined SMART folders and jobs.
An organization has four departments, Accounts, Business, Catering, and Development. Each department runs their own, unique workflows. However, Accounts uses a SMART folder, called Billing, that uses a series of event-dependent jobs which the remaining departments also rely on. The Business, Catering, and Development departments create reference sub-folders in their Workspaces which run the referenced sub-folder Billing in the Accounts workflow to run the same jobs they would otherwise need to manually replicate.
The defined entities of the referenced SMART folders or jobs are added to the reference sub-folder as follows:
-
Variables that are defined in a referenced SMART folder or job are merged with the variables of the reference sub-folder as follows:
-
Variables that are defined in a referenced SMART folder or job that do not exist in the reference sub-folder are added to the reference sub-folder.
-
If variables exist on both the reference sub-folder and referenced SMART folder or job, Control-M uses the variable values of the reference sub-folder.
-
Variables that are defined in the reference sub-folder that do not exist in the referenced SMART folder or job are not changed.
-
-
If-Actions that are defined in a referenced SMART folder run before the If-Actions that are defined in the reference sub-folder. If-Actions that are defined in a referenced job are not added to the reference sub-folder, and remain in the job.
-
Lock Resources that are defined in a referenced SMART folder or job are merged with the Lock Resources of the reference sub-folder as follows:
-
Lock Resources that are defined in the referenced SMART folder that do not exist in the reference sub-folder are added to the reference sub-folder.
-
If a Lock Resource with the same name exists in both the reference sub-folder and referenced SMART folder, Control-M uses the value of the reference sub-folder.
-
Lock Resources that are defined in a referenced job are not added to the reference sub-folder and remain in the job.
-
-
Notifications that are defined in a referenced SMART folder are added to the reference sub-folder. Notifications that are defined in a referenced job are not added to the reference sub-folder, and remain in the job.
-
The defined values of the documentation fields (Type, Doc Path, Doc File), and Priority, Description, Application, and Sub-application in a referenced SMART folder or job are added into the reference sub-folder during the run process. If no values are defined in the reference sub-folder, Control-M uses the values defined in the referenced SMART folder and job.
During the run process the schedule and event definitions of the referenced SMART folder or jobs are ignored and the reference sub-folder definitions are used.
If you make changes to a referenced SMART folder or job that is being referenced by other sub-folders in other workflows and you want to view the entities that are affected by this change, you can filter the sub-folders that reference this entity in Folders and Jobs in the Planning domain.