You are on page 1of 26

Unicenter AutoSys Job Management

Getting Started

MAN01164838E

This documentation and related computer software program (hereinafter referred to as the Documentation) is for the end users 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 users 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 users applicable license agreement. The manufacturer of this documentation is Computer Associates International, Inc. 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.

2002 Computer Associates International, Inc. (CA)


All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies. This product includes software developed by the Apache Software Foundation (<http://www.apache.org>); (c) 1999 The Apache Software Foundation. All rights reserved. THE APACHE SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THE APACHE SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Contents
Chapter 1: Reliable Job Management
Unicenter AutoSys Job Management 11 Approach to Enterprise-Wide Job Management 11 The Purpose Of This Guide 12 Benefits 12 Distinctive Features 12 Supported Environments 13 Taking Job Management To The Next Level 13 CA Services: Enabling Solutions Through Experience 13 CA Education Services 13 Computer Associates: The Software That Manages eBusiness 14 For More Information 14

Chapter 2: Unicenter AutoSys Job Management Basics!


Basic Concepts and Installation Considerations 21 A Unique, Event-Driven Architecture 22 Enhanced Scheduling Flexibility 23 Fault-Tolerant Operations To Prevent Downtime 23 Optimized System Resources 23 Centralized Control 23 Extended Functionality 24 Whats Next? 24

Chapter 3: Customize Your Reports and Create a Job!


An Interface That Suits Your Needs 31 Creating a Report Using the Java Interface 32 Defining a Job in Unicenter AutoSys Job Management Using the GUI Interface 34 Whats Next? 36

iii

Chapter 4: Scheduling a Job to and From the Mainframe!


Jobs Using Bi-directional Scheduling 41 Enabling Unicenter AutoSys Job Management Cross-Platform Scheduling 43 Configuring CCI 44 Starting CCI 45 Installing the Client License Key For OS/390 Machine 46 Defining the OS/390 Machine to Unicenter AutoSys Job Management 46 Submitting Command Jobs to the Mainframe 47

iv

1 Reliable Job Management


Chapter

Unicenter AutoSys Job Management


nicenter AutoSys Job Management is an industry-leading job management system that provides unparalleled reliability to support your mission-critical applications, enterprise-wide. Designed for distributed environments, Unicenter AutoSys Job Management delivers event-driven scheduling, centralized realtime monitoring and programmable error-recovery providing reliability and scalability to your production environment. In addition, Unicenter AutoSys Job Management easily accommodates the massive processing of jobs required by eBusiness, providing the most rapid and reliable Internet job management for all your eBusiness needs.

Approach to Enterprise-Wide Job Management


While the Enterprise is constantly expanding to accommodate new business initiatives including eBusiness and decision support many organizations have deployed mission-critical applications across a wide array of mainframe and open system environments. The goal is to achieve cost-effective information processing while meeting business requirements. This is possible only with an emphasis on optimized job management the effective automation and execution of jobs, along with centralized process control. Unicenter AutoSys Job Management offers an advanced solution to EnterpriseWide Job Management by encompassing three key initiatives: Cross-Platform Job Management enables cross-product and cross-platform integration with central management to optimize the solution by platform. Integrated Job Management integrates with CAs leading Enterprise Management Solutions and third party products. Also tightly integrates with ERP applications from SAP, PeopleSoft, Oracle, and other leading ERP vendors. The combined scope of CA job management solutions provides a total enterprise solution unmatched in breadth and depth anywhere else in the industry. Superior Job Management Administration and Visualization bases the most powerful technology for managing jobs across the entire range of platforms, integrating with all the existing technology, including applications, databases, data movement solutions, backup and recovery offerings, and other schedulers. It provides the ability to view and manage all the relevant jobs and their interdependencies from a single point and presents the various aspects of job management through sophisticated visualization technology, delivering it through modern user interfaces and the Web.

11

Unicenter AutoSys Job Management

The Purpose Of This Guide


This book introduces Unicenter AutoSys Job Management to you in an efficient and visual manner. By the time you have finished reading this guide, you will have an overview of the wide scope of the product and its usability will be familiar to you. It is important to us that you feel comfortable with Unicenter AutoSys Job Management before you begin to use it. To accomplish this, we are providing a typical real-life scenario that parallels the tasks that you will be performing.

Benefits
Simplifies the managing and monitoring of thousands of jobs by providing a single point of control of enterprise-wide networks and by allowing related tasks to be grouped into a single job stream. Provides job scheduling flexibility by basing start conditions on time/day, file arrival, and job dependencies (such as success, failure, or process exit code). Helps ensure uninterrupted processing of jobs by providing automated restart, recovery, re-queuing, and fault tolerance; uses alarms to notify users of potential problems before they occur. Integrates easily with other open systems products and applications (for example, alarms and events can be integrated into existing email, notification, troubleticketing, and console systems).

Distinctive Features
Increased Performance Improved performance using multi-threaded processing to enable more jobs to run in parallel. Enterprise-wide Cross Platform Job Management Simplifies cross platform job management through direct integration communication to Unicenter Job Management solutions. Web-Based User Interface Provides a single point of control and administration of jobs and reduces IT learning and operational costs. Multi-platform Support Customers can manage their enterprise-wide processes on a number of various platforms. Unparalleled Reliability and Scalability Scales tens of thousands of jobs easily over hundreds of multi-platform machines per night, while maintaining its hallmark reliability.

12

Unicenter AutoSys Job Management

Supported Environments
Supported server and agent platforms include: HP-UX; IBM AIX; NCR/AT&T UNIX; Pyramid DC/OSx; Silicon Graphics IRIX; Sun Solaris; Data General DG-UX; DEC OSF/1; Sequent DYNIX; Siemens Nixdorf SINIX; DEC; Compaq Tru64; RedHat Linux; Windows NT; Windows 2000; and Windows XP.

Taking Job Management To The Next Level


Unicenter AutoSys Job Management provides the flexibility to schedule jobs across major platforms such as UNIX or Windows, with platform-independent functionality. Unicenter AutoSys Job Management is a truly flexible solution that allows companies to deploy scheduling to their platform of choice, providing a modular solution that can be custom-fit to any environment, and mainframe-level capabilities across all platforms. Each of the components was architected for the respective platforms and not retrofitted.

CA Services: Enabling Solutions Through Experience


When it comes to getting on the information fast track, CA Services can recommend and install a full suite of enterprise management solutions to keep your business moving. Our associates offer the proprietary know-how on custom-fitting your enterprise for solutions ranging from life cycle management, data warehousing, and next-level business intelligence. Our experts will leave you with the technology and knowledge tools to fully collect, exploit, and leverage your data resources and applications.

CA Education Services
Computer Associates Global Education Services (CA Education) offerings include instructor-led and computer-based training, product certification programs, third-party education programs, distance learning, and software simulation. These services help to expand the knowledge base so companies are better able to use CAs products more efficiently, contributing to their greater success. CA Education has been developed to assist todays technologists in everything from understanding product capabilities to implementation and quality performance. Because the vast community of education seekers is varied, so too are CAs methods of instruction. CA Education is committed to provide a variety of alternatives to traditional instructor-led training, including synchronous and asynchronous distance learning, as well as Unicenter simulation. For training that must be extended to a wider audiencefor a fraction of the cost and logistical hassle of sending everybody away to a classCA Education offers excellent distance learning options.

13

Unicenter AutoSys Job Management

Computer Associates: The Software That Manages eBusiness


The next generation of eBusiness promises unlimited opportunities by leveraging existing business infrastructures and adopting new technologies. At the same time, extremely complicated management presents challengesfrom managing the computing devices to integrating and managing the applications, data, and business processes within and across organizational boundaries. Look to CA for the answers. CA has the solutions available to help eBusinesses address these important issues. Through industry-leading eBusiness Process Management, eBusiness Information Management, and eBusiness Infrastructure Management offerings, CA delivers the only comprehensive, state-of-the-art solutions, serving all stakeholders in this extended global economy.

For More Information


After reading through this Getting Started, you can refer to the numerous resources available to you for additional information. Your product CD contains useful instructional documents that showcase your software and provide detailed explanations about the products comprehensive, feature-rich components. In addition, the online help system at esupport.ca.com offers procedural information and answers to any questions you may encounter. You may also initiate a support incident on the new Computer Associates webbased, self-help support system, eSupport, at http://esupport.ca.com. Technical Support is available 24 hours a day, seven days a week.

14

2 Unicenter AutoSys Job Management Basics!


Chapter

Basic Concepts and Installation Considerations

nicenter AutoSys Job Management, an industry-leading job management solution provides robust, scalable production control. As more and more companies rely on the Internet as a primary business resource, they require increasingly powerful, dependable tools that can effectively manage their missioncritical eBusiness needs. Unicenter AutoSys Job Management easily accommodates the massive processing of jobs required by eBusiness, providing rapid and reliable Internet job management. Unicenter AutoSys Job Management delivers visualization and modeling capabilities to effectively implement job flows across the environment. It further centralizes processing by providing seamless integration with leading ERP packages, such as SAP R/3, PeopleSoft, and others. Unicenter AutoSys Job Management delivers immediate benefits such as: Reducing development costs through the elimination of time-consuming shell script coding and debugging. Increasing productivity by automating routine tasks. It also minimizes downtime by proactively searching for problems and immediately recovering from them. Expanding profits by using a single system built to manage a complex, distributed network of computers.

Unicenter AutoSys Job Management comprises many functional components designed to provide the best means for centralizing and automating the scheduling and management of jobs in distributed UNIX and Windows environments. This product brings the functionality of mainframe batch scheduling to these environments with features such as centralized system-wide monitoring and programmable error recovery. Unicenter AutoSys Job Management offers Java, Windows, and Motif user interfaces, allowing customers to mix and match scheduling components to meet their UNIX and/or Windows environments.

21

Basic Concepts and Installation Considerations

A Unique, Event-Driven Architecture


Unicenter AutoSys Job Management architecture is designed to deliver these essentials to job management for mission-critical applications, enterprise-wide. Its event-driven, tiered architecture comprises three components: Relational Database Stores all events and job information. Event Processor Interprets events and, based on job definitions, initiates actions via the Remote Agent. This is the engine of Unicenter AutoSys Job Management. Remote Agent Performs its tasks and sends the resulting job status back to the database. In addition, Unicenter AutoSys Job Management provides utilities to help you define, run, and maintain Unicenter AutoSys Job Management instances and jobs. The included utilities are platform-specific; however, all platforms include the Unicenter AutoSys Job Management graphical user interface (GUI) and Job Information Language (JIL). Both the GUI and CLI enable you to define, manage, monitor, and report on jobs. This architecture simplifies the management and monitoring of thousands of jobs by providing centralized control of enterprise-wide networks. It also helps ensure the uninterrupted processing of jobs with automated restart, recovery, re-queuing, and fault tolerance capabilities. See the appropriate installation guide for detailed information regarding these components. The figure below illustrates the communication paths between the Unicenter AutoSys Job Management system components in a basic configuration:
AutoSys Server (UNIX or Windows)
Event Processor Unix Job

UNIX Client
Remote Agent

Windows Client
Remote Agent Windows Job
Event Server (database)

22

Basic Concepts and Installation Considerations

Enhanced Scheduling Flexibility


You can base job-starting conditions on calendar event (basic time/day or custom calendars), job dependency status, and/or file arrival. Unicenter AutoSys Job Management also automatically accounts for international time zone changes. For example, when dependent jobs are running in Tokyo, London, and New York, Unicenter AutoSys Job Management recognizes and adapts to each time zone difference, without requiring manual intervention.

Fault-Tolerant Operations To Prevent Downtime


With Unicenter AutoSys Job Management, youre assured automated, uninterrupted scheduling services a key requirement for eBusiness and other mission-critical operations through Unicenter AutoSys High-Availability. This feature allows you to run both the Event Processor and database on two machines as a hot backup system. If one machine goes down, the other detects the problem, signals all remote agents, and performs an automatic rollover picking up where the first machine left off. Before Unicenter AutoSys Job Management starts each job, it automatically checks machine and resource availability issuing an alarm and scheduling a restart if a problem is detected. It continuously monitors each job as it executes, and then verifies its completion.

Optimized System Resources


Unicenter AutoSys Job Management uses the powerful construct of virtual machines to group real machines for workload balancing. Thus, the best machine for the job is automatically selected at run-time, giving you an effective way to manage resources across your network.

Centralized Control
As distributed environments become increasingly complex, the importance of a single point of control is even more of a necessity. Unicenter AutoSys Job Management greatly enhances the graphical user interface (GUI), by providing a webenabled user interface, which may be accessed from any machine. The database is accessible from the Unicenter AutoSys Job Management Java GUI server node. Only one database connection is established for each Unicenter AutoSys Job Management instance that is being monitored. When the first user signs on to the GUI and opens up a monitoring session, the server will go out to the database and cache a local copy of the jobs on the server. This single connection will then periodically poll the Unicenter AutoSys Job Management instance for any changes to the database and refresh its cached copy with the relevant changes. Since you view the cached version of the data, the load against the Unicenter AutoSys Job Management database remains unaffected, regardless of the number of users that are signed on. And because database connection is accomplished using JDBC, the same Java GUI server can access Unicenter AutoSys Job Management instances that utilize different databases.

23

Basic Concepts and Installation Considerations

Extended Functionality
Unicenter AutoSys Connect Option provides an interface for Unicenter AutoSys Job Management to communicate with OS/390 scheduling products such as Unicenter CA-7 Scheduling, Unicenter CA-7 Scheduler, and Unicenter CA-Jobtrac Scheduling. This allows Unicenter AutoSys Job Management to centralize the management of an enterprise workload, which helps you leverage your existing investment in scheduling products.

Whats Next?
Unicenter AutoSys Job Management is part of the Unicenter scheduling solution, which offers complete job management across all major platforms and provides support for companies deploying applications and systems across global environments. Unicenter AutoSys Job Management is a true cross-platform, modular solution that runs on UNIX and Windows, and can schedule to these and other platforms, delivering one scheduling solution to span the entire organization. In the next chapter, you will begin to take advantage of the many unique capabilities Unicenter AutoSys Job Management has to offer. You will begin by customizing the web user-interface. You will customize your reports and create a basic job definition in order to familiarize yourself with Unicenter AutoSys Job Management architectures vast potential for your business.

24

3 Customize Your Reports and Create a Job!


Chapter

An Interface That Suits Your Needs


nicenter AutoSys Job Management now lets you select the interface that meets your needs by choosing from either the traditional Motif or Windows console interface, or through a web enabled interface providing complete scheduling interoperability between UNIX and Windows platforms. This allows you to mix and match scheduling components to fit your environment. The Unicenter AutoSys Job Management Java interface provides: Jobflow monitoring, providing both an enterprise-wide and user customizable view. Reporting, providing the user with various customizable reports. My Reports, providing interface customization. Report definition forms Administrative functionality A single point of control, giving you the option of viewing one or all of your scheduling servers, enhancing your ability to monitor and control jobs. Access from anywhere, since the GUIs are web enabled, this allows the user access to the GUIs from any web browser enabled machine, freeing the user from installing and configuring the software. The traditional Motif and Windows console also provide: A virtual console, rather than a physical console, accessible from any Unicenter AutoSys Job Management machine. This means that you can bring up the console anywhere in your environment, giving you additional flexibility to manage and control Unicenter AutoSys Job Management. Unicenter AutoSys Job Management also provides a command line interface that, when coupled with Unicenter AutoSys Job Management Job Information Language (JIL), offers full dial-in functionality, programming access, and control. All Unicenter AutoSys Job Management interfaces allow you to execute, monitor, and manage jobs in real time or batch. The Unicenter AutoSys Job Management interface provides several dialogs that you can use to define Command, File Watcher, and Box Jobs. The complexity of the job definition determines how many dialogs you will use. In addition, there are dialogs that provide the means to send events and monitor jobs.

31

An Interface That Suits Your Needs The Java Interface Administrator can create sub-views of the overall or enterprise job flow. Depending upon the permissions assigned to your unique user account, you may be allowed access to the Enterprise view, or provide access to specific sub-views pertaining to your role in the company. The graphical Monitoring view displays the jobs contained in an Unicenter AutoSys Job Management instance in text and graphical views. The display is colorcoded and customizable. The size of the text or graphical viewing panes can be reduced or enlarged by centering the mouse on the bar between the two views and dragging up or down. The Jobflow View can be customized by color-coding job status, changing the relative size of the text or graphical viewing panes and rearranging the Jobflow. You can rearrange jobs and boxes belonging to a business unit to be in proximity in the Jobflow view. Detailed reporting is available for all jobs from the Monitoring dialog. To display a job detail report, right click on a job from the text pane and scroll over Detail and select the number of job runs to display. To display a job detail report, right click on a job from the graphical pane and scroll over Detail and select the number of job runs to display.

Creating a Report Using the Java Interface


Lets run through an example of how to create a report that show all the successful jobs from yesterday using the Java interface. 1. Enter the Web Server URL to start up the interface:

32

An Interface That Suits Your Needs 2. Choose My Reports and click Manage.

3. 4.

Complete the fields and click Save Report to save the report definition. You have now successfully created a report definition. From here on, you will have this report available to you every time you access My Reports.

33

An Interface That Suits Your Needs

Defining a Job in Unicenter AutoSys Job Management Using the GUI Interface
Lets run through an example of how to define a job in Unicenter AutoSys Job Management using the traditional GUI interface. To start the GUI: 1. In Windows, in the Unicenter AJM program group, choose the Unicenter AutoSys Graphical Interface.

On UNIX, at the command prompt, enter the following command:


autosc &

2.

The Job Editor provides all the fields you need to create a basic job definition. Click Job Editor on the Unicenter AutoSys toolbar:

34

An Interface That Suits Your Needs The Job Editor displays different tabs and fields based on whether you are defining a command job, file watcher job, or box job. The Job Editor shown is based on a command job.

3. 4.

Enter the following in the Command field:


echo AUTOSYS install test run

In the Send to Machine field, enter the machine on which the command will be executed, by doing one of the following: Click Add, enter a machine name, and click OK. Select localhost from the drop-down list, which specifies to run the job on the event processor machine.
NOTE: You should add your own machine name. In addition, for Windows, you must have already entered into the Unicenter AutoSys Job Management database a valid Windows user ID and password for the Owners user account on the machine.

5. 6.

From the File menu, choose Save. The Save As dialog opens. In the Save As dialog, select an Instance and enter the new job name and click OK, for example:
test_run

7.

When the definition is written to the database, a confirmation dialog is displayed. Click OK to close the dialog.

35

An Interface That Suits Your Needs

Whats Next?
Using the user-interface described in this chapter, you will learn how to schedule a job to the mainframe in the next chapter. By the time you reach the end of Chapter 4, you will have demonstrated the bi-directional communication Unicenter AutoSys Job Management has to offer.

36

4 Scheduling a Job to and From the Mainframe!


Chapter

Jobs Using Bi-directional Scheduling

hen a job is submitted, the Unicenter AutoSys Job Management Event Processor on the distributed platform interrogates the start job request, processes and transmits it to the mainframe to a cross platform enabled scheduling system. This can be any one of the CA developed mainframe schedulers, or to the Unicenter AutoSys Connect product. Once the product receives the request on the mainframe, it goes ahead and submits and then tracks the mainframe job. This is done either directly by the XPS enabled mainframe-scheduling product or through Unicenter AutoSys Connect via a two-step process to submit and track the mainframebased job. Unicenter AutoSys Job Management not only allows for job submission to the mainframe but it has the ability to accept a job submitted from any one of the CA developed mainframe scheduling products and report the status back. This includes CA-7, CA-Scheduler, and CA-Job Tracker. For details and procedures on how to submit the job, see the appropriate mainframe scheduler product guide. The following tutorial guides you through the procedure necessary to enable bidirectional scheduling in Unicenter AutoSys Job Management. The tutorial's scenario involves the following systems:

Unicenter AutoSys Job Management Machine Mainframe Hostname- local_host Hostname- remote_host Operating System- UNIX Operating System- OS/390 Software Installed- Unicenter Common Services Interface (CAICCI) Parameter Configuration: AUTOSYS=/opt/autotree/tst/autosys Software Installed- Unicenter Common Services Interface (CAIRIM, CAICCI, CAIENF) AUTOUSER=/opt/autotree/tst/autouse AUTOSERV=ACE

41

Jobs Using Bi-directional Scheduling In order for this bi-directional scheduling to take place, you must enable Unicenter AutoSys Job Management cross platform scheduling and configure CCI. To enable cross platform scheduling, the following Unicenter AutoSys Broker options in the Unicenter AutoSys Job Management must be enabled: AutoSysAgentSupport This activates a process managed by the Unicenter AutoSys Broker that acknowledges the mainframes presence. Receive Remote Job Submission This activates a second process managed by the Unicenter AutoSys Broker that allows it to receive job submissions from the mainframe. In addition to those options being set, in order for Unicenter AutoSys Job Management to submit a job to the mainframe, the job to be executed (specified by the command line argument within the Unicenter AutoSys Job Management definition) must be defined as a valid job within the mainframe scheduling system. And conversely, in order for the mainframe to submit a job to Unicenter AutoSys Job Management, the job to be executed (specified by the SUBFILE parameter of the mainframe job) must be defined as a valid job within the Unicenter AutoSys Job Management system.

42

Jobs Using Bi-directional Scheduling

Enabling Unicenter AutoSys Job Management Cross-Platform Scheduling


To enable Unicenter AutoSys Job Management cross-platform scheduling support you must do the following: 1. In Windows, open the Unicenter AutoSys Event Processor in the Unicenter AutoSys Administrator. To enable cross-platform scheduling support to the mainframe, check the AutoSysAgentSupport check box. To allow Unicenter AutoSys Job Management to receive jobs from the mainframe, check the Receive Remote Job Submissions check box. Both of these check boxes are located within the AutoSys Broker Options group box.

On UNIX, to enable cross-platform scheduling support to the mainframe set the AutoSysAgentSupport parameter in the instance configuration file to a value of 1.
$AUTOUSER/config.$AUTOSERV: AutoSysAgentSupport=1

To allow Unicenter AutoSys Job Management on Unix to receive jobs from the mainframe set the AutoSysAgentSupportReceiveSubmit parameter in the instance configuration file to a value of 1.
$AUTOUSER/config.$AUTOSERV:AutoSysAgentSupportReceiveSubmit=1

43

Jobs Using Bi-directional Scheduling 2. Cross-platform dependencies are jobs that execute on an external instance but were not initiated on behalf of the local Unicenter AutoSys Job Management instance. When the cross-platform dependent job completes, status information will be forwarded back to the local Unicenter AutoSys Job Management instance and recorded in the database. Cross-platform dependency support on mainframe is obtained through Unicenter AutoSys Connect. Currently, this support cannot be obtained directly with a mainframe scheduler. If you wish to implement support for cross-platform dependencies create a file named config.EXTERNAL in the $AUTOUSER directory. Add an entry similar to the following:
RMT:CNCT=remote_host

Where RMT is a 3-character name that you assign to the external instance. Where CNCT is set for Unicenter AutoSys Connect. Where remote_host is a valid mainframe hostname, defined to Unicenter AutoSys Job Management. This is discussed in more detail later. For further information on creating the config.EXTERNAL file, see the appendix "Integrating with the Mainframe and AutoSys Agents for AS/400 and OpenVMS," in the Unicenter AutoSys Job Management for Windows User Guide.

Configuring CCI
CCI provides the underlying communication infrastructure that connects applications running on OpenVMS, OS/390, AS/400, Windows, various versions of UNIX, and many other operating systems. CCI forms the basis for the cross-platform Job Management Agent that you can manage from Unicenter AutoSys Job Management. To configure CCI on Windows: 1. During installation of the Unicenter AutoSys Job Management CCI component, the installation prompted for remote machines that Unicenter AutoSys Job Management would communicate with. If additional machines need to be added to $CAIGLBL0000/caiuser/ccirmtd.rc file, continue with the steps below. Otherwise, proceed to section Starting CCI. 2. 3. Log into the Windows desktop with an account having administrative privileges where Unicenter AutoSys Job Management is installed. Locate and edit file $CAIGLBL0000/caiuser/ccirmtd.rc file.

44

Jobs Using Bi-directional Scheduling 4. Confirm or enter the following values for local and remote parameters:
LOCAL = local_host local_host 32768 startup REMOTE = remote_host cci_system_id 32768 startup port=7000

See the Unicenter AutoSys Job Management for Windows Installation Guide for detailed syntax information. To configure CCI on UNIX: 1. Log in as root to open the $CAIGLBL0000/cci/config/local_host/ ccirmtd.prf file. 2. Enter the following values for local and remote parameters:
LOCAL = local_host local_host 32768 startup REMOTE = remote_host cci_system_id 32768 startup port=7000

See the Unicenter AutoSys Job Management for UNIX Installation Guide for detailed syntax information.

Starting CCI
You must start or restart CCI to enable the new settings. To start CCI on Windows: Existing Condition Unicenter is installed Unicenter is not installed To stop CCI on Windows: Existing Condition Unicenter is installed Unicenter is not installed To start CCI on UNIX: Existing Condition Unicenter is installed Unicenter is not installed Command unistart cci $CAIGLBL0000/cci/scripts/CCISA_rc Command unicntrl stop uni ccicntrl stop Command unicntrl start uni ccicntrl start

45

Jobs Using Bi-directional Scheduling To stop CCI on UNIX: Existing Condition Unicenter is installed Unicenter is not installed Command unishutdown cci $CAIGLBL0000/cci/scripts/CCISA_cshut

Installing the Client License Key For OS/390 Machine


A valid Client License Key for the machine must be installed to allow Unicenter AutoSys Job Management to run jobs on it. Install the client license key for the OS/390 machine in the Unicenter AutoSys Job Management database as follows:
gatekeeper <Enter> Utility to Add/Delete or Print KEYs. Add (A) or Delete (D) or Print (P) ? a KEY Type:[(c)lient,(s)erver,(t)ime,(x)pert ]: c Hostname: remote_host Hostid: 0 KEY: IIJJKKLLMMNNOOPP

Defining the OS/390 Machine to Unicenter AutoSys Job Management


The OS/390 machine must be defined in the Unicenter AutoSys Job Management database identifying the machine name and type. To define the machine, which is running CA7 via JIL, at the operating system command prompt, enter:
jil insert_machine: remote_host type: t NOTE: The above machine definition type t implies Unicenter

AutoSys Job Management will submit work directly to CA7.

If Unicenter AutoSys Job Management will submit work to CA7 and support cross-platform dependencies through Unicenter AutoSys Connect, the following would be entered via JIL at the operating system command prompt:
jil insert_machine: remote_host type: c NOTE: The above machine definition type c implies Unicenter

AutoSys Job Management will submit work through Unicenter AutoSys Connect on the mainframe.

See the appendix Integrating with the Mainframe and AutoSys Agents for AS/400 and OpenVMS, in the Unicenter AutoSys Job Management for Windows User Guide.
46

Jobs Using Bi-directional Scheduling

Submitting Command Jobs to the Mainframe


A command job can be defined to be dependent on certain starting conditions to tell Unicenter AutoSys Job Management when to run the job. However, if the job does not have any starting conditions, you must start it manually. 1. To submit a job directly to CA7, where the CA7 defined job to run on the mainframe is CA7JOBNM use the following JIL:
insert_job: ca7_job1 command: CA7JOBNM machine: remote_host * date_conditions: 1 days_of_week: all start_mins: 25 NOTE: The machine definition of remote_host must have type

coded as t for Unicenter NSM.

2.

To submit a job to CA7, through Unicenter AutoSys Connect where the CA7 defined job to run on the mainframe is CA7JOBNM use the following JIL:
insert_job: ca7_job1 command: auto_cnct a remote_host j CA7JOBNM s CA7 c RUN -d machine: remote_host * date_conditions: 1 days_of_week: all start_mins: 25 NOTE: The machine definition of remote_host must have type

coded as c for Unicenter AutoSys Connect.

3.

To define two jobs, each having a dependency on two OS/390 cross-platform dependent jobs named JB5MINS and JB5HRS respectively, use the following JIL:
insert_job: test_dep1 command: sleep 100 condition: success(JB5MINS^RMT) machine: local_host insert_job: test_dep2 command: sleep 100 condition: success(JB5HRS^RMT) machine: local_host NOTE: This job definition requires the config.EXTERNAL file

contain an entry for a external instance named RMT.

47

Jobs Using Bi-directional Scheduling 4. You can also define jobs as a combination of both command jobs and external dependencies. To submit a job that will execute a CA7 defined job named ASYS7002 after the cross-platform dependent job JB5HRS completes use the following JIL:
insert_job: CA7job4 command: auto_cnct a remote_host j ASYS7002 s CA7 c RUN -d machine: remote_host condition: success(JB5HRS^RMT) NOTE: This job definition requires the config.EXTERNAL file

contain an entry for a external instance named RMT and the machine definition of remote_host must have type coded as c for Unicenter AutoSys Connect.

Unicenter AutoSys Job Management is an automated job control system for scheduling, monitoring, and reporting on any AutoSys-configured machine that is attached to a network. As with most control systems, there are many ways to correctly define and implement jobs. It is likely that the way you utilize Unicenter AutoSys Job Management to address your distributed computing needs will evolve over time. As you become more familiar with both the features and the characteristics of your own jobs, you will also refine your use of Unicenter AutoSys Job Management.

48