JAMS User Guide
Total Page:16
File Type:pdf, Size:1020Kb
JAMS User Guide Order Number: JAMS-UG-42 This manual provides a complete description of the Job Access & Management System. Revision/Update Information: This manual supersedes the Guide to the Job Access & Management System, Version 4.0. Operating System and Version: OpenVMS/VAX Version 6.2 or higher, OpenVMS/AXP V6.2 or higher Software Version: JAMS Version 4.2 The information in this document is subject to change without notice and should not be construed as a commitment by MVP Systems Incorporated. MVP Systems, Inc. assumes no responsibility for any errors that may appear in this document. The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of this license. Restricted Rights Notice: Use, duplication, or disclosure by the U.S. Government is subject to restrictions set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013. All Rights Reserved. Printed in the U.S.A. If you have questions about JAMS please feel free to call JAMS technical support at (866) 259-5267. Technical support is available around the clock, 24 hours a day, 7 days a week. The mailing address is: TECHNICAL SUPPORT DEPT. MVP SYSTEMS INC. 2700 E. MAIN ST. SUITE 108 COLUMBUS, OH 43209 E-Mail: [email protected] WWW: http://JAMS.mvpsi.com WWW: http://www.mvpsi.com The following are trademarks of Hewlett-Packard Company: Alpha, DECnet, DECwindows, OpenVMS, VAX, VMS, VMScluster. Window and Windows NT are registered trademarks of Microsoft Corporation. Motif is a registered trademark of The Open Group, Inc. Copyright ©2003 MVP Systems, Inc. Contents PREFACE x CHAPTER 1 OVERVIEW OF JAMS 1–1 1.1 INTRODUCTION 1–1 1.2 CAPABILITIES OF THE JOB ACCESS AND MANAGEMENT SYSTEM 1–1 1.2.1 User Access to Batch Processing 1–2 1.2.1.1 Menu based job submission • 1–3 1.2.1.2 DECwindows/Motif based job submission • 1–3 1.2.1.3 Command line interface • 1–3 1.2.1.4 Windows 9x/NT/2000 based job submission • 1–3 1.2.1.5 Callable interface • 1–3 1.2.2 Managing Batch Jobs 1–4 1.2.3 Tracking Batch Job History 1–4 1.2.4 Remote Access 1–4 1.2.5 Recurring Jobs 1–4 1.2.5.1 Time Based Schedules • 1–5 1.2.5.2 Event Based Schedules • 1–5 1.2.6 Maintaining Schedules 1–5 1.2.7 Control of Printed Reports 1–6 CHAPTER 2 GETTING STARTED WITH JAMS 2–1 2.1 AFTER THE INSTALLATION 2–1 2.1.1 Job Execution History 2–1 2.1.2 Job Failure Alerting 2–1 2.1.3 Job Monitoring and Management 2–1 2.2 DEFINING AND USING JAMS JOBS 2–1 2.3 SYSTEMS DEFINITIONS 2–2 2.4 JOB DEFINITIONS 2–3 iii Contents 2.4.1 Automatic Job Submission 2–3 2.4.2 Parameters 2–4 2.4.3 Source Code 2–4 2.5 SETUP DEFINITIONS 2–5 2.6 SEQUENCING 2–6 2.6.1 Setups 2–6 2.6.2 Dependencies 2–7 2.6.2.1 Job Dependencies • 2–7 2.6.2.2 Variable Dependencies • 2–8 2.6.3 Precheck Jobs 2–8 2.6.4 Resources 2–9 CHAPTER 3 GETTING STARTED ON WINDOWS NT/2000 3–1 3.1 GETTING READY FOR WINDOWS NT 3–1 3.1.1 Install and Configure the JAMS Agent 3–1 3.1.2 Define NT Usernames in JAMS 3–2 3.1.3 Grant ‘‘Log on as a batch job’’ to NT accounts or groups 3–2 3.1.3.1 Granting rights under Windows NT V4.0 • 3–2 3.1.3.2 Granting rights under Windows 2000 • 3–3 3.1.3.3 Granting rights with the NTRights.exe Utility • 3–3 3.2 CREATING NT JOBS 3–3 3.2.1 Windows NT Execution Methods 3–3 3.2.2 Windows NT Example Job 3–3 CHAPTER 4 GETTING STARTED ON UNIX 4–1 4.1 GETTING READY FOR UNIX 4–1 4.1.1 Define Unix Usernames in JAMS 4–1 4.1.2 Verify that the rexec daemon is enabled on your target 4–1 4.2 CREATING UNIX JOBS 4–2 4.2.1 Rexec Execution Methods 4–2 4.2.2 Rexec Example Job 4–2 iv Contents CHAPTER 5 USING JAMS_MASTER 5–1 5.1 JAMS_MASTER 5–1 5.1.1 Foreign Command Lines 5–1 5.2 CUSTOMIZING JAMS_MASTER 5–1 5.2.1 Remote Connections 5–2 5.2.2 Title 5–2 5.2.3 Default Job Submission Menu 5–2 5.2.4 Messages 5–2 5.2.5 Date and Time Format 5–3 5.2.6 Monitor Options 5–3 CHAPTER 6 THE SCREEN BASED ENVIRONMENT 6–1 6.1 THE MAIN MENU 6–1 6.1.1 History Inquiry 6–1 6.1.2 Definitions 6–4 6.1.2.1 Setup Definitions • 6–4 6.1.2.2 Job Definitions • 6–4 6.1.2.3 System Definitions • 6–5 6.1.2.4 Trigger Definitions • 6–5 6.1.2.5 Variable Definitions • 6–5 6.1.2.6 Menu Definitions • 6–5 6.1.3 Job Submission 6–5 6.1.4 Show Current Jobs 6–5 6.1.5 Monitor Current Jobs 6–6 6.1.5.1 Monitor Options • 6–8 6.1.5.2 Job Management Menu • 6–10 6.1.6 Management Functions 6–12 6.1.6.1 Named Times • 6–12 6.1.6.2 Dates • 6–12 6.1.6.3 Access Control • 6–13 6.1.6.4 Node Definitions • 6–13 6.1.6.5 Node Groups • 6–13 6.1.6.6 Configuration • 6–13 6.1.6.7 Date Types • 6–13 6.2 COMMON FUNCTIONS AND FEATURES 6–13 6.2.1 On-line Help 6–13 6.2.2 Menus 6–14 v Contents 6.2.3 Insert/Overstrike 6–14 6.2.4 Moving Between Fields 6–14 6.2.5 Exit Key 6–14 6.2.6 Find Key 6–15 6.2.7 List Screens 6–15 6.2.8 Screen Layout 6–15 6.2.9 Maintenance Functions 6–15 6.2.9.1 Maintenance Mode Menu/Indicator • 6–16 6.2.9.2 Key Fields • 6–17 6.2.9.3 Data Entry Screens • 6–17 6.2.9.4 Special Function Keys • 6–17 CHAPTER 7 JAMS WINDOWS INTERFACE 7–1 7.1 STARTING THE JAMS WINDOWS 9X/NT/2000 INTERFACE 7–1 7.2 SUBMIT WINDOW 7–1 7.2.1 Navigating the Window 7–1 7.2.2 File menu 7–2 7.2.3 Action menu 7–3 7.2.4 Window menu 7–3 7.3 SUBMITTING A JOB 7–3 7.4 MONITOR WINDOW 7–4 7.4.1 The Monitor Display 7–4 7.4.2 Monitor Detail Lines 7–5 7.4.3 File menu 7–6 7.4.4 Action menu 7–6 7.4.5 Window menu 7–7 7.5 HISTORY WINDOW 7–7 7.5.1 The History Display 7–8 7.5.2 File menu 7–8 7.5.3 Action menu 7–9 7.5.4 Window menu 7–9 7.5.5 History Search Window 7–9 7.6 USING HELP 7–10 vi Contents CHAPTER 8 JAMS DECWINDOWS/MOTIF INTERFACE 8–1 8.1 STARTING THE JAMS DECWINDOWS/MOTIF INTERFACE 8–1 8.1.1 Remote Connections 8–1 8.2 SUBMIT WINDOW 8–1 8.2.1 Navigating the Window 8–2 8.2.2 File menu 8–2 8.2.3 Action menu 8–3 8.2.4 Window menu 8–4 8.3 SUBMITTING A JOB 8–4 8.4 MONITOR WINDOW 8–4 8.4.1 The Monitor Display 8–4 8.4.2 Monitor Detail Lines 8–4 8.4.3 File menu 8–6 8.4.4 Action menu 8–7 8.4.5 Window menu 8–8 8.5 HISTORY WINDOW 8–8 8.5.1 The History Display 8–9 8.5.2 File menu 8–9 8.5.3 Action menu 8–9 8.5.4 Window menu 8–10 8.5.5 History Search Window 8–10 8.6 DEFINITIONS WINDOW 8–11 8.6.1 Button Bar 8–12 8.6.2 The Definitions Display 8–12 8.6.3 File menu 8–12 8.6.4 Action menu 8–13 8.6.5 Window menu 8–13 8.6.6 Management menu 8–14 8.6.7 Search Criteria 8–14 8.7 CONNECT DIALOG 8–14 8.8 USING HELP 8–15 vii Contents CHAPTER 9 SUBMITTING AD HOC JOBS 9–1 9.1 SUBMITTING A JAMS JOB 9–1 9.1.1 Replacing the OpenVMS SUBMIT Command 9–1 9.2 SELECTING A JOB TO SUBMIT 9–2 9.2.1 Parameters 9–2 9.2.2 Report Overrides 9–4 CHAPTER 10 ENTERING GENERIC DATE SPECIFICATIONS 10–1 10.1 DATE SPECIFICATIONS 10–1 10.1.1 Scheduled Date 10–1 10.1.2 Default Parameter Values 10–1 10.1.3 Setup Parameter Values 10–1 10.2 SIMPLE SPECIFICATIONS 10–2 10.2.1 Description of components 10–2 10.2.2 Valid Simple Date Specifications 10–3 10.3 COMPLEX SPECIFICATIONS 10–3 10.3.1 User Defined Periods 10–4 10.3.2 Weeks 10–4 10.3.3 Valid Complex Date Specifications 10–4 CHAPTER 11 MANAGING JAMS 11–1 11.1 JAMS PROCESSES 11–1 11.1.1 The JAMS_MONITOR process 11–1 11.1.2 The JAMS_SCHEDULE process 11–2 11.1.2.1 Controlling the JAMS_SCHEDULE node selection • 11–2 11.1.2.2 Customizing JAMS_SCHEDULE startup • 11–3 11.1.3 The JAMS_NETWORK process 11–3 11.1.3.1 Controlling the JAMS_NETWORK node selection • 11–3 11.1.4 The JAMS Agent Windows NT/2000 Service 11–4 11.1.5 Log Files 11–5 viii Contents 11.2 RECURRING JOBS 11–5 11.3 RELATIVE CPU POWER RATINGS 11–5 11.4 SECURITY 11–6 11.5 BACKING UP THE JAMS DATABASE 11–7 11.6 JAMS QUEUE CHARACTERISTICS 11–7 11.6.1 Production & Debug Characteristics 11–8 INDEX FIGURES 6–1 Main Menu 6–2 6–2 History List Screen 6–3 6–3 History Detail Screen 6–4 6–4 Monitor Jobs Display 6–6 6–5 Monitor Options 6–9 6–6 Job Management Pop-up Menu 6–11 6–7 Job Detail 6–12 6–8 Sample JAMS Screen 6–16 7–1 Windows Submit Window 7–2 7–2 Windows Monitor Window 7–4 7–3 Windows History Window 7–8 8–1 DECwindows Submit Window 8–2 8–2 DECwindows Monitor Window 8–5 8–3 DECwindows History Window 8–8 8–4 DECwindows Definitions Window 8–11 9–1 Job Submission Menu 9–3 9–2 Sample Parameter Form 9–4 9–3 Sample Job/Report Override Form, one Report 9–5 9–4 Sample Job/Report Override Form, many Reports 9–6 ix Preface This manual provides a detailed description of the capabilities of the Job Access & Management System (JAMS).