Control-M Admin quick guide : Control-M Admin quick guide -Vinil Gopalkrishnan
firstname.lastname@example.org Control-M Admin quick guide : Control-M Admin quick guide Intro:
This presentation is primarily for job schedulers interested to
know about Control-M administration and aspiring
administrators with knowledge of data centre infrastructure
and OS. Since I wanted to keep it simple DB part is skipped. I
recommend Control-M users / aspiring to Control-M Admin to
visit http://www.bmc.com/support.html for more detailed
view and to seek support from BMC. Control-M guides
are available for free download. Control-M Admin quick guide : Control-M Admin quick guide Control-M admin role:
but not limited to the below task. I have not elaborated
much to avoid the complications.
Setting up the Environment
Day-to-Day Administering of CONTROL-M
Special Administrative Actions
Before starting let’s try understand the components
and the Control-M network What’s Control-M? : What’s Control-M? CONTROL-M/Enterprise Manager is a software product that runs primarily on
Windows and Unix workstations to provide centralized control of the job
scheduling production environment for the entire enterprise. The CONTROL-
M/EM advanced graphical user interface (GUI) enables you to view
production flows for the entire active environment.
CONTROL-M/Enterprise Manager works together with CONTROL-M
Production Control Systems and the CONTROL-R Automated Job Restart
System (that is available on OS/390 platforms only).
With CONTROL-M/EM, you can optimize CONTROL-M production throughput
simply and efficiently, even in a cross-platform production environment.
CONTROL-M installations, which include one or more computers, are managed
by one CONTROL-M. One CONTROL-M/EM network can control multiple
CONTROL-M installations on various types of platforms. CONTROL-M/EM Network : CONTROL-M/EM Network The CONTROL-M/EM environment : The CONTROL-M/EM environment The way in which the CONTROL-M environment
is structured can be categorized into three
CONTROL-M Reporting facility CONTROL-M/Enterprise Manager : CONTROL-M/Enterprise Manager With CONTROL-M/Enterprise Manager, you can automate the scheduling and processing of your production jobs. Its
main GUIs are CONTROL-M/Desktop and the CONTROL-M/Enterprise Manager window (simply called CONTROL-
To automate your production environment, perform the following tasks:
■ Model your production job flow by using job processing definitions Job processing definitions provide CONTROL-M
with the instructions for scheduling, submitting, and performing post-processing tasks of the jobs in your
■ Automate job ordering : After job processing definitions have been defined for your production jobs, you perform
several tasks to transition your definitions to production. As part of this transition, you can use a feature called
New Day processing to automate the ordering of jobs each day.
■ Monitor (and where necessary, intervene in) the processing of your production jobs: To ensure that everything is
running smoothly, you can monitor job processing, and if problems arise you can intervene effectively. Generally,
monitoring by exception (that is, checking problems or potential problems rather than viewing the entire system)
is the most effective way to monitor your production jobs.
■ Analyze (and optimizing) job processing in your production jobs : After your production jobs have been
automated, you can ensure that processing is maximized by using analysis tools to identify areas that can be
improved, such as resource allocation, work balancing, and so on. CONTROL-M/Desktop : CONTROL-M/Desktop CONTROL-M/Desktop is a production design and definition system for users of CONTROL-M. It provides you
with an intuitive and easy-to-use tool for creating and maintaining job processing definitions, scheduling tables,
Group scheduling tables, and calendars.
CONTROL-M/Desktop is a component of CONTROL-M/Enterprise Manager
(CONTROL-M/EM). It is installed as a client component during CONTROL-M/EM installation.
CONTROL-M/Desktop runs under all supported Windows platforms.
CONTROL-M/Desktop uses offline and online forms to simplify definition of job processing parameters, calendars and
CONTROL-M/Desktop can help you
■ display job hierarchy based on a CONTROL-M scheduling table or application/group parameters
■ move job processing definitions between CONTROL-M installations/scheduling tables or between
applications/groups using “drag-and-drop” techniques
■ view and modify parameters in job processing definitions
■ perform global search-and-replace of job processing parameters
■ create multiple job processing definitions automatically with predefined parameters and functions
■ define “collections” of job processing definitions for both viewing and performing mass updates
■ view job production flow graphically, according to job dependencies
■ view and modify calendars New or modified scheduling tables are saved into the CONTROL-M/EM database. Both
scheduling tables and calendars can be uploaded or downloaded from the CONTROL-M/EM database to their respective CONTROL-M/Server database directly in CONTROL-M/Desktop. CONTROL-M Reporting facility : CONTROL-M Reporting facility The CONTROL-M/Enterprise Manager (CONTROL-M/EM) Reporting facility
enables you to produce high-quality documentation of production flows using
a combination of text, graphics, and colour. Reports can be viewed online,
printed on the workstation or network printer, or printed to a file.
Several pre-defined reports are provided in CONTROL-M/EM. The information
in these reports reflects the production environment.
You can tailor most reports by defining filters to isolate jobs that are of
interest and by specifying the job attributes that you want displayed in the
report. The elements that can be modified differ for each report type. Some
reports cannot be modified.
Report data can be taken from the active and the definition environment. CONTROL-M/EM server components : CONTROL-M/EM server components Configuration Management Server: This collects all the relevant data from all
CONTROL-M components through the Configuration Agents, which can then be
managed from the CONTROL-M Configuration Manager. The CONTROL-M
Configuration Manager is the central point of administration for the CONROL-M
environment. Only one instance of CONTROL-M Configuration Management Server
can be run at any one time.
GUI Server: The central point of control for the enterprise production
management system. This process performs all user-initiated functionality for
CONTROL-M/EM workstations and components. The GUI Server is run and
managed from the CONTROL-M Configuration Manager. The GUI Server can be
given a logical name.
Global Alerts Server: A process that identifies, maintains and distributes
CONTROL-M alerts to CONTROL-M/EM GUIs. The Global Alerts Server is run and
managed from the CONTROL-M Configuration Manager. The Global Alerts Server
can be given a logical name. CONTROL-M/EM server components cont.. : CONTROL-M/EM server components cont.. Global Conditions Server (GCS): A process that distributes
conditions between CONTROL-M data centers. The Global
Conditions Server is run and managed from the CONTROL-M
BIM server: The server for the BMC Batch Impact Manager product,
which monitors critical batch services. BMC Batch Impact Manager is
dependent on job information supplied by the GUI Server.
Forecast server: A process that enables you to accurately predict
the pattern of specific job definitions. This enables you to predict a
schedule to be run on a future date. The Forecast Server is
dependent on user information supplied by the GUI Server, for user
authentication. Infrastructure components : Infrastructure components Configuration Agents: These enable you to monitor and
manage CONTROL-M/Servers, and CONTROL-M/EM
Server Components. A CONTROL-M/Server Configuration
Agent is installed on every computer on which a CONTROL-
M/Server 6.3.01 or later is installed. A CONTROL-M/EM
Configuration Agent is installed on every computer on which
one of the CONTROL-M/EM server components is installed
Databases: This is the CONTROL-M/EM databases that hold
all CONTROL-M/EM-related information. Can be either
Oracle, Sybase or MSSQL.
Naming Service: A CORBA-based process that routes between
a client request and the appropriate CONTROL-M/EM Server. Setting up the EnvironmentDay-to-Day Administering of CONTROL-MSpecial Administrative Actions : Setting up the EnvironmentDay-to-Day Administering of CONTROL-MSpecial Administrative Actions Control- M administration tasks Control- M administration tasks Setting up the Environment : Control- M administration tasks Setting up the Environment This section comprises the following elements:
“Setting up the CONTROL-M Configuration Manager work environment”
“Defining a CONTROL-M/EM Component”
“Defining a CONTROL-M data center”
“Configuring connectivity with CONTROL-M/Agent”
“Setting administrator passwords” Control- M administration tasks Setting up the Environment : Control- M administration tasks Setting up the Environment Setting up the CONTROL-M Configuration Manager work environment
In the CONTROL-M Configuration Manager, choose Tools => Options.
The Options dialog box is displayed.
Specify your preferences for the available options, and click OK:
Show CONTROL-M/Server components in their current state
(enabled or disabled)
Show dates in long format
Refresh rate interval - the time in seconds between refreshing the
topology display. Control- M administration tasks Setting up the Environment : Control- M administration tasks Setting up the Environment Defining a CONTROL-M/EM Component
In the CONTROL-M Configuration Manager, choose
Components => New => CONTROL-M/EM Component. The CONTROL-M/EM Component
dialog box is displayed
Specify the parameters as required for the component that you want to define.
CONTROL-M/EM Component dialog box
Desired State Choose as Up to run the CONTROL-M/EM component. Valid values:
_ Up or _ Down or _ Ignore
Type Choose the required CONTROL-M/EM component. Note: A Gateway can only be
specified when defining a CONTROL-M data center.
Name (GUI Server Name) For the GUI Server and Global Alerts Server (GAS):Logical name
of the component For BIM and CONTROL-M/Forecast: This parameter is called GUI Server
Name. An existing GUI Server should be specified as the value. Note: If no GUI Server
name is specified, the component (BIM or CONTROL-M/Forecast) will search for a GUI
Server with the same name as the local host. This parameter cannot be modified in this
Platform Operating system of the computer on which you want the CONTROL-M/EM component to run.
Host name Name of the host computer on which you want the CONTROL-M/EM component to run.
Check interval Indicates the length of time between life checks performed on CONTROL-M/EM components.
Override manually Choose to modify the command line that invokes the CONTROL-M/EM component.
Command Line Command line argument that invokes the component
Additional parameters Arguments that will be added to the command that invokes the component. Example:
Debugging. Optional. Control- M administration tasks Setting up the Environment : Control- M administration tasks Setting up the Environment Defining a CONTROL-M data center
In the CONTROL-M Configuration Manager, choose Components => New =>CONTROL-M/Server and Gateway.
The CONTROL-M/Server Definition dialog box is displayed, presenting you with the following options:
Discover provides automatic detection of a CONTROL-M data center, with minimal information supplied. This option is available in CONTROL-M/Server version 6.3.01 and later.
Define provides the ability to manually define a CONTROL-M/Server and corresponding Gateway.
The Discover option
To discover a CONTROL-M data center
1 Choose Discover.
2 In the dialog box displayed, specify the CONTROL-M/Server Connection parameters.
Name: Logical name of the required CONTROL-M data center.
Host name: Host name of the computer on which the CONTROL-M data center is installed.
Port number: Port number of the Configuration Agent of the specific CONTROL-M data center.
3 Click Next. The Discover process begins. Parameters are automatically retrieved, and displayed. A dialog box is displayed indicating the state of the Discover progress.
4 Ensure that Activate Gateway is selected.
5 Review the list of parameters, and click Finish. Control- M administration tasks Setting up the Environment : Control- M administration tasks Setting up the Environment CONTROL-M Definition parameters
Name Descriptive name for the CONTROL-M. 20 character maximum, blank spaces not
permitted. Should describe the CONTROL-M data center. Example: HQ,PARIS,DIVISION-07
Code Unique 3-character code used by CONTROL-M/EM to identify each CONTROL-M. Permitted characters: digits and uppercase letters. Example: 999, NYC
Version Version of the CONTROL-M/Server. Note: When defining an iSeries (AS/400) data center, choose 225.
Host Host name of the CONTROL-M data center.
Gateway A Gateway must be specified when you set up your work environment.
Platform Operating system on which your CONTROL-M is installed. If your platform is not listed, choose UNIX/Windows/TANDEM. Note: If your CONTROL-M runs on iSeries (AS/400), but any of the connecting
CONTROL-M/Agents run on non-iSeries operating systems, you should choose UNIX/Windows/TANDEM.
Time Zone Time zone in which the CONTROL-M data center is located.
Start day Set the first day of the week for the CONTROL-M/Server.
New Day Time Set the time that each new day begins for the CONTROL-M/Server.
Protocol Specify the type of protocol for communication with CONTROL-M.
Port TCP/IP port for communicating with CONTROL-M.
Gateway TCP/IP Host Name Name of the workstation containing the CONTROL-M/EM Gateway connected to the
CONTROL-M installation. This field is updated automatically when the CONTROL-M Gateway is started.
Gateway TCP/IP Port Number Port number of the workstation containing the gateway used to connect to the
CONTROL-M installation. This field is updated automatically when the CONTROL-M Gateway is started. To define a CONTROL-M data center
1 Choose Define.
2 In the CONTROL-M Definition dialog box,specify
the CONTROL-M connection parameters. Control- M administration tasks Setting up the Environment : Control- M administration tasks Setting up the Environment CONTROL-M/EM Component dialog box for defining a Gateway
Under Gateway, click New. The CONTROL-M/EM Component dialog box is displayed
Specify the required parameters, and click OK. Control- M administration tasks Setting up the Environment : Control- M administration tasks Setting up the Environment Configuring connectivity with CONTROL-M/Agent
Configuring a new installation
In the CONTROL-M Configuration Manager, right click the required
CONTROL-M/Agent, and choose Properties. The CONTROL-M/Agent
Properties dialog box is displayed.
Specify the parameters in all three tabs, as applicable to your environment.
Click Test to check that your settings are correct and workable.
Once the test has validated the settings, click OK.
Updating an existing installation
Same as above apart from Modify the parameters in all three tabs as required.
Testing the communication channel
1 In the CONTROL-M Configuration Manager, right click the required CONTROL-M/Agent, and choose Ping Agent.
2 A test is automatically performed on the communication channel between the CONTROL-M/Agent and the applicable CONTROL-M data center. When the check is complete, a dialog box displaying the result is displayed. Control- M administration tasks Setting up the Environment : Control- M administration tasks Setting up the Environment Adding a CONTROL-M/Agent
In the CONTROL-M Configuration Manager, right click the required CONTROL-M/Server, and click Add Agent. The Add CONTROL-M/Agent dialog box is displayed.
Click Advanced to display the General, Persistent Connection and Retry/Timeout tabs.
Specify the parameters in all three tabs, as applicable to your environment.
Click Test to check that your settings are correct and workable.
Once the test has validated the settings, click OK. Control- M administration tasks Setting up the Environment : Control- M administration tasks Setting up the Environment Setting administrator passwords
The CONTROL-M/EM administrator is awarded full administrator privileges when CONTROL-M/EM is
installed. This also includes full DBO privileges for the CONTROL-M/EM database.
The following step must be run on each computer on which CONTROL-M/EM is installed, except those
with only client components that do not have the Reporting Facility installed.
To change the DBO password
Enter one of the following SQL commands:
For Sybase: sp_password oldPassword, newPassword, userName
For Oracle: alter userId identified by newPassword
For MSSQL: sp_password oldPassword, newPassword, userName
Run the cryptocli utility using the following syntax.
On UNIX: cryptocli ecs user_name new_password <EMHomedir>/ini/mcs.ini
On Windows: cryptocli user_name new_password windir\system32\mcs.ini
NOTE : This user name and encrypted password are stored in the mcs.ini file in the EMHome/ini/
directory on every computer on which CONTROL-M/EM server components are installed. Day-to-Day Administering of CONTROL-M : Day-to-Day Administering of CONTROL-M Control- M administration tasks Control- M administration tasks Day-to-Day Administering of CONTROL-M : Control- M administration tasks Day-to-Day Administering of CONTROL-M Starting, stopping, recycling and ignoring components
to start: In the CONTROL-M Configuration Manager, choose the component that you
want to start or stop, and right-click.
Choose Start or Stop as required. You can also choose Ignore if you do not want the
state of a specific component to be controlled by the CONTROL-M Configuration
To recycle a component
1 In the CONTROL-M Configuration Manager grid, choose the required component. You can only choose a component that is currently running (State: Up).
2 Right-click and choose Recycle.
Analyzing the state of components
Up Component is active (started).
Down Component is not active (stopped).
Hanging Component is not responding Control- M administration tasks Day-to-Day Administering of CONTROL-M : Control- M administration tasks Day-to-Day Administering of CONTROL-M Troubleshooting CONTROL-M/EM component states
You can use the Agents Log to understand the activation history of one or more components by selecting View => Agents Log in the CONTROL-M Configuration Manager. Special Administrative Actions : Special Administrative Actions Control- M administration tasks Control- M administration tasks Special Administrative Actions : Control- M administration tasks Special Administrative Actions Managing CONTROL-M data centers
Disabling a CONTROL-M/Agent
In the CONTROL-M Configuration Manager, right-click the required CONTROL-M/Agent, and choose Disable.
Enabling and disabling a CONTROL-M data center
Disabling a CONTROL-M data center is only relevant if the data center in unmanaged and inactive.
Right click the required CONTROL-M data center and choose Enable or Disable.
In the CONTROL-M Configuration Manager, highlight the required CONTROL-M data center, right-click and choose Delete.
check database space
In the CONTROL-M Configuration Manager, choose Database => Check space.
!Removing old alerts
In the CONTROL-M Configuration Manager, choose Database => Remove Old Alerts.
Click the Date drop down list, and choose the desired date.
Click OK. All alerts posted on or before the specified date are deleted from the CONTROL-M/EM database.
Cleaning up old global conditions
Run the ctmcontb utility to clean up old conditions Control- M administration tasks Special Administrative Actions : Control- M administration tasks Special Administrative Actions Column Description
Type The context of the system parameter. This can be a component type, task specific or a general parameter..
Name Name by which the parameter is recognized by CONTROL-M/EM processes.
Component Name of a CONTROL-M/EM component type that the system variable affects.
A value of * indicates that it affects all relevant components. Default: *
Comp. Name Name of the component. Maximum number of characters: 50 A value of * indicates that it affects all relevant components. Default: *
Note: This system parameter is activated only for the component whose logical name is specified.
Host Host name of the specified computer. Maximum number of characters: 100 Note: IP addresses are not supported.
A value of * indicates that it affects all relevant components. Default: *
Value Value of the system parameter. Maximum number of characters: 255
Last Update The date and time when the system parameter was last updated, based on local computer settings. Display purposes only. Configuring CONTROL-M/EM using system parameters
CONTROL-M Configuration Manager, choose Tools => System Parameters. The CONTROL-M/EM System Parameters window is displayed.
Adding a new system parameter
1 In the System Parameters window, click New. The New System parameter dialog box is displayed.
2 Specify values for the required parameters and click save
Select the required parameter, and click Update or Delete, as appropriate. If you are modifying an existing parameter, change the values as required, and click Save. Control- M administration tasks Special Administrative Actions : Control- M administration tasks Special Administrative Actions Changing security permissions for CONTROL-M/Server
You can configure CONTROL-M security definitions that are also maintained by the ctmsec security utility, from the CONTROL-M Configuration Manager
To change security permissions
In the CONTROL-M Configuration Manager, right-click an instance of CONTROL-M/Server, and choose CONTROL-M/Server Security. The CONTROL-M/Server Security dialog box is displayed.
Set CONTROL-M/Server security permissions as required, and click OK. Thanks : Thanks