Control-M Installation Guide

CONTROL-M
Installation Guide
Book 3 – Configuration
Version 6.1.01
June 20, 2002

Copyright 2002 BMC Software, Inc., as an unpublished work. All rights reserved.
BMC Software, the BMC Software logos, and all other BMC Software product or service names are registered
trademarks or trademarks of BMC Software, Inc. IBM is a registered trademarks of International Business
Machines Corp.; Oracle is a registered trademark, and the Oracle product names are registered trademarks or
trademarks of Oracle Corp. All other registered trademarks or trademarks belong to their respective companies.
THE USE AND CONTENTS OF THIS DOCUMENTATION ARE GOVERNED BY THE SOFTWARE
LICENSE AGREEMENT ENCLOSED AT THE BACK OF THIS DOCUMENTATION.
Restricted Rights Legend

U.S. GOVERNMENT RESTRICTED RIGHTS. UNPUBLISHED–RIGHTS RESERVED UNDER THE
COPYRIGHT LAWS OF THE UNITED STATES. Use, duplication, or disclosure by the U.S. Government is
subject to restrictions set forth in FAR Section 52.227-14 Alt. III (g)(3), FAR Section 52.227-19, DFARS
252.227-7014 (b), or DFARS 227.7202, as amended from time to time. Contractor/Manufacturer is BMC
Software, Inc., 2101 CityWest Blvd., Houston, TX 77042-2827, USA. Any contract notices should be sent to this
address.
Contacting BMC Software

You can access the BMC Software Web site at http://www.bmc.com. From this Web site, you can obtain
information about the company, its products, corporate offices, special events, and career opportunities.
United States and Canada Outside United States and Canada
Address BMC Software, Inc. Telephone (01) 713 918 8800
2101 CityWest Blvd.
Houston TX 77042-2827 Fax (01) 713 918 8000
Telephone 713 918 8800 or
800 841 2031
Fax 713 918 8000
Customer Support
You can obtain technical support by using the Support page on the BMC Software Web site or by contacting
Customer Support by telephone or e-mail. To expedite your inquiry, please see “Before Contacting BMC
Software.”
Support Web Site

You can obtain technical support from BMC Software 24 hours a day, 7 days a week at
http://www.bmc.com/support.html. From this Web site, you can
• read overviews about support services and programs that BMC Software offers
• find the most current information about BMC Software products
• search a database for problems similar to yours and possible solutions
• order or download product documentation
• report a problem or ask a question
• subscribe to receive e-mail notices when new product versions are released
• find worldwide BMC Software support center locations and contact information, including e-mail addresses,
fax numbers, and telephone numbers
Support by Telephone or E-mail

In the United States and Canada, if you need technical support and do not have access to the Web, call
800 537 1813. Outside the United States and Canada, please contact your local support center for assistance. To
find telephone and e-mail contact information for the BMC Software support center that services your location,
refer to the Contact Customer Support section of the Support page on the BMC Software Web site at
www.bmc.com/support.html.
Before Contacting BMC Software

Before you contact BMC Software, have the following information available so that Customer Support can begin
working on your problem immediately:
• product information
— product name
— product version (release number)
— license number and password (trial or permanent)
• operating system and environment information
— machine type
— operating system type, version, and service pack or other maintenance level such as PUT or PTF
— system hardware configuration
— serial numbers
— related software (database, application, and communication) including type, version, and service pack or
maintenance level
BMC Software, Inc., Confidential and Proprietary Information
iii
• sequence of events leading to the problem
• commands and options that you used
• messages received (and the time and date that you received them)
— product error messages
— messages from the operating system, such as file system full
— messages from related software
iv CONTROL-M Installation Guide - Book 3

Contents
Contents
About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Chapter 1 Introduction
Chapter 2 Post-Installation Configuration

On Unix Computers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Check the Database Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Start CONTROL-M/EM Components . . . . . . . . . . . . . . . . . . . . 2-2
Start CONTROL-M/Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Check the CONTROL-M/EM to CONTROL-M Port Number . 2-3
On the Microsoft Windows Computer . . . . . . . . . . . . . . . . . . . . . . . 2-5
Register CONTROL-M/EM Server Components . . . . . . . . . . . . 2-5
Create CONTROL-M Definitions in CONTROL-M/EM . . . . . . 2-7
Register Gateways for Communication With CONTROL-M/Server
2-9
Create CONTROL-M Definitions in CONTROL-M/Desktop . . 2-10
Show Extra Keyboard Help in Programs . . . . . . . . . . . . . . . . . . 2-12
Chapter 3 Troubleshooting
CONTROL-M/EM Installation on Unix . . . . . . . . . . . . . . . . . . . . . . 3-2
CONTROL-M/EM Installation on Microsoft Windows . . . . . . . . . . 3-5
CONTROL-M/Server for Unix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
Oracle Database Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
Sybase Database Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17
Contents v
Chapter 4 Uninstalling CONTROL-M/EM On Unix Computers
Chapter 5 Uninstalling CONTROL-M/EM On Windows Computers

Selecting Components to Remove . . . . . . . . . . . . . . . . . . . . . . . . . . .5-1
Uninstall the Actuate User Desktop . . . . . . . . . . . . . . . . . . . . . . . . . .5-9
Completing Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12
Chapter 6 Uninstalling CONTROL-M/Server for Unix

Running the utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-1
Cleanup After Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-3
Chapter 7 Uninstalling CONTROL-M/Server for Microsoft Windows

Uninstalling CONTROL-M/Server – Windows NT . . . . . . . . . .7-2
Uninstalling CONTROL-M/Server – Windows 2000 . . . . . . . . .7-5
Chapter 8 Uninstalling CONTROL-M/Agent for Microsoft Windows
Index
vi CONTROL-M Installation Guide - Book 3

Figures
Figures
Figure 3-1 Microsoft SQL Server Enterprise Manager . . . . . . . . . . . . . . . . 3-6

Figure 3-2 SQL Server Properties Window. . . . . . . . . . . . . . . . . . . . . . . . . 3-7
Figure 3-3 SQL Query Server Analyzer Window . . . . . . . . . . . . . . . . . . . . 3-8
Figures vii
viii CONTROL-M Installation Guide - Book 3

Tables
Tables
Table 2-1 Fields in the CONTROL-M Dialog Box . . . . . . . . . . . . . . . . . . 2-11

Table 3-1 CONTROL-M/Server for Unix Troubleshooting . . . . . . . . . . . 3-11
Tables ix
x CONTROL-M Installation Guide - Book 3

About . . .
About This Book
This book is Part 3 of the CONTROL-M Installation Guide. It describes

how to configure CONTROL-M products after installation is complete.
This book also includes procedures for installation troubleshooting and
for uninstallation of CONTROL-M products.
How This Book Is Organized

This book is organized as follows. In addition, a glossary of terms and an
index appear at the end of the book.
Chapter Description
Chapter 1 Introduction
Describes the purpose of this book and how it fits into the
CONTROL-M installation process.
Chapter 2 Post-Installation Configuration
Describes the how to perform configuration tasks after all
necessary CONTROLM products have been installed.
Chapter 3 Troubleshooting
Describes how to recover from and avoid problems that
may occur during installation of CONTROL-M products.
Chapter 4 Uninstalling CONTROL-M/EM On Unix Computers
Describes how to remove CONTROL-M/EM from a Unix
computer.
xi
Chapter Description
Chapter 5 Uninstalling CONTROL-M/EM On Windows Computers
Describes how to remove CONTROL-M/EM components
from a Microsoft Windows computer.
Chapter 6 Uninstalling CONTROL-M/Server for Unix
Describes how to remove CONTROL-M/Server from a
Unix computer.
Chapter 7 Uninstalling CONTROL-M/Server for Microsoft
Windows
Describes how to remove CONTROL-M/Server from a
Microsoft Windows computer.
Chapter 8 Uninstalling CONTROL-M/Agent for Microsoft
Windows
Describes how to remove CONTROL-M/Agent from a
Microsoft Windows computer.
xii CONTROL-M Installation Guide - Book 3

Related Documentation
The following table lists other BMC publications that are relevant to
Enterprise Controlstation.
• CONTROL-M Quick Installation Guides describe a default

installation of CONTROL-M Scheduling solution. Each of these
guides is intended for trial and proof-of-concept implementations on
a specific default configuration (for example a Unix-based
installation).
• CONTROL-M/Enterprise Manager User Guide describes

CONTROL-M/EM concepts, features, facilities, and operating
instructions. It can be used as a learning guide as well as a reference
guide.
• CONTROL-M/Desktop User Guide describes an application used

to define and manage CONTROL-M job processing definitions,
Scheduling tables, and Calendars.
• CONTROL-M/Enterprise Manager Administrator Guide

describes the tasks that the ENTERPRISE/CS administrator must
perform to define and to monitor and maintain the ENTERPRISE/CS
environment.
• CONTROL-M/Server Administrator Guides each describe setup,

maintenance, and security, for CONTROL-M/Server on a specific
type of computer (e.g., Unix or Microsoft Windows).
• CONTROL-M User Manual (for OS/390) is a complete guide to

the CONTROL-M Production Control System in a mainframe
environment.
xiii
Online and Printed Books
The books that accompany BMC Software products are available in
online format and printed format. You can view online books with
Acrobat Reader from Adobe Systems. The reader is provided at no cost,
as explained in “To Access Online Books.” You can also obtain
additional printed books from BMC Software, as explained in “To
Request Additional Printed Books.”
To Access Online Books
Online books are provided as Portable Document Format (PDF) files.

You can view them, print them, or copy them to your computer by using
Acrobat Reader 3.0 or later. You can access online books from the
documentation compact disc (CD) that accompanies your product or
from the World Wide Web.
In some cases, installation of Acrobat Reader and downloading the

online books is an optional part of the product-installation process. For
information about downloading the free reader from the Web, go to the
Adobe Systems site at http://www.adobe.com.
To view any online book that BMC Software offers, visit the support
page of the BMC Software Web site at http://www.bmc.com/support.html.
Log on and select a product to access the related documentation. (To log
on, first-time users can request a user name and password by registering
at the support page or by contacting a BMC Software sales
representative.)
To Request Additional Printed Books
BMC Software provides a core set of printed books with your product
order. To request additional books, go to
http://www.bmc.com/support.html.
xiv CONTROL-M Installation Guide - Book 3

Online Help
You can access Help for a product through the product’s Help menu. The
online Help provides information about the product’s graphical user
interface (GUI) and provides instructions for completing tasks.
Release Notes
Printed release notes accompany each BMC Software product. Release

notes provide up-to-date information such as
• updates to the installation instructions

• last-minute product information
The latest versions of the release notes are also available on the Web at
http://www.bmc.com/support.
xv
Conventions
The following abbreviations are used in this guide:
Abbreviation Description
CONTROL-M/EM CONTROL-M/Enterprise Manager
The following conventions are used in this guide:
<key> When describing keystrokes, angle brackets are

used to enclose the name of a key (for
example, <F1>). When two keys are joined with “+”
as in <Shift>+<F1>, hold down <Shift> while
pressing <F1>.
Menu => Option This represents an option selection sequence. For
example,
Users and Groups => Groups => Add
means that you first select Users and Groups from

the menu bar. Select the Groups option from the
submenu. Finally, select the Add option from the
Groups submenu.
{Option A|Option B} The vertical bar is used to separate choices. For
example:
{AND|OR}
means that you specify either AND or OR.

[Option] Square brackets are used to enclose parameters
that are optional.
Code Samples Format syntax, operating system terms,
examples, and JCL scripts are
presented in this typeface.
xvi CONTROL-M Installation Guide - Book 3

Italics Italic type is used to emphasize important terms.
The titles of BMC Software product documentation
are also displayed in italic type.
Option Symbol A vertical bar ( | ) separating items indicates that
you must choose one item. In the following
example, you would choose a, b, or c:
a|b|c
xvii
xviii CONTROL-M Installation Guide - Book 3

1
Introduction 1
This book describes how to configure your CONTROL-M environment.

Additional chapters in this book also describe how to troubleshoot a
failed installation, and if necessary, how to remove it.
Note
Before performing the configuration steps in this book, ensure that you
have completed installation of all CONTROL-M components (as
described in “Book 2 – Installation Procedures” of the CONTROL-M
Installation Guide).
For more information about the process of installing CONTROL-M

products, see Book 1 – Planning and Preparation of the CONTROL-M
Installation Guide.
Introduction 1-1
1-2 CONTROL-M Installation Guide - Book 3

2
Post-Installation Configuration 2
After you have installed all the necessary CONTROL-M products at your
site, there are certain configuration tasks that must be performed. These
tasks ensure that the various elements of the CONTROL-M scheduling
solution are active and able to communicate with each other.
Post-Installation Configuration 2-1

Step 1 – On Unix Computers
Perform the following steps on each Unix computer on which you
installed CONTROL-M/Server and/or CONTROL-M/EM components:
1.0.1 Log in to the unix account for CONTROL-M/EM.
Step 1.1 – Check the Database Server
1.1.1 If the Database was installed on Unix, use one of the following
commands to verify that the database server is active:
• For Sybase: isql -U <em_user> -P <password>

• For Oracle: sqlplus <em_user>/<password>
where <em_user> is the user name under which CONTROL-M/EM was

installed, and <password> is that user’s password for CONTROL-M/EM
(Default: empass).
If the database server is active an appropriate prompt is displayed.
1.1.2 Type quit to exit the database server.
Step 1.2 – Start CONTROL-M/EM Components
1.2.1 Use the following steps to verify that the Orbix service is active.
A: Enter the root_menu command.
B: You are asked for the CONTROL-M/EM user name and password.
Enter them in order to continue.
C: Select and display the Activation Menu from the list of available
menus.
D: Select the Check All option.

1.2.2 Select the Start All option from the Activation Menu (the same menu as
in the previous step) to activate the CONTROL-M/EM components.
Step 1.3 – Start CONTROL-M/Server
1.3.1 Log in to the Unix account for CONTROL-M.
1.3.2 Use the following command to start CONTROL-M/Server:
start-ctm
Step 1.4 – Check the CONTROL-M/EM to CONTROL-M Port

Number
In this step, you will get the number of the port that is used by
CONTROL-M/Server to “listen” for communication from
CONTROL-M/EM. This number will be needed later (when creating a
CONTROL-M definition in CONTROL-M/EM).
1.4.1 Enter the following command, to open the CONTROL-M main menu:
ctm_menu
1.4.2 The following menu is displayed:
CONTROL-M Main Menu: Select one of the following menus:

1 - CONTROL-M Manager
2 - Database Creation
3 - Database Maintenance
4 - Database Mirroring
5 - Security Authorization
6 - Parameter Customization
7 - Node Group
8 - Agent Status
9 - Troubleshooting
q - Quit

1.4.3 Choose option 6 to display the Parameter Customization menu.
Parameter Customization Menu

-----------------------------
Select one of the following options:
1 - Communication and Operational Parameters

2 - System Parameters and Shout Destination Tables
3 - Default Parameters for Communicating with Agent Platforms
4 - Parameters for Communicating with Specific Agent Platforms
q - Quit
1.4.4 Choose option 1 (Communication and Operational Parameters). The

following menu is displayed:
Communication Parameters:
1) Local IP Host Interface Name:

2) Agent-to-Server Port Number:
3) Communication Protocol:
a) Modify all of the above

q) Quit
n) Next page
Enter command or item number you wish to change [n]:
Enter n, to display the Operational Parameters menu.
Operational Parameters:
1) Input Process Communication Port Number:

2) Maximum Job State Changes:
3) CONTROL-M/EM TCP/IP Port Number:
4) Statistics Mode:
5) CONTROL-M/EM RELVER param:
6) Maximum server processes (CS):
7) Minimum server processes (CS):
a) Modify all of the above.

p) Previous
q) Quit
1.4.5 Note the value of option 3 (CONTROL-M/EM TCP/IP Port Number).

You will need to specify this port number later when creating a
CONTROL-M definition in CONTROL-M/EM.

Step 2 – On the Microsoft Windows Computer
Step 2.1 – Register CONTROL-M/EM Server Components
2.1.1 On the Windows desktop, click the Administration Facility icon.
2.1.2 Specify the username and password for the CONTROL-M/EM Database
administrator, and click Login.
2.1.3 The Administration Facility window is displayed.

2.1.4 Choose Component => New Component from the menu.
A: In the Type field, choose GUI Server to register the

CONTROL-M/EM GUI server.
B: In the Machine Type field indicate the type of computer on which

the GUI server was installed. (Unix or Windows).
Note: Specify Windows for the GUI server on any Microsoft
Windows operating system (including Windows 2000).
C: In the Machine name field specify the host name of the computer on
which you installed the CONTROL-M/EM GUI server.
D: Set the Desired State to UP.
For more information about this dialog box, see Chapter 3 of the
CONTROL-M/Enterprise Manager Administrator Guide.
2.1.5 Repeat Step 2.1.4 to register the Global Alerts Server (GAS).
2.1.6 Repeat Step 2.1.4 to register the Global Condition Server (GCS).

Step 2.2 – Create CONTROL-M Definitions in CONTROL-M/EM
2.2.1 On the Microsoft Windows desktop click the CONTROL-M/EM icon:
2.2.2 Enter the CONTROL-M/EM username and password. You are also
requested for the Hostname. This refers to the hostname of the computer
on which you installed the CONTROL-M/EM GUI Server.
2.2.3 Use the following steps to create a CONTROL-M definition for each
CONTROL-M/Server that will need to communicate with
CONTROL-M/EM.
A: Choose Tools => Communication => Administration. The

Communication Administration window is displayed.

B: Click New. The CONTROL-M Definition window is displayed.
C: Fill in all mandatory fields in this window.
• Specify the port number (default: 2370) that is used by

CONTROL-M/Server to “listen” for communication from
CONTROL-M/EM. (This is the port number that was checked
earlier in Step 1.4 on page 2-3.)
• Ensure that the Enable checkbox in the upper left-hand corner of

the CONTROL-M Definition window, is selected.

Step 2.3 – Register Gateways for Communication With
CONTROL-M/Server
2.3.1 Return to the Administration Facility window.
2.3.2 Choose Component => New Component from the menu. The
Component dialog box is displayed.
A: In the Type field, choose the name of CONTROL-M/EM gateway

for communication with the CONTROL-M that was defined in Step
2.2.3 on page 2-7.
B: In the Name field choose the same name as the CONTROL-M name
defined in Step C on page 2-8.
C: Set the Desired State to UP.
D: In the Machine name field, specify the host name of the computer
on which you installed the GUI server.
For more information about the fields in this dialog box, see Chapter 3 of
the CONTROL-M/Enterprise Manager Administrator Guide.

Step 2.4 – Create CONTROL-M Definitions in
CONTROL-M/Desktop
In this step you will create a separate CONTROL-M definition with the
same properties for each CONTROL-M that was defined in Step 2.2.3 on
page 2-7.
This will ensure that CONTROL-M/Desktop will allow creation of job

processing definitions for the CONTROL-M/Server.
2.4.1 Click to open CONTROL-M/Desktop.
Repeat Step 2.4.2 through Step 2.4.5 for each CONTROL-M/Server that
will communicate with CONTROL-M/EM.
2.4.2 Select Edit => CONTROL-M Definitions. The following window is

displayed:
2.4.3 Click Add. The following dialog box is displayed:

2.4.4 Fill in the fields in this dialog box as described in the following table.
Table 2-1 Fields in the CONTROL-M Dialog Box
Field Description
Name Name of the CONTROL-M. It is recommended that you use the
same name as was specified for this CONTROL-M when it was
defined for CONTROL-M/EM (in Step 2.2 on page 2-7).
Type Type of computer on which the CONTROL-M is installed.
Version Version of the CONTROL-M at the specified installation.
Uppercase Indicates if all parameters in the Job Editing form for this
Only CONTROL-M must be in uppercase. For most installations this
option should not be selected.
Start Day of Indicates the first day of the week for use in the Week Days
the Week field in the Job Editing form.
Note: This field is used to ensure that the display of calendars
for this CONTROL-M is properly adjusted. Use the ctmsys
utility to ensure that the start day of the week for the
CONTROL-M installation is the same as in this field.
Installed For OS/390 (MVS) platforms only:
Products Indicate which other INCONTROL products are installed with
CONTROL-M on the OS/390 platform.
2.4.5 Click OK to add the CONTROL-M to CONTROL-M/Desktop.
2.4.6 After all CONTROL-M installations have been defined, click OK to save
the changes and close the CONTROL-M window.

Step 2.5 – Show Extra Keyboard Help in Programs
For CONTROL-M/EM components installed on
Microsoft Windows 2000 computers:
The Microsoft Windows 2000 Show Extra Keyboard Help in Programs

feature is supported by CONTROL-M/EM. When this feature is disabled
(the default setting), you must press Alt to enable the access keys for
menus and buttons. When the feature is enabled, the access keys are
identified by an underline under the appropriate letter.
To enable this feature:
2.5.1 Choose Start => Settings => Control Panel to display the Control
Panel.
2.5.2 Double-click the Accessibility Options icon to display the Keyboard

panel of the Accessibility Options window.
2.5.3 Select the Show Extra Keyboard Help in Programs check box.
2.5.4 Close the Accessibility Options window and the Control Panel.

3
Troubleshooting 3
This chapter describes various problems that you may encounter during
installation of CONTROL-M products, and how to resolve them.
The troubleshooting procedures in this chapter are divided into the

following categories:
• CONTROL-M/EM Installation on Unix

• CONTROL-M/Server for Unix
• Oracle Database Issues
• Sybase Database Issues
Troubleshooting 3-1
CONTROL-M/EM Installation on Unix
If the installation of CONTROL-M/EM and/or Sybase Server fails, the
following procedures can help you correct installation problems.
Configure the Orbix Server
The Orbix Server should have been configured when it was installed.
However, if a message was displayed during installation that indicated
that there was a problem, you must configure the Orbix Server
interactively using the configure script, or silently using the default
Orbix configuration file.
» To run the configure script, type configure at the prompt and press
<Enter>. You must answer a series of questions that are displayed. The
script is located in the $IT_PRODUCT_DIR directory.
Note
The default configuration file, orbix_prep_file, is located in the
$HOME/appl/lib/bin.<uxtype>/Orbix/ directory (Where <uxtype> is
hp10 for HP-UX, ibm4 for AIX, or sparc for Solaris).
To run configure silently, use the following command:
configure -useprep
$HOME/apple/lib/bin.<uxtype>/Orbix/orbix_prep_file
Cleanup After an Aborted Installation
If you quit CONTROL-M/EM installation before it completed, or if the

installation failed, you will need to clean up certain files and processes
before restarting the installation process.
Use the following steps to clean up leftovers from an aborted installation.
Step 1 Use the following command to check for CONTROL-M/EM processes

that were started during the aborted installation:
ps -ef | grep <install_dir>

Where <install_dir> is the home directory of the installation account.
Step 2 If any such processes are found, use the following command to stop each
of them:
kill <process_ID>
Note
For installations using an Oracle database server, do not stop the
LSTNR_<instance_name> process or any Oracle processes, which
begin with the prefix ora_ .
Step 3 For installations using an Oracle server:
3.A Navigate to the CONTROL-M/EM user home directory.
3.B Use the following command to delete any user tables created by
the aborted installation:
clean_ora_inst.sh <ora_usr> <ora_pwd> <ora_sid>
Where:
• <ora_usr> is the CONTROL-M/EM user name specified in

the aborted installation (Default: emuser)
• <ora_pwd> is the CONTROL-M/EM user password
specified in the aborted installation (Default: empass)
• <ora_sid> is the Database Instance Name specified in the
aborted installation
Troubleshooting 3-3
The tmp and oracle subdirectories are not cleared, because they contain
files needed by the Oracle database server.
Note
The clean_ora_inst.sh script deletes old installation files and removes
CONTROL-M/EM tables from the database. If you wish to delete old
installation files but retain existing CONTROL-M/EM database tables,
specify the following command instead:
rm_ctmem_dirs.sh
Step 4 Before repeating the installation procedure, exit the current terminal
environment and open a new terminal environment. Begin the new
installation procedure from the new environment.
Note
If you copied the CONTROL-M/EM installation CD to an installation
directory using the COPY_FROM_CD command, you do not need to
remove this directory. You can use this same directory “as is” for your
next run of the installation process.
Note
When you reinstall CONTROL-M/EM, you must supply the same
CONTROL-M/EM password that you specified during the aborted
installation.

CONTROL-M/EM Installation on Microsoft
Windows
Truncated Environment Path
During CONTROL-M/EM installation, variables are added to the

beginning of the Microsoft Windows environment path. If these additions
result in a path containing more than 1,023 characters, characters beyond
the 1,023rd are truncated.
Solution:
Although the path is truncated, the full path statement is saved to a text
file in the CONTROL-M/EM home directory. This file is called
__prevpath.txt. You can recover all path statements from this file
MSSQL Memory Management
MSSQL Server 7.0 may consume a large number of system resources

(memory) when managing the CONTROL-M/EM database.
Use the following steps to limit the amount of memory used by the
CONTROL-M/EM database:
Step 1 Choose Start => Programs => Microsoft SQL Server => Enterprise
Manager.
The SQL Server Enterprise Manager window is displayed.
Troubleshooting 3-5
Figure 3-1 Microsoft SQL Server Enterprise Manager
Step 2 In the left pane of this window, expand the SQL Server hierarchy and
right-click the name of the MSSQL Server on which the
CONTROL-M/EM database is installed. A pop-up menu is displayed.
Step 3 Choose Properties from the pop-up menu. The SQL Server Properties
window is displayed.

Figure 3-2 SQL Server Properties Window
Step 4 Select the Memory panel.
Step 5 Note the Maximum (MB) value. This value is the maximum amount of
memory that is allocated to the MSSQL Server. You need this number to
complete the memory limitation procedure.
The number is located in the middle of the Memory panel. In Figure 3-2,
this number is circled (for the purpose of illustration).
Step 6 Click OK. The SQL Server Properties window is closed.
Step 7 Choose Tools => SQL Query Server Analyzer from the Enterprise
Manager window.
The SQL Query Server Analyzer window is displayed.
Troubleshooting 3-7
Figure 3-3 SQL Query Server Analyzer Window
Step 8 In the upper frame of this window, specify the following command:
sp_configure "max server memory","<n>"
where <n> is half the Maximum (MB) value that you obtained in Step 5
on page 3-7.
Step 9 On the next line, type:
reconfigure
Step 10 Click to submit the commands.
The following message is displayed in the bottom frame of the window

of the SQL Query Server Analyzer window:
DBCC execution completed.

Configuration option changed. Run the RECONFIGURE
statement to install.

It is not necessary to run the Reconfigure command a second time. This
was already handled in the previous step.
Step 11 Exit the SQL Query Server Analyzer window.
Reporting Facility Startup
When installing CONTROL-M/EM components and an Oracle Client on

a computer that already hosts one or more Oracle Clients, the Oracle
Client installed with CONTROL-M/EM will be unable to update Open
Database Connectivity (ODBC).
As a result, the Reporting facility not start, and the following message is
displayed:
Failed to create empty document.
The following procedure enables the Oracle Client installed with

CONTROL-M/EM to update the ODBC.
Note
It is recommended that you back up the Microsoft Windows registry
before performing this procedure.
Step 1 Log on to the Microsoft Windows computer that hosts the specific
Reporting facility.
Step 2 Choose Start => Run to display the Run dialog box.
Step 3 Enter the following command to display the Registry Editor:
regedit
Step 4 Navigate to
HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI\
Oracle ODBC Driver.
Step 5 Double-click on the Driver key. The Edit dialog box is displayed.
Troubleshooting 3-9
Step 6 Replace the current value with the following value and click OK:
<Oracle_home>\ORA817\BIN\SQORA32.DLL
Step 7 Double-click on the Setup key. The Edit dialog box is displayed.
Step 8 Replace the current value with the following value and click OK:
<Oracle_home>\ORA817\BIN\SQORAS32.DLL
(where <Oracle-home> refers to the local Oracle Client

installation.)
Step 9 Close the registry. The Reporting facility can now be used.

CONTROL-M/Server for Unix
Common Installation Problems
Table 3-1 describes common installation problems and diagnostic

procedures.
Table 3-1 CONTROL-M/Server for Unix Troubleshooting
Problem Solution
After running the cd_inst script, Perform the following checks:
installation files did not load • Do you have sufficient disk space on your computer?
completely. • Was the installation CD was removed by mistake?
Specify the cd_inst command again.
After running the install/custom Your parameter changes up to the point you quit are retained.
script, you decided to quit the When you wish to complete the installation, rerun the script
installation without building the from the home directory of the CONTROL-M user account.
database.
Installation fails when trying to build Check the following log files for the failure reason:
the Sybase database server. • sybase/init/logs/srvbuild<date>.<number>
• <CONTROL-M_home_dir>/ctm/tmp/new_db.<number>
On HP-UX, you may need to install Sybase’s EBF9682 patch
for Sybase version 12.
Installation fails when trying to build Check the following Oracle log files for the reason for failure:
the Oracle database server. • oracle/product/8.1.7/install/crdb1.log
• oracle/product/8.1.7/install/crdb2.log
Note: When using an existing Oracle database server (not a
new database server), only the crbd5.log file will exist.
Also check the following log files:
• <CONTROL-M_home_dir>/log/ create_server.log
• <CONTROL-M_home_dir>/log/ createdb.log
• <CONTROL-M_home_dir>/log/out_log_file
Poor performance for CONTROL-M Use the tuning instructions in Appendix E of Book 1 of the
when installed with an Oracle CONTROL-M Installation Guide to enable better performance
database server on AIX on the AIX computer.
Troubleshooting 3-11
Cleanup After an Aborted Installation
If you quit CONTROL-M installation before it completed, or if the

installation failed, the installation may have created database processes.
These processes should be removed to release all allocated resources, and
so that the necessary processes can be created later when you reinstall
CONTROL-M/Server.
To cleanup an installation that used a existing Oracle database, skip to

“Existing Oracle Database Cleanup” on page 3-14.
To cleanup an installation that used a dedicated Sybase database, skip to

“Dedicated Sybase Database Cleanup” on page 3-17.
To cleanup an installation that used a existing Sybase database, skip to

“Existing Sybase Database Cleanup” on page 3-17.

Oracle Database Issues
Dedicated Oracle Database Cleanup
Step 1 Use the following command to check if there are any Oracle processes
running:
ps -ef | grep ora_ | grep <ctm_user>
If the Oracle database processes are up and running you will get a list of
the following processes:
• ora_dbw0_<dbname>
• ora_lgwr_<dbname>
• ora_pmon_<dbname>
• ora_smon_<dbname>
• ora_ckpt_<dbname>
• ora_reco_<dbname>
where <dbname> is the name of the database instance that was created
(default: ctrlm).
If none of these processes were found, skip to Step 4 on page 3-14.
Step 2 Verify that these processes are owned by the CONTROL-M/Server Unix
account.
Note
The left-most column of the output in Step 1 contains the Unix account
owner of the process and the right-most column is the process name.
Step 3 If any of the above processes were found, enter the following commands:
setenv ORACLE_HOME $HOME/oracle/product/8.1.7

setenv ORACLE_SID <dbname>
$ORACLE_HOME/bin/sqlplus internal
A prompt similar to the following is displayed:
SQL>
Step 4 Use the following command to shut down the Oracle database processes,
and to deallocate all the resources that were allocated to the database
instance so it could be recreated:
shutdown abort
Step 5 Use the following command to return to the O/S prompt.
exit
Step 6 Use the following command to stop the Oracle listener process so that it
can be created again as part of the second installation.
$ORACLE_HOME/bin/lsnrctl stop LSTNR_<dbname>
Existing Oracle Database Cleanup
Step 1 Log in to the Oracle database server as the system user. Specify the
command:
sqlplus <system_user>/<system_password>
Step 2 Specify the command:
select <tablespace_name> from dba_tablespaces
Step 3 Check which devices were dropped from the tablespace. If data or index
devices associated with the CONTROL-M database are still listed, drop
them using the following command:
drop tablespace <tablespace_name>

Step 4 If the database was installed using files, delete the files associated with
the dropped elements. Do not delete raw partitions.
Memory Leak Prevention
If you receive the following error, the Oracle Server is causing a memory
leak that prevents you from accessing the database.
ORA-04031: unable to allocate 4096 bytes of shared

memory ("shared pool","BEGIN
DBMS_APPLICATION_INFO....","PL/SQL MPCODE","BAMIMA:
Bam Buffer")
Note
This error, Oracle known bug 1397603, can occur on all supported
platforms.
Perform the following procedure to prevent the problem:
Step 1 Log in to the computer hosting the Oracle Server as the user/account that
installed the Oracle Server.
Step 2 Open a text editor and navigate to the appropriate file:
For Microsoft Windows:
<Oracle_home>\Admin\<instance>\pfile\init.ora
For Unix:
$HOME/oracle/admin/<instance>/pfile/init<instance>.ora
Step 3 Add the following line at the end of the file:
_db_handles_cached=0
Step 4 Save and close the file.
Step 5 Stop and restart the Oracle Server using the appropriate method.
For Microsoft Windows:
Stop and restart the OracleService<instance> service.
For Unix:
5.A Enter the following command to start an sql session:
sqlplus internal
An SQL> prompt is displayed.
5.B Enter the following commands:
shutdown immediate
startup
5.C Quit the sql session.

Sybase Database Issues
Dedicated Sybase Database Cleanup
On the CONTROL-M/Server, specify the command:
make_db
This process deletes the Sybase database and rebuilds it using current
parameter settings for database name, size and communication ports.
Existing Sybase Database Cleanup
Step 1 Log in to the Sybase database server as the sa user.
Step 2 Specify the following command to check which devices were dropped
from the server:
sp_helpdevice
go
Step 3 If data or log devices associated with the CONTROL-M database are still
listed, drop them using the following command:
sp_dropdevice <device_name>
go
Step 4 If the database was installed using files, delete the files associated with
Step 5 Restart the database server. Dropped devices will not be deleted until you
restart the database server.

4
Uninstalling CONTROL-M/EM On Unix

Computers 4
An CONTROL-M/EM installation consists of one or more components

installed on a single computer. Using the uninstall procedure, you can
remove some or all CONTROL-M/EM components on a computer.
Note
This uninstall procedure removes ALL CONTROL-M/EM components
from the local computer. If you want to remove only selected
components, use the Remove Component option of the Installation
Procedure.
Step 1 Stop all CONTROL-M/EM processes running on the Unix computer.
1.A On a Windows computer on which the Administration facility is

installed, start the Administration facility. Change the Desired
State of all CONTROL-M/EM components on the Unix
computer to Down.
The components that you can shut down using the Administration
facility are:
• GUI Server
• Gateway
• Global Conditions Server
• Global Alerts Server
Uninstalling CONTROL-M/EM On Unix Computers 4-1

1.B The Desired States of any CONTROL-M/EM components on
other computers that are connected with the components that will
be uninstalled must also be changed to Down for the duration of
the uninstall.
1.C From the <CONTROLM_EM_HOME> directory on the Unix

computer (the one on which you are removing
CONTROL-M/EM), enter the following command to display the
root menu:
root_menu
The root menu is displayed:
Root Menu
---------------
1 - Activation Menu
2 - Troubleshooting Menu
3 - New Window
4 - Database Creation Menu
5 - Database Maintenance Menu
1.D Press 1. The Activation Menu is displayed:
Activation Menu
---------------

1 - Check All
2 - Start All
3 - Start Database Server
4 - Start Orbix Services
5 - Start Administration Agent
7 - Stop All
8 - Stop Database Server
9 - Stop Orbix Services
10 - Stop Administration Agent
p - Previous Menu
q - Quit
1.E Press 7 to run the stop_all script. This script shuts down the
database server (if it is installed on this computer), the Orbix
Locator and Naming processes, and the administration agent on
the local computer.
Note
For more information about using the Administration facility, see the
“Maintenance” chapter in the CONTROL-M/Enterprise Manager
Administrator Guide.
Depending on which CONTROL-M/EM components are installed on the

computer some or all of the bulleted utility processes, below, may be
running. Stop the processes, as necessary.
• ecs.util
• ecs.cli
• ecs.ctl
• copydefcal
• copydefjob
• defcal
• defjob
• defjobconvert
• deftable
• deldefjob
• duplicatedefjob
• exportdefcal
• exportdefjob
• exportdeftable

• updatedef
Step 2 To ensure that all CONTROL-M/EM and database server processes have
been stopped, enter the following command:
ps -ef |grep <Unix_account_username>
A list of the processes that are currently running under the account are
displayed. Kill any CONTROL-M/EM processes that are still running.
Step 3 Remove the CONTROL-M/EM account and its contents by entering the
following command:
rm -rf * .*
• If the database server was installed under the CONTROL-M/EM

account, it was removed in the previous step. If so, the uninstall
procedure is complete.
However, if the database server was installed under a different

account on the same computer, you must follow the manufacturer’s
instructions to remove it. When the database server is removed, the
uninstall procedure is complete.
• If the database server is installed on a different Unix computer and

you want to remove only the CONTROL-M/EM database, continue
with Step 4.
Step 4 Log on to the database server host computer as the CONTROL-M/EM

administrator.
If CONTROL-M/EM components are installed on this computer (in

addition to the database), continue with Step 5.
If no CONTROL-M/EM components are installed on this computer

(other than the CONTROL-M/EM database), go to Step Step 8.
Step 5 From the <CONTROLM_EM_HOME> directory on the database

server Unix computer, enter the following command to display the root
menu:

root_menu
The root menu is displayed:
Root Menu
---------------
1 - Activation Menu
2 - Troubleshooting Menu
3 - New Window
4 - Database Creation Menu
5 - Database Maintenance Menu
Step 6 Press 4. The Database Creation Menu is displayed:
Database Creation Menu

----------------------
1 - Build Database
2 - Delete Database
p - Previous Menu
q - Quit
Enter option number --->
Step 7 Press 2 to select the Delete Database option. A brief interactive session is
started, during which you are prompted for the name of the
CONTROL-M/EM database. When the session ends, the database has
been removed and the uninstall procedure is finished.
Step 8 Use the database server’s database removal tool to remove the
CONTROL-M/EM database. When the database has been removed, the
uninstall procedure is finished.
For more information, see the database server documentation.


5
Uninstalling CONTROL-M/EM On
Windows Computers 5
The procedure in this chapter describes how to remove some or all

CONTROL-M/EM components.
Step 1 – Selecting Components to Remove

1.0.1 Use the Administration facility to shut down all CONTROL-M/EM
components.
1.0.2 Select Start => Programs =>

CONTROL-M/Enterprise Manager 6.1.01 => Uninstall
CONTROL-M/Enterprise Manager.
The Uninstall Setup window is displayed.
Uninstalling CONTROL-M/EM On Windows Computers 5-1

1.0.3 Click Next. A window similar to the following is displayed:
Select the required uninstallation type:
• Select Full Uninstall to remove all CONTROL-M/EM components.
— for Oracle installations, this option removes the Oracle Client, if

it was installed, and CONTROL-M/EM database tables. The
tablespace is not removed.

— for Sybase installations, this option removes the Sybase Client, if
it was installed, and the CONTROL-M/EM database.
— for MSSQL Server installations, this option removes the

CONTROL-M/EM database. It does not remove the MSSQL
client.
Click Next and continue with Step 1.0.5 on page 5-5.
• Select Custom Uninstall to select which components should be

removed. Click Next.The Select Components window is displayed.

1.0.4 Select the components you want to remove. All checked components will
be uninstalled. Click Next to continue.
If you choose to remove the CONTROL-M/Enterprise Manager

Database:
• for Oracle installations, this option removes the CONTROL-M/EM

database tables. The tablespace is not removed.
• for Sybase installations, this option removes the CONTROL-M/EM
database completely, including data.
• for MSSQL installations, this option removes the CONTROL-M/EM
database. It does not remove the MSSQL client.
If an Oracle or Sybase database client was installed with

CONTROL-M/EM, it is not removed if any of the following components
remain on the computer:
• CONTROL-M/EM Database
• GAS
• GCS
• Gateway
• GUI Server
• Administration Facility
• Reporting Facility

1.0.5 If you are performing a Full Uninstall or removing the
CONTROL-M/EM database, you are prompted for database server
information:
For Sybase or MSSQL databases, the following window is displayed:
For Oracle databases, the following window is displayed:
Enter and confirm the administrator password. Click Next to continue.

1.0.6 The following window is displayed:
A list of the components that will be removed is displayed.
1.0.7 If the displayed list matches your needs, click Next to continue with the
uninstallation.
Note
Clicking Next, in this window proceeds to the next stage of the uninstall
process. After doing this, you will not be able to return to this window.
1.0.8 The uninstall procedure checks if any CONTROL-M/EM processes are

running and displays the names in the following window:

If no CONTROL-M/EM processes are running, continue with Step
1.0.12 on page 5-7.
1.0.9 If necessary, use the Administration Facility to shut down the following
components:
• Global Alerts Server (GAS)

• Global Conditions Server (GCS)
• GUI Server
• Gateway
1.0.10 Close the Administration facility window.
1.0.11 Close any other CONTROL-M/EM windows that are open.
1.0.12 If you are removing the CONTROL-M/EM database from a Sybase

server or you selected Full Uninstall (including removal of a Sybase
database), one or both of the following messages are displayed:

Click OK for each message.
Note
If you performing an uninstall that involves an Oracle Database Server or
a database on Oracle, the uninstall procedure removes the Oracle Client.
You may get messages at this time that inform you that not all Oracle
components were removed.
If you received a message of this type, continue with the uninstall

procedure, and when the procedure is complete, check if the
CONTROL-M/EM home directory (default: D:\Control-M/EM) has
been removed. If it still exists, remove it manually.
• If you want to remove the Actuate User Desktop continue with Step
2 on page 5-9.
• If you do not want to remove the Actuate User Desktop, continue

with Step 3 on page 5-12.

Step 2 – Uninstall the Actuate User Desktop
2.0.1 If you are performing a Full Uninstall or removing the Reporting
facility, the following dialog box is displayed.
Note
Actuate is a report generator that is embedded in CONTROL-M/EM. Do
not remove Actuate if other programs on your computer use it.
• If you do not want to remove Actuate, click No and continue with

Step 3 on page 5-12.
• Click Yes if you want to remove Actuate.
2.0.2 The Confirm File Detection dialog box is displayed.
2.0.3 Click Yes to remove the Actuate User Desktop. The following window
may be displayed.

2.0.4 Click Yes to All. The following window is displayed:
Click Yes to continue. The following window is displayed:
Note
The checklist in this window applies only to removal of Actuate.

2.0.5 Click OK. The following note is displayed:
2.0.6 Click OK. The Actuate Unistall Program dialog box is displayed.
2.0.7 Click Yes to remove the Actuate User Desktop directory. The following
message is displayed:
2.0.8 Click OK. The Actuate User Desktop has been removed.

Step 3 – Completing Uninstall
3.0.1 If uninstall cannot remove the <CONTROL-M/EM_HOME> directory, the
following warning is displayed:
Note
The <CONTROL-M/EM_HOME> directory must be removed manually
after rebooting after the uninstallation.
3.0.2 Click OK. The following window is displayed:
3.0.3 Select whether to restart the computer at this time (Yes) or restart at a
later time (No). Click Finish.
3.0.4 After reboot, remove the <CONTROL-M/EM_HOME> directory, if

required.

Installing ENTERPRISE/CS Version 1.5.0 on a Computer that Hosted Version 6.0.03
The installation for ENTERPRISE/CS version 1.5.0 must be changed

when installing it on a computer from which ENTERPRISE/CS version
6.0.03 server components were previously uninstalled.
Note
You may want to install ENTERPRISE/CS version 1.5.0 on a computer
from which ENTERPRISE/CS version 6.0.03 server components were
previously uninstalled if you were testing version 6.0.03 on a computer.
To successfully install ENTERPRISE/CS version 1.5.0:
A: Uninstall the ENTERPRISE/CS version 6.0.03 server components.
B: Remove NuTCRACKER using the Add/Remove Programs feature

on the Windows Control Panel.
C: Install ENTERPRISE/CS version 1.5.0, as directed in the Enterprise

Controlstation for Microsoft Windows NT Administrator Guide
version 1.5.0.
Note
If only ENTERPRISE/CS version 6.0.03 client components were
previously installed, version 1.5.0 can be installed without these steps.
Client components include: ENTERPRISE/CS GUI,

CONTROL-M/Desktop, CLI, Administration facility, and Reporting
facility.


6
Uninstalling CONTROL-M/Server for

Unix 6
The ctm_uninstall utility can be used to undo CONTROL-M/Server

installation. The following actions are performed by this utility:
• Shut down of all processes that are up and running.

• Shut down of the CONTROL-M Database server, if it is running.
• Removal of all files from the CONTROL-M home directory.
Step 1 – Running the utility

Use the following steps to uninstall CONTROL-M/Server for Unix:
1.0.1 Log on to a root user account.
1.0.2 Navigate to the home directory of the CONTROL-M/Server user.
1.0.3 Enter the following command to run the uninstall utility:
./ctm/scripts/ctm_uninstall
1.0.4 Log out of the root user account.
Uninstalling CONTROL-M/Server for Unix 6-1

Output of the ctm_uninstall utility
The following messages are issued during uninstall of CONTROL-M/

Server under user: "ctm600s"
home directory: "/disk1/ctm600s".

Do you wish to continue? [y]:
-------------------------------
Uninstall Procedure Started.
-------------------------------
Shutting down CONTROL-M/Server ...

Shutting down CONTROL-M.
Waiting 15 secs.
Shutting down the database ...
Uninstall Procedure will remove all files in the home directory "/disk1/
ctm600s"
of the user "ctm600s".
Do you wish to continue? [y]:
================= dedicated installation =============================

Deleting all database datafiles ...
Done.
=======================================================================
------------------------existing installation ------------------------------
Deleting CONTROL-M database from remote SQL Server.
CONTROL-M database datafile: <remote filename>

CONTROL-M logdb datafile: <remote filename>
WARNING ! These files or raw partitions are on remote SQL Server computer.
In order to complete uninstall procedure, you should

delete above physical files on remote SQL Server host
and not raw partitions if there is any.
----------------------------------------------------------------
Removing the contents of "/disk1/ctm600s" directory...
Uninstall Procedure completed successfully
You can delete the CONTROL-M/Server user account ’ctm600s’ from /etc/passwd
file.
You can delete the CONTROL-M/Server group account ’controlm’from /etc/passwd
file if there is no other CONTROL-M installed on the current machine.

Step 2 – Cleanup After Uninstall
In some cases, the uninstall procedure may abort before deleting the
CONTROL-M database, or may not remove all database elements.
Follow the following steps to check the database server and remove any
remaining elements.
Cleanup for Sybase Database Servers
2.0.1 Log in to the Sybase database server as the sa user.
2.0.2 Specify the following command to check which devices were dropped
from the server:
sp_helpdevice
go
2.0.3 If data or log devices associated with the CONTROL-M database are still
listed, drop them using the following command:
sp_dropdevice <device_name>
go
2.0.4 If the database was installed using files, delete the files associated with
2.0.5 Restart the database server. Dropped devices will not be deleted until you
restart the database server.
Cleanup for Oracle Database Servers
2.0.1 Log in to the Oracle database server as the system user. Type the
command:
sqlplus <system_user>/<system_password>
2.0.2 Select <tablespace_name> from dba_tablespaces.
2.0.3 Check which devices were dropped from the tablespace:
Uninstalling CONTROL-M/Server for Unix 6-3

2.0.4 If data or index devices associated with the CONTROL-M database are
still listed, drop them using the following command:
drop tablespace <tablespace_name>
2.0.5 If the database was installed using files, delete the files associated with

7
Uninstalling CONTROL-M/Server for

Microsoft Windows 7
This chapter describes how to uninstall CONTROL-M/Server for

Microsoft Windows from your machine. Uninstall removes all files from
the CONTROL-M/Server home directory.
The following topics are discussed in this section:
• Uninstalling CONTROL-M/Server – Windows NT

• Uninstalling CONTROL-M/Server – Windows 2000
Uninstalling CONTROL-M/Server for Microsoft Windows 7-1

Uninstalling CONTROL-M/Server – Windows NT
Use the following steps to uninstall CONTROL-M/Server when using

Windows NT:
Step 1 Verify that no jobs are running on the server and no utilities are executing
on the server.
Step 2 Shut down the CONTROL-M/Server application using the following

command:
shut_ctm
Step 3 Select Start => Settings => Control Panel => Add/Remove Programs.
Select CONTROL-M/Server from the application list. Click

Add/Remove.
Step 4 A window prompts you to confirm the uninstall. Click Yes to remove
CONTROL-M/Server.
Step 5 After confirmation, the following dialog box is displayed.

Step 6 Click Next. The following dialog box is displayed.
Step 7 Select the Remove option. Click Next. The following dialog box is
displayed.

Step 8 Click Remove to continue with the uninstall procedure. The following
dialog box is displayed.
After a few seconds the following dialog box is displayed.
Step 9 Click Finish. CONTROL-M/Server is uninstalled.

Uninstalling CONTROL-M/Server – Windows 2000
Use the following steps to uninstall CONTROL-M/Server when using

Windows 2000:
Step 1 Verify that no jobs are running on the server and no utilities are executing
on the server.
Step 2 Shut down the CONTROL-M/Server application using the following

command:
shut_ctm
Step 3 Select Start => Settings => Control Panel => Add/Remove Programs.
The following dialog box is displayed.
Select CONTROL-M/Server from the application list. Click Remove.
Step 4 A window prompts you to confirm the uninstall. Click Yes to remove
CONTROL-M/Server.

Step 5 A progress screen is displayed during uninstall.When uninstall is
complete, close the Add/Remove Programs window.

8
Uninstalling CONTROL-M/Agent for

Microsoft Windows 8
Use the following steps to remove CONTROL-M/Agent for Microsoft

Windows from a computer.
Note
This uninstall procedure deletes all files, including user-created files,
from CONTROL-M/Agent directories. Back up all relevant data before
running this procedure.
To make the uninstall procedure work faster, delete all files in the sysout
and backup directories before running the procedure.
Step 1 Verify that CONTROL-M jobs are not running on the computer and that
utilities invoked by CONTROL-M/Agent are not being processed by
CONTROL-M/Server.
Step 2 Stop the CONTROL-M Agent and Tracker services.
1. Select Start => Settings => Control Panel => Admin Tools.
2. In the Admin Tools window, click Services.
3. Select the CONTROL-M Agent service and click Stop.
4. Select the CONTROL-M Tracker service and click Stop.
Uninstalling CONTROL-M/Agent for Microsoft Windows 8-1

Step 3 Choose Start => Settings => Control Panel => Add/Remove Programs
Step 4 The following window is displayed.
4.A Select CONTROL-M Agent from the Currently installed

programs list.
4.B Click Remove.
Step 5 The Add/Remove confirmation window displays the prompt:
Are you sure you want to remove CONTROL-M/Agent from your computer?
Click Yes.
Step 6 When the uninstallation procedure is complete, the window in Step 4 is

displayed. CONTROL-M/Agent is not in the list of Currently installed
programs.
Click Close to exit.

Index
Index
Symbols conventions xvi

online xiv
__prevpath.txt file 3-5 printed xiv
related publications xiii
release notes xv
A
access keys E
enabling 2-12
Add/Remove Programs dialog box 8-2 environment path
troubleshooting 3-5
C I
changing previous installation 8-2
Configure utility 3-2 installation problems (Windows)
CONTROL-M MSSQL memory management 3-5
uninstall utility 6-1 truncated environment path 3-5
CONTROL-T Installed Products fields
with CONTROL-M 2-11 CONTROL-M definition 2-11
installing
changing 8-2
D modifying 8-2
removing 8-1
defining uninstalling 8-1
see creating
documentation
accessing online xiv
Index 1
M T
maintaining troubleshooting
CONTROL-M/Agent 8-1 environment path truncation 3-5
previous installation 8-2 MSSQL memory management 3-5
modifying Type field
see also creating CONTROL-M definition 2-11
MSSQL memory settings 3-5
MSSQL Server
memory management 3-5 U
uninstallation (Windows)
N description 4-1
uninstallation formats
Name field Custom 5-3
CONTROL-M definition 2-11 Full 5-3
uninstalling 7-1
remove 8-1
O Uninstalling CONTROL-M/Agent status
window 8-2
Orbix Server Uppercase Only field
configuring with Configure 3-2 CONTROL-M definition 2-11
orbix_prep_file 3-2
OS/390
other INCONTROL products 2-11 V
Version field
R CONTROL-M definition 2-11
remove
uninstalling 8-1
S
Show extra keyboard help
access keys 2-12
enabling 2-12
Start Day of the Week
CONTROL-M definition 2-11
2 CONTROL-M Installation Guide - Book 3

END USER LICENSE AGREEMENT
NOTICE
BY OPENING THE PACKAGE, INSTALLING, PRESSING "AGREE" OR "YES" OR USING THE PRODUCT, THE ENTITY OR
INDIVIDUAL ENTERING INTO THIS AGREEMENT AGREES TO BE BOUND BY THE FOLLOWING TERMS. IF YOU DO NOT
AGREE WITH ANY OF THESE TERMS, DO NOT INSTALL OR USE THE PRODUCT, PROMPTLY RETURN THE PRODUCT TO
BMC OR YOUR BMC RESELLER, AND IF YOU ACQUIRED THE LICENSE WITHIN 30 DAYS OF THE DATE OF YOUR ORDER
CONTACT BMC OR YOUR BMC RESELLER FOR A REFUND OF LICENSE FEES PAID. IF YOU REJECT THIS AGREEMENT,
YOU WILL NOT ACQUIRE ANY LICENSE TO USE THE PRODUCT.
This Agreement ("Agreement") is between the entity or individual entering into this Agreement ("You") and BMC Software Distribution,
Inc., a Delaware corporation located at 2101 CityWest Blvd., Houston, Texas, 77042, USA or its affiliated local licensing entity ("BMC").
"You" includes you and your Affiliates. "Affiliate" is defined as an entity which controls, is controlled by or shares common control with
a party. THIS AGREEMENT WILL APPLY TO THE PRODUCT, UNLESS (1) YOU AGREED TO A WEB BASED LICENSE
AGREEMENT WITH BMC WHEN ORDERING THE PRODUCT, IN WHICH CASE THAT WEB BASED LICENSE AGREEMENT
GOVERNS THE USE OF THE PRODUCT, OR (2) IF YOU DID NOT AGREE TO A WEB BASED LICENSE AGREEMENT WITH BMC
WHEN ORDERING THE PRODUCT AND YOU HAVE A WRITTEN LICENSE AGREEMENT WITH BMC, THEN THAT WRITTEN
AGREEMENT GOVERNS THE USE OF THE PRODUCT. THE ELECTRONIC AGREEMENT PROVIDED WITH THE PRODUCT AS
PART OF THE INSTALLATION OF THE PRODUCT WILL NOT APPLY. In addition to the restrictions imposed under this Agreement,
any other usage restrictions contained in the Product installation instructions or release notes shall apply to Your use of the Product.
PRODUCT AND CAPACITY. "Software" means the object code version of the computer programs provided, via delivery or electronic
transmission, to You. Software includes computer files, enhancements, maintenance modifications, upgrades, updates, bug fixes, and
error corrections.
"Documentation" means all written or graphical material provided by BMC in any medium, including any technical specifications,
relating to the functionality or operation of the Software.
"Product" means the Software and Documentation.
"License Capacity" means the licensed capacity for the Software with the pricing and other license defining terms, including capacity
restrictions, such as tier limit, total allowed users, gigabyte limit, quantity of Software, and/or other capacity limitations regarding the
Software. For licenses based on the power of a computer, You agree to use BMC’s current computer classification scheme, which is
available at http://www.bmc.com or can be provided to You upon request.
ACCEPTANCE. The Product is deemed accepted by You, on the date that You received the Product from BMC.
LICENSE. Subject to the terms of this Agreement, as well as Your payment of applicable fees, BMC grants You a non-exclusive,
non-transferable, perpetual (unless a term license is provided on an order) license for each copy of the Software, up to the License
Capacity, to do the following:
(a) install the Software on Your owned or leased hardware located at a facility owned or controlled by You in the country where You
acquired the license;
(b) operate the Software solely for processing Your own data in Your business operations; and
(c) make one copy of the Software for backup and archival purposes only (collectively a "License").
If the Software is designed by BMC to permit you to modify such Software, then you agree to only use such modifications or new
software programs for Your internal purposes or otherwise consistent with the License. BMC grants You a license to use the
Documentation solely for Your internal use in Your operations.
LICENSE UPGRADES. You may expand the scope of the License Capacity only pursuant to a separate agreement with BMC for such
expanded usage and Your payment of applicable fees. There is no additional warranty period or free support period for license
upgrades.
RESTRICTIONS: You agree to NOT:

(a) disassemble, reverse engineer, decompile or otherwise attempt to derive any Software from executable code;
(b) distribute or provide the Software to any third party (including without limitation, use in a service bureau, outsourcing environment,
or processing the data of third parties, or for rental, lease, or sublicense); or
(c) provide a third party with the results of any functional evaluation or benchmarking or performance tests, without BMC’s prior written
approval, unless prohibited by local law.
TRIAL LICENSE. If, as part of the ordering process, the Product is provided on a trial basis, then these terms apply: (i) this license
consists solely of a non-exclusive, non-transferable evaluation license to operate the Software for the period of time specified from BMC
or, if not specified, a 30 day time period ("Trial Period") only for evaluating whether You desire to acquire a capacity-based license to
the Product for a fee; and (ii) Your use of the Product is on an AS IS basis without any warranty, and BMC, ITS AFFILIATES AND
RESELLERS, AND LICENSORS DISCLAIM ANY AND ALL WARRANTIES (INCLUDING, WITHOUT LIMITATION, THE IMPLIED
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT) AND HAVE NO
LIABILITY WHATSOEVER RESULTING FROM THE USE OF THIS PRODUCT UNDER THIS TRIAL LICENSE ("Trial License").
BMC may terminate for its convenience a Trial License upon notice to You. When the Trial Period ends, Your right to use this Product
automatically expires. If You want to continue Your use of the Product beyond the Trial Period, contact BMC to acquire a
capacity-based license to the Product for a fee.
TERMINATION. This Agreement shall immediately terminate if You breach any of its terms. Upon termination, for any reason, You must
uninstall the Software, and either certify the destruction of the Product or return it to BMC.
OWNERSHIP OF THE PRODUCT. BMC or its Affiliates or licensors retain all right, title and interest to and in the BMC Product and all
intellectual property, informational, industrial property and proprietary rights therein. BMC neither grants nor otherwise transfers any
rights of ownership in the BMC Product to You. BMC Products are protected by applicable copyright, trade secret, and industrial and
intellectual property laws. BMC reserves any rights not expressly granted to You herein.
CONFIDENTIAL AND PROPRIETARY INFORMATION. The BMC Products are and contain valuable confidential information of BMC
("Confidential Information"). Confidential Information means non-public technical and non-technical information relating to the BMC
Products and Support, including, without limitation, trade secret and proprietary information, and the structure and organization of the
Software. You may not disclose the Confidential Information to third parties. You agree to use all reasonable efforts to prevent the
unauthorized use, copying, publication or dissemination of the Product.
WARRANTY. Except for a Trial License, BMC warrants that the Software will perform in substantial accordance with the Documentation
for a period of one year from the date of the order. This warranty shall not apply to any problems caused by software or hardware not
supplied by BMC or to any misuse of the Software.
EXCLUSIVE REMEDY. BMC’s entire liability, and Your exclusive remedy, for any defect in the Software during the warranty period or
breach of the warranty above shall be limited to the following: BMC shall use reasonable efforts to remedy defects covered by the
warranty or replace the defective Software within a reasonable period of time, or if BMC cannot remedy or replace such defective copy
of the Software, then BMC shall refund the amount paid by You for the License for that Software. BMC’s obligations in this section are
conditioned upon Your providing BMC prompt access to the affected Software and full cooperation in resolving the claim.
DISCLAIMER. EXCEPT FOR THE EXPRESS WARRANTIES ABOVE, THE PRODUCT IS PROVIDED "AS IS." BMC, ITS
AFFILIATES AND LICENSORS SPECIFICALLY DISCLAIM ALL OTHER WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE
IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. BMC
DOES NOT WARRANT THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR FREE, OR THAT
ALL DEFECTS CAN BE CORRECTED.
DISCLAIMER OF DAMAGES. IN NO EVENT IS BMC, ITS AFFILIATES OR LICENSORS LIABLE FOR ANY SPECIAL, INDIRECT,
INCIDENTAL, PUNITIVE OR CONSEQUENTIAL DAMAGES RELATING TO OR ARISING OUT OF THIS AGREEMENT, SUPPORT,
AND/OR THE PRODUCT (INCLUDING, WITHOUT LIMITATION, LOST PROFITS, LOST COMPUTER USAGE TIME, AND DAMAGE
OR LOSS OF USE OF DATA), EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, AND IRRESPECTIVE OF ANY
NEGLIGENCE OF BMC OR WHETHER SUCH DAMAGES RESULT FROM A CLAIM ARISING UNDER TORT OR CONTRACT
LAW.
LIMITS ON LIABILITY. BMC’S AGGREGATE LIABILITY FOR DAMAGES IS LIMITED TO THE AMOUNT PAID BY YOU FOR THE
LICENSE TO THE PRODUCT.
SUPPORT. If Your order includes support for the Software, then BMC agrees to provide support (24 hours a day/7 days a week)
("Support"). You will be automatically re-enrolled in Support on an annual basis unless BMC receives notice of termination from You
as provided below. There is a free support period during the one year warranty period.
(a) Support Terms. BMC agrees to make commercially reasonable efforts to provide the following Support: (i) For malfunctions of
supported versions of the Software, BMC provides bug fixes, patches or workarounds in order to cause that copy of the Software to
operate in substantial conformity with its then-current operating specifications; and (ii) BMC provides new releases or versions, so long
as such new releases or versions are furnished by BMC to all other enrolled Support customers without additional charge. BMC may
refuse to provide Support for any versions or releases of the Software other than the most recent version or release of such Software
made available by BMC. Either party may terminate Your enrollment in Support upon providing notice to the other at least 30 days prior
to the next applicable Support anniversary date. If You re-enroll in Support, BMC may charge You a reinstatement fee of 1.5 times what
You would have paid if You were enrolled in Support during that time period.
(b) Fees. The annual fee for Support is 20% of the Software’s list price less the applicable discount or a flat capacity based annual fee.
BMC may change its prices for the Software and/or Support upon at least 30 days notice prior to Your support anniversary date.
VERIFICATION. If requested by BMC, You agree to deliver to BMC periodic written reports, whether generated manually or
electronically, detailing Your use of the Software in accordance with this Agreement, including, without limitation, the License Capacity.
BMC may, at its expense, audit Your use of the Software to confirm Your compliance with the Agreement. If an audit reveals that You
have underpaid fees, You agree to pay such underpaid fees. If the underpaid fees exceed 5% of the fees paid, then You agree to also
pay BMC’s reasonable costs of conducting the audit.
EXPORT CONTROLS. You agree not to import, export, re-export, or transfer, directly or indirectly, any part of the Product or any
underlying information or technology except in full compliance with all United States, foreign and other applicable laws and regulations.
GOVERNING LAW. This Agreement is governed by the substantive laws in force, without regard to conflict of laws principles: (a) in
the State of New York, if you acquired the License in the United States, Puerto Rico, or any country in Central or South America; (b) in
the Province of Ontario, if you acquired the License in Canada (subsections (a) and (b) collectively referred to as the "Americas
Region"); (c) in Singapore, if you acquired the License in Japan, South Korea, Peoples Republic of China, Special Administrative
Region of Hong Kong, Republic of China, Philippines, Indonesia, Malaysia, Singapore, India, Australia, New Zealand, or Thailand
(collectively, "Asia Pacific Region"); or (d) in the Netherlands, if you acquired the License in any other country not described above.
The United Nations Convention on Contracts for the International Sale of Goods is specifically disclaimed in its entirety.
ARBITRATION. ANY DISPUTE BETWEEN YOU AND BMC ARISING OUT OF THIS AGREEMENT OR THE BREACH OR
ALLEGED BREACH, SHALL BE DETERMINED BY BINDING ARBITRATION CONDUCTED IN ENGLISH. IF THE DISPUTE IS
INITIATED IN THE AMERICAS REGION, THE ARBITRATION SHALL BE HELD IN NEW YORK, U.S.A., UNDER THE CURRENT
COMMERCIAL OR INTERNATIONAL, AS APPLICABLE, RULES OF THE AMERICAN ARBITRATION ASSOCIATION. IF THE
DISPUTE IS INITIATED IN A COUNTRY IN THE ASIA PACIFIC REGION, THE ARBITRATION SHALL BE HELD IN SINGAPORE,
SINGAPORE UNDER THE CURRENT UNCITRAL ARBITRATION RULES. IF THE DISPUTE IS INITIATED IN A COUNTRY
OUTSIDE OF THE AMERICAS REGION OR ASIA PACIFIC REGION, THE ARBITRATION SHALL BE HELD IN AMSTERDAM,
NETHERLANDS UNDER THE CURRENT UNCITRAL ARBITRATION RULES. THE COSTS OF THE ARBITRATION SHALL BE
BORNE EQUALLY PENDING THE ARBITRATOR’S AWARD. THE AWARD RENDERED SHALL BE FINAL AND BINDING UPON
THE PARTIES AND SHALL NOT BE SUBJECT TO APPEAL TO ANY COURT, AND MAY BE ENFORCED IN ANY COURT OF
COMPETENT JURISDICTION. NOTHING IN THIS AGREEMENT SHALL BE DEEMED AS PREVENTING EITHER PARTY FROM
SEEKING INJUNCTIVE RELIEF FROM ANY COURT HAVING JURISDICTION OVER THE PARTIES AND THE SUBJECT MATTER
OF THE DISPUTE AS NECESSARY TO PROTECT EITHER PARTY’S CONFIDENTIAL INFORMATION, OWNERSHIP, OR ANY
OTHER PROPRIETARY RIGHTS. ALL ARBITRATION PROCEEDINGS SHALL BE CONDUCTED IN CONFIDENCE, AND THE
PARTY PREVAILING IN ARBITRATION SHALL BE ENTITLED TO RECOVER ITS REASONABLE ATTORNEYS’ FEES AND
NECESSARY COSTS INCURRED RELATED THERETO FROM THE OTHER PARTY.
U.S. GOVERNMENT RESTRICTED RIGHTS. The Software under this Agreement is "commercial computer software" as that term is
described in 48 C.F.R. 252.227-7014(a)(1). If acquired by or on behalf of a civilian agency, the U.S. Government acquires this
commercial computer software and/or commercial computer software documentation subject to the terms of this Agreement as
specified in 48 C.F.R. 12.212 (Computer Software) and 12.211 (Technical Data) of the Federal Acquisition Regulations ("FAR") and its
successors. If acquired by or on behalf of any agency within the Department of Defense ("DOD"), the U.S. Government acquires this
commercial computer software and/or commercial computer software documentation subject to the terms of this Agreement as
specified in 48 C.F.R. 227.7202 of the DOD FAR Supplement and its successors.
MISCELLANEOUS TERMS. You agree to pay BMC all amounts owed no later than 30 days from the date of the applicable invoice,
unless otherwise provided on the order for the License to the Products. You will pay, or reimburse BMC, for taxes of any kind, including
sales, use, duty, tariffs, customs, withholding, property, value-added (VAT), and other similar federal, state or local taxes (other than
taxes based on BMC’s net income) imposed in connection with the Product and/or the Support. This Agreement constitutes the entire
agreement between You and BMC and supersedes any prior or contemporaneous negotiations or agreements, whether oral, written or
displayed electronically, concerning the Product and related subject matter. No modification or waiver of any provision hereof will be
effective unless made in a writing signed by both BMC and You. You may not assign or transfer this Agreement or a License to a third
party without BMC’s prior written consent. Should any provision of this Agreement be invalid or unenforceable, the remainder of the
provisions will remain in effect. The parties have agreed that this Agreement and the documents related thereto be drawn up in the
English language. Les parties exigent que la présente convention ainsi que les documents qui s’y rattachent soient rédigés en anglais.
SW EULA Int 030102

Notes

*16982*

Control-M Installation Guide

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Control-M Installation Guide

Uploaded by

Copyright:

Available Formats

CONTROL-M

June 20, 2002

Restricted Rights Legend

Contacting BMC Software

Support Web Site

Support by Telephone or E-mail

Before Contacting BMC Software

BMC Software, Inc., Confidential and Proprietary Information

BMC Software, Inc., Confidential and Proprietary Information

iv CONTROL-M Installation Guide - Book 3

About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Chapter 2 Post-Installation Configuration

BMC Software, Inc., Confidential and Proprietary Information

Chapter 5 Uninstalling CONTROL-M/EM On Windows Computers

Chapter 6 Uninstalling CONTROL-M/Server for Unix

Chapter 7 Uninstalling CONTROL-M/Server for Microsoft Windows

Chapter 8 Uninstalling CONTROL-M/Agent for Microsoft Windows

BMC Software, Inc., Confidential and Proprietary Information

vi CONTROL-M Installation Guide - Book 3

Figure 3-1 Microsoft SQL Server Enterprise Manager . . . . . . . . . . . . . . . . 3-6

BMC Software, Inc., Confidential and Proprietary Information

viii CONTROL-M Installation Guide - Book 3

Table 2-1 Fields in the CONTROL-M Dialog Box . . . . . . . . . . . . . . . . . . 2-11

BMC Software, Inc., Confidential and Proprietary Information

x CONTROL-M Installation Guide - Book 3

About This Book

This book is Part 3 of the CONTROL-M Installation Guide. It describes

How This Book Is Organized

BMC Software, Inc., Confidential and Proprietary Information

BMC Software, Inc., Confidential and Proprietary Information

xii CONTROL-M Installation Guide - Book 3

• CONTROL-M Quick Installation Guides describe a default

• CONTROL-M/Enterprise Manager User Guide describes

• CONTROL-M/Desktop User Guide describes an application used

• CONTROL-M/Enterprise Manager Administrator Guide

• CONTROL-M/Server Administrator Guides each describe setup,

• CONTROL-M User Manual (for OS/390) is a complete guide to

BMC Software, Inc., Confidential and Proprietary Information

To Access Online Books

Online books are provided as Portable Document Format (PDF) files.

In some cases, installation of Acrobat Reader and downloading the

To Request Additional Printed Books

BMC Software, Inc., Confidential and Proprietary Information

xiv CONTROL-M Installation Guide - Book 3

Printed release notes accompany each BMC Software product. Release

• updates to the installation instructions

BMC Software, Inc., Confidential and Proprietary Information

The following conventions are used in this guide:

<key> When describing keystrokes, angle brackets are

Users and Groups => Groups => Add

means that you first select Users and Groups from

means that you specify either AND or OR.

BMC Software, Inc., Confidential and Proprietary Information

xvi CONTROL-M Installation Guide - Book 3

BMC Software, Inc., Confidential and Proprietary Information

xviii CONTROL-M Installation Guide - Book 3

This book describes how to configure your CONTROL-M environment.

For more information about the process of installing CONTROL-M

BMC Software, Inc., Confidential and Proprietary Information

1-2 CONTROL-M Installation Guide - Book 3

BMC Software, Inc., Confidential and Proprietary Information

Post-Installation Configuration 2-1