Control-M/Server Management

The Control-M/Server management pane enables you to troubleshoot, manage, and monitor Control-M/Servers and their databases, Services, Agents, and Gateways, as described in the following procedures:

• Adding a Control-M/Server

• Managing a Control-M/Server

• Unmanaging a Control-M/Server

• Pausing a Control-M/Server

• Disabling a Control-M/Server

• Recycling a Control-M/Server

• Setting the Control-M/Server Desired State to Up

• Setting the Control-M/Server Desired State to Down

• Setting the Control-M/Server Desired State to Ignore

• Recycling a Service

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, as described in Unmanaging a Control-M/Server.

Begin

1. From the icon, select Configuration.

   The Configuration domain appears.

2. From the drop-down list, select Control-M/Servers.

   The Control-M/Servers pane appears.

3. Click Add Server.

   The Add Control-M/Server dialog box appears.

4. 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:

     1. 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.

     2. 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 pane.

   • Manual: Enables you to add and redefine Control-M/Server or Control-M for z/OS.

     Do the following:

     1. 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 pane.

     2. (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: Alphanumeric Latin Characters: 1–20 Case-Sensitive: Yes Invalid Characters: Whitespace, %, &, (, ), $, ;, <, >, /, `, *, and \.
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 Control-M/EM uses to identify each Control-M/Server or Control-M for z/OS. 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: TCP: A transmission control protocol (TCP) is a basic communications standard that is designed to transfer data between applications and devices. SSL: A Secure Sockets Layer (SSL) is a security protocol that runs on top of a communication protocol, such as TCP, and encrypts data that passes between applications and devices.
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: Distributed: Control-M/Server is installed on a UNIX or Windows operating system. z/OS: Control-M/Server is installed on a z/OS mainframe operating system.
Version	Determines one of the following Control-M/Server versions: 921: Control-M/Server or Control-M for z/OS 9.0.21.xxx. 920: Control-M/Server or Control-M for z/OS 9.0.20.xxx. 919: Control-M/Server or Control-M for z/OS 9.0.19.xxx.
Control-M/EM Statistics	Determines one of the following job attributes that is used as the key that collects statistics information: Job Name: Defines the job name on a Control-M/Server. Member Name: Defines the job name on a Control-M for z/OS. A member is a partition of a partitioned data set (PDS) or partitioned data set extended (PDSE) that contains programs, parts of a program, or data. 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: No Synchronization: Does not synchronize. To manually synchronize, you can perform any of the following procedures: Downloading the Control-M/Server Data to Control-M/EM Uploading the Control-M/EM Data to All Control-M/Servers Creating a Regular or Relative Calendar Update Control-M/Server Definitions during Check-In: Only synchronizes Workspace and calendar changes with the Control-M/Server or Control-M for z/OS when Workspaces are checked in. Update Control-M/Server Only: Only synchronizes changes in Control-M/EM with the Control-M/Server or Control-M for z/OS. Changes to this Control-M/Server or Control-M for z/OS are not synchronized with Control-M/EM. Update Control-M/Server and Control-M/EM: Fully synchronizes all Control-M/EM and Control-M/Server or Control-M for z/OS changes with each other.
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: Up: Configuration Agent attempts to start up the Gateway when it is down, which enables it to communicate with other components. Down: Configuration Agent attempts to shut down the Gateway when it is up, which removes its ability to communicate with other components. Ignored: Configuration Agent does not attempt to start up or shut down 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: Monday Tuesday Wednesday Thursday Friday Saturday Sunday 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 A Control-M process that begins every day at midnight, adds jobs and folders to the Run Queue for the day that is about to begin, and removes jobs and folders from previous days. procedure begins, as described in New Day Procedure. 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.

Begin

1. From the icon, select Configuration.

   The Configuration domain appears.

2. From the drop-down list, select Control-M/Servers.

   The Control-M/Servers pane appears.

3. 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.

4. 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, and change its states.

Begin

1. From the icon, select Configuration.

   The Configuration domain appears.

2. From the drop-down list, select Control-M/Servers.

   The Control-M/Servers pane appears.

3. 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.

Begin

1. From the icon, select Configuration.

   The Configuration domain appears.

2. From the drop-down list, select Control-M/Servers.

   The Control-M/Servers pane appears.

3. From the Control-M/Servers pane, 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.

4. 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

1. From the icon, select Configuration.

   The Configuration domain appears.

2. From the drop-down list, select Control-M/Servers.

   The Control-M/Servers pane appears.

3. From the Control-M/Servers pane, 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.

4. 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

1. From the icon, select Configuration.

   The Configuration domain appears.

2. From the drop-down list, select Control-M/Servers.

   The Control-M/Servers pane appears.

3. From the Control-M/Servers pane, 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.

4. 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.

Setting the Control-M/Server Desired State to Up

This procedure describes how to set the desired state of a Control-M/Server or Control-M for z/OS to Up. 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

1. From the icon, select Configuration.

   The Configuration domain appears.

2. From the drop-down list, select Control-M/Servers.

   The Control-M/Servers pane appears.

3. From the Control-M/Servers pane, 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.

4. 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.

Setting the Control-M/Server Desired State to Down

This procedure describes how to set the desired state of a Control-M/Server or Control-M for z/OS to Down. 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

1. From the icon, select Configuration.

   The Configuration domain appears.

2. From the drop-down list, select Control-M/Servers.

   The Control-M/Servers pane appears.

3. From the Control-M/Servers pane, 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.

4. 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.

Setting the Control-M/Server Desired State to Ignore

This procedure describes how to set the desired state of a Control-M/Server or Control-M for z/OS to Ignore. 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

1. From the icon, select Configuration.

   The Configuration domain appears.

2. From the drop-down list, select Control-M/Servers.

   The Control-M/Servers pane appears.

3. From the Control-M/Servers pane, 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.

4. 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 recycle (restart) a Control-M Service. For more information, see Control-M Services.

Begin

1. From the icon, select Configuration.

   The Configuration domain appears.

2. From the drop-down list, select Control-M/Servers.

   The Control-M/Servers pane appears.

3. From the Control-M/Servers pane, 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.

4. From the Service Type column in the Services pane, select the relevant Service, and then from the Recycle Service column click Recycle.

   A Recycle Service confirmation dialog box appears.

5. Click Recycle.

   The Service recycles and its new State and Desired State appears in the Services pane.