This section explains how to define a new CONTROL-M/EM component and how to
update component properties.
Defining a new CONTROL-M/EM component
1 In the CONTROL-M Configuration Manager, choose Components => New =>
CONTROL-M/EM Component.
2 Fill in the CONTROL-M/EM Component dialog box:
Defining a new CONTROL-M/EM component
A At Desired State, select one of the following states:
■ Up if you want the component to be started
■ Down if you do not want the CONTROL-M Configuration Manager to start
■ the component.
BIM (Batch Impact Manager server)
GAS (Global Alerts server)
GCS (Global Conditions server)
GUI_Server
Forecast_Server
Enter the name of the component.
Optional for the GAS and GUI servers, and not relevant for the GCS server.
When defining a BIM or Forecast_Server component, you must enter the name
of the GUI server with which the component will communicate.
Observe the following guidelines when choosing a name for a new server:
■ You can define multiple GUI servers and multiple GAS servers to run
simultaneously. (These capabilities allow you to balance job loads as needed in
your environment.) These servers can run on the same account or on different
hosts. Each instance of a GUI server (or GAS server) must have a unique name.
The GUI Server name and the GAS server name are used to reference both
components when using the CONTROL-M/EM client components.
■ You can specify any logical name for an instance of either component. For
example, you can enter the virtual host name of a cluster computer in which the
GUI Server (or Global Alerts Server) is installed, without specifying the node on
which the component is installed.
■ By default, the GUI Server is named according to its host name. Thus, if more
than one GUI Server exists on the same host, each instance must have a unique
name.
3 Complete the Running on box:
A At Platform, select the operating system for the host computer on which the
component runs.
B At Host Name, enter the name of the host computer.
Updating a previously defined component
4 At Check Interval, enter how frequently, in number of seconds, you want to check
the component’s state.
5 (optional) In the Startup box, indicate the mode in which the component should
start:
■ To use a startup command other than the default, select the Override Manually
check box and enter a command in the Command box.
■ If you want to use optional arguments for the startup command, enter them in
the Additional Parameters box.
Updating a previously defined component
1 In the Component window of the Configuration Manager, right-click the
component and select Properties.
2 Modify the values as needed, and click OK.
Defining a CONTROL-M/Server and its Gateway
CONTROL-M refers to an instance of CONTROL-M/Server and its corresponding
Gateway.
When adding a new CONTROL-M/Server and its Gateway, you can use automatic
discovery or manual definition:
Automatic discovery bases the new server on an existing CONTROL-M, retrieving
the parameter values and requiring minimal information from you.
Defining a CONTROL-M/Server (automatic discovery method)
Defining a CONTROL-M/Server (automatic discovery method)
NOTE
This method is valid only for CONTROL-M/Server versions 6.3.01 and higher.
1 In the CONTROL-M Configuration Manager, choose Components => New =>
CONTROL-M/Server and Gateway.
2 In the CONTROL-M/Server Definition dialog box, choose Discover.
3 In the wizard, specify the CONTROL-M/Server connection parameters:
A At CONTROL-M Name, enter the logical name of the required CONTROL-M.
B At CONTROL-M ID, accept the default unique code or enter a unique 3-digit
code identifying the CONTROL-M/Server.
C At CONTROL-M Host, enter the name of the host computer on which the
CONTROL-M is installed.
D At Configuration Agent Port, enter the port number of the CONTROL-M’s
Configuration Agent.
E Click Next.
The discovery process begins. CONTROL-M automatically retrieves parameters
and shows how the discovery is progressing.
4 When the Step 3 wizard panel is displayed, ensure that Activate Gateway is
selected.
5 Review the list of retrieved parameters, and click Finish.
The new CONTROL-M is displayed in the CONTROL-M Configuration Manager
after a short period of time.
Defining a CONTROL-M/Server (manual definition method)
1 Perform one of the following in the CONTROL-M Configuration Manager:
■ To modify the definition of an existing CONTROL-M/Server, right click the
server, and choose Properties.
■ To define a new CONTROL-M/Server
— Choose Components => New => CONTROL-M/Server and Gateway.
— In the prompt, choose Define to display the CONTROL-M Definition dialog
box.
CONTROL-M Definition dialog box
2 Fill in the CONTROL-M Definition dialog box. Table 4 describes the essential
parameter values that you need to provide.
Defining a CONTROL-M/Server (manual definition method)
Table 4
Parameters for manually defining a CONTROL-M/Server and its Gateway
Parameter field Description
Name descriptive name for the CONTROL-M/Server
You should choose a name that is meaningful enough to identify your CONTROL-M.
For example, if the CONTROL-M handles workloads for Division 7, which is associated
with the company’s headquarters in Paris, you might use HQ_PARIS_DIVISION-07.
The name can be a maximum of 20 alphanumeric characters long. You can include
symbols, but do not use blank spaces.
unique 3-character code (such as 999 or NYC) that CONTROL-M/EM uses to identify
each CONTROL-M/Server ID
The code must be unique. It can consist of numerals and uppercase letters.
operating system on which your CONTROL-M is installed. Note the following:
Platform
■ If your platform is UNIX, Windows, TANDEM, or not listed, choose Distributed.
■ If your CONTROL-M runs on iSeries (AS/400) but any of the connecting
CONTROL-M/Agents run on non-iSeries operating systems, choose Distributed.
version number of the CONTROL-M/Server Version
Note: When defining an iSeries (AS/400) CONTROL-M, choose 225.
Time Zone time zone in which the CONTROL-M is located
Start day day that CONTROL-M/Server should consider to be the first day of the week
New Day Time the time that each new day should begin for the CONTROL-M/Server
Communication type of protocol for communication with CONTROL-M
Protocol
Communication host name of the CONTROL-M Host
Communication TCP/IP port for communicating with CONTROL-M/EM
CONTROL-M/E
M Port
For specific instructions pertaining to CONTROL-M installations on z/OS, see the
INCONTROL for z/OS Installation Guide.
3 If you are defining a new CONTROL-M/Server, under Gateway, click New. You
must specify a Gateway when you set up your work environment. Otherwise, you
can define a new gateway, or modify or delete an existing gateway.
The CONTROL-M/EM Component dialog box is displayed.
4 Specify the required parameters.
Chapter 2 Connecting components
A At Desired State, select one of the following states:
■ Up if you want the gateway to be started
■ Down if you do not want the CONTROL-M Configuration Manager to start
■ the gateway.
B Enter the name of the gateway. You can define multiple gateways for a
CONTROL-M/Server, but only one CONTROL-M can be up (started) at one
time. Additionally, each Gateway should be located on a separate computer.
C In the Platform field, select the operating system for the host computer on which
the component runs.
D In the Host Name, enter the name of the host computer.
E In the Check Interval field, enter how frequently, in seconds, to check the
gateway’s state.
F (optional) In the Startup box, indicate the mode in which the gateway should
start:
■ To use a startup command other than the default, select the Override
Manually check box and enter a command in the Command box.
■ You want enter optional arguments for the startup command in the
Additional Parameters box.
G Click OK to save the changes you made in the CONTROL-M/EM Component
dialog box.
5 Click OK in the CONTROL-M Definition dialog box to save your
CONTROL-M/Server definition.
This section explains how to add a new agent to an existing CONTROL-M, and if and
how to configure and manage remote hosts.
Planning your strategy
Completing this section can help you expedite the remaining tasks in this chapter.
This section summarizes prerequisites that you should know about before connecting
components. The provided worksheets also help you gather data that you will need
to provide for tasks in this chapter.
Before proceeding, ensure that you comply with the following requirements and
guidelines.
Deciding whether to define remote hosts
Both CONTROL-M/Agents and remote hosts have distinct advantages. Consider the
following before deciding which method to use on a particular computer:
■ The main advantage of remote hosts over CONTROL-M/Agents is that remote
hosts:
— Can run all jobs assigned to the specific node ID which identifies the remote
computer
— Do not require CONTROL-M/Agent installation on the remote computer
— Do not require version updates
— Require less management
■ The main advantages of CONTROL-M/Agents over remote hosts are that agents
support counters and multiple types of shouts:
— CONTROL-M/Agents can utilize features that require a CONTROL-M counter.
If you need any of these features, you should choose a CONTROL-M/Agent
over a remote host. For example, CONTROL-M/Agents can use the File
Watching feature, run jobs using CONTROL-M/Agent utilities, and run jobs
requiring Control Modules (plug-ins for the CONTROL-M/Agent).
— CONTROL-M/Agents support many types of shouts. (Remote host support is
limited to e-mail shouts and CONTROL-M/Server shouts.)
Planning your strategy
■ To use remote hosts, the CONTROL-M/Server must be in Managed state:
— If you discover the CONTROL-M, its default state is Managed.
— If you define the CONTROL-M, the default state is Unmanaged, and you must
change it to Managed via the CONTROL-M Configuration Manager.
Choosing a connection method for a remote host
To enable communication between the remote host and a CONTROL-M/Agent. You
can use either of the following connection methods, which are available with the
operating system:
■ Secured Shell (SSH)
You can use SSH connections for remote hosts running UNIX, Windows,
OpenVMS, Z/OS USS (OpenEdition) and PASE (AIX environment) on AS/400:
— Most UNIX operating system packages include SSH.
— To use SSH on Windows computers, you must purchase and install it
separately.
— SSH functionality on OpenVMS is available as part of TCP/IP Services Version
5.4 and higher. For older versions of OpenVMS, you must install it separately.
Third party packages are also available.
— To use SSH on AS/400 computers, you must install PASE on AS/400.
NOTE
When you work with z/OS USS (OpenEdition) or PASE AS/400 remote hosts, set the
RJX_CONN_MODE system parameter in CONTROL-M/Agent to 0.
If you will be using more simultaneous connections than your current SSH server
settings allow, you must increase the value for these settings accordingly.
EXAMPLE
For an OpenSSH server, set the MaxStartups and LoginGraceTime parameters in the
sshd_config file.
Planning your strategy
■ Window Management Instrumentation (WMI)
You can use WMI connections with remote hosts running Windows 2003,
Windows XP, or a later version. WMI is part of the Windows operating system.
NOTE
If the CONTROL-M/Agent will be connecting to a remote host on Windows by using the
WMI connection method, ensure that the following requirements are satisfied:
■ The CONTROL-M/Agent is installed on either Windows 2003, Windows XP, or a later
version.
■ The Log On as option for the CONTROL-M/Agent service is set to This account.
■ The user account that is running the CONTROL-M/Agent service is Administrator and
is defined as a Domain user.
■ Job owners are members of the Administrator group on the remote host.
Consider the following requirements when deciding which connection method to use
for remote hosts:
■ For Window Management Instrumentation (WMI) connections, the following
requirements apply:
— To use On statements and the View JCL, Edit JCL, and View Sysout options, you
must define a directory named SYSOUT on the remote host. This directory must
be writable by all the job owners on that host. This directory must also be shared
so that the CONTROL-M/Agent user can access it for reading and writing.
When defining the properties of a remote host, specify the full local path (for
example, C:\shared documents\SYSOUT) of this directory so that the job output
will be written to it.
— SYSOUTs created on remote hosts must be copied to a CONTROL-M/Agent. If
a SYSOUT is large, its file transfer can place a heavy load on system resources.
Also, a job will not end until its SYSOUT copying is finished.
■ For Secured Shell (SSH) connections, you must ensure that an SSH Server is
installed and running on each remote host.
A CONTROL-M/Agent should be installed first before it is defined. For information about
installing CONTROL-M/Agents, see the CONTROL-M Installation Guide.
1 From the CONTROL-M Configuration Manager, perform one of the following:
■ To modify the parameters of an existing CONTROL-M/Agent, right click the
agent and choose Properties.
The CONTROL-M/Agent Properties dialog box is displayed.
■ To add a new CONTROL-M/Agent to a CONTROL-M/Server, right click the
CONTROL-M/Server and choose New CONTROL-M/Agent.
The Add CONTROL-M/Agent dialog box is displayed. Fill in the name for the
agent. Click Advanced.
2 In the appropriate dialog box, fill in the fields in the General, Persistent Connection
and Retry/Timeout tabs.