Run book on Control-M for

Activity Coordinator
Version 1.0

1 Vodafone India Services Private Limited

Document History

Version Status Date Reason Author Reviewed By

1.0 Draft 30/01/2013 Control-M Document Vishal Shete Deepak Semwal

2.0

3.0

4.0

2 Vodafone India Services Private Limited

Contents

1 Control-M Architecture ........................................................................................................................ 5

1.1 Control-M Enterprise Manager [EM]: ........................................................................................... 5

1.2 Control-M Server: ......................................................................................................................... 6

1.3 Control-M Agent: .......................................................................................................................... 6

1.4 Control-M in Vodafone Environment: .......................................................................................... 6

2 How to access Control-M: .................................................................................................................... 7

2.1 Login into Control-M Enterprise Manager: ................................................................................... 7

2.2 Login into Control-M Desktop:...................................................................................................... 7

3 CONTROL-M/Enterprise Manager GUI: ............................................................................................... 9

3.1 Navigation Tree ....................................................................................................................... 9

3.2 Flow Diagram .......................................................................................................................... 9

3.3 Net Overview .......................................................................................................................... 9

4 Control-M ViewPoints: ....................................................................................................................... 10

4.1 Opening a Viewpoint: ................................................................................................................. 10

4.2 Archived ViewPoint: .................................................................................................................... 11

5 Control-M New Day Process (NDP) .................................................................................................... 12

5.1 New Day Plan for ordering Control-M jobs: ............................................................................... 12

6 REFRESH CONTROL-M/EM GUI : ........................................................................................................ 13

7 Job Status & Colour Codes: ................................................................................................................ 14

8 Control-M Job Actions: ...................................................................................................................... 15

9 How to find Control-M Server & Table name in Control-M Desktop- ............................................... 17

10 Job execution calendar: ................................................................................................................... 20

11 Dynamic Filter in Control-M ............................................................................................................. 21

11.1 To define a dynamic filter: ........................................................................................................ 21

11.2 Consider the following when filling in filtering criteria: ........................................................... 22

12 Find Jobs in Control-M ..................................................................................................................... 23

3 Vodafone India Services Private Limited

 12.1 To find jobs in the flow diagram that confirm to specific criteria ............................................ 23

12.2 To change the focus (navigate among multiple selected nodes) ............................................. 23

13 Order/Force action in Control-M: .................................................................................................... 24

13.1 Difference between Order and Force: ...................................................................................... 24

13.2 Steps to Order/Force a Job- ...................................................................................................... 25

14 SMART TABLE: .................................................................................................................................. 26

15 Complex Scenarios: .......................................................................................................................... 27

4 Vodafone India Services Private Limited

 Control-M
Control M is nothing but a scheduler. It’s software produced by BMC Corporation. It can be
said as a scheduling plus monitoring tool. Scheduler can be described as a software or
program which runs your jobs(basically means scripts to be run ) automatically at a specified
time like crontab file in Unix .But the handling capacity of crontab is not much and we can’t
have complex conditioning involved in scheduling a job with crontab so in more complex
environments we need some automation tool like Control M which automatically schedules
jobs based on their scheduling criteria of date, time, priority, pre-conditions and resource
availability. .

1 Control-M Architecture

Control-M mainly consists of three basic components –

 Control-M/ EM
 Control-M/Server
 Control-M/Agent

1.1 Control-M Enterprise Manager [EM]:

This part is primarily responsible for the GUI part. The prime functionality of this EM server is
to display you the output in GUI format of information regarding the processing of jobs. So all
the information that we want to see regarding alerts, jobs condition, job processing are done
by this part. EM doesn’t process jobs. It only shows or display you the processed output jobs
are executed at control-M server level only. Also a EM server can connect to many control-M
server but not vice versa. The second utility that this part has is that it is used to connect two

5 Vodafone India Services Private Limited

or more different Control-M servers together. Two different control-M servers cannot directly
talk to each other, they need a Control-M EM server in between them to communicate. EM
server has got its own database which is in real time sync with the database of control-M
server. Database can be primarily divided into two parts: one having Permanent Job
Definitions and one having Active Job Definitions.

1.2 Control-M Server:

This is the main central point of whole system. It is the part which fetched job from the
database checks their scheduling criteria that their time, conditions etc are matched and then
schedule the jobs and sends them to agent for execution while keeping track of the status of
job on agent continuously. The database is obviously needed here to store the permanent
definitions of the jobs

1.3 Control-M Agent:

This is where the jobs actually execute when scheduled by control-M server. The server checks
the agent regularly and communicates via fixed port number. Often we here about term
“agentless” it means there is only one agent machine connected to control-M server and all
other agents connect to that machine to get in touch with server.

Control-M Software consists of three components –

 Control-M Enterprise Manager

 Control-M Desktop
 Control-M Configuration Manager

1.4 Control-M in Vodafone Environment:

There are two instances of Control-M present in South European environment.

 One in Galileo SOC containing jobs of Spain and TeleTu , UK & DE .

In this Control-M/EM [ V 7.0 ], we have 5 servers-

 DECTRLM1
 ESCTRLM
 ESCTRLMIAT
 ITCTRLM1
 UKCTRLM1

 One in Spain containing jobs of local Spanish applications.

In this Control-M/EM [ V 6.3 ], we have 2 servers-

 10th Server
 11th Server

6 Vodafone India Services Private Limited

2 How to access Control-M:

2.1 Login into Control-M Enterprise Manager:

Start => Programs =>BMC Control-M => CONTROL-M Enterprise Manager => Control-M Enterprise
Manager

2.2 Login into Control-M Desktop:

Start => Programs =>BMC Control-M => CONTROL-M Enterprise Manager => Control-M Desktop

7 Vodafone India Services Private Limited

In our environment, we can access Control-M application via different RDP servers. All these
servers can be accessed with Windows Logins via SSGD or VPN connection.

 For Control-M in Galileo SOC containing jobs of Spain and TeleTu , UK & DE .

 DCWVA006.dc.sedc.internal.vodafone.com
 DCWVA007.dc.sedc.internal.vodafone.com
 DCWVA008.dc.sedc.internal.vodafone.com

 For Control-M in Spain containing jobs of local Spanish applications.

 eswha099.es.sedc.internal.vodafone.com
 eswha100.es.sedc.internal.vodafone.com

8 Vodafone India Services Private Limited

 3 CONTROL-M/Enterprise Manager GUI:

Flow Diagram

Navigation
Tree

Network Overview

3.1Navigation Tree – Hierarchical view of jobs in the current environment.

3.2Flow Diagram – Graphic representation of job production flow, based on job

dependencies established by prerequisite conditions specified in job processing
definitions. Components of the active environment are represented by boxes called
nodes. The information displayed in a node varies depending on the type of node
and on how certain customization options.

3.3Net Overview – Miniature version of the flow diagram, indicating the part of the
network currently displayed in the Flow Diagram view. By ragging the selected
area in this view to a different part of the network, you can quickly navigate in a
complex environment.

9 Vodafone India Services Private Limited

4 Control-M ViewPoints:

CONTROL-M provides a powerful graphic user interface that allows you to view, monitor, and
control all enterprise-wide batch flows from a single console, called the CONTROL-
M/Enterprise Manager console

Using CONTROL-M/EM, you can see the progress of your batch flows, and identify problems and
potential problems. CONTROL-M/EM provides a customizable, dynamic tool called ViewPoints
to allow you to display only those jobs and job flows of interest. For example, you can view
and monitor:

 Jobs on a particular CONTROL-M

 Jobs belonging to a specific user
 Jobs having a particular status, such as failed jobs

Viewpoints are constantly updated and show in real-time the execution status of the batch
production. CONTROL-M provides a set of predefined Viewpoints. You can define other
Viewpoints according to need.

4.1 Opening a Viewpoint:

Click on File/Open Viewpoint in the Control-M/Enterprise Manager window to load the list of
viewpoints.

File => Open Viewpoint

You can have more than one viewpoint open at a time.

10 Vodafone India Services Private

Limited
4.2 Archived ViewPoint:

This option is available only in Galileo Control-M . This is very useful while
finding the history of job like chain & status.
We can access this via, File => Open Archived ViewPoint

We can view NDP history of last 4 days in Archived ViewPoint. We have to select Control-M
server name & NDP date in order to view the NDP of jobs.

11 Vodafone India Services Private

Limited
5 Control-M New Day Process (NDP)

 At a set time each day (defined during installation as the start of day at the site),
CONTROL-M performs New Day processing, during which:
 CONTROL-M performs a number of maintenance and clean-up functions that the
operator would otherwise have to perform manually.
 Job scheduling definitions are selected from the scheduling tables (based on
their basic scheduling criteria) and are placed in the Active Jobs file. These
jobs can then be submitted and tracked by the CONTROL-M monitor.
 During New Day processing, jobs that have ended OK or whose retention period
has expired according to job scheduling definition parameters are deleted from
the Active Jobs file.
 In simple terms "this loads all of the jobs that Control-M knows should run that day.
Control-M does not necessarily know all of the jobs to run. it only knows the ones
scheduled to run that day. In process of cleanup Control-M will clear all the jobs
(ended OK, Deleted Jobs, Maxwait expired jobs, Eligible Failed jobs) except the jobs
which are in Hold and Jobs which are having MAXWAIT".
 Note: The jobs which were ended OK will be retained for one day.
In Control-M EM GUI, where you can see the currently running jobs for today is called AJF
(Active Job File).

5.1 New Day Plan for ordering Control-M jobs:

In our environment, we have different timings for ordering jobs [New Day
Plan] for different instances.

For Italian Instance:

At midnight 12:00 am [CET]

For Spainish Instance:

At 8:00 am [CET]

For DE istance:

At 11:00 am [CET]

For UK instance:

At 12:00 PM [CET]

12 Vodafone India Services Private

Limited
6 REFRESH CONTROL-M/EM GUI :

Sometimes due to NDP or changes in Active Job File , we can not take any action on jobs until
we refresh the GUI window.

Always keep a practice to refresh the GUI after logging into Control-M.

Refresh GUI

13 Vodafone India Services Private

Limited
7 Job Status & Colour Codes:

Conditions Colour
Wait Condition
Wait User
Wait Resource
Executing
Ended Ok
Ended Not Ok
Unknown

Wait Condition:

This status indicated that the job is waiting for some conditions to be satisfied like
job dependencies, timings, hold etc.

Wait User:

This status indicates that the job is waiting for user confirmation to run.

Wait Resource:

This indicates that the job is waiting for resources like Control & Quantitative.

Executing:

This indicated that the job is in running status.

Ended Ok:

This indicates that the job has been completed/Finished successfully & currently in Success
status.

Ended Not Ok:

This indicates that the job has not been completed/Finished successfully & currently in
Failed status.

Unknown:
Sometimes due to problem in network or in control-m agent, Control-M server unable to
retrieve the current status of that job. Due to this the job status becomes Unknown. As soon as the
problem gets resolved, the job comes into its original status.

14 Vodafone India Services Private

Limited
8 Control-M Job Actions:

There are different actions that can be performed on jobs in Control-M.

 Confirm –
This action is used to confirm the job. The job which is in ‘user wait’ condition
can only be confirmed. After confirmation, the job will execute when all requirements
are met.

 Delete -
This action is used to delete the job. To delete the job, we have to put it on
hold first.

 Documentation-
This action is used to check job’s documentation.

 Edit JCL/Script-
This action is used to edit the job's JCL or job script statements.

 Enhanced Why-
This action is used to View the predecessor’s jobs and Group Scheduling table for a
selected job or Group Scheduling table. It is selectable only from Flow Diagram.

 Force OK-
This action is used to change the status of job to Success/Ok.

 Hold-
This action is used to hold the job.

 Free-
This action is used to free the job. We can free the job which is only on hold.

 Kill-
This action is used to terminate the job and its associated processes. We can kill
the job which is running status only.

 Log-
This action is used to view the job’s log. This log contains an audit trail of job
related events occurring in the Control-M production environment.

 Rerun-
This action is used to re-run the job. Re-running a job starts execution from the
beginning. You can re-run a job that is completed Ok or NOT Ok.

 Statistics-
The statistics option allows you to view statistical information related to the
execution time of a job, such as the Start time & CPU time.
 View JCL/Script-

The View JCL/Script action opens the view JCL dialog, displaying programming code
for a job from a file.

15 Vodafone India Services Private

Limited
  Sysout-

The Sysout of a job is a record of the execution of that job, which includes operating
system messages captured by Control-M processes.

 Why-

This action is used to determine why the job has not yet been executed.

 Enhanced Why-

This option enables you to identify any jobs that have not yet completed with an OK
status that are predecessor jobs of a specified job. This feature can help you to
determine why a selected job or SMART table failed to run as expected.

NOTE: Menu options can be disabled in specific situations.

 The Why option is disabled when the job is executing or has completed.
 The Hold option is disabled when the job is already held.
 All options (excluding the Properties option) are disabled when communication is
temporarily not synchronized.

16 Vodafone India Services Private

Limited
9 How to find Control-M Server & Table name in Control-M Desktop-

Step 1: Select the option ‘Load from Control-M\EM’.

Step 2: Enter the job name in the ‘Job Name’ option & click on apply.

17 Vodafone India Services Private

Limited
18 Vodafone India Services Private
Limited
Step 3: This will gives you all the details of Control-M Server & Table name of that job.

19 Vodafone India Services Private

Limited
10 Job execution calendar:

To find the date & execution timing of job,

Order/Force => Enter Control-M Server name , Table name & Job name => double click on
the job in the filter

This is useful while handling activities to manage jobs. Also we can use this option to
decide whether there is need to order a job or need to force it.

20 Vodafone India Services Private

Limited
11 Dynamic Filter in Control-M
A dynamic filter is a filter that you define locally as you need it. You can then discard it or
save it for reuse.

11.1 To define a dynamic filter:

1. If the Dynamic Filter Definition dialog box is not currently displayed, display it
by performing one of the following tasks (whichever is appropriate):
o If the Select ViewPoint dialog box is currently displayed (that is, you are in
the process of opening a ViewPoint), after you select the ViewPoint, click
Dynamic Filter.
o If the ViewPoint is currently displayed, select <Dynamic Filter> in the Filter
list box.
o The Dynamic Filter Definition dialog box displays the last-used dynamic
filtering criteria.
2. To edit an existing filter, select it in the Filter Presets field and click OK. To create
a new filter, specify a name for it in the Filter Presets field.
3. Fill in filtering criteria.
4. To save this definition for later reuse, click SAVE Button.

21 Vodafone India Services Private

Limited
11.2 Consider the following when filling in filtering criteria:

 Most fields are self-explanatory. If you need a description of the fields that correspond
to fields in the job editing form,
 You can use the LIKE operator for all text fields except the Odate and
Time parameters. For Odate From and Time From, use the >= operator. For the Odate
To and Time To fields, use the <= operator.
 For Odate From and Odate To, use the yymmdd format. For Time From and Time To,
use the hh:mm format.
 Fields can contain several criteria separated by commas (for example, CONTROLM =
A*,B*).
 If you specify values for Time From and To fields in the filter, the filter processes
values in the Start Time and End Time fields in the Job Detail screen (not the From and
 Until fields in the Job Detail screen).

22 Vodafone India Services Private

Limited
12 Find Jobs in Control-M

12.1 To find jobs in the flow diagram that confirm to specific criteria

1. In CONTROL-M/Desktop or CONTROL-M/EM, select Edit => Find Jobs.

2. In the Find Job dialog box, fill in the criteria (you can specify pattern-matching strings
in certain fields).
3. In CONTROL-M/EM only, to save the specified Find criteria for future use, assign a
name in the Find Presets field, and click Save.
4. Click Find, which selects all nodes matching the criteria, and displays the first
node that fits the criteria.

12.2 To change the focus (navigate among multiple selected nodes)

Click the appropriate navigation button (First) , (Previous) , (Next) , or (Last)

, or use the View => Toggle Selection menu.

23 Vodafone India Services Private
Limited
13 Order/Force action in Control-M:

Click the Icon on the Toolbar or select Tools -> Order/Force a Job (Cntrl+R is the shortcut
key).

You will get Order/Force dialog box. You have to select Control-M (Data center) and Table
from the dropdown list to display all the jobs in that table. Then you can select the job which
you want to order/force job.

13.1 Difference between Order and Force:

 Order: will bring the in to AJF if the job is in schedule.

 Force: will bring the job into AJF irrespective of the schedule.

24 Vodafone India Services Private

Limited
Note: If you would like to bring the job with HOLD then you need to select ‘Order/Force with
Hold’ option.

13.2 Steps to Order/Force a Job-

 Check the order date [ODAT] of job for which job has to be ordered
 Find the job in Control-M if it is already present of same ODAT
 If job is already present in Control-M of same ODAT, then confirm with the requester
about the execution timings.
 If job is not found in Control-M , then we have to Order/Force it.
 Find the Control-M Server name & Table name in Control-M Desktop.
 Enter all the details in Control-M Order/Force window.
 Please do not forge to select the option ‘Order/Force with hold’. This is useful to avoid
mistakes of ordering unwanted job or unwanted run time.

25 Vodafone India Services Private

Limited
14 SMART TABLE:

SMART Tables are a special kind of table; they are indicated graphically in Control-M/EM by a
clock symbol below the group level. They are used by Schedulers to achieve specific
behaviours.

SMART tables have properties that are similar to individual jobs. Included in these parameters
is the capability to define In & Out conditions for jobs in SMART table collectively.

26 Vodafone India Services Private

Limited
15 Complex Scenarios:

 Request to change the status of job to SUCCESS or Force Ok the job –

Sol- If job is in failed /wait condition status, we can directly change the status of the
job to success by right click on job => Force Ok.

If job is in running status, then we have to kill it first & then force ok the job.

 “Rejected by Data Centre” error while performing action on jobs –

Sol - In such case, route Service Request/Incident to Scheduling team for further
analysis.

 Request to re-run the job & found more than 1 instance of job –
Sol - In such case, if job Odate is given, then we can re-run that particular job. But if
Odate is not provided, then route back the request to requester for correct Odate.

If this is an incident, then we can get Odate details of job in ‘Notes’ field of ticket
in remedy. Check the Odate & perform the action respectively.

 For PSRs , request to hold the job & job not found –
Sol - In such case, find the job execution calendar & timing. If job is not scheduled on
that day, then there is no need to order/Force the job & put it on hold. We can write in
remedy as, Task partially done as mentioned job is not scheduled for the day.

 For PSRs , request to hold the chain or all the jobs of same name –
Sol- The jobs which are need to be hold, find in ‘Find’ option as shown below.

For example, the chain is ESCTRLM => SAP => * … This means that we need to hold
all the jobs present in chain SAP.

27 Vodafone India Services Private

Limited
  Request to execute the job of SMART Table –
Sol - SMART Table concept is different from other tables. All the jobs in SMART Table are
dependent on the execution timing of the table. So, in order to run a job, we have to put
it on hold & fill all the required details like execution timing & dependencies. After this
we have to edit the SMART table by putting it on hold & changing the timings as per
requirement. We can edit the SMART table in same way as we do for jobs.

Also we can use the option, Bypass => Pre-Submission(Run Now)

We can use this option to submit & run the table by ‘Bypassing’ the condition.

28 Vodafone India Services Private

Limited
  Request to delete Pre-requisite condition & run a job-
Sol- Go to Tools => Pre-requisite Conditions => Enter job details like Sever Name &
Order date details

We can delete/add the conditions by selecting proper options as shown below.

 Request to run/execute/schedule a job & it’s found in Control-M

Sol- If job is already present Control-M, verify the Odate. If Odate is different then
Order/Force the job & load into control-m. Then run it as per requirement. If Odate is
same as requested in the request, then we have to route back the request to the
requester with an update of details like, Odate & execution timing. If requester wants to
run the same copy of job with different timing, then we can load a new copy & run. If
requester wants to change the execution timing of the job, then put it on hold & change
the execution timing.

 For PSR, we have a task to put job on hold & we found more than one
instance of job in control-m like more than 20. Out of these instances,
few instances are already on hold.
Sol – In such situation, don’t worry about already held jobs, as it is very difficult to filter
these jobs & put remaining jobs on hold & again put these jobs off hold at the end of PSR.
We have to select all the jobs & put them on hold & put off hold at the end of PSR. There
are ways to put certain instance on hold & put them off hold. But if we have Top Service
PSRs like Canvass, then directly perform actions as mentioned previously.

 Request to schedule a job for a specific time like 23/09/2012 at 3:00 AM

& today’s date is 22/09/2012
Sol- We have different Control-M Servers in our environment. All have different time
durations for loading a new day plan of jobs.

First thing we have to do is, find the respective Control-M Server for that job, to which the
job belongs. Then check for the NDP timing. We cannot schedule a job for future date. If
want to schedule/execute the job on particular future date , then keep that request in
pending status & load the job on that particular day after NDP. However, we can
schedule/execute the job for past dates anytime.

29 Vodafone India Services Private

Limited