Professional Documents
Culture Documents
Autosys Job Management Getting Started
Autosys Job Management Getting Started
Getting Started
4.5
MAN09095423E
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.22719(c)(1) and (2) or DFARS Section 252.227-7013(c)(1)(ii) or applicable successor provisions.
Contents
The Purpose Of This Guide ..................................................13 Benefits ....................................................................13 Distinctive Features .........................................................14 Supported Environments ....................................................14 Taking Job Management To The Next Level ...................................15 CA Services: Enabling Solutions Through Experience ..............................15 CA Education Services ......................................................16 Computer Associates: The Software That Manages eBusiness ...................17 For More Information .......................................................17
Contents
iii
eTrust Access Control .......................................................... 27 Integrating eTrust with Unicenter AutoSys Job Management....................... 28 Unicenter AutoSys JM Web Interface and eTrust .............................. 29 The Unicenter AutoSys JM and eTrust Administrator......................... 210 Security Classes ........................................................... 212 Creating Resources .................................................... 213 Default Resource ...................................................... 213 Resource Access Levels ................................................ 214
32 33 33
43 46 47
.................................................................
................................................... 410
................................................................ 410
Adding an Instance .................................................... 411 Creating a New User Account .......................................... 413 Viewing your Instance ................................................. 414
iv
Getting Started
.................................................
415
Defining a Job ............................................................ 417 Viewing Your Job ..................................................... 419 What is Next? ................................................................ 420
Contents
Chapter
Unicenter AutoSys Job Management (Unicenter AutoSys JM) 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 JM delivers event-driven scheduling, centralized real-time monitoring and programmable error-recovery providing reliability and scalability to your production environment. In addition, Unicenter AutoSys JM easily accommodates the massive processing of jobs required by eBusiness, providing the most rapid and reliable Internet job management for all your eBusiness needs.
11
Unicenter AutoSys JM 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.
12
Getting Started
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, trouble ticketing, and console systems).
13
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.
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; SuSE Linux, Windows NT; Windows 2000; and Windows XP.
14
Getting Started
15
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.
16
Getting Started
17
Chapter
21
Unicenter AutoSys JM 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 JM offers Web-enabled, Windows, and Motif user interfaces, allowing customers to mix and match scheduling components to meet their UNIX and/or Windows environments.
22
Getting Started
In addition, Unicenter AutoSys JM provides utilities to help you define, run, and maintain Unicenter AutoSys JM instances and jobs. The included utilities are platform-specific; however, all platforms include the Unicenter AutoSys JM graphical user interface (GUI) and Job Information Language (JIL). Both the GUI and command line interface (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 enterprisewide 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 following illustrates the communication paths between the Unicenter AutoSys JM system components in a basic configuration:
23
24
Getting Started
Centralized Control
As distributed environments become increasingly complex, the importance of a single point of control is even more of a necessity. Unicenter AutoSys JM greatly enhances the graphical user interface (GUI), by providing a web-enabled user interface, which may be accessed from any web browser enabled machine. The database is accessible from the Unicenter AutoSys JM Java GUI server node. Only one database connection is established for each Unicenter AutoSys JM 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 JM 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 JM database remains unaffected, regardless of the number of users that are signed on. Since the database connection is accomplished using JDBC, the same Java GUI server can access Unicenter AutoSys JM instances that utilize different databases.
25
Extended Functionality
Unicenter AutoSys Connect Option provides an interface for Unicenter AutoSys JM to communicate with OS/390 scheduling products such as Unicenter CA-7 Job Management, Unicenter CA-Scheduler Job Management, and Unicenter CA-Jobtrac Job Management. This allows Unicenter AutoSys JM to centralize the management of an enterprise workload, which helps you leverage your existing investment in scheduling products.
Web Interface
Unicenter AutoSys Job Management Web Interface 4.5 (Web Interface) is the web based Portal to Computer Associates International, Inc (CA) Unicenter AutoSys Job Management (Unicenter AutoSys JM). Designed for end-users and managers, Web Interface lets you securely monitor, manage and control your Unicenter AutoSys JM job-scheduling environment from the web. The Web Interface has been completely redesigned to fit your needs. Performance improvements and increased scalability were also top priorities. This new version gives you a Web administration tool with loaded features and advanced graphical representations. Included is a new consolidated real time monitor view that lets you see if there is a problem with any of the instances that are being monitored.
26
Getting Started
27
28
Getting Started
If the option to install an eTrust AC Server is selected, then the parent pmdb used to store and distribute security policy updates to subscribed clients will be created. During the Server installation, the users who have the authority to administer the parent pmdb as well as the machines that can be used by the administrators to administer the parent pmdb are configured. In addition, all the remote clients that will be subscribed to the parent are defined. If the option to install an eTrust AC Client is selected, only the local seosdb will be created and as such is intended for target machines that have installed the Unicenter AutoSys JM command utility or GUI programs. As in the Server installation, the users who have the authority to modify the policies on the local seosdb as well as the administrator machines are configured through the Client installation. From the Client installation, the local eTrust AC will be configured so its parent pmdb subscription points to the eTrust AC Server machine. This allows the Client to receive new or updated security policy updates from the eTrust AC Server For more information on Unicenter AutoSys JM and eTrust AC, see the chapter Security in the Unicenter AutoSys Job Management for UNIX User Guide, or the Unicenter AutoSys Job Management for Windows User Guide.
29
However, which ever security you use on Unicenter AutoSys JM, you must use the same security with the Web Interface. The Web Interface will use the following eTrust User Defined Classes with the Unicenter AutoSys JM. as-view as-job as-list as-owner as-control as-machine
These classes are created in the eTrust database and the autosys pmdb, during Unicenter AutoSys JM installation. The classes are eTrust enabled and will make security call outs prior to performing an action on a specified object. For more information on Web Interface security, see the chapter Security, in the Unicenter AutoSys Job Management Web Interface User Guide.
210
Getting Started
1. 2.
An eTrust AC administrative user must first be created within the eTrust AC environment. An administrative host (terminal) resource must be created within the eTrust AC environment for each machine from which eTrust AC is to be administered. A list of all the eTrust AC administrative users that are authorized to use the eTrust AC administrative host created in Step 2 (including the eTrust AC administrator created in Step 1) must be defined within the eTrust AC environment. For more information about Authorizing an administrator to access an eTrust AC Administrative Host, see the chapter Security in the Unicenter AutoSys Job Management for Windows User Guide, the Unicenter AutoSys Job Management for UNIX User Guide, or the section autosys_secure in the chapter Commands in the Unicenter
3.
211
Security Classes
Unicenter AutoSys JM will use the following eTrust userdefined classes:
These classes are used to control access to jobs, calendars, machines, global variables, and the owner field of a job. These classes will be created in eTrust AC and are enabled by default. The Unicenter AutoSys JM product will issue a security callout prior to performing an action on the specified object (For example; a job, a global variable, and so forth.). For more information on resource classes, see the chapter Security in the Unicenter AutoSys Job Management for UNIX User Guide, or the Unicenter AutoSys Job Management for Windows User Guide.
212
Getting Started
Creating Resources A member in the eTrust AC class is an eTrust resource. These eTrust resources let you define the allowable operations that apply to a specific object or a subset of objects represented by the eTrust resource. For Unicenter AutoSys JM, a resource created within the as-job class represents a job, or jobs, and contains the rules specifying the operations that are allowed for that job. A resource created within the as-machine class represents a machine and contains the rules of operations that apply to that machine. Some Unicenter AutoSys JM classes contain predefined resources. For example, the Unicenter AutoSys JM control class represents administrative tasks in general, so the predefined resources represent a specific administrative task. In these instances, Unicenter AutoSys JM does not recognize and ignores any new and distinct resource created for these classes.
Default Resource Each Unicenter AutoSys JM user-defined class within eTrust AC contains a default resource. If eTrust cannot find a resource for a given secured object or task, eTrust applies the rules defined by the default resource. The rules established for the default resource govern the allowable operations for all objects or tasks that have no associated resource.
213
Resource Access Levels Each resource defined to eTrust AC will have a set of predefined security access levels. These access levels may include one or more of the following:
The access level setting of each resource governs whether access to the resource will be granted or denied by eTrust AC. For example, suppose a resource is created within eTrust AC named job1.ACE with only an access level of read. Unicenter AutoSys JM would then deny an unauthorized user access to creating, updating, executing, or deleting job1 within instance ACE. For more information on the pre-defined resource access levels for the Unicenter AutoSys JM user-defined classes, see the chapter Security in the Unicenter AutoSys Job Management for UNIX User Guide, or the Unicenter AutoSys Job Management for Windows User Guide.
214
Getting Started
Chapter
To set up Unicenter AutoSys JM correctly, you should understand the security features that control where and by whom certain secured activities can be edited or executed.
Overview
Unicenter AutoSys JM is able to run in either eTrust secured mode or native security mode. External security (eTrust) can be enabled during the installation of the product, or later on by an authorized EXEC superuser. For more information on controlling the security setting with the native autosys_secure utility, see autosys_secure in the
Unicenter AutoSys Job Management for UNIX and Windows Reference Guide.
31
Overview
This chapter is to be used in conjunction with the chapter Commands, in the Unicenter AutoSys Job Management for UNIX and Windows Reference Guide, and the chapter Security in the Unicenter AutoSys Job Management for Windows User Guide, or the Unicenter AutoSys Job Management for UNIX User Guide.
WARNING! We recommend that you have a thorough understanding of Unicenter AutoSys JM security as it pertains to eTrust AC before continuing.
Native Security
Unicenter AutoSys JM native security includes the following:
Job-level security Superuser privileges System-level security UNIX and Windows file permissions (See Restricting Access to Jobs in this chapter.)
Security is initiated when either a user sends events that affect the running of a job or the event processor sends events that affect a job.
32
Getting Started
Overview
33
Overview
To access autosys_secure and administer the EDIT or EXEC superusers, do the following: 1. From a Unicenter AutoSys JM Command Prompt, enter the following:
autosys_secure
2.
Select option 1 to Administer EDIT or EXEC superusers. The following dialog will appear.
Please select from the following options: [1] Create an EDIT/EXEC superuser. [2] Modify an EDIT/EXEC superuser. [3] Delete an EDIT/EXEC superuser. [4] Show all EDIT/EXEC superuser. [5] Return to main menu.
3. 4. 5. 6. 7. 8.
Select option 1, to Create an EDIT or EXEC superuser. Input the user name of the person you will create as the EDIT superuser. Enter user Host or Domain for the EDIT superuser, or enter if no host. Input the user name of the person you will create as the EXEC superuser. Enter user Host or Domain for the EXEC superuser, or enter if no host. Select option 4 to Show all EDIT or EXEC superusers, to verify your entries.
34
Getting Started
Overview
9.
If your entries are correct, from the EDIT or EXEC menu select option 5 to return to the main menu. If not, select option 2 to Modify an EDIT or EXEC superuser, or option 3 to Delete an EDIT or EXEC superuser and repeat step 3.
Note: If this dialog reads [1] Disable eTrust Access Control, eTrust AC is currently controlling security within the Unicenter AutoSys JM environment. This indicates you activated eTrust AC security during the installation.
35
Overview
2.
Select option 1 to enable eTrust Access Control. The following message appears:
Are you sure you want to take this action? {y/n]:
Select y to enable eTrust Access Control, or n to exit without changing your security option. 3. Select option 6, to return to the main menu.
You have now enabled eTrust Access Control. If eTrust security is enabled, you must establish a subscriber authentication security word (option [2]) before any secured executables will work properly. Before establishing your security word define your enterprise security policy since Unicenter AutoSys JM is effectively locked down until you establish the security word. When autosys_secure is invoked and eTrust AC is installed on this system, you will have the ability to perform administration (option [3]) on the eTrust AC administrators defined in either the eTrust AC seosdb or the autosys pmdb. An eTrust AC administrator is allowed to dictate and modify policy within the eTrust AC environment. We recommend that you continue setting up your new security environment before performing any other action with Unicenter AutoSys JM 4.5. To continue setting up your security environment see the chapter Commands, in the Unicenter
AutoSys Job Management for UNIX and Windows Reference Guide, and the chapter Security in the Unicenter AutoSys Job Management for Windows User Guide, the Unicenter AutoSys Job Management for UNIX User Guide, or the Unicenter AutoSys Job Management Web Interface User Guide.
36
Getting Started
Whats Next?
Whats Next?
Unicenter AutoSys JM 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 JM 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.
37
Chapter
User Interfaces
Unicenter AutoSys JM 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.
User Interfaces
41
The following are the Control Panel buttons and the actions they perform: Scheduler Console Displays the Scheduler Console, which lets you monitor jobs and alarms across multiple instances. Job Editor Displays the Job Editor, which lets you define jobs. Calendar Editor Displays the Calendar Editor window, which lets you define, run and exclude calendars. Monitor/Browser Editor Displays the Monitor/Browser Editor, which lets you define and run monitors and reports (or browsers). Alarm Manager Displays the Alarm Manager application, which lets you view and respond to alarms across multiple instances. Alarm Sentry Displays the Alarm Sentry dialog, which indicates if there is an alarm for any instance you are monitoring. Admin GUI Displays the administration dialog, which lets you implement several advanced configurations, dual-event servers, and shadow event processors. Exit Exits the GUI Control Panel.
42
Getting Started
Defining a Job Let us run through an example of how to define a job using the traditional Graphical User Interface. To start the GUI, do the following: 1. Select Start, Programs, Computer Associates, Unicenter, AutoSys Job Management [instance], Graphical Interface.
User Interfaces
43
2.
The Job Editor provides all the fields you need to create a basic job definition. Click Job Editor on the Unicenter AutoSys toolbar:
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 following defines a command job.
3.
44
Getting Started
4.
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 JM database, through autosys_secure, a valid Windows user ID and password for the Owners user account on the machine.
5.
From the File menu, choose Save. The Save As dialog opens.
6.
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.
For more information about defining jobs, see the chapter Defining Jobs Using the Job Editor in the Unicenter AutoSys Job Management for Windows User Guide, or the chapter Defining Jobs Using the GUI, in the Unicenter AutoSys Job Management for UNIX User Guide.
User Interfaces
45
Viewing Your Job Now that you have defined a job to the Unicenter AutoSys JM database, you can view this job through the scheduler console. The Scheduler Console provides a sophisticated method of monitoring jobs from multiple instances in real time. The Scheduler Console lets you view any jobs that are defined, whether they are currently active or not. From the Unicenter AutoSys JM toolbar, select Scheduler Console.
For more information about the Scheduler Console, see the chapter Scheduler Console in the Unicenter AutoSys Job Management for Windows User Guide, or the chapter, The Operator Console in the Unicenter AutoSys Job Management for UNIX User Guide.
46
Getting Started
Web Interface
Web Interface
Designed for end-users and managers, the Web Interface lets you securely monitor, manage and control your Unicenter AutoSys JM job-scheduling environment from the web. In addition to web-enabling Unicenter AutoSys JM, the Web Interface enhances native functionality with intuitive graphical and text views of multiple instances of your job stream, pop-up alarm monitoring, unique user permissions and capabilities, forecasting, throughput analysis and comprehensive reporting. For more information about defining jobs with the Web Interface, see the Unicenter AutoSys Job Management Web Interface User Guide. The Unicenter AutoSys JM Web Interface provides: Jobflow monitoring Providing both an enterprise-wide and user customizable view of job dependency relations in the Unicenter AutoSys JM environment. Jobflow management Provides detailed administration abilities to create, delete or modify a job. Reporting Providing the user with various customizable reports. Report definition forms Multiple report options, increases your knowledge of your environment. Administrative functionality Greatly simplifies the creation of a personalized view, either statically or based on a set of rules.
User Interfaces
47
Web Interface
Unicenter AutoSys Job Management Xpert Lets you select a particular machine to simulate jobs defined to run on that machine. AutoSys Log View in real time the event_demon.AUTOSERV, similar to autosyslog -e. Dual Server Support You can view all current active server names in the browser. Alarm Management In addition to viewing alarms, this new feature enables you to respond to an alarm by either acknowledging or closing the alarm. In addition, you can view a record of the user who responded to the alarm in the database. View Filter Lets you view the jobs based on one, or on a set of criteria. 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. Unicenter AutoSys JM also provides a command line interface that, when coupled with the Unicenter AutoSys JM Job Information Language (JIL), offers full dial-in functionality, programming access, and control. All Unicenter AutoSys JM interfaces allow you to execute, monitor, and manage jobs in real time or batch.
48
Getting Started
Web Interface
The Unicenter AutoSys JM 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 The Unicenter AutoSys JM Web 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 tab displays the jobs contained in a Unicenter AutoSys JM instance in text and graphical views. The display is color-coded and customizable. You can customize the Jobflow View 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. For more information, or a more thorough explanation, for the following sections, see the Unicenter AutoSys Job Management Web Interface User Guide.
User Interfaces
49
Web Interface
Login To access the Web Interface Main Console, enter the following into the address or URL field of your Internet Explorer browser.
http://yourwebserver/autosys/login
where:
yourwebserver
Specifies the name or IP address of the Web Interface web server. If you do not know this information, contact your Web Interface Administrator.
410
Getting Started
Web Interface
Enter a valid username and password into the Web Interface login page. If you do not have a username and password, contact your Web Interface Administrator. After login, the Web Interface start page opens as in the following:
Adding an Instance Before Web Interface can monitor Unicenter AutoSys JM, you must configure the Web Interface to communicate with each instance. To add an Instance for the Web Interface to monitor, do the following: 1. 2. Open Internet Explorer on any client machine. Log in with the default Web Interface Administrator username (autosys) and password (autosys) to access the Web Interface Start Page Window:
User Interfaces
411
Web Interface
3. 4.
Click the Admin tab and select Instance Management to view the Instance Management form. In the Instance Management window, click the Create action button to initiate a new Instance Management form.
5.
Enter the configuration information in the appropriate fields and click Submit to save the configuration. Note: For more information about the configuration information on the previous screen, see the chapter Administration in the Unicenter AutoSys Job Management Web Interface Users Guide.
412
Getting Started
Web Interface
Creating a New User Account To create a new User account, do the following, 1. 2. 3. Select Admin from the navigation tabs. Select User Management to display the User Management Choice Form. Select Users and click select.
4. 5.
Click Create, and fill in the appropriate fields. Click Submit to save the User account.
User Interfaces
413
Web Interface
Viewing your Instance After you have created your instance, you need to load that instance into the Web Interface. The instance view, the left pane, displays all instances defined in the interface. To display an instance job in the jobflow view, do the following: 1. 2. 3. Select Job Management from the Web Interface navigational pane. Right click Job Views and select Load New Instances. Right click the instance and select Load Jobs.
For more information about creating or defining views, see the chapter Administration in the Unicenter AutoSys Job Management Web Interface User Guide. Note: You may need to refresh the display before the instance will appear.
414
Getting Started
Web Interface
Create User Mapping When you create a mapped user, that user is associated with the security permissions determined in the Web Interface. These permissions let you do actions, like view the eplog, generate send events, and edit a job. Users that are not mapped to an instance will have no security definitions. These users will be able to see the jobs in an instance, but cannot perform any actions against those jobs. For more information on users, see the chapter Administration, in the Unicenter AutoSys Job Management Web Interface User Guide. To create a User Mapping account, do the following: 1. 2. 3. 4. 5. Select Admin from the navigation tabs. Select Administration from the left side tree view. Select AutoSys User Mapping from the left side tree view. Select the Instance. Fill in the appropriate fields and click Add to enter the user information. RCS machine and port number are now editable fields. This allows the user to authenticate to other machines other than the EP host. If the fields are left blank then the EP host and RCS port defined with the instance are used.
User Interfaces
415
Web Interface
416
Getting Started
Web Interface
Defining a Job
Let us run through an example of how to define a job using the Web Interface with the job property sheet. The job property sheet allows you to enter, schedule, and specify the parameters for command jobs, box jobs, and file jobs.
User Interfaces
417
Web Interface
To define a job through the Web Interface, do the following: 1. 2. From the Web Interface toolbar, select Command Job. to initiate a new
From the job property dialog, click Basic to define a command job.
2. 3.
In the Machine field, enter the machine on which the command will be executed, by doing the following: Select localhost from the drop-down list, which specifies to run the job on the event processor machine.
4. 5.
Enter a job name into the Job Name field. Click to save the command job to the database.
418
Getting Started
Web Interface
6. 7.
If the information is correct, click Yes, click No to correct the information. When the definition is written to the database, a confirmation dialog is displayed. Click OK to close the dialog.
Viewing Your Job After you have defined your job into the Web Interface, you will be able to view your job in the Real Time Monitor. To display an instance job in the jobflow view, do the following: 1. From the Web Interface toolbar, click the drop down dialog and select Real Time Monitor.
2.
Right click the instance and select Load Jobs. Following these steps will ensure a refresh has occurred.
User Interfaces
419
What is Next?
For more information about creating or defining views, see the chapter Administration in the Unicenter AutoSys Job Management Web Interface User Guide. Note: You may need to refresh the display before the instance will appear.
What is Next?
Using the graphical 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 5, you will have demonstrated the bi-directional communication Unicenter AutoSys JM has to offer.
420
Getting Started
Chapter
51
What is Next?
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
In order for this bi-directional scheduling to take place, you must enable Unicenter AutoSys JM cross platform scheduling and configure CCI. To enable cross platform scheduling, the following Unicenter AutoSys Broker options in Unicenter AutoSys JM 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 JM to submit a job to the mainframe, the job to be executed (specified by the command line argument within the Unicenter AutoSys JM definition) must be defined as a valid job within the mainframe scheduling system.
52
Getting Started
What is Next?
And conversely, in order for the mainframe to submit a job to Unicenter AutoSys JM, 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 JM system.
53
What is Next?
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 JM 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
Cross-platform dependencies are jobs that execute on an external instance but were not initiated on behalf of the local Unicenter AutoSys JM instance. When the cross-platform dependent job completes, status information will be forwarded back to the local Unicenter AutoSys JM 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.
54
Getting Started
What is Next?
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
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 JM. Note: You do not need to configure the rmtd file on a Windows to Windows platform environment. However, you must configure the rmtd file on any cross platform environment. For example, Windows to UNIX, UNIX to Mainframe, Mainframe to Windows and so forth. To configure CCI on Windows: 1. During installation of the Unicenter AutoSys JM CCI component, the installation prompted for remote machines that Unicenter AutoSys JM 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. Log into the Windows desktop with an account having administrative privileges where Unicenter AutoSys JM is installed. Locate and edit file $CAIGLBL0000/caiuser/ccirmtd.rc file.
2.
3.
55
What is Next?
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. 2. Log in as root to open the $CAIGLBL0000/cci/config/local_host/ ccirmtd.prf file. 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 Command unicntrl start uni ccicntrl start
To stop CCI on Windows: Existing Condition Unicenter is installed Unicenter is not installed Command unicntrl stop uni ccicntrl stop
56
Getting Started
What is Next?
To stop CCI on UNIX: Existing Condition Unicenter is installed Unicenter is not installed Command unishutdown cci $CAIGLBL0000/cci/scripts/CCISA_cshut
Note: The above machine definition type t implies Unicenter AutoSys Job Management will submit work directly to Unicenter CA-7. If Unicenter AutoSys Job Management will submit work to Unicenter CA-7 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.
57
What is Next?
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 Submitting Command Jobs to the Mainframe A command job can be defined to be dependent on certain starting conditions to tell Unicenter AutoSys JM 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 Unicenter CA-7, where the Unicenter CA-7 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 Unicenter CA-7, through Unicenter AutoSys Connect where the Unicenter CA-7 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)
58
Getting Started
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 an external instance named RMT. 4. You can also define jobs as a combination of both command jobs and external dependencies. To submit a job that will execute a Unicenter CA-7 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 an external instance named RMT and the machine definition of remote_host must have type coded as c for Unicenter AutoSys Connect. Unicenter AutoSys JM is an automated job control system for scheduling, monitoring, and reporting on any AutoSysconfigured 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 JM 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 JM.
59