Prev | Table of Contents | Next

PJS®

Personal Job Scheduler

User’s Guide

Release 2.1

 

Related PJS Technical Documentation

 

Personal Job Scheduler (PJS®) Messages and Codes

Personal Job Scheduler (PJS®) Installation Guide

 

Personal Job Scheduler (PJS) 2.1.1 was released for distribution in April, 1992.

Personal Job Scheduler (PJS) 2.1.2 was released for distribution in November, 1992.

Personal Job Scheduler (PJS) 2.1.3 was released for distribution in October, 2002.

Personal Job Scheduler (PJS) 2.1.4 was released for distribution in February, 2004.

 

 

PJS is a registered trademark of Northrop Grumman.

 

 

MVS is a trademark and IBM®, OS/390®, RACF®, and z/OS® are registered trademarks of International Business Machines Corporation.

 

 

Copyright © Northrop Grumman, 1990, 2004.  All rights reserved.

 

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with the Invariant Sections being "PJS Software Copyright and License" and "GNU General Public License", with no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license is included in the section entitled "GNU Free Documentation License".

 

 

 

Table of Contents

 

 

Preface

Notational Symbols

Acknowledgments

PJS Software Copyright and License

Comments and Suggestions

 

1.   Introduction

 

2.   PJS System Overview

2.1    PJS Software Overview

2.1.1    The PJS Request Queue

2.1.2    The PJS JCL Spool

2.1.3    The PJS/TSO Interface

2.1.4    The PJS/ISPF Interface

2.1.5    The PJS System Task

2.2    Owners

2.3    PJS Job Requests

2.3.1    The request ID

2.3.2    Job Request Status

2.3.3    The JCL Data Set

2.3.4    Job Submission Date and Time

2.3.4.1   Start Date and Start Time

2.3.4.2   End Date and End Date

2.3.4.3   Next Run Date and Time

2.3.4.4   Last Run Date and Time

2.3.5    The Submit Window

2.3.6    Frequency

2.3.7    Job Request Events

2.4    PJS Calendars

2.5    PJS Events

2.5.1    The event ID

2.5.2    Events and Job Request Events

2.5.3    How to Post Events or Job Request Events

2.5.4    Preposted and Non Preposted Events

2.5.5    How to Reset Events or Job Request Events

2.6    PJS System Task Process Summary

 

3.   PJS Specification Conventions

3.1    The owner ID

3.2    The request ID

3.3    The calendar ID

3.4    The event ID

3.5    Time Specifications

3.5.1    Absolute Time

3.5.2    Relative Time

3.6    Date Specifications

3.6.1    Absolute Date

3.6.2    Relative Date

3.7    Job Request Status Values

 

4.   PJS TSO Commands

4.1    PJS Job Request Commands

4.1.1    PJREQADD

4.1.1.1   How to Specify an OWNER

4.1.1.2   How to Specify the Data Set Name

4.1.1.3   How to Use the PJS JCL Spool

4.1.1.4   How to Specify the Date of Submission

4.1.1.5   How to Specify the Time of Submission

4.1.1.6   How to Specify a Frequency Option

4.1.1.7   How to Specify an End Date

4.1.1.8   How to Specify an End Time

4.1.1.9   How to Specify Job Request Events

4.1.1.10  How to Post Job Request Events

4.1.1.11  How to Specify a Submit Window

4.1.1.12  How to Disable the Job Request

4.1.2    PJREQDEL

4.1.2.1   How to Specify the request ID

4.1.3    PJREQLST

4.1.3.1   How to List One Job Request

4.1.3.2   How to List All Job Requests For an Owner

4.1.3.3   How to List All Job Requests

4.1.3.4   How to Specify the Amount of Displayed Information

4.1.4    PJREQMOD

4.1.4.1   How to Specify the request ID

4.1.4.2   How to Modify the Data Set Name

4.1.4.3   How to Use the PJS JCL Spool

4.1.4.4   How to Specify a New Date of Submission

4.1.4.5   How to Specify a New Time of Submission

4.1.4.6   How to Specify a New Frequency Option

4.1.4.7   How to Specify, Replace, or Delete an End Date

4.1.4.8   How to Specify, Replace, or Delete an End Time

4.1.4.9   How to Specify, Add, or Delete Job Request Events

4.1.4.10  How to Post Job Request Events

4.1.4.11  How to Reset Job Request Events

4.1.4.12  How to Specify, Replace, or Delete a Submit Window

4.1.4.13  How to Disable or Enable the Job Request

4.2    PJS Calendar Commands

4.2.1    PJCALADD

4.2.1.1   How to Specify the calendar ID

4.2.1.2   How to Select Dates by Inclusion

4.2.1.3   How to Select Dates by Exclusion

4.2.2    PJCALDEL

4.2.2.1   How to Specify the calendar ID

4.2.3    PJCALIST

4.2.3.1   How to List One Calendar

4.2.3.2   How to List All Calendars for an Owner

4.2.3.3   How to List All Calendars

4.2.3.4   How to Specify the Amount of Displayed Information

4.2.4    PJCALMOD

4.2.4.1   How to Specify the calendar ID

4.2.4.2   How to Replace All Selected Dates by Inclusion

4.2.4.3   How to Replace All Selected Dates by Exclusion

4.2.4.4   How to Add Selected Dates to a Calendar

4.2.4.5   How to Delete Selected Dates from a Calendar

4.3    PJS Event Commands

4.3.1    PJEVLIST

4.3.1.1   How to List One Event

4.3.1.2   How to List All Events for an Owner

4.3.1.3   How to List All Events

4.3.2    PJEVPOST

4.3.2.1   How to Specify the event ID

4.3.3    PJEVRSET

4.3.3.1   How to Specify the event ID

 

5.   PJS/ISPF Interface

5.1    PJS Main Menu Panel

5.2    PJS Job Request Panel System

5.2.1    Job Request Menu Panel

5.2.2    List Job Requests Panel

5.2.3    Add Job Request Panel

5.2.4    Modify Job Request Panel

5.2.5    Specify Job Frequency Panel

5.2.6    Specify Job Request Events Panel

5.2.7    Delete Job Request Panel

5.2.8    Display Job Request Panel

5.2.9    Display Job Request Events Panel

5.2.10  Browse Saved JCL Panel

5.3    PJS Calendar Panel System

5.3.1    Calendar Menu Panel

5.3.2    List Calendars Panel

5.3.3    Add Calendar ID Panel

5.3.4    Add Calendar Panel

5.3.5    Modify Calendar Panel

5.3.6    Delete Calendar Panel

5.3.7    Display Calendar Panel

5.3.8    Job Requests for Calendar Panel

5.4    PJS Event Panel System

5.4.1    Event Menu Panel

5.4.2    List Events Panel

5.4.3    Post Event Panel

5.4.4    Reset Event Panel

5.4.5    Display Event Panel

5.4.6    Job Requests for Event Panel

 

6.   Examples

6.1    How to Run a One Time Job

6.2    How to Run a Daily Job

6.3    How to Run a Job on the First Tuesday of Each Month

6.4    How to Run a Job That Depends on Another Job

6.5    How to Set Up Several Dependent Jobs

6.6    How to Run a Job Whenever CICS Terminates

6.7    How to Run a Weekly Job After a Daily Job

6.8    How to Run a Job After a Manual Operation

6.9    How to Reset an Event

6.10  How to Enable a Failed Job Request

 

A.  Summary of Changes

A.1   Changes for Release 2.1.4

A.2   Changes for Release 2.1.3

A.3   Changes for Release 2.1

 

GNU General Public License

 

GNU Free Documentation License

 

 

 

Preface

 

 

Big jobs mean slow response.  By day, most computer systems are clogged with requests for service;  at night, many computers only run at a fraction of their capacity.  The Personal Job Scheduler (PJS®) enables you to submit batch jobs on any day, at any time, as often as needed, under any circumstances.

 

Because PJS does not rely on scheduling specialists or system operators, the ability to schedule job submission is placed in your hands.  When scheduling is decentralized, procedure and paperwork are eliminated, and scheduling errors decrease.  With the ability to schedule big or small jobs whenever you need them, the Personal Job Scheduler helps you make full use of your computer at all times of the day or night.

 

This manual describes how to use PJS. It assumes that you need to create ad hoc job submissions and that you have some knowledge of IBM mainframes, TSO, ISPF/TSO, and job submission standards at your site.

 

If you need information on error messages and abend codes encountered during PJS use, please refer to the Personal Job Scheduler (PJS®) Messages and Codes manual.  For more information on product installation and system options, please refer to the Personal Job Scheduler (PJS®) Installation Guide.

 

 

 

Notational Symbols

 

 

The following conventions are used in command formats throughout this manual:

 

 

BOLD UPPERCASE        is used to display commands or keywords you must code exactly as shown, for example, SEND FILENAME.TXT.

 

 

italic lowercase                  is used to display information you must supply, for example, SEND filename.txt.

 

 

Underscores                       either show a default value in a command description, display a default value in a screen image, or represent a highlighted word in a screen image.

 

 

Brackets   [  ]                     mean that you can select one of the items enclosed by the brackets;  none of the enclosed items is required.

 

 

Braces   {  }                       mean that you must select one of the items enclosed by the braces.

 

 

Vertical Bar   |                    separates options.  One vertical bar separates two options, two vertical bars separate three options, and so on.  You can select only one of the options.

 

 

Ellipsis   . . .                        means that you can repeat the word or clause that immediately precedes the ellipsis.

 

 

 

Acknowledgments

 

 

PJS was written by Tim Henness

 

The original version of this manual was written by Matthew ???? and Tim Henness.

Extensive revisions have been made by Tim Henness

 

 

 

PJS Software Copyright and License

 

 

All PJS software is Copyright © Northrop Grumman, 1990, 2004.  All rights reserved.

 

PJS is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

 

PJS is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

 

A copy of the GNU General Public License is included in the back of this book.

 

 

 

Comments and Suggestions

 

 

The author welcomes your comments and suggestions.  He can be contacted at:

 

Tim Henness

Northrop Grumman IT

Internal Information Services

Bldg. 521-2

4101 Washington Ave.

Newport News, VA  23607

 

E-mail: Tim.Henness@ngc.com

 

 


 

Prev | Table of Contents | Next

Copyright © Northrop Grumman, 1990, 2004. All rights reserved.