Professional Documents
Culture Documents
Manager
Administrator Guide
r1 SP3
First Edition
This documentation and related computer software program (hereinafter referred to as the "Documentation") is for
the end user's informational purposes only and is subject to change or withdrawal by Computer Associates
International, Inc. ("CA") at any time.
This documentation may not be copied, transferred, reproduced, disclosed or duplicated, in whole or in part,
without the prior written consent of CA. This documentation is proprietary information of CA and protected by the
copyright laws of the United States and international treaties.
Notwithstanding the foregoing, licensed users may print a reasonable number of copies of this documentation for
their own internal use, provided that all CA copyright notices and legends are affixed to each reproduced copy.
Only authorized employees, consultants, or agents of the user who are bound by the confidentiality provisions of
the license for the software are permitted to have access to such copies.
This right to print copies is limited to the period during which the license for the product remains in full force and
effect. Should the license terminate for any reason, it shall be the user's responsibility to return to CA the
reproduced copies or to certify to CA that same have been destroyed.
To the extent permitted by applicable law, CA provides this documentation "as is" without warranty of any kind,
including without limitation, any implied warranties of merchantability, fitness for a particular purpose or
noninfringement. In no event will CA be liable to the end user or any third party for any loss or damage, direct or
indirect, from the use of this documentation, including without limitation, lost profits, business interruption,
goodwill, or lost data, even if CA is expressly advised of such loss or damage.
The use of any product referenced in this documentation and this documentation is governed by the end user's
applicable license agreement.
Provided with "Restricted Rights" as set forth in 48 C.F.R. Section 12.212, 48 C.F.R. Sections 52.227-19(c)(1) and
(2) or DFARS Section 252.227-7013(c)(1)(ii) or applicable successor provisions.
All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.
Contents
Chapter 1: Introduction 7
Documentation Set................................................................................................................ 7
Contact Customer Support ..................................................................................................... 7
Contents iii
Defining the PROFILE Data Set Used by the SCHSRVR Task ................................................. 28
Modifying the SCHSRVR Task .......................................................................................... 29
Identifying the SCHSRVR Started Task to the Host Security Systems..................................... 30
Merging the Unicenter CA-7 Product Table......................................................................... 31
Restarting CAIENF ......................................................................................................... 31
Updating Unicenter CA-7 ................................................................................................ 32
Starting CA-CPS ............................................................................................................ 32
iv Administrator Guide
Configuration Manager ................................................................................................... 71
Setup Tab .................................................................................................................... 71
CAICCI Link Definitions................................................................................................... 72
Verifying CAICCI Link Status ........................................................................................... 72
Adding and Configuring Servers ....................................................................................... 72
Verifying Server Status................................................................................................... 72
Adding Host Access Link Definitions.................................................................................. 73
Security Tab ................................................................................................................. 73
Environment Tab ........................................................................................................... 75
Deploy Tab ................................................................................................................... 75
Stopping and Restarting Services .......................................................................................... 76
Restarting User Sessions ................................................................................................ 77
Logging In to the Portal ....................................................................................................... 78
Session Security ................................................................................................................. 78
Modifying Session Timeout Values ......................................................................................... 78
CleverPath Portal Timeouts ............................................................................................. 79
Scheduling and Monitoring Timeouts ................................................................................ 79
Timeouts for Other Servers ............................................................................................. 79
SAP Java Connector............................................................................................................. 80
Contents v
Tomcat with IIS-SSL .....................................................................................................100
Troubleshooting Tips .....................................................................................................100
Index 125
vi Administrator Guide
Chapter 1: Introduction
This guide describes configuration tasks you must perform to enable Unicenter
Enterprise Job Manager to function in your enterprise. It is intended for system
administrators.
Documentation Set
The following guides are provided with Unicenter Enterprise Job Manager:
Unicenter Enterprise Job Manager Release Summary
Unicenter Enterprise Job Manager Administrator Guide
Unicenter Enterprise Job Manager Host Access User Guide
Introduction 7
Chapter 2: Concepts and Components
This chapter helps you to become familiar with the layout of Unicenter
Enterprise Job Manager, and to understand its basic concepts and
components.
Architecture
The Unicenter Enterprise Job Manager architecture has three tiers:
Web client tier
Server tier
Back-end system tier
The tiers and their functions are depicted in the following illustration:
From the web client tier, you use the main interface to access the primary
Unicenter Enterprise Job Manager functions. The main interface uses
CleverPath Portal, which is required at installation.
Server Tier
Most of the work is performed in the server tier. This level includes the
interfaces, servlets, servlet engines, and adapters, including the portal
application. Each functional category has its own servlet deployed in a
private servlet engine.
10 Administrator Guide
Job Command Center
With Job Command Center, your enterprise will have all the information
required to efficiently and effectively manage the job management function.
The following sections describe the portlets included in Job Command Center:
Quick Start
The Quick Start portlet displays links to the Unicenter Enterprise Job Manager
features to which the current user has access. Depending upon your access
level, the Quick Start portlet may display the following features:
Configuration
Job Editor
Event Console
Host Access
Job Flow Design
Job Flow Monitoring
Job Flow Overview
Job Status Console
To launch a feature, click its name in the Quick Start portal. The selected
feature opens in a separate window.
The Job Status Views portlet displays the Job Status Console view name and
dashboard status for all the views in the enterprise. Click any view name to
launch Job Status Console, displaying the selected View.
Users and system administrators can use the Job Flow Summary View portlet
to create and publish Job Flow Summary Views. Job Flow Summary Views
consist of one or more Job Flows, and display graphical status information for
the Job Flow (in pie chart or bar chart form) and a list view that summarizes
status information for the jobs in the Job Flow.
From the Job Editor Find Object portlet, schedulers and other authorized users
can search for a particular job or job object, or perform a wildcard search on a
character string to locate a particular job or job object on the selected
Unicenter AutoSys Job Management or Unicenter CA-7 Job Management
server.
From the Job Editor Create Object portlet, schedulers and other authorized
users can launch Job Editor in context to create a job or job object on the
selected Unicenter AutoSys Job Management or Unicenter CA-7 Job
Management server.
The CCI Link Status portlet summarizes the status of all CCI Links defined on
the Unicenter Enterprise Job Manager server. Click a CCI Link name to launch
Configuration, displaying the properties of the selected CCI Link.
Server Status
The Server Status portlet summarizes the status of all Unicenter AutoSys Job
Management and Unicenter CA-7 Job Management servers defined on the
Unicenter Enterprise Job Manager server. Click a server name to launch
Configuration, displaying the properties of the selected server.
12 Administrator Guide
Job Command Center
Services Status
The Services Status portlet summarizes the status of the Unicenter Enterprise
Job Manager services. Click an entry to launch Configuration, displaying the
Services page.
Shift Notes
The Shift Notes portlet lets you add and review notes in a discussion board
format.
Job Editor
The Job Editor lets you perform tasks related to job management and
scheduling. You can view, create, modify, and delete jobs and their associated
objects, including jobsets (box jobs or systems), calendars, predecessor jobs,
successor jobs, triggers, and global variables.
The interface provides a tree (in the left pane) to display the objects defined in
your enterprise. You can filter the tree view to focus on a specific set of jobs or
job objects.
When you select an object in the tree, the right pane provides detailed
information about that object through multiple views.
The Job Editor lets you administer all of your job scheduling objects using the
following views:
Flow View
The Flow View offers a graphical representation of the logical flow of job
execution. This view displays the dependencies of a jobset or job, showing
you its predecessors and successors.
14 Administrator Guide
Job Editor
Requirements View
For more information about the Job Editor, see the Job Editor Help.
Operating Modes
Availability of the Job Flow Design applet depends upon your authorized level
of access.
16 Administrator Guide
Job Flow Monitoring
When you launch Job Flow Monitoring, the left pane displays the Job Flows
defined for your enterprise. Expand a Job Flow object to display its jobs and
jobsets.
Each node in the tree displays an icon reflecting the real-time status of the
current object, helping you to identify job streams that require attention.
The right pane of Job Flow Monitoring provides detailed information about the
objects in the Job Flow through a variety of views:
Graph View
Displays the overall health of the system at a glance. The segments of the
graph illustrate the status of the Job Flow components, the jobs and
jobsets. Each status, such as Running, Inactive, or Success, is color-
coded. A legend identifies the associations between color and status. When
you move the mouse over a particular segment, the status and percent
represented by that segment appears. You can also view this graph as a
bar chart.
List View
Flow View
Displays the flow of the jobs in a selected Job Flow in a graphical format,
in which colors represent status and lines with different styles and colors
represent relationships. This view can be at the Job Flow level or at the
Job level.
Requirements View
Displays a focused form of the Flow View, with all the job objects directly
related to the job you selected.
Properties
For more information about Job Flow Monitoring features and views, see the
Job Flow Monitoring Help.
The Job Status Console provides a powerful alternative to the Job Flow
Monitoring interface. Advantages of the Job Status Console include ease of
use, compatibility with Java and non-Java browser platforms, and
performance.
For more information, see the Release Summary and the Job Status Console
Help.
18 Administrator Guide
Job Status Console
From the Job Status tab, you can see the status of the jobs for the selected
job management server or view.
From the list of jobs, you can select a job and view its details. The details
show the specific properties for each job. From this point, you can manage the
job. For example, you can start, stop, or suspend the job, depending on the
job manager’s capabilities.
Alerts Tab
In the Job Status Console, you can define alert policies for your enterprise.
When the policies are deployed, you can click the Alerts tab to display all alerts
generated that match the criteria defined in your policies. You can
acknowledge or close alerts and AutoSys alarms from this view.
Dashboard Tab
From the Dashboard tab, you can see the statistical summary of job status
and alerts for the current server or view. In addition, you can set the policies
to define the severity level of the Dashboard. Based on this configured level of
severity, the Dashboard can display a visual cue to alert you to a potential
problem.
Specialized View
The Job Status Console also provides specialized views including CA-7’s Run
Log and Prior Run queues, the AutoSys Event Processor log, and standard
output, standard error, and remote agent logs.
For more information, see the Event Console Help (available from the Event
Console portlet), and the chapter “Configuring Event Management” in this
guide.
Host Access
The Host Access portlet provides a web-based terminal emulator to access
3270 host applications.
For more information, see the Host Access Help (available from the Host
Access portlet).
Configuration
Unicenter Enterprise Job Manager provides full system configuration
capabilities. System administrators can configure Job Scheduling, Job Flow
Monitoring, and Job Status Console runtime parameters, connectivity to
back-end servers, users, CAICCI nodes, OPS/MVS links, and services, and can
deploy configuration changes. In addition, administrators can assign
credentialed users and groups to back-end servers, providing both an
enhanced level of security and simplified logins for users accessing multiple
back-end servers.
20 Administrator Guide
Chapter 3: Installing Unicenter CA-7
Host Components
Before you install and configure the essential components used on your
Unicenter CA-7 host machine, make sure you are familiar with the
components, structure, and concepts of Unicenter Enterprise Job Manager, as
described in the chapter "Concepts and Components" in this guide.
2. Install CA-CPS.
10. Identify the SCHSRVR started task to the host security systems.
11. Merge the Unicenter CA-7 Product table into the CA Common Services for
z/OS ViewPoint Control table.
The following sections provide more information to help you configure your
Unicenter CA-7 server so that it can communicate with Unicenter Enterprise
Job Manager.
Before you install and configure the Unicenter CA-7 Host system, install the
required CA Common Services for z/OS components. You must ensure that all
of the required FMIDs are installed. These are listed in the z/OS Server
Minimum Requirements provided in the Unicenter Enterprise Job Manager
Readme file. If any FMIDs are missing, install them before continuing. For
instructions, see the CA Common Services for z/OS Getting Started guide.
22 Administrator Guide
Reviewing Your Installation Tasks
Installing CA-CPS
If the Unicenter® CA-7® Webstation Component is installed, you can skip this
step; however, you must verify that the configuration options are set as
detailed in this step.
After you have installed the necessary CA Common Services for z/OS
components, you must install CA-CPS. For instructions on installing CA-CPS
FMID CWR1000, see the CA Common Product Services Installation Guide.
For more information on the CA-CPS configuration values, see the CA-
Common Product Services Installation Guide.
After CA-CPS has been installed, you must link edit CAICCI with TCP/IP.
Requirements for link editing CAICCI with TCP/IP differ based on the
combination of TCP/IP and runtime libraries you are using. For a description of
the link edit process, see one of the following Computer Associates
publications:
CA Common Services for z/OS Getting Started
CA Common Services for z/OS Administrator Guide
The next step in the process is to configure the TCP/IP Gateway started task.
CAI.CAIPROC member CCITCPGW contains the JCL needed to run the CAICCI
TCP/IP Gateway server using IBM TCP/IP with LE/370.
If you do not have the SAS C Runtime modules in a LNKLST data set,
concatenate your runtime library to the appropriate CAICCI TCP/IP load
library. (Unicenter TCPaccess Communications Server provides the SAS C
Runtime library.) The Unicenter TCPaccess Communications Server load
library should be ahead of the SAS C library in the CCIGWI3 STEPLIB
concatenation.
If you do not have the IBM LE/370 or SAS C Runtime modules in a LNKLST
data set, concatenate your runtime library to the appropriate CAICCI
TCP/IP load library.
TCP/IP is normally provided with the operating system for most servers.
Consult your vendor documentation for more information.
The following sections provide instructions to define the values for the
PROTOCOL statement and identify a port number for your TCP/IP connections.
Examples are provided in the section following these instructions.
PROTOCOL Statement
To start the desired TCP address space for host-to-host connectivity, include
the PROTOCOL(TCPIPGW,...) statement in the data set pointed to by the
//ENFPARMS DD statement with your CAIENF started task JCL.
PROTOCOL(TCPIPGW,…) starts procedure CCITCPGW to use IBM TCP/IP (with
the IBM C Runtime) for host-to-host connectivity.
TCP/IP can be started before or after any of the CAICCI address spaces. If
TCP/IP services are not available, the Gateway server started task periodically
retries the connection until TCP/IP starts. If TCP/IP is shut down for any
reason, the Gateway server started task terminates. If originally started by
CAICCI, the Gateway server started task restarts automatically and again polls
for TCP/IP restart. Otherwise, you must restart the address space manually.
To manually restart the CAICCI Gateway server, issue the following console
command:
ENFPROTOCOL(TCPIPGW,...)
24 Administrator Guide
Reviewing Your Installation Tasks
Port Number
TCP/IP connections are based on network addresses, plus a port number. The
combination of address and port number uniquely identifies each application
on the network. CAICCI, like all other TCP/IP applications, requires that you
specify a port number for its use. This port number must be available to both
the mainframe CAICCI software and PC client systems.
Examples
IBM TCP/IP users
If CAICCI starts the TCP address space, override the port number using
the associated PROTOCOL statement in the //ENFPARMS DD statement of
the CAIENF started task JCL. For example:
SYSID(SYSA)
PROTOCOL(TCPIPGW,1721,,SYSA)
If CAICCI starts the TCP address space, override the port number using
the associated PROTOCOL statement in the //ENFPARMS DD statement of
the CAIENF started task JCL. For example:
SYSID(SYSA)
PROTOCOL(TCPIP3GW,SSID=ACSS:1721,,SYSA)
To test TCP/IP communications from the server, issue the following command
from a command prompt:
PING ipaddr
where ipaddr is the TCP/IP address or the DNS name of the target Unicenter
CA-7 host system where CA-CPS is installed.
Ask your network systems programmer for the TCP/IP address or DNS name
of the host computer where TCP/IP is installed and running.
PING ipaddr
Where ipaddr is the TCP/IP address or the DNS name of the server on which
Unicenter Enterprise Job Manager is to be installed.
26 Administrator Guide
Reviewing Your Installation Tasks
You must customize CAIENF with the spawn parameters necessary to start the
Unicenter Enterprise Job Manager communications task. To define the spawn
parameters, create a PDS member to contain the CAICCI spawn parameters.
The CAIENF procedure SPNPARMS DD statement points to these parameters.
The spawn parameters describe the SCHSRVR started task and allow it to be
started when Unicenter Enterprise Job Manager makes an initial session
request through CA-CPS to Unicenter CA-7. When this request is initiated, CA-
CPS issues a CAICCI SPAWN request (on behalf of the requestor) to CAIENF
that, upon completion, initiates the SCHSRVR started task that communicates
with Unicenter CA-7.
The following are sample spawn parameters you can use to point to the
SCHSRVR member addressed by the SPNPARMS DD statement:
The CA Common Services for z/OS sample JCL library contains member
WCnnPROF to allocate the Profile data set, where nn represents the version
number. This is a partitioned data set containing at least one member. The
name of that member is CACCENV.
Note: The version number replaces nn. If the version number is 2.0, the JCL
member is WC20PROF.
CA7APPL=applid
CA7SESS=high_acb_name
where:
applid
identifies the VTAM APPLID for the Unicenter CA-7 task with which the
server is to communicate. The applid is in the Unicenter CA-7 initialization
file on the APPL= keyword of the UCC7VTAM statement.
high-acb-name
identifies the set of VTAM ACB names the Unicenter CA-7 application
programming interface (API) can use locally to establish communications
with Unicenter CA-7. For example, if you have ten ACBs (CA70001 through
CA70010), you should specify CA7SESS=CA70010. The interface deduces
from this that there are ten ACBs from which to choose, and locates an
available ACB from that pool.
For more information about these parameters, see the Unicenter CA-7
Interfaces Guide, CA-7/API Requirements.
28 Administrator Guide
Reviewing Your Installation Tasks
//SCHSRVR PROC
//*
//SCHSRVR EXEC PGM=CCISRVR,REGION=4M
//STEPLIB DD DISP=SHR,DSN=CAI.CAILIB
//SYSPRINT DD SYSOUT=*,FREE=CLOSE
//PROFILE DD DISP=SHR,DSN=CA.UNI.PROFILE
Note: If the z/OS load library for Unicenter CA-7 is not in the z/OS systems
LINKLIST, you must add it to the STEPLIB DD concatenation.
You must define the SCHSRVR task to the security package installed on the
z/OS server to permit CAIENF authority to START and CANCEL the SCHSRVR
procedure.
SET LID
INSERT SCHSRVR MUSASS MUSUPDT STC
Add the SCHSRVR started task to the eTrust CA-Top Secret started task
table:
For RACF
Define the SCHSRVR started task to the STARTED task RACF class. The
following example shows the command necessary for the z/OS security
server:
RDEFINE STARTED
(SCHSRVR.?) STDATA (USER(=MEMBER) GROUP(STCGRP))
30 Administrator Guide
Reviewing Your Installation Tasks
After you have identified the SCHSRVR task to the host security systems, you
must merge the Unicenter CA-7 Product Table into the CA Common Services
for z/OS ViewPoint Control Table.
The CA Common Services for z/OS sample JCL library contains member
WCnnMRG, where nn represents the version number. This member is created
when you install the ViewPoint common component CWC1200 or CWC2000.
WCnnMRG is the model JCL that merges individual product tables into the
CA4FAPPL table.
Note: The version number replaces nn. If the version number is 2.0, the JCL
member is WC20MRG.
The following Unicenter CA-7 Product Table must be merged for Unicenter
Enterprise Job Manager:
Control Table name: CA4FAPPL
Product Table name: CAL2APPL
Description: Unicenter CA-7 Application Control Table
For more information about the Unicenter CA-7 Product Table, see the
Unicenter CA-7 Interfaces Guide, CA-7/API Requirements.
Restarting CAIENF
You must restart CAIENF so that the changes you entered in the previous
steps take effect.
After you restart CAIENF, perform the following steps to update Unicenter CA-
7 (if needed):
CALENDAR,DSN=calendar.dsnname
2. Enable the online Calendar maintenance facility. This feature lets you
create, update, and delete Unicenter CA-7 base calendars without the
need for z/OS batch assemblies. Add the following statement to your
Unicenter CA-7 initialization file:
CALENDAR, DSN=calendar.dsname
3. Enable Unicenter CA-7 mixed case editor support to allow you to use
mixed case in JCL and prose. This is critical to support cross-platform
scheduling definitions. Ensure that the following keyword is specified in the
OPTIONS statement in the Unicenter CA-7 initialization file:
OPTIONS,INITCASE=YES
4. Ensure that the user IDs used to log on to Unicenter Enterprise Job
Manager are authorized for use with Unicenter CA-7.
If you made any changes to the initialization file, restart Unicenter CA-7 to
activate the changes. For more information about virtual terminal definitions
and the Unicenter CA-7 initialization file, see the topic CA-7/API Requirements
in the Unicenter CA-7 Interfaces Guide.
Starting CA-CPS
When you have completed all of the preceding steps, you can start the CA-CPS
started task you installed previously (see Installing CA-CPS (on page 23)).
32 Administrator Guide
Chapter 4: Installing and Configuring
Unicenter AutoSys Job Management
Components
One of the following Unicenter AutoSys Job Management components must be
installed and configured to access an AutoSys instance:
Java Listener
Remote Command Service (RCS)
For Unicenter AutoSys Job Management r4.5 installations, use either the Java
Listener or the Remote Command Service. For Unicenter AutoSys Job
Management r4.0 installations, use the Java Listener.
Prerequisites
Before installing the Java Listener, verify that you have the following software
and settings:
Sun Java Runtime Environment (JRE) 1.4
If you are installing the Java Listener on the AIX operating system, see
Configuring Java for AIX (on page 38).
A Unicenter AutoSys Job Management 4.0 or 4.5 Event Processor machine
or Remote Agent machine. The Java Listener will run on one of these
machines.
To install the Java Listener using the Unicenter AutoSys Job Management Web
Interface r4.5 installation media, perform the following steps:
3. Expand the JavaListener directory and select the directory for your
platform (for example, AIX, HP, Linux, Solaris, Tru64, or Windows).
4. Copy the entire directory for the selected platform to a new directory on
your machine. While you can create a directory anywhere on your system,
we recommend that you create the directory structure as follows:
Windows
Program Files\CA\UnicenterAutoSysJMJavaListener
/opt/CA/UnicenterAutoSysJMJavaListener
34 Administrator Guide
Installing and Configuring the Java Listener
You must configure the Java Listener to work properly with Unicenter AutoSys
Job Management.
Note: After modifying configuration files, you must restart the Java Listener.
Edit the file autosysenv.cfg, located in the Java Listener root directory. Add the
following definitions:
Definition Description
Note: Only one instance of the Java Listener can be installed on a server. If
you have more than one instance of Unicenter AutoSys Job Management
installed on the AutoSys Event Processor machine, you can make multiple
entries in autosysenv.cfg.
Windows
port=5555
ACE:AUTOSYS=C:\Program Files\CA\UnicenterAutoSysJM.ACE\autosys
ACE:AUTOUSER=C:\Program Files\CA\UnicenterAutoSysJM.ACE\autouser
ACE:AUTOREMOTEDIR=C:\Program Files\CA\UnicenterAutoSysJM.ACE\tmp
ACE:logdir=C:\tmp1
ACE:eplogfile=C:\Program Files\CA\UnicenterAutoSysJM.ACE\autouser\out\event_demon.ACE
ACE:lines=200
A40:AUTOSYS=C:\Program Files\CA\UnicenterAutoSys.A40\autosys
A40:AUTOUSER=C:\Program Files\CA\UnicenterAutoSys.A40\autouser
A40:AUTOREMOTEDIR=C:\Program Files\CA\UnicenterAutoSys.A40\tmp
A40:logdir=C:\Program Files\CA\UnicenterAutoSys.A40\tmp
A40:eplogfile=C:\Program Files\CA\UnicenterAutoSys.A40\autouser\out\event_demon.A40
A40:lines=200
Unix
port=4444
ACE:AUTOSYS=/autosys/LINUX/ORA/autosys
ACE:AUTOUSER=/autosys/LINUX/ORA/autouser
ACE:AUTOREMOTEDIR=/tmp
ACE:eplogfile=/autosys/LINUX/ORA/autouser/out/event_demon.ACE
ACE:lines=200
36 Administrator Guide
Installing and Configuring the Java Listener
The next step in configuring the Java Listener is to edit the validips
configuration file, which is located in the Java Listener root directory.
You must add the IP addresses of the Unicenter Enterprise Job Manager server
machines that will access this Java Listener. Type each IP address on its own
line, as shown below:
127.0.0.1
123.123.123.123
222.222.222.222
You must designate who can start or stop the Java Listener.
User Permission
The user who starts the Java Listener should have the Unicenter AutoSys Job
Management Edit Superuser privilege. Also, the user who starts the Java
Listener must have write privileges to the directory where the Listener resides.
Windows
On Windows, the user must also have the rights “Act as part of the
operating system” and “Log on as a service.”
To set the right “Act as part of the operating system,” do the following:
2. Expand the Local Policies folder and select User Rights Assignment.
4. Add the user name to the list, and then click OK.
To set the right “Log on as a service,” perform the previous steps again,
except at Step 4, select the “Log on as a service” policy.
UNIX
38 Administrator Guide
Installing and Configuring the Java Listener
Windows
On Windows:
UNIX
On UNIX:
To start the listener, execute the startListener.sh file from the Java
Listener directory.
To stop the listener, execute the stopListener.sh file from the Java
Listener directory.
To test the Java Listener, start it, and then perform the tasks in this section.
To verify the user’s privilege, execute the following program located in the BIN
directory under the Java Listener directory:
where OSuserid and OSuserpassword are the user ID and password of the
user who has the privilege of starting the Listener.
To verify the Java Listener, open the file jil.log in the Java Listener directory.
If the listener is running correctly, you should see the following messages:
INFO [main] com.ca.uajm.eplis.jillistener.main - port initialized
INFO [main] com.ca.uajm.eplis.jillistener.main - Starting listener on port
= 4444
40 Administrator Guide
Installing and Configuring the Java Listener
From the Windows command prompt, change to the Java Listener directory,
and issue the following command:
where:
path
password
To start the Java Listener service, issue the following command, or start the
service from the Windows Services dialog:
SrvCtl start
To stop the Java Listener service, issue the following command, or stop the
service from the Windows Services dialog:
SrvCtl stop
SrvCtl remove
If you are installing the Java Listener on AIX, you must make sure JRE 1.4 is
properly configured.
Note: If you are installing the Java Listener on AIX 4.3.3, contact CA Technical
Support for additional information.
To configure JRE:
security.provider.1=sun.security.provider.Sun
security.provider.2=com.sun.crypto.provider.SunJCE
security.provider.3=com.ibm.security.jgss.IBMJGSSProvider
security.provider.4=com.ibm.security.cert.IBMCertPath
ssl.KeyManagerFactory.algorithm=SunX509
ssl.TrustManagerFactory.algorithm=SunX509
42 Administrator Guide
Installing and Configuring RCS
If you plan to use the Web Interface, you should select the RCS component for
installation when installing the Unicenter AutoSys Job Management r4.5 base
product.
The Remote Command Service (RCS) includes some configurable values and
files including the port number, number of lines to be retrieved from EPLOG,
Valid Hosts and IPs, and Valid Directories.
PORT NUMBER
4444
EPLOG LINES
Number of lines from the Event Processor log to retrieve and return to the
web server when handling an EPLOG request
200
Note: After installation the PORT NUMBER and EPLOG LINES values cannot be
modified.
The installation allows the user to configure the VALID HOSTS and IPs and the
VALID DIRECTORIES files for the RCS. In order for the graphical user interface
(GUI) and the RCS to communicate, the hostname for the GUI machine must
be entered. In order to view the output or error file through the GUI, the
directory path of the file must be entered.
After installation, the VALID HOST and IPs file and the VALID DIRECTORIES
file can be modified by editing the validips and valid_dirs files.
/opt/CA/SharedComponents/UnicenterAutoSys/data
After the installation, you may add or remove valid machines by modifying
the validips. Open the file with a text editor and add an IP address or the
hostname of the GUI machine to the list. RCS only accepts requests from
the machines listed in validips
127.0.0.1
Autosys
autosys-win32
146.124.55.132
44 Administrator Guide
Installing and Configuring RCS
VALID DIRS
The valid_dirs file contains a list of valid directories that the RCS uses to
find an output or error file from a job that has run successfully. To view a
job log through the GUI, the directory path of the output or error file must
be specified in this file.
/tmp
/home/autosys/logs
The valid directory refers to the directory that contains the standard
output or error file that was specified in the job definition.
insert_job: example
machine: localhost
command: dir
std_out_file: /tmp/dir.out
std_err_file: /tmp/dir.err
For a user to view the output from the preceding job using the GUI, the
directory, /tmp must be specified as a valid directory. When trying to view
a log in which the directory is not an entry in the valid_dirs file, the
request will fail the GUI will display a message saying the directory is not
valid.
Note: RCS must be restarted after any modifications are made to either
one of these two files.
Use the start_rcs and stop_rcs scripts located in the autosys/bin directory to
start and stop RCS.
Logging
All RCS messages including GUI requests and errors are written to the RCS log
file, asrcslsn.log.
These messages are useful when a job may have been added, modified, or
deleted from the Event Server, when a web user is mapped, or when an EP or
Joblog request is issued through the GUI. You can also use this log file for
troubleshooting. For example, when a user tries to add a job through an
unknown GUI (that is, through a GUI machine that is not listed as a valid
machine in the validips configuration file), the RCS log lists which GUI machine
must be added to the validips configuration file.
The RCS log file rolls over daily, at midnight, and the product renames the
previous day's file asrcslsn.previous_date. A new log file is then created to
receive the current day's messages. Because each day has a unique RCS log
file, you should perform regular maintenance on the log files to ensure disk
space availability.
Debugging
When a problem occurs, RCS can write more specific system debug
information to the log file. This is controlled through the RCSDEBUG system
environment variable:
To have RCS write this information to the log file, set the value to 1.
Set and export the variable using the syntax of your current shell.
RCSDEBUG=ON
export RCSDEBUG
46 Administrator Guide
Chapter 5: Installing Unicenter Enterprise
Job Manager
This chapter explains the following installation procedures:
How to install Unicenter Enterprise Job Manager on the server
How to install CA Common Services
You must ensure that all Unicenter-related processes and services, including
CAICCI and CA Common Services, are stopped or shut down before starting
the installation.
To install Unicenter Enterprise Job Manager on the server, insert the Unicenter
Enterprise Job Manager installation media into the drive of the computer on
which you are installing the product. The CA Unicenter Enterprise Job Manager
Product Explorer opens.
If the CA Unicenter Enterprise Job Manager Product Explorer does not start,
double-click the installation media drive letter in My Computer, then run
setupwin32.exe. The Product Explorer Wizard appears with the options Install
Unicenter Enterprise Job Manager and Install CA Common Services. The Install
Unicenter Enterprise Job Manager option is selected by default.
Note: The Product Explorer lets you explore the product, view product
descriptions, and review the Readme file before installing.
Click the Install button, then follow the on-screen prompts to complete the
installation. (For CCS installation procedures, see Installing CA Common
Services.
48 Administrator Guide
Installing Unicenter Enterprise Job Manager
As the Response File is created, you are prompted for a reboot preference.
This does not cause the machine to reboot during the generation of the
Response File. At the end of the procedure, a response file is created. The
default location is C:\Documents and Settings\administrator\setup.rep.
You can accept the location or browse to a directory of your choice. When
browsing to a directory, you must specify a filename. For more
information, see Installing Unicenter Enterprise Job Manager (on page 39).
Important! Before you invoke silent installation from the command line,
you must be aware of licensing information.
2. Refer to the TERMS AND CONDITIONS FOR THE USE OF Java™ 2 Runtime
Environment (J2RE), Standard Edition, Version 1.4.2_X in the
Acknowledgements section of the Unicenter Enterprise Job Manager
Administrator Guide.
Note: Enter the full path to access the response file. If you install from an
installation media, you must begin the installation from the hard drive of
your machine, and specify the fully qualified path to setup.exe. If the path
to setup.exe contains spaces, you must enclose the path with double
quotes.
2. In the dialog, select Unicenter Enterprise Job Manager and follow the
prompts.
50 Administrator Guide
Installing CA Common Services
Note: You must ensure that all Unicenter-related processes and services,
including CAICCI, are stopped or shut down before starting the installation.
Note: If you are installing CA Common Services from the Product Explorer,
after installing Unicenter Enterprise Job Manager, you must restart the system
first.
If the CA Unicenter Enterprise Job Manager Product Explorer does not start,
double-click the installation media drive letter in My Computer, then run
setupwin32.exe. The Product Explorer Wizard appears with the options Install
Unicenter Enterprise Job Manager and Install CA Common Services. The Install
Unicenter Enterprise Job Manager option is selected by default.
Select the Install CA Common Services option, then click the Install button.
Follow the on-screen prompts to complete the installation.
As the Response File is created, you are prompted for a reboot preference.
This does not cause the machine to reboot during the generation of the
Response File. At the end of the procedure, a response file is created. If
any element of CCS has been previously installed, you cannot change the
install locations. We recommend that you use the installation locations
identified in this screen.
Important! Before you invoke silent installation from the command line,
you must be aware of licensing information.
setup /S /f1”<ResponseFilePath>:\ccsSetup.iss"
Note: Enter the fully qualified path to access the response file. If you
install from an installation media, you must begin the installation from the
hard drive of your machine, and specify the fully qualified path to
setup.exe. If the path to setup.exe contains spaces, you must enclose the
path with double quotes. Also, there is no space between f1 and the path
statement.
52 Administrator Guide
Chapter 6: Configuring Unicenter
Enterprise Job Manager
When the installation process is complete, you must prepare Unicenter
Enterprise Job Manager for use. This chapter explains the steps necessary to
configure Unicenter Enterprise Job Manager, including:
Adding portal users to workgroups
Creating CAICCI link definitions
Adding and configuring servers
Adding and configuring users and security
Configuring the environment
Deploying changes
Configuration Tasks
Configuration tasks for Enterprise Job Manager include the following:
Setting the CPS_MULTI_SERVER environment variable
Adding Portal Users
Adding CAICCI Link Definitions
Adding and Configuring Servers
Adding HostAccess Link Definitions
Create Unicenter Enterprise Job Manager Users
Create Credentialed Groups
Create Credentialed Users
Deploying changes
Setting Up Portal
Note: we strongly recommend that you modify the default Portal admin
password, to enhance security. When you modify the Portal admin password,
you must also update the value of this parameter in UEJM Configuration, on
the Environment tab and the Monitoring Server subtab.
Portal Workplaces
Workplaces help you organize the objects and workplace elements to which
you have access. Unicenter Enterprise Job Manager provides a default
workplace for each sample Portal user, or you can create your own. You can
customize the content and layout of your workplace, and you can define
multiple workplaces to further organize information. For information about
setting up workplaces, see the documentation for your portal. After you define
and customize your workplace, you can assign users to the default
workgroups.
54 Administrator Guide
Configuration Tasks
Portal Workgroups
EJM_JobFlow_Overview
EJM_JobFlow_Run
This workgroup allows users to monitor jobs at a detailed level. The portlet
assigned to this workgroup is Job Flow Monitoring.
EJM_JobEditor
This workgroup allows users to create and manage jobs and related
objects (calendars, schedules, global variables, datasets, ARFSETS, and so
on). The portlet assigned to this workgroup is Job Editor.
EJM_JobFlow_Design
This workgroup provides access to create, modify, and delete job flows
through the assigned portlet, Job Flow Design.
EJM_Configuration
EJM_Event
This workgroup allows users to access and use the Event Console to
monitor events in the enterprise, through the assigned launch portlet,
Event Console.
EJM_HostAccess
This workgroup allows users to access and use the 3270 host access
facility through the assigned portlet, Host Access.
EJM_JobStatusConsole
This workgroup allows users to monitor jobs and alerts through the Job
Status Console. The portlet assigned to this workgroup is Job Status
Console.
56 Administrator Guide
Configuration Tasks
Portal Users
The Portal Administrator can create users and assign them to one or more
workgroups, to provide access rights appropriate for the user’s responsibilities.
This provides maximum flexibility in administering Unicenter Enterprise Job
Manager.
You must add portal users for each user or user group and assign the user to
an appropriate workgroup. To do so, follow these steps:
2. Create new portal users. To assist you, sample users are installed with
Unicenter Enterprise Job Manager, as described in Portal Users in this
chapter.
The portal user ID is the key for user authentication. To significantly reduce
administrative effort, choose this ID carefully and consider the following:
If a user accesses one back-end server or system only, we recommend
that you use the same user ID for the portal and the back-end server. The
portal user ID and password are used as credentials to access the back-
end server.
If your enterprise uses a common user ID and different passwords for
multiple systems, we recommend that you use this user ID for the portal.
You can create a credentialed user for each back-end server or system and
use the Server Password feature. For more information about credentialed
users, see the Configuration Help.
New portal user IDs should meet the most restrictive naming conventions
applicable to back-end servers or systems. You can create a credentialed
user for each back-end server the user can access, using the Alias ID and
Password feature.
There are several ways to add users. You can create users from scratch, copy
them from existing users, or import them from another source. Alternately, by
enabling self registration, you can let users create their own accounts, which
you then only need to review and activate.
If your portal is likely to attract a large number of new users, it may become
too time-consuming for you, as portal administrator, to register each user
individually. You can set the portal server up so that it lets new users register
themselves. This involves completing several forms, including the Manage
Users, Manage Users - Editing, and User Self Registration Properties forms.
After you enable user self registration, new users can gain access to
appropriate areas of the portal as soon as they provide a unique user name
and password on the Register form in the portal client. For more information
about this form, see the CleverPath Portal User Help.
1. Create a new user account to use for a standard or guest user. For
example, you might create a user called Guest with password guest. New
unregistered users initially log in to the portal using the Guest user
account. For information about creating a new user account, see Add a
Single User.
2. Log out as the Admin user and log in to CleverPath Portal as the guest
user.
4. Log out of the guest user's account and log back in as the Admin user.
6. Click Search to list the users currently defined on the portal server.
7. Choose the new Guest user from the list box, then click Edit. The Manage
Users - Editing form opens.
9. Click Save to save changes to the guest user's profile and close the
Manage Users - Editing form.
11. Complete the fields in the User Self Registration Properties form as
appropriate. The Allow User Self Registration check box must be selected.
12. Click Save to save changes and close the User Self Registration Properties
form.
58 Administrator Guide
Configuration Tasks
Users may now register themselves with the portal server according to the
properties you specified for self-registration. To do so, they must log in to the
guest user account, click Register in the top right corner, and then complete
and submit the Register form.
Creating user accounts from scratch is accomplished using the Manage Users
- Adding form. To add a new user account to the portal server, follow these
steps:
2. Click Add to add a new user. The Manage Users - Adding form opens.
4. Click Save to add the new user. The Manage Users - Adding form closes
and the list box on the Manage Users form updates to include the new
user.
5. Repeat Steps 2 through 4 to add another user, or choose a user from the
list box and click Edit to edit that user's information.
Fields
Username - Identifies the user ID for the new user. This name
classifies the user throughout CleverPath Portal. The user enters
the value assigned here during login.
60 Administrator Guide
Configuration Tasks
Note: This drop-down list has None as its only option until you
move one or more workgroups into the subsequent Member of
list box, at which time those workgroups become available for
selection here.
62 Administrator Guide
Configuration Tasks
– User Admin - Users with this role have access to the Manage
Users form of Portal Administration. They are able to add,
delete, and modify users in the associated workgroup (and its
subgroups) only. Users with this role can also assign users to
the associated workgroup.
Command Buttons
Save - Saves the user's profile and adds the user to the portal
server's database.
Copying a user from an existing user to reduce data entry (copying basic user
profile data and then adding user-specific information) is accomplished using
the Manage Users - Duplicating form. To base a new user's account profile on
that of an existing user, follow these steps:
2. In the list box of existing users, choose the base user whose profile you
want to use for the new user.
5. Click Save to add the new user. The Manage Users - Duplicating form
closes and the list box in the Manage Users form updates to include the
new user. The portal server creates the new user's account with the same
settings that exist in the base user's profile. If you selected the Yes radio
button for Copy Workplaces, the base user's workplaces are copied to the
new user's workplaces.
64 Administrator Guide
Configuration Tasks
When user and authentication information for multiple users already exists on
another server or database, you can save time by uploading it all at once to
the portal server.
Note: When importing user and workgroup information, you must explicitly
set the default workgroup.
For information about how to configure the portal server to upload user and
authentication information for multiple users, see the following topics:
Import User Information from CSV Files
Import User Information from LDAP Servers
Import User Information from NIS Servers
You can use the CSV Properties form to configure the portal server to import
user and authentication information from a Comma Separated Variables (CSV)
file located on the machine on which the portal server is running. A CSV file is
used as a portable representation of a database. Each line represents one
entry or record, and the fields in a record are separated by commas.
Note: Workgroup information can also be imported here from a CSV file. In
Step 3, you have the ability to enter a CSV Group Filename and its
corresponding CSV Group Fields.
To upload user and authentication information from a CSV file, follow these
steps:
1. Verify that the CSV files that contain the user (and workgroup) information
you want to import exist on the machine on which the portal server is
running.
2. From the Properties menu in Portal Administration, click CSV. The CSV
Properties form opens.
4. Click Import. The fields are imported to the portal server from the CSV
file(s).
5. Click Update Changes. The information entered on the CSV Properties form
is saved. The new users are listed on the Manage Users form in Portal
Administration.
You can use the LDAP Properties form to configure the portal server to import
user and authentication information from a Lightweight Directory Access
Protocol (LDAP) server. To do so, you must have administrator rights to the
portal server. To upload user and authentication information from an LDAP
server, follow these steps:
1. Verify that the applicable LDAP servers are running and that the user
information you want to import exists.
2. From the Properties menu in Portal Administration, click LDAP. The LDAP
Properties form opens.
3. Update the Schedule Interval to how often, in minutes, you want the LDAP
servers to update the information, or set it to "-1" to run immediately only
once. Click the Import check box for each LDAP server from which you
want to import user and authentication information, and make any
changes necessary to the server definitions. If the LDAP server from which
you want to import has not been defined, complete the fields in the Add
New Server section of the LDAP Properties form as appropriate, and then
click Add New Server. The LDAP Properties form refreshes, and you can
now import from the newly defined server. Click Update Changes. The
portal server saves the server definition information.
4. From the Microsoft Windows, UNIX, or Linux command line, use the cd
command to change to the directory where the portal server is installed.
5. On Windows systems, type import ldap to run the Importer tool. On UNIX
or Linux systems, type import.sh ldap to run the Importer tool. The
Importer tool is a command-line program provided with the portal server
that lets you import user and authentication information from LDAP
servers, NIS servers or CSV files.
6. Press Enter. The portal server uploads the user information from the LDAP
servers you selected in Step 3. The new users are listed in the Manage
Users form in Portal Administration.
synchronize.key.retrieval=true
In ldap.properties
auto.add.user=1
66 Administrator Guide
Configuration Tasks
Use the NIS Properties form to configure the portal server to import user and
authentication information from a Network Information Systems (NIS) server.
You must have administrator rights to the portal server. To upload user and
authentication information from an NIS server, follow these steps:
1. Verify that the applicable NIS servers are running and that the user
information you want to import exists.
2. From the Properties menu in Portal Administration, click NIS. The NIS
Properties form opens.
3. Update the Schedule Interval to how often, in minutes, you want the NIS
servers to update the information, or set it to "-1" to run immediately only
once. Click the Import check box for each NIS server from which you want
to import user and authentication information, and make any changes
necessary to the server definition. If the NIS server from which you want
to import has not been defined, complete the fields in the Add New Server
section of the NIS Properties form as appropriate, and then click Add New
Server. The NIS Properties form refreshes, and you can import from the
newly defined server. Click Update Changes. The portal server saves the
server definition information.
4. From the Microsoft Windows, UNIX, or Linux command line, use the cd
command to change to the directory where the portal server is installed.
5. On Windows systems, type import nis to run the Importer tool. On UNIX or
Linux systems, type import.sh nis to run the Importer tool. The Importer
tool is a command-line program provided with the portal server that lets
you import user and authentication information from LDAP servers, NIS
servers or CSV files.
6. Press Enter. The portal server uploads the user information from the NIS
servers you selected in Step 3. The new users are listed in the Manage
Users form in Portal Administration.
The following sample portal users (two for each level of access) are created
during installation:
EJMADMIN
EJM_Configuration
EJMEXEC
EJM_JobFlow_Overview
EJM_JobStatusConsole
EJMOPERATOR
EJM_Event
EJM_JobFlow_Run
EJM_JobFlow_Overview
EJM_JobStatusConsole
68 Administrator Guide
Configuration Tasks
EJMSCHEDULER:
Provides a level of access that includes the ability to create and modify
jobs and job objects. These users are, typically, both Scheduling Monitors
and Job/Jobset Administrators:
EJMSCHEDULER(password: ejmscheduler)
EJM_Event
EJM_HostAccess
EJM_JobFlow_Run
EJM_JobFlow_Overview
EJM_JobEditor
EJM_JobStatusConsole
EJMSUPERVISOR
EJM_Event
EJM_HostAccess
EJM_JobFlow_Design
EJM_JobFlow_Run
EJM_JobFlow_Overview
EJM_JobEditor
EJM_JobStatusConsole
EJMCOMMANDER
The highest level of access. These users have access to all in Unicenter
Enterprise Job Manager features. This user is, typically, a System
Administrator, Scheduling Monitor or Job/Jobset Adminstrator:
EJM_JobFlow_Run
EJM_JobFlow_Overview
EJM_JobEditor
EJM_JobFlow_Design
EJM_Configuration
EJM_HostAccess
EJM_Event
EJM_JobStatusConsole
Each of these users has a default workplace that opens to display the available
launch portlets. No workplace definition is required. Users have access to
appropriate portal content from their default workplaces.
These users are set up in the CleverPath Portal instance and the Unicenter
Enterprise Job Manager Configuration files.
70 Administrator Guide
Configuration Tasks
Configuration Manager
Setup Tab
The Setup tab displays by default when you start the Configuration Manager.
The Setup tab contains the following options:
CCI Links
Opens the Setup: CCI Links page so you can add, edit, and delete CAICCI
nodes for Unicenter Enterprise Job Manager. This is the default page on
the Setup tab.
Opens the Setup: CCI Links Status page so you view the status of the CCI
Links currently deployed in Unicenter Enterprise Job Manager.
Servers
Opens the Setup: Servers page so you can add, edit, and delete servers
for Unicenter Enterprise Job Manager.
Servers Status
Opens the Setup: Servers Status page so you verify the status of all
servers currently deployed in Unicenter Enterprise Job Manager.
Host Access
Opens the Setup: Host Access Links page so you can add, edit, and delete
host access links for Unicenter Enterprise Job Manager.
The first task is to create CCI Links. In the CCI Links subtab, you will perform
the following tasks:
Create a CAICCI link definition for each system that you want Unicenter
Enterprise Job Manager to access.
Assign appropriate parameter values for the properties of the server or
system. For help determining appropriate parameter values, see the
Configuration Help.
From this page, you can view the status of all CCI Links currently deployed in
Unicenter Enterprise Job Manager.
Note: For a link to appear with correct status information, you must deploy
the CCI Link definition and then restart the CA-Unicenter (Remote) service.
The second task is to define Unicenter Enterprise Job Manager servers. On the
Servers subtab you will perform the following tasks:
Create a Unicenter Enterprise Job Manager server definition for each back-
end server or system your enterprise accesses with Unicenter Enterprise
Job Manager. The server names you use (display names) must be unique.
Configure each server, assigning parameter values for the properties of
the server or system. For help determining parameter values, see the
Configuration Manager Help.
From this page, you can verify the status of a deployed Unicenter Enterprise
Job Manager Server. To verify a server status:
Select the radio button to the left of the server name and click Verify
72 Administrator Guide
Configuration Tasks
The third task is to create Host Access Links. In the Host Access Link subtab,
you will perform the following tasks:
Create a Host Access link definition for each 3270 system to be accessed
with Unicenter Enterprise Job Manager.
Assign appropriate parameter values for the properties of the 3270 host.
For help determining appropriate parameter values, see the Configuration
Help.
Security Tab
Credential Users
Opens the Security: Credential Users page so you can add, edit, and
delete credential users for Unicenter Enterprise Job Manager. This is the
default page on the Security tab.
Credential Groups
Opens the Security: Credential Groups page so you can add, edit, and
delete credential groups for Unicenter Enterprise Job Manager.
Users
Opens the Security: User Configuration page so you can add, edit, and
delete users for Unicenter Enterprise Job Manager.
The next task is to create Unicenter Enterprise Job Manager users. From the
Users subtab, you will perform the following tasks:
Create a user for each portal user with access to Unicenter Enterprise Job
Manager. The user must have the same ID as the corresponding portal
user.
Identify a list of Unicenter Enterprise Job Manager servers or systems each
user can view.
Assign a Terminology Preference, a Monitoring Refresh Interval, a Job Flow
Summary Refresh Interval, and an Administration Objects Display Number
for each user.
The next task is to create Credentialed Groups. Credentialed groups map one
user ID on the back-end server to a group of Credentialed Users to:
Simplify access to back-end servers or systems
Allow you to change group information once and make changes
immediately available to all users in the group
Provide an additional level of security
From the Credential Groups subtab, you will perform the following tasks:
Create a credentialed group for each group user ID on the job
management server
Configure each credentialed group, assigning parameter values for the
properties of the group ID. For help determining parameter values, see the
Configuration Manager Help.
From the Credential Users subtab, you will perform the following tasks:
Create a credentialed user for each user ID on the job management
server.
Configure each credentialed user, assigning parameter values for the
properties of the group ID. For help determining parameter values, see the
Configuration Manager Help.
74 Administrator Guide
Configuration Tasks
Environment Tab
Opens the Environment: Job Scheduling Server page so you can view and
edit properties for the job scheduling server. This is the default page on
the Environment tab.
Monitoring Server
Opens the Environment: Monitoring Server page so you can view and edit
the job management information you want the server to monitor during a
session and the intervals at which that information is updated.
Opens the Environment: Job Status Console Server page, so you can view
and edit properties for the Job Status Console.
All of the server properties are set to intelligent defaults. You can modify these
as required to meet the needs of your enterprise.
Deploy Tab
Deploy
Opens the Deploy: Deploy Changes page so you can add comments before
deploying configuration changes and view comments made for the
previous deployment. You can also deploy configuration changes from this
page. This is the default page on the Deploy tab.
Services
Opens the Deploy: Services page so you can start, stop, restart, and
refresh Unicenter Enterprise Job Manager services.
Use the Deploy feature, from the Configuration main window, to finalize your
configuration changes and make them available to servers. You must deploy
configuration changes for these changes to become effective.
The Services Configuration dialog also provides information about the following
services, although you cannot stop or start these services from Services
Configuration:
Portal
CA-Unicenter Enterprise Job Manager Configuration Server
Important! If you are running Unicenter Enterprise Job Manager from the
machine on which it is installed, you can also use the Windows Services dialog
to stop and restart your services. The Portal and Configuration services must
be stopped and restarted using the Windows Services dialog. To stop, start,
and restart either the Configuration service or the Portal service, you must use
the Windows Services dialog on the machine on which Unicenter Enterprise Job
Manager is installed.
76 Administrator Guide
Stopping and Restarting Services
When a Unicenter Enterprise Job Manager service stops and restarts while
users are logged in, the user sessions are broken. To continue to use
Unicenter Enterprise Job Manager, you must restart your user session. The
following procedures allow you to restart user sessions:
To restart Job Scheduling, close the Job Scheduling window and relaunch
Job Scheduling from its launch portlet.
To restart Configuration, close the Configuration window and relaunch
Configuration from its launch portlet.
To restart the Event Console, close the Event Console window and
relaunch the Event Console from its launch portlet.
To restart Host Access, close the Host Access window and relaunch Host
Access from its launch portlet.
To restart Job Flow Monitoring (Job Flow Monitoring, Job Flow Design, or
Job Flow Overviews), close the Job Flow Monitoring window, log off the
portal, log in again, and restart the Job Flow Monitoring interface from the
appropriate launch portlet.
Session Security
Security for job sessions uses not only the session timeout of the server but
also the session timeout of the CleverPath Portal server. When you log in to
the portal and access any file (for example, Job Flow Design or Job Flow
Overviews), the client browser session is registered with the server. If the
browser remains idle for longer than the server session timeout time (the
default session time-out is 30 minutes), the server considers the session to
have timed-out and prevents any further user activity. This maintains security
and privacy if your browser is inadvertently left open, and it can prevent
unauthorized accesses. Sessions can also expire if the server stops and
restarts while a user is logged on to the system. This also prevents users from
accessing Unicenter Enterprise Job Manager pages directly without logging in
to the portal first.
78 Administrator Guide
Modifying Session Timeout Values
1. Log in as admin.
4. From the Properties section of the left pane menu, select Global. The
Global properties dialog opens.
5. Change the User Timeout (minutes) value to the desired value and click
Update Changes.
Session timeouts for Job Scheduling and Job Flow Monitoring are determined
by the Session Idle Timeout parameter. This value is the time in seconds that
a user session can remain idle before timing out and releasing the session. You
can modify the Session Idle Timeout parameter for the respective interface in
the Job Scheduling Server and Monitoring Server subtabs of the Environment
tab. For more information on modifying these parameters, see the
Configuration Manager Help.
To modify the session timeout for other servers, you must modify the timeout
value of the underlying Apache Tomcat server. To modify the session timeout
for other servers, follow these steps: Open the file install
root/ServerNameServer/conf/web.xml in an editable format (typically, either
Microsoft Notepad or an HTML editor).
The following XML element contains the Session Timeout value, which is 30
minutes by default:
session-config
<session-timeout>30</session-timeout>
</session-config>
1. The AutoSys server must have the Unicenter Job Management Adapter for
SAP installed and configured. For more information, see the Unicenter Job
Management Adapter for SAP Administration Guide.
2. You must define the SAP server in the Unicenter Enterprise Job Manager
Configuration Manager. For more information, see the Configuration
Manager Help.
3. You must install the SAP Java Connector (JCo) on the Unicenter Enterprise
Job Manager Server. You can obtain information regarding the SAP JCo
and downloads of this product from the SAP web site. The SAP Java
Connector is supplied as a .zip file. Unzip the contents, and complete the
following steps:
80 Administrator Guide
Chapter 7: Configuring Event
Management
This chapter describes how to set up Unicenter Event Management to forward
messages to a consolidated event console. It explains the following:
How to configure a Consolidated Event Console to view job manager
messages
How to set up the Event Console to acknowledge and close AutoSys alarms
82 Administrator Guide
Creating a Consolidated Event Console to View Unicenter AutoSys Job Management Messages
The first step is to publish all messages to the Unicenter Event Console on the
Unicenter AutoSys Job Management event processor machine. The procedure
to do this varies depending on which platform the Unicenter AutoSys Job
Management Event Processor machine is running. If the machine is running on
a Windows platform, you must modify your administrator configuration as
follows:
2. From the drop-down list, select the instance whose events you want to
publish to the Unicenter Event Console, and click OK.
3. Select Event Processor from the Unicenter AutoSys Job Management drop-
down list.
4. Enter 3 in the Unicenter Events edit field. This field is located in the lower-
right corner of the event processor window.
Note: To modify the settings on this screen, you must have privileges in the
Windows Administrators group.
Important! The event processor reads the settings in the Unicenter AutoSys
Job Management Administrator on startup only. Therefore, if you make a
change that you want to implement immediately, you must stop the event
processor using the sendevent -E STOP_DEMON command, and then restart
the event processor using the Administrator Services screen (as described in
the chapter “AutoSys Administrator” of the Unicenter AutoSys Job
Management for Windows User Guide). Alternatively you can restart the CA
Unicenter Autosys Event Processor Service.
To do this, install the Unicenter Event Manager agent on the event processor
machine.
Note: The Unicenter Event Manager agent can be installed alone, as part of
Unicenter Framework, or as part of the entire Unicenter product.
UnicenterEvents = n,
To log all events to the Unicenter Event Console, set UnicenterEvents to the
following:
UnicenterEvents = 3
84 Administrator Guide
Creating a Consolidated Event Console to View Unicenter AutoSys Job Management Messages
Now that you have configured Unicenter AutoSys Job Management to publish
all messages to the Unicenter Event Console on the Unicenter AutoSys Job
Management Event Processor machine, you must forward these messages to
the Unicenter Event Console on the focal point system as follows:
The new action is FORWARD, and the node name is the TCP/IP host name
of the focal point system.
You can choose which Unicenter AutoSys Job Management messages are
forwarded to the focal point system by using the Unicenter Event Console to
further restrict those messages forwarded, based on the text at the beginning
of the messages. Unicenter AutoSys Job Management messages begin with the
string %CAATS and informational, warning, and error messages are
differentiated by the next two characters that follow %CAATS. For example:
%CAATS_I—Informational message
%CAATS_W—Warning message
%CAATS_E—Error message
You can also forward messages based on the entire Unicenter AutoSys Job
Management message ID, which is of the format:
%CAATS_ x_ nnn
For information on how to take full advantage of the Unicenter Event Console
to view these messages, see the Administrator Guide of either Unicenter
Common Services or Unicenter Network and Systems Management.
Considerations:
The Unicenter Enterprise Job Manager server must have an Event Agent
installed.
cd <install root>\EventServer\alarm
cautil –f uejm.uti
Oprcmd opreload
86 Administrator Guide
Chapter 8: Configuring Your Browser
This chapter describes how to configure your web browser to run with
Unicenter Enterprise Job Manager.
Unicenter Enterprise Job Manager supports the following web browsers and
versions:
Microsoft Internet Explorer 6.0
Mozilla 1.6
For the latest information about supported browsers and versions, see the
Readme file.
1. Download and install JRE 1.4.2 from the Java website. The JRE can be
found at http://java.sun.com/products/archive/index.html
(http://java.sun.com/products/archive/index.html).
2. After the JRE 1.4.2 is installed, from the Windows Start menu, choose
Settings, Control Panel, Java Plug-in. If you have more than one Java
Plug-in installed, click the About tab to verify the version.
4. Click Apply.
5. Close the Plug-in dialog.
1. Install JRE 1.4.2 from the Java website. The JRE 1.4.2 is available for
download as an RPM file.
3. Go to the plugins directory and ensure that the JRE was installed correctly.
If you installed the JRE using an RPM file, the path of the JRE is:
/usr/java/j2re_1.4.2/
or
/usr/java/j2re_1.4.2_04/
4. Create a symbolic link to the Java plug-in for Mozilla to use. In the Mozilla
install directory/plugins directory, use the following command:
ln -s /usr/java/j2re1.4.2_04/plugin/i386/ns610/libjavaplugin_oji.so javaplugin.so
If you have previously installed a version of the JRE Plug-in, you must perform
these additional steps:
java(TM) Plug-in1.4.2_04 :$
is followed by
Locate the last number and, using the next number in sequence, add an
entry similar to the following:
Next number:application/x-java-applet;jpi-version=1.4.2:Java:$
11:application/x-java-applet;jpi-version=1.4.2:Java:$
88 Administrator Guide
Increasing the Initial and Maximum Heap Size on the Client Machine
2. Select Control Panel. In the Control Panel, double-click the Java Plug-in
icon.
-Xms256m -Xmx400m
5. Click Apply.
This chapter describes how to implement SSL with Unicenter Enterprise Job
Manager, including how to establishing a standard SSL certificate for Unicenter
Enterprise Job Manager.
What Is SSL?
SSL is an encryption technology that leverages public and private key
infrastructures to provide secure communication between a browser and the
web server. The communication is a two-way process between the server and
browser, so both must support SSL. Handshaking is performed to establish a
connection and the data is encrypted and decrypted on both the server and
browser side.
To implement SSL successfully, both the browser and server sides must be
configured correctly. The browser must have the proper certificate (proof of
identity) and the server must have a certificate to give.
The procedures described here show you how to integrate SSL with the
following:
Apache Tomcat and CleverPath Portal (see Tomcat Standalone SSL
Configuration (on page 93))
Microsoft IIS, Apache Tomcat and CleverPath Portal (see Tomcat with IIS-
SSL (on page 100))
Although the steps will vary depending on your environment, they should
serve as a reference for most standard installations. Note that this section is
not a comprehensive guide to SSL implementations.
Note: This document assumes that Unicenter Enterprise Job Manager was
installed with the “Enable SSL” option selected. If it was not, then you must
update your installation and choose that option.
The Portal is a servlet that runs under the Tomcat 3.3a engine. Therefore,
most of the configuration to support SSL should be done on the server side.
SSL Architecture
All communications between the user and the Portal Server are encrypted. The
following illustration shows the major components.
92 Administrator Guide
Implementing SSL with Unicenter Enterprise Job Manager
This section describes how to configure Tomcat and the Portal to take
advantage of SSL.
Definitions
UEJM_ROOT
PORTAL_INSTALL
The path for the embedded CleverPath Portal. If no other portal installation
is found, it is UEJM_ROOT/CleverPath Portal.
TOMCAT_HOME
To configure Tomcat to take advantage of SSL, you can use the Tomcat-SSL
documentation at http://jakarta.apache.org/tomcat/tomcat-3.3-doc/tomcat-
ssl-howto.html (http://jakarta.apache.org/tomcat/tomcat-3.3-doc/tomcat-ssl-
howto.html). You need, however, to make some modifications specific for
Portal.
If you are using CleverPath Portal’s JRE, [JRE_HOME] is
[PORTAL_INSTALL] and you will need to place any required jar files in the
directory [PORTAL_INSTALL]/jre/lib/ext.
For Tomcat purposes, [PORTAL_INSTALL]/jakarta-tomcat-3.3a/ is the
same as [TOMCAT_HOME].
CleverPath Portal 3.51 and 4.0 use Tomcat 3.3a.
You can follow these steps to configure Tomcat to use SSL using the Sun SSL
implementation, Java Secure Sockets Extension (JSSE). The steps are for
reference only; you will need to adjust them according to your needs and
specifications.
Note: Before using this procedure, shut down the Unicenter Enterprise Job
Manager servers.
4. Now, you must prepare keystore to contain the SSL certificate. For that
you will need the keytool utility which is located in your JDK bin directory.
Ensure that the JDK bin directory is in the system path.
5. Rename the default keystore file for each of the Unicenter Enterprise Job
Manager services. The file (.keystore) is located in each of the following
directories:
UEJM_ROOT\AdminServer\conf
UEJM_ROOT\OPSMVSServer\conf
UEJM_ROOT\MonitorServer\conf
UEJM_ROOT\ConfigServer\conf
UEJM_ROOT\EventServer\conf
UEJM_ROOT\JobStatusConsoleServer\conf
UEJM_ROOT\UIFrameworkServer\conf
94 Administrator Guide
Implementing SSL with Unicenter Enterprise Job Manager
The command will create a .keystore file in the –keystore value. Ensure
that the path uses appropriate escape characters if it contains long file
names or blanks.
7. After executing the command, you will be prompted for the keystore
password. The default password used by Tomcat is "changeit". You will
need to reflect the password you chose in the server.xml configuration file.
The “first and last name” requested should be the hostname for the
machine running UEJM.
Finally, you will be asked for the key password. Use the same password
that was used for the keystore, ‘changeit’.
UEJM_ROOT\OPSMVSServer\conf
UEJM_ROOT\MonitorServer\conf
UEJM_ROOT\ConfigServer\conf
UEJM_ROOT\EventServer\conf
UEJM_ROOT\JobStatusConsoleServer\conf
UEJM_ROOT\UIFrameworkServer\conf
9. Export the certificate from the keystore using the following command:
–keystore “UEJM_ROOT\AdminServer\conf\.keystore”
10. Import this certificate into the Unicenter Enterprise Job Manager server
trusted keystore (under UEJM_ROOT\Jre\lib\security folder) using the
following command:
-keystore UEJM_ROOT\Jre\lib\security\cacerts
security.provider.x=com.sun.net.ssl.internal.ssl.Provider
96 Administrator Guide
Implementing SSL with Unicenter Enterprise Job Manager
13. Next, configure the Portal Tomcat server.xml file. This is located in
[PORTAL_INSTALL]/ jakarta-tomcat-3.3a/conf directory.
Important! Do NOT use SPACES on the lines that are added. It will cause
an error parsing the file.
UEJM_ROOT\ConfigServer\webapps\ServletConfiguration\WEB-INF\classes
UEJM_ROOT\OPSMVSServer\webapps\OPSMVSServlet\webapps\WEB-
INF\classes UEJM_ROOT\MonitorServer\webapps\UEJMMonitor\WEB-
INF\classes
UEJM_ROOT\EventServer\webapps\UEJMEvent\WEB-INF\classes
UEJM_ROOT\JobStatusConsoleServer\webapps\JobConServlet\WEB-
INF\classes
UEJM_ROOT\UIFrameworkServer\webapps\JobConServlet\WEB-
INF\classes
15. This should be all that is necessary on the Tomcat side to implement SSL.
The following sections describe additional configuration required for the
Portal. For more information please refer to the links specified in Tomcat
with SSL. For more information on keytool and on importing certificates
from Certificate Authorities, please see
http://java.sun.com/j2se/1.3/docs/tooldocs/win32/keytool.html.
Portal.bat/Portal Scripts
-Djava.protocol.handler.pkgs=com.sun.net.ssl.internal.www.protocol -
Djavax.net.ssl.truststore=”[UEJM_ROOT]\AdminServer\conf\.keystore”
Local Properties
host.name=hostname
The hostname should be the actual hostname for the machine that UEJM is
installed on. It should exactly match the host name that you used to create
the certificate in Step 7 above.
host.protocol.scheme=https
The protocol scheme specification is one line. Ensure there are no spaces
before and after the equal sign, and after https. If your secure connection is
the only http connector you have enabled for the portal, then you may also
want to alter the host.port= line to reflect the port your portal runs on. This
line determines which port the portal uses for XML calls.
98 Administrator Guide
Implementing SSL with Unicenter Enterprise Job Manager
Accessing Portal
After you have correctly configured both the Portal and Tomcat sides, you are
ready to access the Portal. If you use the default implementation according to
instructions, then the HTTPS port will be 8443, but you can change it.
When you access the portal for the first time, it asks you to install a digital
certificate for the site. You must accept this certificate for HTTPS to function
properly between client and server.
Under this configuration, you must implement IIS with CleverPath Portal. You
must configure IIS to accept your calls to the portal and then install your
security credential as directed by the provider of your certificate. For details,
see technical document #TEC264794, “Integrating CleverPath Portal/Tomcat
3.3x with IIS,“which is available at Computer Associates Technical Support
web site.
Troubleshooting Tips
Requests with URLs containing encoded characters and a query string may
lose the query string when the request is forwarded to Tomcat. A bug with the
Jakarta isapi_redirect.dll causes this problem. According to the Jakarta site,
this affects the isapi_redirect.dll versions prior to 3.3; however, in a specific
situation we found that the latest version did not resolve the issue.
Acknowledgements 101
Acknowledgements
Acknowledgements
Portions of this product include software developed by the Apache Software
Foundation (http://www.apache.org/). The Apache software is distributed in
accordance with the following license agreement.
1. Definitions.
"License" shall mean the terms and conditions for use, production, and
distribution as defined by Sections 1 through 9 of this document. "Licensor"
shall mean the copyright owner or entity authorized by the copyright owner
that is granting the License. "Legal Entity" shall mean the union of the acting
entity and all other entities that control, are controlled by, or are under
common control with that entity. For the purposes of this definition, "control"
means (i) the power, direct or indirect, to cause the direction or management
of such entity, neither by contract or otherwise, or (ii) ownership of fifty
percent (50%) or more of the outstanding shares, or (iii) beneficial
ownership of such entity.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation source, and
configuration files.
"Object" form shall mean any form resulting from mechanical transformation
or translation of a Source form, including but not limited to compiled object
code, generated documentation, and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or Object form,
made available under the License, as indicated by a copyright notice that is
included in or attached to the work (an example is provided in the Appendix
below).
"Derivative Works" shall mean any work, whether in Source or Object form,
that is based on (or derived from) the Work and for which the editorial
revisions, annotations, elaborations, or other modifications represent, as a
whole, an original work of authorship. For the purposes of this License,
Derivative Works shall not include works that remain separable from, or
merely link (or bind by name) to the interfaces of, the Work and Derivative
Works thereof.
"Submitted," for the purposes of this definition, means any form of electronic,
verbal, or written communication sent to the Licensor or its representatives,
including but not limited to communication on electronic mailing lists, source
code control systems, and issue tracking systems that are managed by, or on
behalf of, the Licensor for the purpose of discussing and improving the Work,
but excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
of whom a Contribution has been received by Licensor and subsequently
incorporated within the Work.
Subject to the terms and conditions of this License, each Contributor hereby
grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
irrevocable copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the Work and such
Derivative Works in Source or Object form.
Subject to the terms and conditions of this License, each Contributor hereby
grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
irrevocable (except as stated in this section) patent license to make, have
made, use, offer to sell, sell, import, and otherwise transfer the Work, where
such license applies only to those patent claims licensable by such Contributor
that are necessarily infringed by their Contribution(s) alone or by combination
of their Contribution(s) with the Work to which such contribution(s) was
submitted. If You institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work or a
Contribution incorporated within the Work constitutes direct or contributory
patent infringement, then any patent licenses granted to You under this
License for that Work shall terminate as of the date such litigation is filed.
4. Redistribution.
Acknowledgements 103
Acknowledgements
You may reproduce and distribute copies of the Work or Derivative Works
thereof in any medium, with or without modifications, and in Source or Object
form, provided that You meet the following conditions:
(a) You must give any other recipients of the Work or Derivative Works a copy
of this License; and
(b) You must cause any modified files to carry prominent notices stating that
You changed the files; and
(c) You must retain, in the Source form of any Derivative Works that You
distribute, all copyright, patent, trademark, and attribution notices from the
Source form of the Work, excluding those notices that do not pertain to any
part of the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its distribution, then
any Derivative Works that You distribute must include a readable copy of the
attribution notices contained within such NOTICE file, excluding those notices
that do not pertain to any part of the Derivative Works, in at least one of the
following places: within a NOTICE text file distributed as part of the Derivative
Works; within the Source form or documentation, if provided along with the
Derivative Works; or, within a display generated by the Derivative Works, if
and wherever such third-party notices normally appear. The contents of the
NOTICE file are for informational purposes only and do not modify the License.
You may add Your own attribution notices within Derivative Works that You
distribute, alongside or as an addendum to the NOTICE text from the Work,
provided that such additional attribution notices cannot be construed as
modifying the License. You may add Your own copyright statement to Your
modifications and may provide additional or different license terms and
conditions for use, reproduction, or distribution of Your modifications, or for
any such Derivative Works as a whole, provided Your use, reproduction, and
distribution of the Work otherwise complies with the conditions stated in this
License.
5. Submission of Contributions.
6. Trademarks.
This License does not grant permission to use the trade names, trademarks,
service marks, or product names of the Licensor, except as required for
reasonable and customary use in describing the origin of the Work and
reproducing the content of the NOTICE file.
7. Disclaimer of Warranty.
8. Limitation of Liability.
While redistributing the Work or Derivative Works thereof, You may choose to
offer, and charge a fee for, acceptance of support, warranty, indemnity, or
other liability obligations and/or rights consistent with this License. However,
in accepting such obligations, You may act only on Your own behalf and on
Your sole responsibility, not on behalf of any other Contributor, and only if
You agree to indemnify, defend, and hold each Contributor harmless for any
liability incurred by, or claims asserted against, such Contributor by reason of
your accepting any such warranty or additional liability.
MIT License
Copyright (c) 1999, 2003 TanukiSoftware.org
Acknowledgements 105
Acknowledgements
The original version of this source code and documentation is copyrighted and
owned by Gero Vermaas. This notice and attribution to Gero Vermaas may not
be removed. Permission to use the software in a commercial or non-
commercial product is hereby granted. Permission to distribute the source, the
software generated by it and its documentation for REFERENCE PURPOSES is
granted: a) to people and organizations that have bought the source code
from Gero Vermaas b) provided that this copyright notice appears in all copies.
It is not allowed for anyone to sell the source, software generated by it and
the documentation as a separate product. This right is reserved to Gero
Vermaas only. Gero Vermaas MAKES NO REPRESENTATIONS OR WARRANTIES
ABOUT THE SUITABILITY OF THE SOFTWARE, EITHER EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-
INFRINGEMENT. Gero Vermaas SHALL NOT BE LIABLE FOR ANY DAMAGES
SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
This product includes code licensed from RSA Security, Inc. Some portions
licensed from IBM are available at http://oss.software.ibm.com/icu4j/.
Licensee agrees that the following terms (in addition to the applicable
provisions above) shall apply with respect to any open source provided by Sun
Microsystems, Inc. contained within the Product. Notwithstanding anything
contained in the CA End User License Agreement, solely with respect to such
open source, these terms are not superseded by any written agreement
between CA and Licensee:
The Software is provided "AS IS". As to any claim made by Licensee against
Sun respecting the Software, Licensee’s exclusive remedy and Sun's entire
liability under this limited warranty will be at Sun's option to replace the
Software media or refund the fee paid for the Software which Licensee
acknowledges is $0. The foregoing shall not affect any warranties provided in
any other applicable agreement between Licensee and CA.
Acknowledgements 107
Acknowledgements
Sun may terminate Licensee’s right to use the Software if Licensee fails to
comply with any provision of this agreement. Upon such termination, Licensee
must destroy all copies of the Software.
Licensee acknowledges and agrees as between Licensee and Sun that Sun
owns the SUN, SOLARIS, JAVA, JINI, FORTE, and iPLANET trademarks and all
SUN, SOLARIS, JAVA, JINI, FORTE, and iPLANET-related trademarks, service
marks, logos and other brand designations ("Sun Marks"), and Licensee agrees
to comply with the Sun Trademark and Logo Usage Requirements currently
located at http://www.sun.com/policies/trademarks. Any use Licensee makes
of the Sun Marks inures to Sun's benefit.
For inquiries please contact: Sun Microsystems, Inc., 4150 Network Circle,
Santa Clara, California 95054, U.S.A. (LFI#119611/Form ID#011801)
Licensee agrees that the following terms (in addition to the applicable
provisions above) shall apply with respect to any open source provided by
International Business Machines Corporation contained within the Product.
Notwithstanding anything contained in the CA End User License Agreement,
solely with respect to such open source, these terms are not superseded by
any written agreement between CA and Licensee:
The IBM® 32-bit Runtime Environment for AIX™, Java™ 2 Technology Edition,
Version 1.4 (the “Program”) is owned by International Business Machines
Corporation or one of its subsidiaries (IBM) or an IBM supplier, and is
copyrighted and licensed, not sold.
No Warranty
Limitation of Liability
NEITHER IBM NOR ITS SUPPLIERS WILL BE LIABLE FOR ANY DIRECT OR
INDIRECT DAMAGES, INCLUDING WITHOUT LIMITATION, LOST PROFITS,
LOST SAVINGS, OR ANY INCIDENTAL, SPECIAL, OR OTHER ECONOMIC
CONSEQUENTIAL DAMAGES, EVEN IF IBM IS INFORMED OF THEIR
POSSIBILITY. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR
LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE
EXCLUSION OR LIMITATION MAY NOT APPLY TO LICENSEE.
General
With respect to any claim by or against IBM relating to the Program, neither
Licensee nor IBM will bring a legal action more than two years after the cause
of action arose unless otherwise provided by local law without the possibility of
contractual waiver or limitation.
Acknowledgements 109
Acknowledgements
The laws of the country in which Licensee acquires the Program govern this
agreement, except 1) in Australia, the laws of the State or Territory in which
the transaction is performed govern this agreement; 2) in Albania, Armenia,
Belarus, Bosnia/Herzegovina, Bulgaria, Croatia, Czech Republic, Georgia,
Hungary, Kazakhstan, Kirghizia, Former Yugoslav Republic of Macedonia
(FYROM), Moldova, Poland, Romania, Russia, Slovak Republic, Slovenia,
Ukraine, and Federal Republic of Yugoslavia, the laws of Austria govern this
agreement; 3) in the United Kingdom, all disputes relating to this agreement
will be governed by English Law and will be submitted to the exclusive
jurisdiction of the English courts; 4) in Canada, the laws in the Province of
Ontario govern this agreement; and 5) in the United States and Puerto Rico,
and People's Republic of China, the laws of the State of New York govern this
agreement.
AUSTRALIA:
No Warranty:
Although IBM specifies that there are no warranties, Licensee may have
certain rights under the Trade Practices Act 1974 or other legislation and are
only limited to the extent permitted by the applicable legislation.
Limitation of Liability:
GERMANY:
No Warranty:
Limitation of Liability:
The limitations and exclusions specified in the agreement will not apply to
damages caused by IBM with fraud or gross negligence, and for express
warranty.
INDIA:
General:
If no suit or other legal action is brought, within two years after the cause of
action arose, in respect of any claim that either party may have against the
other, the rights of the concerned party in respect of such claim will be
forfeited and the other party will stand released from its obligations in respect
of such claim.
IRELAND:
No Warranty:
ITALY:
Limitation of Liability:
Unless otherwise provided by mandatory law, IBM is not liable for any
damages which might arise.
NEW ZEALAND:
Acknowledgements 111
Acknowledgements
No Warranty:
Although IBM specifies that there are no warranties, Licensee may have
certain rights under the Consumer Guarantees Act 1993 or other legislation
which cannot be excluded or limited. The Consumer Guarantees Act 1993 will
not apply in respect of any goods or services which IBM provides, if Licensee
requires the goods and services for the purposes of a business as defined in
that Act.
Limitation of Liability:
Where Programs are not acquired for the purposes of a business as defined in
the Consumer Guarantees Act 1993, the limitations in this Section are subject
to the limitations in that Act.
Charges:
All banking charges incurred in the People's Republic of China will be borne by
Licensee and those incurred outside the People's Republic of China will be
borne by IBM.
UNITED KINGDOM:
Limitation of Liability:
The following paragraph is added to this Section at the end of the first
paragraph:
The limitation of liability will not apply to any breach of IBM's obligations
implied by Section 12 of the Sales of Goods Act 1979 or Section 2 of the
Supply of Goods and Services Act 1982.
Licensee agrees that the following terms (in addition to the applicable
provisions above) shall apply with respect to any open source provided by
International Business Machines Corporation contained within the Product.
Notwithstanding anything contained in the CA End User License Agreement,
solely with respect to such open source, these terms are not superseded by
any written agreement between CA and Licensee:
IBM ® zSeries Developer Kit for Linux®, Java™ 2 Technology Edition (the
“Program”) is owned by International Business Machines Corporation or one of
its subsidiaries (IBM) or an IBM supplier, and is copyrighted and licensed, not
sold.
No Warranty
Limitation of Liability
NEITHER IBM NOR ITS SUPPLIERS WILL BE LIABLE FOR ANY DIRECT OR
INDIRECT DAMAGES, INCLUDING WITHOUT LIMITATION, LOST PROFITS,
LOST SAVINGS, OR ANY INCIDENTAL, SPECIAL, OR OTHER ECONOMIC
CONSEQUENTIAL DAMAGES, EVEN IF IBM IS INFORMED OF THEIR
POSSIBILITY. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR
LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE
EXCLUSION OR LIMITATION MAY NOT APPLY TO LICENSEE.
General
Licensee recognizes IBM's and Sun's ownership and title to their respective
trademarks and of any goodwill attaching thereto, including goodwill resulting
from use. Licensee will not use or attempt to register any trademark which is
confusingly similar to such IBM or Sun trademarks.
With respect to any claims by or against IBM relating to the Program, neither
Licensee nor IBM will bring a legal action more than two years after the cause
of action arose unless otherwise provided by local law without the possibility of
contractual waiver or limitation.
Acknowledgements 113
Acknowledgements
The laws of the country in which Licensee acquires the Program govern this
Agreement, except 1) in Australia, the laws of the State or Territory in which
the transaction is performed govern this Agreement; 2) in Albania, Armenia,
Belarus, Bosnia/Herzegovina, Bulgaria, Croatia, Czech Republic, Georgia,
Hungary, Kazakhstan, Kirghizia, Former Yugoslav Republic of Macedonia
(FYROM), Moldova, Poland, Romania, Russia, Slovak Republic, Slovenia,
Ukraine, and Federal Republic of Yugoslavia, the laws of Austria govern this
Agreement; 3) in the United Kingdom, all disputes relating to this Agreement
will be governed by English Law and will be submitted to the exclusive
jurisdiction of the English courts; 4) in Canada, the laws in the Province of
Ontario govern this Agreement; and 5) in the United States and Puerto Rico,
and People's Republic of China, the laws of the State of New York govern this
Agreement.
AUSTRALIA:
No Warranty:
Although IBM specifies that there are no warranties, Licensee may have
certain rights under the Trade Practices Act 1974 or other legislation and are
only limited to the extent permitted by the applicable legislation.
Limitation of Liability:
GERMANY:
No Warranty:
Limitation of Liability:
The limitations and exclusions specified in the agreement will not apply to
damages caused by IBM with fraud or gross negligence, and for express
warranty.
INDIA:
General:
If no suit or other legal action is brought, within two years after the cause of
action arose, in respect of any claim that either party may have against the
other, the rights of the concerned party in respect of such claim will be
forfeited and the other party will stand released from its obligations in respect
of such claim.
IRELAND:
No Warranty:
ITALY:
Limitation of Liability:
Unless otherwise provided by mandatory law, IBM is not liable for any
damages which might arise.
NEW ZEALAND:
Acknowledgements 115
Acknowledgements
No Warranty:
Although IBM specifies that there are no warranties, Licensee may have
certain rights under the Consumer Guarantees Act 1993 or other legislation
which cannot be excluded or limited. The Consumer Guarantees Act 1993 will
not apply in respect of any goods or services which IBM provides, if Licensee
requires the goods and services for the purposes of a business as defined in
that Act.
Limitation of Liability:
Where Programs are not acquired for the purposes of a business as defined in
the Consumer Guarantees Act 1993, the limitations in this Section are subject
to the limitations in that Act.
Charges:
All banking charges incurred in the People's Republic of China will be borne by
Licensee and those incurred outside the People's Republic of China will be
borne by IBM.
UNITED KINGDOM:
Limitation of Liability:
The following paragraph is added to this Section at the end of the first
paragraph:
The limitation of liability will not apply to any breach of IBM's obligations
implied by Section 12 of the Sales of Goods Act 1979 or Section 2 of the
Supply of Goods and Services Act 1982.
Licensee agrees that the following terms (in addition to the applicable
provisions above) shall apply with respect to any open source provided by HP
contained within the Product. Notwithstanding anything contained in the CA
End User License Agreement, solely with respect to such open source, these
terms are not superseded by any written agreement between CA and
Licensee:
HP may terminate this license for the Software upon notice for failure to
comply with any of these license terms. Upon termination, Licensee must
immediately destroy the Software, together with all copies, adaptations and
merged portions in any form.
Licensee acknowledges that the Software is not designed or intended for use
in on-line control of aircraft, air traffic, aircraft navigation, or aircraft
communications; or in the design, construction, operation or maintenance of
any nuclear facility. HP disclaims any express or implied warranty of fitness for
such uses.
HP does not warrant that the operation of the Software will be uninterrupted
or error free. If HP is unable, within a reasonable time, to repair or replace the
Software to a condition warranted, Licensee will be entitled to a refund of the
purchase price paid by Licensee to HP, which Licensee acknowledges is $0,
upon prompt return of the Software. HP’s warranty does not apply to defects
resulting from: a) improper or inadequate maintenance of calibration; b)
software, interfacing, parts or supplies not supplied by HP; c) unauthorized
modification or misuse; d) operating outside of the published environmental
specifications for the Software; or e) improper site preparation or
maintenance.
Acknowledgements 117
Acknowledgements
Terms and Conditions for the Use of Java Naming and Directory
InterfaceTM (JNDI) Version 1.2.1
Licensee agrees that the following terms (in addition to the applicable
provisions above) shall apply with respect to any open source provided by Sun
Microsystems, Inc. contained within the Product. Notwithstanding anything
contained in the CA End User License Agreement, solely with respect to such
open source, these terms are not superseded by any written agreement
between CA and Licensee:
Title to Java Naming and Directory InterfaceTM (JNDI), Version 1.2.1 and the
above named Service Providers (collectively the “Software”) and all associated
intellectual property rights is retained by Sun Microsystems, Inc. (“Sun”)
and/or its licensors. Licensee acknowledges that the Software is not designed,
licensed or intended for use in the design, construction, operation or
maintenance of any nuclear facility. Sun disclaims any express or implied
warranty of fitness for such uses. No right, title or interest in or to any
trademark, service mark, logo or trade name of Sun or its licensors is granted
under this agreement.
The Software is provided "AS IS". As to any claim made by Licensee against
Sun respecting the Software, Licensee’s exclusive remedy and Sun's entire
liability under this limited warranty will be at Sun's option to replace the
Software media or refund the fee paid by Licensee to Sun for the Software
which Licensee acknowledges is $0. The foregoing shall not affect any
warranties provided in any other applicable agreement between Licensee and
CA.
Sun may terminate Licensee’s right to use the Software if Licensee fails to
comply with any provision of this agreement. Upon termination, Licensee must
destroy all copies of the Software.
Acknowledgements 119
Acknowledgements
Licensee acknowledges and agrees as between Licensee and Sun that Sun
owns the SUN, SOLARIS, JAVA, JINI, FORTE, STAROFFICE, STARPORTAL and
iPLANET trademarks and all SUN, SOLARIS, JAVA, JINI, FORTE, STAROFFICE,
STARPORTAL and iPLANET-related trademarks, service marks, logos and other
brand designations ("Sun Marks"), and Licensee agrees to comply with the Sun
Trademark and Logo Usage Requirements currently located at
http://www.sun.com/policies/trademarks. Any use Licensee makes of the Sun
Marks inures to Sun's benefit.
For inquiries please contact: Sun Microsystems, Inc., 4150 Network Circle,
Santa Clara, California 95054, U.S.A
(LFI#107226/Form ID#011801)
Licensee agrees that the following terms (in addition to the applicable
provisions above) shall apply with respect to any open source provided by Sun
Microsystems, Inc. contained within the Product. Notwithstanding anything
contained in the CA End User License Agreement, solely with respect to such
open source, these terms are not superseded by any written agreement
between CA and Licensee:
Title to Java™ XML Pack Summer ’02 Bundle (the “Software”) and all
associated intellectual property rights is retained by Sun Microsystems, Inc.
(“Sun”) and/or its licensors. Licensee acknowledges that the Software is not
designed or intended for use in the design, construction, operation or
maintenance of any nuclear facility. Sun disclaims any express or implied
warranty of fitness for such uses. No right, title or interest in or to any
trademark, service mark, logo or trade name of Sun or its licensors is granted
under this agreement.
The Software is provided "AS IS". As to any claim made by Licensee against
Sun respecting the Software, Licensee’s exclusive remedy and Sun's entire
liability under this limited warranty will be at Sun's option to replace the
Software media or refund the fee paid by Licensee to Sun for the Software
which Licensee acknowledges is $0. The foregoing shall not affect any
warranties provided in any other applicable agreement between Licensee and
CA.
Sun may terminate Licensee’s right to use the Software if Licensee fails to
comply with any provision of this agreement. Upon termination, Licensee
must destroy all copies of the Software.
Licensee acknowledges and agrees as between Licensee and Sun that Sun
owns the SUN, SOLARIS, JAVA, JINI, FORTE, and iPLANET trademarks and all
SUN, SOLARIS, JAVA, JINI, FORTE, and iPLANET-related trademarks, service
marks, logos and other brand designations ("Sun Marks"), and Licensee agrees
to comply with the Sun Trademark and Logo Usage Requirements currently
located at http://www.sun.com/policies/trademarks. Any use you make of the
Sun Marks inures to Sun's benefit.
For inquiries please contact: Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California 94303
(LFI#113314/Form ID#011801)
Licensee agrees that the following terms (in addition to the applicable
provisions above) shall apply with respect to any open source provided by Sun
Microsystems, Inc. contained within the Product. Notwithstanding anything
contained in the CA End User License Agreement, solely with respect to such
open source, these terms are not superseded by any written agreement
between CA and Licensee:
Acknowledgements 121
Acknowledgements
The Software is provided "AS IS". As to any claim made by Licensee against
Sun respecting the Software, Licensee’s exclusive remedy and Sun's entire
liability under this limited warranty will be at Sun's option to replace the
Software media or refund the fee paid by Licensee to Sun for the Software
which Licensee acknowledges is $0. The foregoing shall not affect any
warranties provided in any other applicable agreement between Licensee and
CA.
Sun may terminate Licensee’s right to use the Software if Licensee fails to
comply with any provision of this agreement. Upon termination, Licensee must
destroy all copies of the Software.
Licensee acknowledges and agrees as between Licensee and Sun that Sun
owns the SUN, SOLARIS, JAVA, JINI, FORTE, and iPLANET trademarks and all
SUN, SOLARIS, JAVA, JINI, FORTE, and iPLANET-related trademarks, service
marks, logos and other brand designations ("Sun Marks"), and Licensee agrees
to comply with the Sun Trademark and Logo Usage Requirements currently
located at http://www.sun.com/policies/trademarks. Any use Licensee makes
of the Sun Marks inures to Sun's benefit.
For inquiries please contact: Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California 94303
(LFI#115020/Form ID#011801)
Licensee agrees that the following terms (in addition to the applicable
provisions above) shall apply with respect to any open source provided by Sun
Microsystems, Inc. contained within the Product. Notwithstanding anything
contained in the CA End User License Agreement, solely with respect to such
open source, these terms are not superseded by any written agreement
between CA and Licensee:
Title to JavaMail™, Version 1.3 (the “Software”) and all associated intellectual
property rights is retained by Sun Microsystems, Inc. (“Sun”) and/or its
licensors. Licensee acknowledges that the Software is not designed, licensed
or intended for use in the design, construction, operation or maintenance of
any nuclear facility. Sun disclaims any express or implied warranty of fitness
for such uses. No right, title or interest in or to any trademark, service mark,
logo or trade name of Sun or its licensors is granted under this agreement.
The Software is provided "AS IS". As to any claim made by Licensee against
Sun respecting the Software, Licensee’s exclusive remedy and Sun's entire
liability under this limited warranty will be at Sun's option to replace the
Software media or refund the fee paid by Licensee to Sun for the Software
which Licensee acknowledges is $0. The foregoing shall not affect any
warranties provided in any other applicable agreement between Licensee and
CA.
Acknowledgements 123
Acknowledgements
Sun may terminate Licensee’s right to use the Software if License fails to
comply with any provision of this agreement. Upon termination, Licensee
must destroy all copies of the Software.
Licensee acknowledges and agrees as between Licensee and Sun that Sun
owns the SUN, SOLARIS, JAVA, JINI, FORTE, STAROFFICE, STARPORTAL and
iPLANET trademarks and all SUN, SOLARIS, JAVA, JINI, FORTE, STAROFFICE,
STARPORTAL and iPLANET-related trademarks, service marks, logos and other
brand designations ("Sun Marks"), and Licensee agrees to comply with the Sun
Trademark and Logo Usage Requirements currently located at
http://www.sun.com/policies/trademarks. Any use Licensee makes of the Sun
Marks inures to Sun's benefit.
For inquiries please contact: Sun Microsystems, Inc., 4150 Network Circle,
Santa Clara, California 95054, U.S.A
(LFI#114176/Form ID#011801)
Index 125
Unicenter CA-7 • 21
installing host components • 21
server, configuring • 22
updating • 32
Unicenter CA-7 Product Table, merging • 31
Unicenter TCPaccess Communications Server •
24