Control-M/Server Management
The Control-M/Server management tab enables you to troubleshoot, manage, and monitor Control-M/Servers and their databases, Services, Agents, and Gateways, as described in the following procedures:
You can navigate to the Notification Destinations and Control-M/Server System Parameters from the Control-M/Servers toolbar, as described in Notification Destinations and Configuring Control-M/Server System Parameters.
Adding a Control-M/Server
This procedure describes how to add a Control-M/Server or Control-M for z/OS to your environment, which enables you to divide job workflows based on load balancing requirements, geographic distribution, or organizational structure.
Before You Begin
-
Verify that the Control-M/Server is unmanaged by a Control-M/EM, as described in Unmanaging a Control-M/Server.
Begin
-
From the
icon, select Configuration.
The Configuration domain opens.
-
From the
drop-down list, select Control-M/Servers.
The Control-M/Servers tab appears.
-
Click Add Server.
The Add Control-M/Server dialog box appears.
-
Select one of the following options and click Next:
-
Auto: Enables you to discover a Control-M/Server or Control-M for z/OS and its current definitions, assign it a logical name, and define its connection parameters.
Do the following:
-
From the Add Control-M/Server Automatic Configuration - Step 1 of 2 dialog box, define the Control-M/Server or Control-M for z/OS connection parameters, as described in Control-M/Server Component Parameters, and then click Next.
-
From the Add Control-M/Server Automatic Configuration - Step 2 of 2, click More Parameters, review the remaining Control-M/Server or Control-M for z/OS parameters, and then click Add.
The added Control-M/Server or Control-M for z/OS appears in the Control-M/Servers tab.
-
-
Manual: Enables you to add and redefine Control-M/Server or Control-M for z/OS.
Do the following:
-
From the Add Control-M/Server Manual Configuration dialog boxes, define the Control-M/Server or Control-M for z/OS parameters, as described in Control-M/Server Component Parameters, and then click Add.
The added Control-M/Server or Control-M for z/OS appears in the Control-M/Servers tab.
-
(Optional) To manage this Control-M/Server or Control-M for z/OS, which enables you to disable, pause, and redefine its states, see Managing a Control-M/Server.
The Control-M/Server or Control-M for z/OS is now managed.
-
-
Control-M/Server Component Parameters
The following table describes the parameters that enable you to add a Control-M/Server or Control-M for z/OS, as described in Adding a Control-M/Server.
Parameter |
Description |
---|---|
Name |
Defines the logical name of the Control-M/Server or Control-M for z/OS. Rules:
|
Host |
Defines the Control-M/Server or Control-M for z/OS hostname. |
ID |
Defines a unique three-character ID, such as 999 or NYC, which Default: The next available consecutive ID. |
Configuration Agent Port |
Defines the port number that the Configuration Agent uses to communicate with Control-M/EM, as described in Infrastructure Components. Default: 2369 |
Protocol |
Determines one of the following protocols that Control-M/Server or Control-M for z/OS uses to communicate with Control-M/EM:
|
Control-M/EM Port |
Defines the port number that Control-M/Server or Control-M for z/OS uses to communicate with Control-M/EM. Default: 2370 |
Description |
Defines a free-text description of the Control-M/Server or Control-M for z/OS. |
Contact |
Defines the name of the contact person who is responsible for the maintenance of this Control-M/Server or Control-M for z/OS. |
Platform |
Determines whether to add a Control-M/Server or Control-M for z/OS, as follows:
|
Version |
Determines one of the following Control-M/Server versions:
|
Control-M/EM Statistics |
Determines one of the following job attributes that is used as the key that collects statistics information:
The settings on the Control-M/Server computer must match these settings. |
Synchronization Mode |
Determines when data is synchronized between the Control-M/Server or Control-M for z/OS and Control-M/EM, as follows:
|
z/OS Attributes |
Determines whether job attribute fields must be completed in uppercase letters. |
Desired State |
Determines one of the following desired states of the Gateway:
|
Gateway Status Check Interval |
Determines the number of seconds to wait before Control-M/EM checks the status of the Gateway. Default: 20 |
Command Line Startup Flags |
Defines alternative parameters to deliver via the command line that start up the Gateway. There is no need to change this value unless directed by BMC Software. |
Time Zone |
Determines the time zone where the Control-M/Server or Control-M for z/OS is located. For more information, see Time Zones. You must unmanage the Control-M/Server or Control-M for z/OS to edit this attribute, as described in Unmanaging a Control-M/Server. |
First Day of the Week |
Determines the first day of the business week, as follows:
You must unmanage the Control-M/Server or Control-M for z/OS to edit this attribute, as described in Unmanaging a Control-M/Server. |
New Day Time |
Determines when the New Day You must unmanage the Control-M/Server or Control-M for z/OS to edit this attribute, as described in Unmanaging a Control-M/Server. |
Synchronize Daylight-Savings Time |
Determines whether the Control-M Configuration Server synchronizes the Control-M/Server or Control-M for z/OS time with daylight-savings time. You must unmanage the Control-M/Server or Control-M for z/OS to edit this attribute, as described in Unmanaging a Control-M/Server. |
Start |
Determines the calendar date that daylight-savings time begins. |
End |
Determines the calendar date that daylight-savings time ends. |
Managing a Control-M/Server
This procedure describes how to manage a Control-M/Server or Control-M for z/OS, which enables you to disable, pause, and change its states.
You cannot edit time settings when the Control-M/Server or Control-M for z/OS is managed.
Begin
-
From the
icon, select Configuration.
The Configuration domain opens.
-
From the
drop-down list, select Control-M/Servers.
The Control-M/Servers tab appears.
-
Select the relevant Control-M/Server or Control-M for z/OS from the Control-M/Servers toolbar, and then click Manage.
The Manage Control-M/Server dialog box appears.
-
Review the connection parameters, as described in Control-M/Server Component Parameters, and then click Manage.
This Control-M/Server or Control-M for z/OS is now managed and all Services are available.
Unmanaging a Control-M/Server
This procedure describes how to unmanage a Control-M/Server or Control-M for z/OS, which disenables you to disable, pause, or change its states.
Begin
-
From the
icon, select Configuration.
The Configuration domain opens.
-
From the
drop-down list, select Control-M/Servers.
The Control-M/Servers tab appears.
-
Select the relevant Control-M/Server or Control-M for z/OS and from the Control-M/Servers toolbar, click
and then click Unmanage.
The Control-M/Server or Control-M for z/OS is now unmanaged and all Services are now unavailable.
Pausing a Control-M/Server
This procedure describes how to pause a Control-M/Server or Control-M for z/OS, which enables you to keep jobs from executing until you resume the Control-M/Server.
The New Day procedure and User Dailies still run on paused Control-M/Servers and Control-M for z/OS environments, but newly run jobs do not execute until you resume.
Begin
-
From the
icon, select Configuration.
The Configuration domain opens.
-
From the
drop-down list, select Control-M/Servers.
The Control-M/Servers tab appears.
-
From the Control-M/Servers tab, select the relevant Control-M/Server or Control-M for z/OS, and from the Control-M/Servers toolbar click Pause.
A Pause Control-M/Server confirmation dialog box appears.
-
Click Pause.
The Control-M/Server or Control-M for z/OS remains up, but jobs do not execute until you reselect the Control-M/Server or Control-M for z/OS, and from the Control-M/Servers toolbar, click Resume.
Disabling a Control-M/Server
This procedure describes how to disable a Control-M/Server or Control-M for z/OS. This removes the ability to sync new folder and job definitions and monitor and manage the Control-M/Server or Control-M for z/OS and its components.
Begin
-
From the
icon, select Configuration.
The Configuration domain opens.
-
From the
drop-down list, select Control-M/Servers.
The Control-M/Servers tab appears.
-
From the Control-M/Servers tab, select the relevant Control-M/Server or Control-M for z/OS, and then from the Control-M/Servers toolbar click Disable.
A Disable Control-M/Server confirmation dialog box appears.
-
Click Disable.
The Control-M/Server or Control-M for z/OS remains up, but you can neither monitor and manage it and its components, nor define and run new jobs until you reselect the Control-M/Server or Control-M for z/OS, and from the Control-M/Servers toolbar, click Enable.
Recycling a Control-M/Server
This procedure describes how to recycle (restart) a Control-M/Server or Control-M for z/OS.
Begin
-
From the
icon, select Configuration.
The Configuration domain opens.
-
From the
drop-down list, select Control-M/Servers.
The Control-M/Servers tab appears.
-
From the Control-M/Servers tab, select the relevant Control-M/Server or Control-M for z/OS, from the Control-M/Servers toolbar click Desired State, and then click Recycle.
A Recycle Control-M/Server confirmation dialog box appears.
-
Click Recycle.
The Desired State of the Control-M/Server or Control-M for z/OS changes to Recycle, the Actual State changes to Down and then Up, and then the Desired State reverts to Up.
Starting Up the Control-M/Server
This procedure describes how to start up a Control-M/Server or Control-M for z/OS. This instructs the Configuration Agent to attempt to start up the Control-M/Server or Control-M for z/OS when it is down, which enables it to communicate with other components and schedule jobs.
Begin
-
From the
icon, select Configuration.
The Configuration domain opens.
-
From the
drop-down list, select Control-M/Servers.
The Control-M/Servers tab appears.
-
From the Control-M/Servers tab, select the relevant Control-M/Server or Control-M for z/OS, from the Control-M/Servers toolbar click Desired State, and then click Up.
A Set Desired State to Up confirmation dialog box appears.
-
Click Set to Up.
The Desired State and then the Actual State of the Control-M/Server or Control-M for z/OS changes to Up.
Shutting Down the Control-M/Server
This procedure describes how to shut down a Control-M/Server or Control-M for z/OS. This instructs the Configuration Agent to attempt to shut down the Control-M/Server or Control-M for z/OS when it is up, which disables communication with other components and removes the ability to schedule jobs.
Begin
-
From the
icon, select Configuration.
The Configuration domain opens.
-
From the
drop-down list, select Control-M/Servers.
The Control-M/Servers tab appears.
-
From the Control-M/Servers tab, select the relevant Control-M/Server or Control-M for z/OS, from the Control-M/Servers toolbar click Desired State, and then click Down.
A Set Desired State to Down confirmation dialog box appears.
-
Click Set to Down.
The Desired State and then the Actual State of the Control-M/Server or Control-M for z/OS changes to Down.
Ignoring a Control-M/Server
This procedure describes how to ignore a Control-M/Server or Control-M for z/OS. This instructs the Configuration Agent to make no attempts to change the state of a Control-M/Server or Control-M for z/OS.
Begin
-
From the
icon, select Configuration.
The Configuration domain opens.
-
From the
drop-down list, select Control-M/Servers.
The Control-M/Servers tab appears.
-
From the Control-M/Servers tab, select the relevant Control-M/Server or Control-M for z/OS, from the Control-M/Servers toolbar click Desired State, and then click Ignore.
A Set Desired State to Ignore confirmation dialog box appears.
-
Click Set to Ignore.
The Desired State and then the Actual State of the Control-M/Server or Control-M for z/OS changes to Ignored.
Recycling a Service
This procedure describes how to recycle (restart) a Control-M Service.
Begin
-
From the
icon, select Configuration.
The Configuration domain opens.
-
From the
drop-down list, select Control-M/Servers.
The Control-M/Servers tab appears.
-
From the Control-M/Servers tab, select the relevant Control-M/Server or Control-M for z/OS, and then from the Services Status column click the status message.
The Services dialog box appears.
-
From the Service Type column in the Services tab, select the relevant Service, and then from the Recycle Service column click Recycle.
A Recycle Service confirmation dialog box appears.
-
Click Recycle.
The Service recycles and its new State and Desired State appears in the Services tab.