You are on page 1of 120

Getting Started with ESP

Enterprise Systems Platform


Version 5.1

Getting Started with ESP


ESP-GS-01

ESP Workload Manager

First Edition (March 1998) This edition applies to Version 5 Release 1 of ESP Workload Manager Documentation. The software and related manuals are protected by copyright law. ESP Workload Manager Documentation Copyright 1992-1998 Cybermation Inc. All rights reserved. ESP Workload Manager Software Copyright 1992-1998 Cybermation Inc. All rights reserved. No portion of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means without express written permission from: Cybermation Inc., 80 Tiverton Court, Markham, Ontario, Canada, L3R 0G4, (905)-479-4611. U.S. Government Users. RESTRICTED RIGHTS - Use, Duplication or Disclosure restricted by GSA ADP Schedule Contract with Cybermation Inc.

Trademark Notice: ESP Workload Manager is a trademark of Cybermation Inc. All other brand and product names are trademarks or registered trademarks of their respective companies.

Getting Started with ESP

Table of Contents
Preface ........................................................................................................................................ 9 About this Manual............................................................................................................... 9 ESP .................................................................................................................................. 9 This manual ..................................................................................................................... 9 When to use this manual ................................................................................................. 9 Who should use this manual ........................................................................................... 9 How to use this manual ................................................................................................. 10 Menus and panels .......................................................................................................... 10 ESP system name .......................................................................................................... 11 How this manual is organized ....................................................................................... 11 If you need more information........................................................................................ 12 Conventions used in this guide...................................................................................... 12 1. Introducing ESP .................................................................................................................. 13 Overview ........................................................................................................................... 13 Introduction ................................................................................................................... 13 What you will learn ....................................................................................................... 13 In this chapter ................................................................................................................ 13 ESP Overview ................................................................................................................... 14 What ESP can do........................................................................................................... 14 Scheduling Jobs automatically ...................................................................................... 14 Submitting JCL ............................................................................................................. 15 Tailoring JCL ................................................................................................................ 15 Data set triggering ......................................................................................................... 15 Tracking Jobs ................................................................................................................ 16 Job monitoring .............................................................................................................. 16 Reporting....................................................................................................................... 16 Reporting contd........................................................................................................ 17 Sending messages and notification................................................................................ 17 Issuing MVS Commands .............................................................................................. 17 Monitoring Workload.................................................................................................... 17 Some Features of ESP ....................................................................................................... 18 Overview ....................................................................................................................... 18 Free-format schedule criteria......................................................................................... 18 Calendars....................................................................................................................... 19 Security.......................................................................................................................... 19 Control Language (CLANG)......................................................................................... 19 REXX Interface............................................................................................................. 19 InfoServ ......................................................................................................................... 19 How You Can Communicate With ESP ........................................................................... 20 Overview ....................................................................................................................... 20 ESP menus and panels................................................................................................... 20 Using Page Mode .......................................................................................................... 21 Processing in batch........................................................................................................ 22

ESP Workload Manager Using Help panels ......................................................................................................... 22 Summary ........................................................................................................................... 23 What you learned in this chapter................................................................................... 23 2. How ESP Works ................................................................................................................. 25 Overview ....................................................................................................................... 25 In this chapter ................................................................................................................ 25 ESP Applications .............................................................................................................. 26 Overview ....................................................................................................................... 26 APPL1 ........................................................................................................................... 26 ESP Events ........................................................................................................................ 27 Overview ....................................................................................................................... 27 Scheduling an Event...................................................................................................... 27 Event names .................................................................................................................. 28 Event Data set................................................................................................................ 28 Creating an Event .......................................................................................................... 28 Commands in an Event ................................................................................................. 28 ESP Procedures ................................................................................................................. 29 Overview ....................................................................................................................... 29 Characteristics of a Procedure....................................................................................... 29 Putting It All Together ...................................................................................................... 30 Relationships ................................................................................................................. 30 Execution of the Event .................................................................................................. 30 Summary ........................................................................................................................... 31 Wrap-up......................................................................................................................... 31 3. Starting to Use ESP ......................................................................................................... 33 Overview ....................................................................................................................... 33 In this chapter ................................................................................................................ 33 Sending a Message ............................................................................................................ 34 Overview ....................................................................................................................... 34 Creating an Event .......................................................................................................... 34 Analyzing the Event .......................................................................................................... 42 Overview ....................................................................................................................... 42 EVENT command ......................................................................................................... 42 SCHEDULE command ................................................................................................. 42 SEND command............................................................................................................ 42 ENDDEF command ...................................................................................................... 42 Triggering the Event.......................................................................................................... 43 Overview ....................................................................................................................... 43 Triggering the Event now.............................................................................................. 43 Issuing an MVS Operator Command ................................................................................ 46 Overview ....................................................................................................................... 46 Display titles of system dump data sets......................................................................... 46 Submitting a Job................................................................................................................ 49 Overview ....................................................................................................................... 49 Submit the Job............................................................................................................... 49

Getting Started with ESP Summary ........................................................................................................................... 52 In this chapter ................................................................................................................ 52 4. Working with ESP Applications ....................................................................................... 53 Introduction ................................................................................................................... 53 In this chapter ................................................................................................................ 53 Case Study A ..................................................................................................................... 54 Overview ....................................................................................................................... 54 Your assignment............................................................................................................ 54 Flow chart...................................................................................................................... 54 Job relationships............................................................................................................ 54 Dependencies ................................................................................................................ 55 Schedule Criteria ........................................................................................................... 55 Data sets ........................................................................................................................ 55 Creating an ESP Application............................................................................................. 56 Overview ....................................................................................................................... 56 Using the menus ............................................................................................................ 56 Summary ....................................................................................................................... 63 Analyzing the Application................................................................................................. 64 Overview ....................................................................................................................... 64 Payroll: a sample Application ....................................................................................... 64 Job statements and their meanings ................................................................................ 65 Editing a member of a data set ...................................................................................... 65 Creating an Event to Invoke an ESP Application ............................................................. 66 Overview ....................................................................................................................... 66 Creating the Event ......................................................................................................... 66 Summary ........................................................................................................................... 69 In this chapter ................................................................................................................ 69 5. Testing the Event and the Application ............................................................................. 71 Overview ....................................................................................................................... 71 In this chapter ................................................................................................................ 71 Simulation ......................................................................................................................... 72 Overview ....................................................................................................................... 72 What you will simulate ................................................................................................. 72 Simulating the Next Occurrence ....................................................................................... 73 Overview ....................................................................................................................... 73 The simulation results ................................................................................................... 74 Simulating a Specific Day................................................................................................. 75 Overview ....................................................................................................................... 75 The simulation............................................................................................................... 75 Simulating the End of the Month ...................................................................................... 77 Overview ....................................................................................................................... 77 The simulation............................................................................................................... 77 Simulating the Last Day of the Month on a Friday ........................................................... 78 Overview ....................................................................................................................... 78 The simulation............................................................................................................... 78

ESP Workload Manager Summary ........................................................................................................................... 79 In this chapter ................................................................................................................ 79 6. Monitoring an Application ................................................................................................ 81 Overview ........................................................................................................................... 81 Introduction ................................................................................................................... 81 In this chapter ................................................................................................................ 81 Triggering the Event to Invoke the Application................................................................ 82 Overview ....................................................................................................................... 82 Triggering the Event...................................................................................................... 82 Using CSF to View Job Information................................................................................. 84 Consolidated Status Facility (CSF) ............................................................................... 84 This section ................................................................................................................... 84 Assumptions .................................................................................................................. 84 Using CSF ..................................................................................................................... 85 Summary ........................................................................................................................... 91 In this chapter ................................................................................................................ 91 7. Learning More about ESP................................................................................................. 93 Overview ........................................................................................................................... 93 Introduction ................................................................................................................... 93 In this chapter ................................................................................................................ 93 Case Study B ..................................................................................................................... 94 The assignment.............................................................................................................. 94 Editing versus creating .................................................................................................. 94 Member PAYROLL ...................................................................................................... 95 Invoking the Application............................................................................................... 96 Analyzing the Application................................................................................................. 97 Overview ....................................................................................................................... 97 The new statements ....................................................................................................... 97 Summary ........................................................................................................................... 99 In this chapter ................................................................................................................ 99 8. Using CSF to Control Applications ................................................................................ 101 Overview ......................................................................................................................... 101 Introduction ................................................................................................................. 101 In this chapter .............................................................................................................. 101 Listing an Application ..................................................................................................... 102 Overview ..................................................................................................................... 102 LA command to list an Application ............................................................................ 102 Holding and Releasing an Application............................................................................ 103 Overview ..................................................................................................................... 103 HA command to place an Application on hold ........................................................... 103 AA command to release an Application from hold..................................................... 104 Listing a Job .................................................................................................................... 105 Overview ..................................................................................................................... 105 L command to list a job............................................................................................... 105 Holding and Releasing a Job........................................................................................... 106

Getting Started with ESP Overview ..................................................................................................................... 106 H command to hold a job ............................................................................................ 106 A command to release a job ........................................................................................ 107 Listing Job Statistics........................................................................................................ 108 Overview ..................................................................................................................... 108 LJ command ................................................................................................................ 108 Inserting a Job ................................................................................................................. 109 Overview ..................................................................................................................... 109 IJ command to insert a job .......................................................................................... 109 Summary ......................................................................................................................... 111 In this chapter .............................................................................................................. 111 Glossary.................................................................................................................................. 112 Terms........................................................................................................................... 112 Index ....................................................................................................................................... 113

ESP Workload Manager

Getting Started with ESP

Preface About this Manual

ESP

Enterprise System Platform (ESP) Workload Manager is a very powerful and versatile system for scheduling Jobs and managing workload.

This manual

This manual introduces you, the new user, to ESP using a simple, stepby step approach, presenting only the basic information. More experienced users can refer to the ESP Users Guide. The methods described first are those most suitable for people who know little about ESP. As you progress through this guide and learn more about ESP, you will learn other methods that are faster and more direct. As you gain experience, you will find that ESP lets you do very complicated things. The guide uses two case studies to provide context for the examples and methods. Case Study A is very simple, allowing you to focus on what you are doing and what you are seeing. Later, Case Study B expands on Case Study A.

When to use this manual

Use this manual as a learning tool when you first begin to use ESP.

Who should use this manual

This manual is for the scheduler who has never used ESP before and knows nothing about ESP. If you fit the following description, this guide is specifically for you: You are a scheduler or you schedule Jobs for your organization You have worked on mainframes for at least a year You understand MVS terms and are familiar with the ISPF editor You have ESP installed on your system but you dont know anything about it. If you dont fit the description but you are a new user of ESP, you will still find this guide useful.
Continued on next page

ESP Workload Manager

About this Manual, Continued

How to use this manual

Read the first two chapters of this manual to get both an overview of ESP and an understanding of the following ESP concepts: Applications Procedures Events. In chapters 3 and 4, build on your understanding of ESP by creating: Events An Application. Next, read chapters 5 and 6 to learn how to: Test your Events Get information about your Jobs. To learn how to create a more complex ESP Application by editing data sets instead of using menus, read chapter 7. To learn how to use the Consolidated Status Facility (CSF), to control workload, read chapter 8. As a new user, you will probably want to read all the text as you proceed. Later, as you become more familiar with ESP and this guide, you may want to move faster. You can do this by following the numbered steps.

Menus and panels

This guide shows pictures of menus and panels when they appear in the text for the first time. After that, it shows a picture of the menu or panel only when necessary: either because it contains new information or to point out something specific about the menu or panel.
Continued on next page

10

Getting Started with ESP

About this Manual, Continued

ESP system name

The instructions and examples in this guide assume that your System Programmer did not change the name of the ESP subsystem during installation. If ESP does not respond as described, consult your System Programmer, or System Administrator. 

How this manual is organized

Chapter 1 Introducing ESP describes some of the things ESP can do to help you, some features you can use, how you can work with ESP, and how you can obtain more information online. Chapter 2 How ESP Works introduces you to the concepts of ESP and describes how they fit together. Chapter 3 Starting to Use ESP describes how to create an Event to perform simple operations. Chapter 4 Working with ESP Applications uses Case Study A to show you how to create an ESP Application and an Event. Chapter 5 Testing the Event and the ESP Application shows you how to test the Event and ESP Application without actually submitting Jobs. Chapter 6 Monitoring the Application describes how to invoke an Application by triggering an Event and simple ways to keep track of Jobs. Chapter 7 Learning More About ESP uses Case Study B to show you how to create a more complicated ESP Application and describes a different way to achieve the same result. Chapter 8 Using CSF to Control Applications shows you how to control Applications and Jobs using CSF.
Continued on next page

     

11

ESP Workload Manager

About this Manual, Continued

If you need more information

This introductory guide is part of the ESP library. Other titles in the library are: ESP Users Guide ESP Operators Guide ESP Command Reference ESP Command Quick Reference. ESP also provides online help. For more information on how to use the online help, refer to Chapter 1 Introducing ESP.

Conventions used in this guide

This manual uses all uppercase letters for names of the following: Data sets Members Jobs Commands. For example, a data set: USER1.SAMP.ESPPROC This guide uses bold to show all entries you type in. For example, on the command line, type: COMMAND ===> enddef In this example, you type the command ENDDEF on the command line. When you type information, you can use lowercase letters. For example, when you type a command on the command line, you do not need to type the command in uppercase letters. For consistency and to avoid confusion, this manual always uses two steps when instructing you to enter information. For example: Type esp and press ENTER.

12

Getting Started with ESP

1. Introducing ESP Overview

Introduction

This chapter introduces the basic concepts you need to understand to use ESP Workload Manager.

What you will learn

By the end of this chapter, you should know:  Some of the things ESP can do to help you, the scheduler  Some features of ESP you can use  How you can work with ESP  How you can obtain more information online. This chapter contains the following topics: Topic ESP Overview Some Features of ESP How You Can Communicate With ESP Summary See Page 14 18 20 23

In this chapter

13

ESP Workload Manager

ESP Overview

What ESP can do

ESP Workload Manager is a very flexible and versatile jobscheduling and workloadmanagement system. You can use ESP to accomplish many of your tasks. In this section, you will learn about some of the things that you can do using ESP. These include:  Schedule Jobs automatically  Submit JCL (Job Control Language) automatically  Tailor JCL automatically  Use the closing of a data set to start a Job  Keep track of Jobs and have automatic actions performed, if necessary  Create reports  Send messages and notifications to yourself or to other ESP users  Issue MVS commands  Monitor and control workload on many platforms in addition to MVS.

Scheduling Jobs automatically

As a scheduler, you can use ESP to schedule some or all of your Jobs. ESP will run the Jobs for you automatically if you tell it the following information, using familiar, plain English:  Which Jobs to run  When to run Jobs  The location of the Jobs JCL  The relationships between Jobs (such as the sequence in which Jobs must be released for processing)  Any conditions that could affect running the Jobs (such as condition codes). ESP automatically ensures that all dependencies a Job has are met before it submits that Job. You can use ESPs simulation feature to perform a test run without actually running the Jobs. The test run checks for errors and tests which Jobs will run and in what order. Later in this manual, you will have the opportunity to use this feature.
Continued on next page

14

Getting Started with ESP

ESP Overview, Continued

Submitting JCL

ESP submits JCL directly to the JES2 or JES3 internal reader from any JCL library. With ESP, you can use existing JCL, without conversion. You can also obtain a working copy of the JCL ESP uses, so you can use it if you need to resubmit the Job.

Tailoring JCL

Making changes to JCL is a timeconsuming process, prone to errors. ESP eliminates much of this work by automatically modifying the JCL you submit. Instead of manually changing values for dates, parameters, and control cards, you can use what ESP calls builtin symbolic variables or you can create your own symbolic variables, and let ESP resolve the variables for each Job. You can also control how ESP processes JCL, adding or removing JCL statements as required. For example, you could automatically add a Job step every Friday or you could remove a Job step only during the first two weeks in January.

Data set triggering

The closing of a data set can tell ESP to trigger an activity. For example, you can use the closing of a data set to tell ESP to submit a Job. If you close a data set many times, you can use a counter to trigger an ESP activity after a specific number of closures. For example, you can use this feature to tell ESP to back up a critical data set after every thirty closures. If a data set closes due to an ABEND (Abnormal End), triggering will not occur.
Continued on next page

15

ESP Workload Manager

ESP Overview, Continued

Tracking Jobs

ESPs Job-tracking facility keeps track of Jobs in real time as the Jobs run, whether or not the Jobs were submitted through ESP. You can obtain SMF (System Management Facility)based information such as CPU time and elapsed time, at any stage of processing. ESP can track Jobs in the same data center complex or track them at other Network Job Entry (NJE) nodes.

Job monitoring

ESPs Job monitor is an extension of the Job tracking facility. You can use the Job monitor to take action at various stages of a Job (such as Job start, step end, Job end). Some of the actions the Job monitor can take include, but are not restricted to:  Starting a Job stream  Sending a message  Restarting a Job by automatically resubmitting it  Submitting a recovery Job. ESP has several reporting facilities:  The history reporting facility  The scheduledactivity reporting facility  The modeling facility  Job Mapping. The history reporting facility provides detailed history information about the progress of various Jobs. You can use this history information to produce online and hardcopy reports. The scheduledactivity reporting facility creates reports indicating, but not limited to:  What is scheduled and when  Estimates of Job execution times  Estimates of CPU times  Anticipated use of tape drives.
Continued on next page

Reporting

16

Getting Started with ESP

ESP Overview, Continued

Reporting contd

ESPs modeling feature simulates the Job selection process by initiating each Job based on priority, class, and resource availability. You can use modeling to:  Find out what you cannot schedule and why  Find out how changes affect the schedule  Uncover potential resource bottlenecks and shortages. You can tell ESP to send a message at a specific date or time either to yourself, or to another user, or to the operator. You can also notify yourself, another user, or the operator when a specific incident, such as a Job failure, Job start, late Job, or Job submit, occurs.

Sending messages and notification

Issuing MVS Commands

You can tell ESP to issue a command at a specific date or time.

Monitoring Workload

You can monitor and control ESP workload on MVS and non-MVS platforms using the Consolidated Status Facility (CSF). It displays a real-time view of the workload as it executes, and provides a command interface where you can control workload at the Job or application level.

17

ESP Workload Manager

Some Features of ESP

Overview

This section describes some of the features you can use within ESP:  Freeformat schedule criteria to make scheduling easier  Calendars to simplify scheduling  Security  Procedural languages (CLANG and REXX)  InfoServ for recording problems. You can use everyday English words to specify schedule criteria. For example, if you want to start a Job stream at six oclock Friday afternoon, you can use any one of the following expressions:  6 p.m. Friday  6 p.m. Fridays  18.00 on Friday  Fri at 6 p.m. You can also use expressions such as the following:  Last Friday of the month  Daily at 3 p.m. starting May 20th  2nd Monday of July  3rd 15th 23rd day of month  10th-15th workday of month  Every 2 weeks  Every 2 hours. As the above examples show, you do not have to use uppercase characters for the first letters of months or days - ESP accepts upper or lowercase characters.
Continued on next page

Free-format schedule criteria

18

Getting Started with ESP

Some Features of ESP, Continued

Calendars

ESP has a built-in understanding of many scheduling terms. Use a calendar to define your unique scheduling terms to ESP. For example, you can add holidays and special days to your calendar to simplify schedule setting by providing additional terms to use. For example, if you want Jobs to run at specific times within pay periods, you can define your pay periods in your calendar. Then you can use expressions such as: last Friday of pay_period

Security

ESP works with two types of objects:  Internal objects (such as calendars)  External objects (such as user data sets). When ESP accesses an external object for you, ESP uses your existing security system. For internal objects, ESP uses either its own or your existing security system.

Control Language (CLANG)

ESP provides a procedural language (CLANG) you can use to define your Jobs and dependencies. CLANG includes language elements, such as built-in functions, and IF, THEN, and ELSE, to add simple or complex conditional processing to your Job stream.

REXX Interface

You can use IBMs MVS/REXX (Restructured Extended Executor) procedural language to extend CLANG and add new functions to ESP procedures. You can use REXX statements to:  Perform repetitive operations  Issue commands to ESP and capture command responses  Build Application code  Read or write to data sets. The InfoServ interface enables ESP to automatically open and update problem records managed by IBMs Information/Management program. You can then administer problems directly, using CSF (Consolidated Status Facility).

InfoServ

19

ESP Workload Manager

How You Can Communicate With ESP

Overview

ESP provides many ways for you to send or receive information. If you are new to ESP or if you prefer to use menus, you can use ESPs series of menus and panels. As you gain more experience, you may prefer to use Page Mode, which allows you to provide input on the command line and to scroll through the output it generates. This section describes how you can:  Navigate through menus  Use Page Mode to enter and execute commands  Process commands in batch.

ESP menus and panels

ESP provides a series of ISPF menus and panels. Below is an example of an ESP menu, the Main Menu:

ESP displays messages in the top right corner of the menu or panel. When the message is longer than 24 characters, ESP truncates the message. To see the full message, press HELP; ESP then displays the full message on the third line of the panel. Chapters 3 through 7 provide detailed descriptions on how to use the menus and panels.
Continued on next page

20

Getting Started with ESP

How You Can Communicate With ESP, Continued


Using Page Mode

When you choose option G (ESP Page Mode) on the Main Menu, ESP displays the Page Mode panel:

On the Page Mode panel above, you can enter commands, one at a time, on the command line. Every command must conform to the command syntax described in the ESP Command Reference. When you press Enter, ESP executes the command. You can repeat a command without retyping it. Move the cursor to the command you want to repeat and press Enter. If you need to scroll the panel, you can use the scroll keys. ESP copies the command to the command line, where you can make any changes. Finally, press Enter to repeat the command. To edit information displayed in Page Mode, type the following on the command line and press Enter: ===> edit You can then use ISPF editing functions. When you have finished editing, use the ISPF CREATE or REPLACE commands to save the changes.
Continued on next page

21

ESP Workload Manager

How You Can Communicate With ESP, Continued

Processing in batch

At times, you may want to perform a series of commands in batch mode. The following example shows the JCL you should use after your Job card if you want to process commands in batch.
//EXEC PGM=ESP,REGION=4000K //SYSPRINT DD SYSOUT=* ESP command ESP command . . ESP command /*

If the name of the your ESP subsystem was changed, for example to ESPT, the EXEC statement in the example above may look like:
// EXEC PGM=ESP,REGION=4000K,PARM=SUBSYS(ESPT)

Check with the person who installed ESP to see if a STEPLIB is required.

Using Help panels

If you are at an ESP panel, and you want some information about the menu or the options on the menu, press Help, or type HELP at the command prompt. Help is usually PF1 or PF13 but your System Administrator may have designated another key as the Help key. If PF1 or PF13 does not take you to the help information, consult your System Administrator. If you want to find out more about the help panels, press Help to go to a help panel; then press Help again to go to the help tutorial.

22

Getting Started with ESP

Summary

What you learned in this chapter

In this chapter, you learned about the flexibility and versatility of ESP in scheduling Jobs and managing workload. You should have learned that ESP:  Schedules Jobs automatically  Submits Jobs automatically  Resolves all dependencies before submitting a Job  Tailors JCL automatically  Can use the closing of a data set to trigger activity  Keeps track of Jobs and takes automatic action if necessary  Creates reports  Sends messages and notifications automatically. You should have also learned how to work with ESP and how to obtain information online. You should have learned about:  ESP menus  Page Mode  Processing in batch  ESP help.

23

ESP Workload Manager

24

Getting Started with ESP

2. How ESP Works

Overview

This chapter introduces you to the concepts of ESP. In this chapter, you will learn about ESP Applications, Procedures, and Events and how they relate to each other.

In this chapter

This chapter contains the following topics: Topic ESP Applications ESP Events ESP Procedures Putting It All Together Summary See Page 26 27 29 30 31

25

ESP Workload Manager

ESP Applications

Overview

An ESP Application consists of one or more (usually related) Jobs that run under the control of an ESP Manager across your enterprise on mainframes, mid-range, and small systems. (An ESP Application is a type of ESP Procedure.)

Introductory example

To introduce you to the concepts behind ESP, assume the following example. You are to schedule four Jobs where:  The Application begins processing with Job A, which runs daily.  Job B runs daily but only after Job A ends successfully  Job C runs daily but only after Job B ends successfully  Job D runs every Friday but only after Job C ends successfully. In the above example, Jobs A, B, C, and D combine to form a group of related Jobs. This combination of Jobs forms an ESP Application; well call APPL1.

APPL1

In ESP Application APPL1, the following flow chart depicts the relationship between the four Jobs:
A Daily at 6 pm

Daily

Daily

Every Friday

The flow chart shows the following Job dependencies: Job B depends on Job A to finish before it can start. Similarly, Job D depends on Job C, which depends on Job B.

26

Getting Started with ESP

ESP Events

Overview

If you want to run an ESP Application at a certain time every day, you need a way to tell that to ESP. The object you use is an Event. An Event defines:  When ESP must perform the work  What actions ESP must take to perform the work. You can use an ESP Event to:  Invoke an ESP Application  Submit a Job or group of Jobs  Send a message  Issue an MVS operator command.

Scheduling an Event

You can trigger an Event manually, or you can have ESP schedule the Event automatically, by telling ESP when to do so (for example, 6 pm daily). You can also trigger an Event based on data set activity. Note: if no relationship exists between the Jobs you will be submitting, you should use an ESP Application, not an Event, to submit them.
Continued on next page

27

ESP Workload Manager

ESP Events, Continued

Event names

The name of an Event (the Eventid) has two parts:  A prefix, which contains as many as eight alphanumeric characters, including the national characters. The prefix identifies a user or a group of users. It can be used for security purposes.  A descriptive name, which contains as many as 16 alphanumeric characters including the national characters and underscore character.

Event Data set

ESP stores Events in an Event Data set (EVENTSET), which is a VSAM data set that has been defined to ESP.

Creating an Event

You can use the ESP panels to create or edit an Event, or you can use ESP Page Mode commands to create an Event. In your day to day, work you will probably use the panels or edit an existing Event.

Commands in an Event

Typical commands you will find in an Event are:  INVOKE - which provides the location of the ESP Application (for example, INVOKE DEMO.SAMP.ESPPROC(APPL1)  SCHEDULE - which tells ESP when to trigger the Event (for example, SCHEDULE 6 pm DAILY).

28

Getting Started with ESP

ESP Procedures

Overview

An ESP Procedure is a stored set of instructions that, when triggered by an Event, performs some action. One of the instructions within an ESP Procedure may be to build an Application. A common use of an ESP Procedure is to describe an ESP Application to ESP. An ESP Procedure consists of a series of statements to:  Name the ESP Application  Tell ESP where the JCL is located  Identify the Jobs  Describe the Job relationships  Describe how often the Jobs will run.

Characteristics of a Procedure

A Procedure may state such things as what condition codes cause a Job to fail and who should be notified. Following are some of the characteristics of an ESP Procedure:  A Procedure can be as simple or as complicated as you need.  Statements must conform to the syntax described in the ESP Command Reference.  CLANG or REXX statements can be used within an ESP Procedure to let ESP make decisions  Its definition can be stored in a PDS member.  It can be edited using an editor such as the ISPF editor.

29

ESP Workload Manager

Putting It All Together

Relationships

The diagram below shows (in very simplified form) the relationships between an ESP Application, an ESP Procedure, and an Event for ESP Application APPL1:
PROC

Application

Invokes
EVENT

APPL Job A JOB B JOB C JOB D

Builds
JOB B

Job A
JOB C

JOB D

. . Submits
Job A

In the diagram above, the ESP Application consists of four Jobs linked together conceptually by dependencies. The Application shown here is what it looks like on Friday. The ESP Procedure is a member in a PDS and the Event is stored in an EVENTSET, a VSAM data set.

Execution of the Event

When ESP executes the Event, the INVOKE command invokes the ESP Procedure. Statements in the ESP Procedure define the conditions for executing the group of related Jobs specified in the ESP Procedure. Another statement (APPL) specifies the Application identifier for all Jobs in the ESP Procedure. Another statement (JCLLIB) identifies the JCL library that contains the JCL for the Jobs. The JOB statement identifies the name of the Job in the ESP Procedure. ESP finds the JCL, ensures all dependencies are met, then submits the Job.

30

Getting Started with ESP

Summary

Wrap-up

In this chapter, you were introduced to the concepts of ESP. You should have learned about:  ESP Applications  ESP Procedures  Events  How ESP Applications, ESP Procedures, and Events relate to each other.

31

ESP Workload Manager

32

Getting Started with ESP

3.

Starting to Use ESP

Overview

In Chapter 2 How ESP Works, you learned that an ESP Procedure contains statements describing what you want ESP to do. However, ESP is so versatile that, for simple operations, you do not need to create an ESP Procedure. You can include the appropriate commands in an Event. For example, you can include commands in an Event to tell ESP to:  Send a message to you, another user, or a group of users  Issue an MVS operator command  Submit a Job or several unrelated Jobs. Using an ESP Event is an excellent way to submit a single Job or several independent Jobs. However, if you want to submit several Jobs that are dependent upon each other, you must use an ESP Procedure. See ESP Procedures in Chapter 2 for more information. This chapter describes how to create an Event to perform the simplest operation: sending a message to yourself. After creating the Event, you will trigger the Event so that you receive the message. Later in the chapter, other examples show you how to use an Event to issue an MVS operator command and to submit a Job.

In this chapter

This chapter contains the following topics: Topic Sending a Message Analyzing the Event Triggering the Event Issuing an MVS Operator Command Submitting a Job Summary See Page 34 42 43 46 49 52

33

ESP Workload Manager

Sending a Message

Overview

In the following exercise, you will use the ESP menus to create an Event that sends a message to your user ID. You will see a simple, stepbystep method that shows you the panels as you proceed. You can proceed at your own pace. If you want to proceed slowly and carefully, you can read the complete description. If you prefer to move more quickly, you can read the highlighted, numbered headings that summarize the steps.

Creating an Event

In this example, you will create an Event to send a HAPPY BIRTHDAY message to your user ID (USER01) at 8 am May 20th every year. As described earlier in this guide, the name of the Event (the Event identifier) consists of two parts: a prefix (USER01) and a descriptive name (BIRTHDAY). Step 1 Action Access ESP. In most cases, you can access ESP menus by typing esp on the ISPF command line (not the TSO command line) and pressing ENTER. If this does not work, ask your administrator or System Programmer how to access ESP. After accessing ESP, you see ESPs Main Menu.
Continued on next page

34

Getting Started with ESP

Sending a Message, Continued

Creating an Event (continued)

Step 2

Action Choose to work with Events. At the Main Menu, choose option E (Events).

Press ENTER. ESP displays the Event Management Menu:

Continued on next page

35

ESP Workload Manager

Sending a Message, Continued

Creating an Event (continued)

Step 3

Action Define a new ESP Event. At the Event Management Menu, select option 2 (Define a new ESP Event). Press ENTER. ESP displays the Start Event Definition panel:

Name the Event. On the Start Event Definition panel, type the name of the prefix if it is different from your user ID:
PREFIX ==> USER01

Type the descriptive name:


DESCRIPTIVE NAME ==> birthday

Press ENTER. ESP displays the Specify Event Processing Options panel.
Continued on next page

36

Getting Started with ESP

Sending a Message, Continued

Creating an Event (continued)

Step 5

Action Specify options for the event. At the Specify Event Processing Options panel, send a message:
SEND MESSAGE ==> y

Next, have ESP schedule the execution of the Event automatically:


SCHEDULED EXECUTION ==> y

Ensure all other entries are blank. The panel looks like this:

Press ENTER. ESP displays the Send a Message panel.


Continued on next page

37

ESP Workload Manager

Sending a Message, Continued

Creating an Event (continued)

Step 6

Action Identify the recipient and enter the message. On the Send a Message panel, type your user ID, or let it default:
USERS ==> user01

Next, type the message you want to send:


MESSAGE TEXT ==> happy birthday

The panel looks like this:

Press ENTER. ESP now takes you to the Event Schedule panel.
Continued on next page

38

Getting Started with ESP

Sending a Message, Continued

Creating an Event (continued)

Step 7

Action Define when the Event will occur. On the Event Schedule panel, type the criteria for scheduling the Event:
CRITERIA ==> 8am may 20th every year

Ensure that all other fields are blank. The panel looks like this:

Press ENTER. ESP displays the Process Event Definition panel.


Continued on next page

39

ESP Workload Manager

Sending a Message, Continued

Creating an Event (continued)

Step 8

Action Review the Event. To see the Event definition you just created, type the following on the Process Event Definition panel:
e

The panel looks like this:

Press ENTER. ESP displays an editing panel displaying the Event you have just created. The panel looks like this:

Continued on next page

40

Getting Started with ESP

Sending a Message, Continued

Creating an Event (continued)

Step 8

Action 1. Press END to return to the Event Management Menu. Notice that a message appears in the top right corner of the Event Management Menu. 2. Press HELP to see the message in full. It tells you when the Event will be scheduled next. 3. Press END to return to the Main Menu.

41

ESP Workload Manager

Analyzing the Event

Overview

As shown above in the editing panel, the Event consists of four commands:  EVENT  SCHEDULE  SEND  ENDDEF. These commands are described below. Above the Event command are three comment lines (lines 000001 through 000003), identified as comments by /* at the start of the comment and */ at the end. The comments identify the user ID of the person who created the Event (USER01) and the time and date when the user created it (represented by HH.MM and DAY DDMMYYYY). On your editing panel, you may see additional comments or messages.

EVENT command

The EVENT command starts the definition of the Event and provides the name of the Event ID=(USER01.BIRTHDAY).

SCHEDULE command

The SCHEDULE command describes when the Event first occurs and the frequency with which it will occur. In this case, the Event will first occur at 8 a.m. on May 20th 1998, and will occur yearly thereafter at 8 a.m. on May 20th.

SEND command

The SEND command sends the text within single quotation marks to the specified user ID. For example, the following SEND command sends the message HAPPY BIRTHDAY to user USER01:
SEND HAPPY BIRTHDAY USER(USER01)

ENDDEF command

The ENDDEF command identifies the end of the Event definition.

42

Getting Started with ESP

Triggering the Event

Overview

ESP will trigger Event USER01.BIRTHDAY automatically at 8 a.m. on May 20th and will automatically determine when to schedule the Event again.

Triggering the Event now

If you want to trigger the Event now, you can use the ESP menus to do so, as described below. Begin at the Main Menu, and follow the steps below: Step 1 Action Work with Events. At the Main Menu, select option E (Events). Press ENTER. This option takes you to the Event Management Menu. Control an Event. At the Event Management Menu, select option 3 (Control an existing Event). Press ENTER. This option takes you to the Event Control Menu:

Press ENTER. The List Events panel appears.


Continued on next page

43

ESP Workload Manager

Triggering the Event, Continued

Triggering the Event now (continued)

Step 3

Action Choose the Event from the list and trigger it. The List Events panel lists the Events belonging to your user id. It looks like this:

Type t next to the Event called USER01.BIRTHDAY, and press ENTER. ESP displays the Trigger An Event panel. Use the triggering defaults. Add the Event to the schedule. On the Trigger An Event panel, type ADD in the REPLACE/ADD field. ADD results in an additional execution of the Event. Leave all other fields blank:

Press ENTER. You return to the List Events Panel. Note the ESP message Event Triggered in the top right corner of the List Events Panel.
Continued on next page

44

Getting Started with ESP

Triggering the Event, Continued

Triggering the Event now (continued)

Step 5

Action Look at the message you sent. To look at the message you just sent to your user ID, press ENTER. ESP displays the message HAPPY BIRTHDAY ESP(user01).

Press ENTER to return to the Event Control Menu. Press END twice to go to the Main Menu.

45

ESP Workload Manager

Issuing an MVS Operator Command

Overview

Earlier in this chapter, you learned how to create an Event to send a message to yourself. In this section, you will learn how to create an Event to issue an MVS operator command.

Display titles of system dump data sets

This example creates an Event to issue the following MVS operator command which displays the titles of system dump data sets:
d d,t

This command is generally available on all MVS systems and is unlikely to cause problems when executed. Step 1 Action Begin at the Main Menu and use USER01.MVSCMD as the Event name (the Event identifier). Note that to issue an MVS operator command, you must have the authority to do so. See your system administrator for more information. Work with Events. At the Main Menu, select option E (Events). Press ENTER. ESP takes you to the Event Management Menu. Define a new ESP Event. At the Event Management Menu, select option 2 (Define a new ESP Event). Press ENTER. ESP takes you to the Start Event Definition panel. Name the Event. On the Start Event Definition panel, type the name of the prefix:
PREFIX ===> user01

2 3

Type the descriptive name:


DESCRIPTIVE NAME ==> mvscmd

Press ENTER. ESP displays the Specify Event Processing Options panel.
Continued on next page

46

Getting Started with ESP

Issuing an MVS Operator Command, Continued

Display titles of system dump data sets (continued)

Step 5

Action Choose processing options. At the Specify Event Processing Options panel, issue an operator command:
ISSUE OPERATOR COMMAND ==> y

Have ESP schedule the execution of the Event automatically:


SCHEDULED EXECUTION ==> y

Ensure all other entries are blank. Press ENTER. ESP displays the Issue Operator Command panel. Identify the console and enter the operator command. On the Issue Operator Command panel, type the ID of the system console (01) as the UCMID. The UCMID identifies the console that ESP will simulate when issuing the operator command:
UCMID ==> 01

Type the command:


COMMAND TEXT ==> d d,t

The panel looks like this:

Press ENTER. ESP takes you to the Event Schedule panel.


Continued on next page

47

ESP Workload Manager

Issuing an MVS Operator Command, Continued

Display titles of system dump data sets (continued)

Step 7

Action Define when the Event will occur. On the Event Schedule panel, type the criteria for starting the Event:
CRITERIA ==> 8am workdays

By default, workdays are Monday through Friday, excluding holidays. Ensure that all other entries are blank. Press ENTER. ESP displays the Process Event Definition panel. Review the Event. On the Process Event Definition panel, type the following to see the Event definition you have just created:
e

Press ENTER. ESP displays an editing panel showing the Event you have just created. The panel looks like this:

Press END to return to the Event Management Menu. Notice that a message appears in the top right corner of the Event Management Menu. Press HELP to see the message in full. It tells you when ESP will next perform the Event. Press END to return to the Main Menu.

48

Getting Started with ESP

Submitting a Job

Overview

This example submits a Job named A, the JCL for which is in data set USER01.JCL.CNTL.

Submit the Job

Follow the following steps to submit a Job from an Event: Step 1 2 Action Begin at the Main Menu and use USER01.submit_Job as the name of the Event. Choose to work with Events. At the Main Menu, choose option E (Events). Press ENTER. ESP takes you to the Event Management Menu. Define a new ESP Event. At the Event Management Menu, choose option 2 (Define a new ESP Event). Press ENTER. ESP takes you to the Start Event Definition panel. Name the Event. On the Start Event Definition panel, type the name of the prefix:
PREFIX ==> user01

Type the descriptive name:


DESCRIPTIVE NAME ==> submit_job

Press ENTER. ESP takes you to the Specify Event Processing Options panel. Choose processing options. At the Specify Event Processing Options panel, submit a job:
JOB SUBMISSION ==> y

Have ESP schedule the execution of the Event automatically:


SCHEDULED EXECUTION ==> y

Ensure all other entries are blank. Press ENTER. ESP displays the Submit panel.
Continued on next page

49

ESP Workload Manager

Submitting a Job, Continued

Submit the Job (continued)

Step 6

Action Name the member that contains the JCL for the job. On the Submit panel, type the name of the data set (dont forget the single quotation marks) and the member containing the JCL for the job.
DATASET NAME MEMBER NAMES ==> user01.jcl.cntl ==> a

The panel looks like this:

Press ENTER. ESP displays the Event Schedule panel. Define when the Event will occur. On the Event Schedule panel, type the criteria for starting the Event:
CRITERIA ==> 8am workdays

Ensure that all other entries are blank. Press ENTER. ESP takes you to the Process Event Definition panel.
Continued on next page

50

Getting Started with ESP

Submitting a Job, Continued

Submit the Job (continued)

Step 8

Action Review the Event. On the Process Event Definition panel, type the following to see the Event definition you have just created:
e

Press ENTER. ESP takes you to an editing panel displaying the Event you have just created. The panel looks like this:

Press END to return to the Event Management Menu. Press END again to return to the Main Menu.

51

ESP Workload Manager

Summary

In this chapter

This chapter demonstrated the versatility of ESP. It showed you how to use an Event to perform simple tasks. In this chapter, you should have:  Created an Event to send a message using ESP menus  Learned some basic commands  Used ESP menus to trigger an Event  Created an Event to issue an MVS operator command  Created an Event to submit a job.

52

Getting Started with ESP

4. Working with ESP Applications

Introduction

In this chapter, you will learn how to schedule a job stream by creating an ESP Application. To create an ESP Application for the first time, you will use the ESP menus and a simple stepbystep method. Later, in Learning More About ESP, you will learn an easier method for creating an ESP Application, but one that requires that you know about ESP statements. This chapter uses an example scenario, Case Study A, to show you how to create an ESP Application. Case Study A is deliberately simple and straightforward to allow you to concentrate on performing the actions.

In this chapter

This chapter contains the following topics: Topic Case Study A Creating an ESP Application Creating an Event to Invoke the Application Summary See Page 54 56 54 69

53

ESP Workload Manager

Case Study A

Overview

In this exercise, you will create an ESP Application. The first method uses ESP menus, the second uses data set editing.

Your assignment

As a scheduler, you must schedule six jobs: A, B, C, D, E, and F. Jobs A, B, C, and D must run daily after the end of the business day (6 pm). Job E must run Friday. Job F must run on the last workday of the month.

Flow chart

The following flow chart shows the relationships between the jobs:

Daily Job A

Job B

Daily

Job C

Daily

Job D

Daily

Job E

Weekly (every Friday)

Job F

Monthly (last workday" of month)

Job relationships

In the flowchart for Case Study A, job A must complete successfully before jobs B and C can be submitted. Jobs B and C therefore have a dependency upon job A. Similarly, job D has a dependency upon jobs B and C; it cannot be submitted until jobs B and C have completed successfully.
Continued on next page

54

Getting Started with ESP

Case Study A, Continued

Dependencies

The following list summarizes the job dependencies for Case Study A:  Job B depends on job A  Job C depends on job A  Job D depends on jobs B and C  Job E depends on job D  Job F depends on job E. Each job also has schedule criteria:  Jobs A, B, C, and D are to run every day  Job E is to run every Friday  Job F runs on the last workday of every month. If the last workday is not a Friday, for example if it is a Wednesday, ESP will automatically detect this situation and job D will release job F. Job E will not be scheduled. To have ESP build an Application and an Event for Case Study A, you must tell ESP about the job and schedule dependencies.

Schedule Criteria

Data sets

For Case Study A, you will create and store the ESP Application in member PAYROLL of data set USER01.SAMP.ESPPROCS, a data set used for storing your ESP Procedures. Ensure this data set has been allocated. You will give the ESP Application the name PAYROLL. The JCL for the six jobs is in a data set named USER01.JCL.CNTL.

55

ESP Workload Manager

Creating an ESP Application

Overview

In this section, you will use the ESP menus to create an ESP Application. This Application contains statements that, among other things, describe the dependencies between jobs. This method allows you to create an ESP Application without having to know about statements and their syntax.

Using the menus

Use the following steps to create an Application from the ESP menus, beginning at the Main Menu: Step 1 Action Choose to work with ESP Applications. At the Main Menu, select option A (Applications). Press ENTER. Selecting this option takes you to the Application Management Menu. Use the ESP Application Definition Facility. At the Application Management Menu, shown below, select option 4 (ESP Application Definition Facility).

Press ENTER. ESP takes you to the Application Definition panel.


Continued on next page

56

Getting Started with ESP

Creating an ESP Application, Continued

Using the menus (continued)

Step 3

Action Create a new Application. On the Application Definition panel, select option 2 (Create a New Application):

The Create New Application panel appears.


Continued on next page

57

ESP Workload Manager

Creating an ESP Application, Continued

Using the menus (continued)

Step 4

Action Define the ESP Application. On the Application Definition panel, type the name of the Application :
Application Name ===> payroll

Type the name of the Event prefix:


Event Prefix: ===> USER01

Type the name of the ESP Procedure data set:


ESP Procedure Dataset ===> USER01.SAMP.ESPPROCS

Type the name of the default JCL library. Do not forget to enclose the library name in single quotation marks:
JCL Dataset ===> user01.jcl.cntl

There may be a name in this field already. If it is not correct, just type over it. The Application Definition panel now looks like this:

Press ENTER. ESP displays the Job Definition panel.


Continued on next page

58

Getting Started with ESP

Creating an ESP Application, Continued

Using the menus (continued)

Step 5

Action Define the first job, its run criteria, and any job dependencies. On the Job Definition panel, name the job:
Jobname A

Type the run criteria for this job:


Run DAILY

Type the name of any successors to this job:


Successors 01 B 02 C

Press ENTER. The job definition is saved.


Continued on next page

59

ESP Workload Manager

Creating an ESP Application, Continued

Using the menus (continued)

Step 6

Action Define the next job, Job B. Press F10 to place the cursor at the File menu in the top left corner of the panel. Press ENTER to see the list of file options:

Choose 2 - Next Job - Fresh, and press ENTER. The Job Definition panel for Job B appears. Type the run criteria for this job:
Run DAILY

Type the name of any successors to this job:


Successors 01 D

Press ENTER. The job definition is saved. Define the next job, Job C. Press F10 to go to the File menu, and press ENTER to list the file options. Choose 3 - Next Job - Clone, and press ENTER. The Job Definition panel for Job C appears. It is exactly the same as Job B. Press ENTER to save the job definition. Define the next job, Job D. Choose option 2 from the File menu to create a fresh job definition, and press ENTER. The Job Definition panel for Job D appears. Type the run criteria for this job:
Run DAILY

Type the name of any successors to this job:


Successors 01 E

Press ENTER. The job definition is saved.


Continued on next page

60

Getting Started with ESP

Creating an ESP Application, Continued

Using the menus (continued)

Step 9

Action Define the next job, Job E. Choose option 2 from the File menu to create a fresh job definition, and press ENTER. The Job Definition panel for Job E appears. Type the run criteria for this job:
Run FRIDAY

Type the name of any successors to this job:


Successors 01 F

10

Press ENTER. The job definition is saved. Define the next job, Job F. Choose option 2 from the File menu to create a fresh job definition, and press ENTER. The Job Definition panel for Job F appears. Type the run criteria for this job:
Run LAST WORKDAY OF MONTH

There are no successors to this job. Press ENTER. The job definition is saved. Now that you have finished defining the jobs in the Application, lets look at what youve created.
Continued on next page

61

ESP Workload Manager

Creating an ESP Application, Continued

Using the menus (continued)

Step 11

Action Look at Job A. Press END. The Update Application panel appears:

You can use this panel to look at or change the jobs in the Application. Beside A, type P to preview the job. The contents of Job A are displayed:

Press END to return to the Update Application panel.


Continued on next page

62

Getting Started with ESP

Creating an ESP Application, Continued

Using the menus (continued)

Step 12

Action Look at the PAYROLL Application. Press END. The Update Application panel appears. On the View menu at the top left of the panel, choose option 1, Preview Appl:

Press ENTER. The entire Application is displayed. You can use the Function keys to scroll forward and backward within the Application. For a listing of the Application, refer to Payroll: a sample Application on page 64.

Summary

In completing these steps, you have just now successfully created an ESP Application. Press END to return to the Application Management Menu. Press END to return to the Main Menu. To see the ESP Application, return to ISPF and browse or edit member PAYROLL of data set USER01.SAMP.ESPPROCS.

63

ESP Workload Manager

Analyzing the Application

Overview

The ESP Application you created consists of a series of statements that define the Application, the JCL libraries, and several job definitions.

Payroll: a sample Application

The following is a listing of the Application you created in the previous exercise:
Appl PAYROLL Jcllib 'USER01.JCL.CNTL' Job A Noconditional Run DAILY Release (B C ) Endjob Job B Noconditional Run DAILY Release (D ) Endjob Job C Noconditional Run DAILY Release (D ) Endjob Job D Noconditional Run DAILY Release (E ) Endjob Job E Noconditional Run FRIDAY Release (F ) Endjob Job F Noconditional Run LAST WORKDAY OF MONTH Endjob

Continued on next page

64

Getting Started with ESP

Analyzing the Application, Continued

Job statements and their meanings

The following table describes the statements generated within this Application, and what they do: Part APPL JCLLIB Function The APPL statement identifies the name of the ESP Application. The JCLLIB statement tells ESP the name of the JCL library that contains the JCL for the jobs. The name must be within single quotation marks. Each JOB statement identifies the name of a job in the Application. The JOB statement defines the beginning of the job definition. Noconditional (the default) indicates the job must complete in order for the Application to be considered complete. The ENDJOB statement or another JOB statement signifies the end of a job definition. The RUN statement indicates the frequency (schedule dependencies) with which the job will run. A RUN (or equivalent) statement is required in a job definition. The RELEASE statement names the job or jobs that will execute after the job containing the statement is complete.

JOB

ENDJOB RUN

RELEASE

Editing a member of a data set

Once you know what an ESP Application is and what it contains, you can use an alternative method to create one. You can create an ESP Application by using the following: 1. Create a member of a data set to contain your ESP Application. 2. Use an editor such as the ISPF editor to enter statements. Use the format of the ESP Application created above (in member PAYROLL of data set USER01.SAMP.ESPPROC) as a guideline.

65

ESP Workload Manager

Creating an Event to Invoke an ESP Application

Overview

Now that you have created an Application, you must tell ESP:  When to perform the work  Where the instructions it needs to perform the work are stored. You do this with an Event.

Creating the Event

This section describes how to create an Event that you can use to invoke an ESP Application. Begin at the Main Menu. Step 1 Action Choose to work with Events. At the Main Menu, select option E (Events). Press ENTER. Selecting this option takes you to the Event Management Menu. Define a new ESP Event. At the Event Management Menu, select option 2 (Define a new ESP Event). Press ENTER. Selecting this option takes you to the Start Event Definition panel. Name the Event. On the Start Event Definition panel, type the prefix and the descriptive name. It is recommended you use the same name as the Application it runs:
PREFIX DESCRIPTIVE NAME ==> user01 ==> payroll

Press ENTER. ESP takes you to the Specify Event Processing Options panel. Choose to invoke an ESP Procedure and Scheduled Execution. At the Specify Event Processing Options panel, to invoke an ESP Application, type Y in the following fields:
INVOKE ESP PROCEDURE ==> y SCHEDULED EXECUTION ==> y

Ensure all other entries are blank. Press ENTER. ESP takes you to the Invoke panel.
Continued on next page

66

Getting Started with ESP

Creating an Event to Invoke an ESP Application,

Continued

Creating the Event (continued)

Step 5

Action Name the member that contains the ESP Application. On the Invoke panel, type the name of the data set and the member of the data set that contains the ESP Application. ESP may have made an assumption about the name of the data set; type over any data set name that is not correct.
DATASET NAME ==> user01.samp.espprocs MEMBER NAMES ==> payroll

The panel looks like this:

Press ENTER. ESP takes you to the Event Schedule panel. Define when the Event will occur. On the Event Schedule panel, type in the criteria for triggering the Event:
CRITERIA ==> 6pm daily

Ensure that all other entries on the screen are blank. Press ENTER. ESP takes you to the Process Event Definition panel.
Continued on next page

67

ESP Workload Manager

Creating an Event to Invoke an ESP Application,

Continued

Creating the Event (continued)

Step 7

Action Review the Event. On the Process Event Definition panel, type the following to see the Event definition you have just created: e Press ENTER. ESP takes you to an editing panel displaying the Event you have just created:

Press END to return to the Event Management Menu. Notice that a message appears in the top right corner of the Event Management Menu. Press HELP to see the full message. It tells you when the Event will be scheduled next. Press END to return to the Main Menu.

68

Getting Started with ESP

Summary

In this chapter

In this chapter, you should have:  Created an ESP Application using ESP menus  Browsed or edited a member of a data set and examined the ESP Application you created  Learned some basic statements  Learned that you can create an ESP Application by editing a member of a data set  Created an Event using ESP menus.

69

ESP Workload Manager

70

Getting Started with ESP

5. Testing the Event and the Application

Overview

This chapter describes how you can test the Event and ESP Application you created in the previous chapter. ESP has a feature that allows you to simulate various conditions. You will use this feature to simulate the next occurrence of the Event, the next occurrence on a Friday and the next occurrence on the last workday of the month.

In this chapter

This chapter contains the following topics: Topic Simulation Simulating the Next Occurrence Simulating a Specific Day Simulating the End of the Month Summary See Page 72 73 75 77 79

71

ESP Workload Manager

Simulation

Overview

ESPs simulation function allows you to simulate the actions of an event to see:  What would happen if an Event was triggered on a certain day  If any syntax errors or successor loops occur  Which jobs ESP submits. Using simulation, you will test the ESP Application you created to see if:  The correct jobs are selected for all simulations  The JCL for the jobs is in the named library  The ESP Application is error free.

What you will simulate

72

Getting Started with ESP

Simulating the Next Occurrence

Overview

This description assumes that the next occurrence is not on a Friday. Begin at the Main Menu, and follow these steps: Step 1 Action Choose to work with Events. At the Main Menu, select option E (Events). Press ENTER. Selecting this option takes you to the Event Management Menu. Control an existing Event. At the Event Management Menu, select option 3 (Control an existing Event). Press ENTER. ESP takes you to the Event Control Menu. Leave the option blank and press ENTER. At the Event Control Menu, leave the option blank and press ENTER to see a list of Events. Simulate the Event. Type M next to payroll:

Press ENTER. The Simulate Event Execution panel appears:

Ensure that all fields are blank. Press ENTER. ESP starts the Event simulation and presents the results.
Continued on next page

73

ESP Workload Manager

Simulating the Next Occurrence, Continued

The simulation results

The following panel shows the results of the simulation:

The following line indicates the name of the simulated Event (USER01.PAYROLL) and the time and date:
SIMULATION OF Event USER01.PAYROLL AT hh.mm.ss ON dddddd...

The next two lines name the jobs and give the total number of jobs simulated to run. The remaining lines list each simulated job, its hold count, and the job it was simulated to release. The hold count associated with a job indicates the number of immediate predecessors. For details on hold count refer to the ESP Users Guide. Scroll through the results and check for any errors. Press END twice to return to the Event Control Menu and continue to the next simulation. (If you want to return to the Main Menu, press END twice more.)

74

Getting Started with ESP

Simulating a Specific Day

Overview

In this exercise, you will simulate triggering the Event on the next Friday. You can assume both of the following:  The next Friday is not the last workday of the month  You are at the Event Control Menu. Refer to steps 1 and 2 of the previous section if you are at the Main Menu.

The simulation

Follow these steps: 1 Leave the option blank and press ENTER. At the Event Control Menu, leave the option blank and press ENTER to see a list of Events. Simulate the Event Type M next to payroll, and press ENTER. The Simulate Event Execution panel appears.
Continued on next page

75

ESP Workload Manager

Simulating a Specific Day, Continued

The simulation (continued)

Step 3

Action Enter the day to be simulated. Type the schedule criteria:


SCHEDULE TIME ==> friday

The panel looks like this:

Press ENTER. ESP starts the Event simulation and presents the results in a panel like this:

Note that job E now appears in the list of jobs to be run. Press END twice to return to the Event Control Menu and to continue to the next simulation. (If you want to return to the Main Menu, press END twice more.)

76

Getting Started with ESP

Simulating the End of the Month

Overview

This section describes how to simulate the Event on the last workday of the month. Begin at the Event Control Menu.

The simulation

Follow these steps: Step 1 Action Leave the option blank and press ENTER. At the Event Control Menu, leave the option blank and press ENTER to see a list of Events. Simulate the Event Type M next to payroll, and press ENTER. The Simulate Event Execution panel appears. Enter the schedule criteria you want to simulate. Type the schedule criteria:
SCHEDULE TIME ==> last workday of month

Press ENTER. ESP starts the Event simulation and presents the results on a panel like this:

Note that job F now appears in the list of jobs to run. Job E does not appear because the simulated day is not Friday. Press END twice to return to the Event Control Menu. Press END twice more to return to the Main Menu.

77

ESP Workload Manager

Simulating the Last Day of the Month on a Friday

Overview

This section describes how to simulate the Event on the last workday of the month, which is also a Friday. Begin at the Event Control Menu.

The simulation

Follow these steps: Step 1 Action Leave the option blank and press ENTER. At the Event Control Menu, leave the option blank and press ENTER to see a list of Events. Simulate the Event Type M next to payroll, and press ENTER. The Simulate Event Execution panel appears. Enter the schedule criteria you want to simulate. Type the schedule criteria:
SCHEDULE TIME ==> jan 30 1998

Press ENTER. ESP starts the Event simulation and presents the results on a panel like this:

Note that all jobs now appear in the list of jobs to run. Press END twice to return to the Event Control Menu. Press END twice more to return to the Main Menu.

78

Getting Started with ESP

Summary

In this chapter

In this chapter, you should have learned to test an ESP Application and Event by:  Simulating the next occurrence of the Event  Simulating the occurrence of the Event on a specific day during the month  Simulating the occurrence of the Event on the last workday of the month  Simulating the occurrence of the Event when Friday is the last workday of the month.

79

ESP Workload Manager

80

Getting Started with ESP

6. Monitoring an Application

Overview
Introduction

Having defined and simulated an ESP Application, you will want to run and monitor that Application.

In this chapter

This chapter contains the following topics: Topic Triggering the Event to Invoke the Application Using CSF to View Job Information Summary See Page 82 84 91

81

ESP Workload Manager

Triggering the Event to Invoke the Application

Overview

ESP automatically triggers Events that contain a scheduled run time. At 6 pm daily, ESP automatically triggers the Event you created in Chapter 4 and that Event invokes the Application. The following method describes how you can trigger the Event now (and so invoke the Application now).

Triggering the Event

Begin at the Main Menu, and follow these steps to trigger the Event:

Step 1

Action Choose to work with Events. At the Main Menu, select option E (Events). Press ENTER. Selecting this option takes you to the Event Management Menu. Choose to control an Event. At the Event Management Menu, select option 3 (Control an existing Event). Press ENTER. Selecting this option takes you to the Event Control Menu. Leave the option blank and press ENTER. At the Event Control Menu, leave the option blank and press ENTER to see a list of Events. Trigger the Event. Type t next to USER01.PAYROLL, and press ENTER. The Trigger an Event panel appears.
Continued on next page

82

Getting Started with ESP

Triggering the Event to Invoke the Application, Continued

Triggering the Event (continued)

Step 5

Action Add an additional execution of the Event. Type the following: REPLACE/ADD ==> add When you do this, it results in an additional execution of the Event. Leave all other fields blank. The panel looks like this:

Press ENTER. ESP returns you to the Event Control Menu. Note the message EVENT TRIGGERED in the top right corner of the Event Control Menu. This message indicates that ESP has triggered the Event and in turn invoked the Application. Press END twice to go to the Main Menu.

83

ESP Workload Manager

Using CSF to View Job Information

Consolidated Status Facility (CSF)

CSF is a menudriven feature of ESP that provides a realtime view of the systems current workload. Using CSF you can:       See which jobs have recently executed See which jobs are in the system See the status of the jobs in any ESP Application Zoom in on any job to get greater detail Manipulate jobs, edit JCL, and restart jobs Browse or edit ESP Procedures and Events.

For a full description of CSF, refer to the ESP Users Guide.

This section

This section describes how you can use CSF to see the status of the jobs in ESP Application PAYROLL once you have triggered the Event USER01.PAYROLL. It also describes how you can create your own view of the activity on the system. You can tailor this view to your own needs so that you can see the status of the jobs you are interested in without having to look at irrelevant information. You can also tailor the status information so that you can look at some information and ignore other information.

Assumptions

The following exercise assumes that:  You created an ESP Application and an Event as described in Working with ESP Applications.  You triggered the Event as described in Working with ESP Applications.  Rather than step your way through the displayed jobs, you will tailor the CSF panels to show the status of only the jobs in your Application (PAYROLL). You will create your own view of the system activity by replicating an existing view. Then you will tailor the view. Finally, you will use the view to look at the job stream.
Continued on next page

84

Getting Started with ESP

Using CSF to View Job Information, Continued

Using CSF

Begin at the Main Menu, and follow these steps: Step 1 Action Choose CSF. At the ESP Main Menu, select option C (Consolidated Status Facility). This option takes you to the Consolidated Status panel. The resulting panel depends on how CSF was set up, the ESP Applications and jobs in the system. A typical display looks like this:

As you can see in this example, jobs A, B, C, and D for ESP Application PAYROLL are difficult to find among the other jobs.
Continued on next page

85

ESP Workload Manager

Using CSF to View Job Information, Continued

Using CSF (continued)

Step 2

Action Create a new view. Still at the Consolidated Status panel, type the CSF command V (view):
COMMAND ===> v

Selecting this command takes you to the View Definitions panel, which may contain a list of views and their corresponding descriptions. The different views may show different information in various sequences. The View Definitions panel that you see may look like the following screen which shows only one view:

Look for the list entry with the description GENERAL VIEW. Type the CSF command R (Replicate) next to the view name of the general view:
r 1 General View

Press ENTER. ESP takes you to the Replicate a View panel. Type the name of the new view, a description, and the contents of a message that CSF will use if there are no items to display that meet the views criteria:

Press ENTER. ESP returns you to the View Definitions panel, to which the new view, named payroll, has been added.
Continued on next page

86

Getting Started with ESP

Using CSF to View Job Information, Continued

Using CSF (continued)

Step 3

Action Select the new view. On the View Definitions panel, select the new view by typing S (select) next to the view name. The panel looks like this:

Press ENTER. ESP returns you to the Consolidated Status panel you saw earlier.
Continued on next page

87

ESP Workload Manager

Using CSF to View Job Information, Continued

Using CSF (continued)

Enter payroll as filter criteria. On the command line, type the FI (filter) command:
COMMAND ===> fi

Press ENTER. The Filter Specification panel appears. Type the name of the Application to have CSF select all jobs for the ESP Application PAYROLL:

Press ENTER. ESP returns you to the Consolidated Status panel, which now contains only the jobs for the PAYROLL Application:

Continued on next page

88

Getting Started with ESP

Using CSF to View Job Information, Continued

Using CSF (continued)

Step 5

Action Select the fields you want to see. In this step, you will tailor the layout of the fields of the Consolidated Status View panel so that you see only the information you want to see. Assume that you want to see only the following:  The name of the job  The name of the Application  The status of the job  The completion code of the job. Type the PR (presentation) command on the command line:
COMMAND ===> pr

Press ENTER. Entering this command takes you to the Presentation Fields panel, which lists all possible fields that you can display. Delete existing numbers and add new numbers until the panel looks like the following panels:

Continued on next page

89

ESP Workload Manager

Using CSF to View Job Information, Continued

Using CSF (continued)

Step 5 contd

Action Scroll down to see the remainder of the list:

You have just chosen to display the Application name in the second column, the job status in the third column, and completion code in the fourth. ESP always lists the job name in the first column; you cannot change this. Press ENTER. ESP returns you to the Consolidated Status View panel, which now contains only the information you wanted. The panel looks like this:

Press END to return to the Main Menu.

90

Getting Started with ESP

Summary

In this chapter

In this chapter, you should have learned how to:  Invoke an Application by triggering an Event  Use CSF to see the status of a job  Tailor the CSF views of the job stream so that you can filter out unwanted information.

91

ESP Workload Manager

92

Getting Started with ESP

7. Learning More about ESP

Overview
Introduction

This chapter uses Case Study B to describe how to create a more complex ESP Application than the one you created in Case Study A. After creating the Application, you can use the simulation you learned in Testing the Event and the ESP Application to test it. You can then use the method you learned in Working with ESP Applications to manually trigger the Event USER01.PAYROLL (created in Working with ESP Application) and to invoke the Application.

In this chapter

This chapter contains the following topics: Topic Case Study B Analyzing the Application Summary See Page 94 97 99

93

ESP Workload Manager

Case Study B

The assignment

As a scheduler, you must schedule six jobs. The following flow diagram shows the relationships between the jobs:
Job A
Daily (not before 6 pm Fridays, 8 pm other days)

Job B

Daily

Daily

Job C

Job D
Daily Daily except Monday fails if STEP01 CC>7

Job E

Fridays JCL in member MGMTRPT

Job F

Monthly (last workday of month)

Editing versus creating

Case Study B is just a more complex version of Case Study A. Rather than creating a new Application from the beginning, it makes more sense to modify the Application created for Case Study A. That Application is in a member PAYROLL of data set USER01.SAMP.ESPPROCS. The JCL for the six jobs is in a JCL library named USER01.JCL.CNTL.
Continued on next page

94

Getting Started with ESP

Case Study B, Continued

Member PAYROLL

When you completed Case Study A, member PAYROLL of data set USER01.SAMP.ESPPROC contained the Application shown on the left below. Copy the information from member PAYROLL to a new member as backup in case of error. Use the ISPF editor to change member PAYROLL so that it looks like the Application on the right below: Case Study A
Appl PAYROLL Jcllib 'USER01.JCL.CNTL' Job A Noconditional Run DAILY Release (B C) Endjob

Case Study B
Appl PAYROLL Jcllib 'USER01.JCL.CNTL' Job A Noconditional Run DAILY If today(Friday) then delaysub 6 pm Else delaysub 8 pm Release (B C) Endjob Job B Noconditional Run DAILY Release (D ) Endjob Job C Noconditional Run DAILY Release (D ) Endjob Job D Noconditional Run DAILY Norun Monday CCCHK STEP(STEP01) RC(8:4095) FAIL Notify failure users(user02) Release (E ) Endjob Job E Noconditional Run FRIDAY Release (F ) Member MGMTRPT Delaysub 10 pm Endjob Job F Noconditional Run LAST WORKDAY OF MONTH Endjob

Job B Noconditional Run DAILY Release (D ) Endjob Job C Noconditional Run DAILY Release (D ) Endjob Job D Noconditional Run DAILY Release (E ) Endjob

Job E Noconditional Run FRIDAY Release (F ) Endjob

Job F Noconditional Run LAST WORKDAY OF MONTH Endjob

95

ESP Workload Manager

Case Study B, Continued

Invoking the Application

You can use the Event you created in Chapter 4, Working with ESP Application (USER01.PAYROLL) to invoke the modified Application. You can use the method described in Chapter 5, Testing the Event and the Application to simulate triggering the Event so you can test the Application. Then you can use the method described in Working with ESP Applications to trigger the Event and invoke the Application. Finally, you can use CSF to see the status of the jobs, using the method described in Keeping Track of Jobs earlier in this manual.

96

Getting Started with ESP

Analyzing the Application

Overview

In Chapter 4, Working with ESP Applications, you saw the ESP statements for the original Application, shown on the left above. The new ESP statements in the Application shown on the right are:  CCCHK  DELAYSUB  IF/THEN/ELSE  MEMBER  NORUN  NOTIFY. The following table shows the new statements and their meanings:

The new statements

Statement CCCHK

Description Tells ESP which condition codes classify a job as failed. The syntax is as follows:
CCCHK STEP(stepname) RC(value1:value2)FAIL

In the syntax above:  Stepname is the name of a step  Value1 and value 2 indicate a range of codes  FAIL indicates that a return code in this range is to be considered a failure. In the Application above, ESP considers the job to have failed if STEP01 has a condition code greater than 7. Tells ESP to delay the submission of a job. In the following example, the statement tells ESP to delay the submission of the job until 10 p.m.:
DELAYSUB 10PM

DELAYSUB

Continued on next page

97

ESP Workload Manager

Analyzing the Application, Continued

The new statements (continued)

Statement IF, THEN, and ELSE

Description Tell ESP to perform a test on a condition and, depending on the result, to perform one action or another. In the following example, the statements tell ESP that:  If today is Friday, the earliest time for job submission is 6 p.m.  If today is not Friday, the earliest time for job submission is 8 p.m.
IF TODAY(FRIDAY) THEN DELAYSUB 6PM ELSE DELAYSUB 8PM

MEMBER

NORUN NOTIFY

Tells ESP the name of the member that contains the JCL for the job. Normally, ESP assumes that the JCL is in a member that has the same name as the job. If that is the case, you do not need a MEMBER statement. Tells ESP when a job must not be run. Tells ESP to inform a user or system console when a specific incident occurs. In the following example the statement tells ESP to notify user USER02 when a failure occurs:
NOTIFY FAILURE USERS(USER02)

98

Getting Started with ESP

Summary

In this chapter

In this chapter, you should have:  Created a more complex ESP Application by editing an existing ESP Application  Learned more ESP statements.

99

ESP Workload Manager

100

Getting Started with ESP

8. Using CSF to Control Applications Overview

Introduction

This chapter uses the Application you created in Case Study A to demonstrate how you monitor and control your jobs and Applications.

In this chapter

This chapter contains the following topics: Topic Listing an Application Holding and Releasing an Application Listing a Job Holding and Releasing a Job Listing Job Inserting a Job Summary See Page 102 103 105 106 108 109 111

101

ESP Workload Manager

Listing an Application

Overview

When you are looking at the jobs in an Application on CSF, you can display many details about all jobs within the Application with a single CSF command. You see information such as predecessors, successors, submission times, and so on.

LA command to list an Application

Type LA next to a job, and press ENTER. Type LA next to a job in the Application you want to display:

Press ENTER. The details of the Application and the jobs within the Application are displayed:

Press END to return to CSF.

102

Getting Started with ESP

Holding and Releasing an Application

Overview

You can place an Application on hold, until you are ready for it to run. Hold stops any further submission of jobs within the Application. Then you can release the Application from its wait state. You can perform each of these actions from CSF with a single command.

HA command to place an Application on hold

Type HA next to a job in the Application, and press ENTER. Type HA next to a job in the Application you want to place on hold:

Press ENTER. APPLHOLD:

The status of each job in the Application is changed to

Continued on next page

103

ESP Workload Manager

Holding and Releasing an Application, Continued

AA command to release an Application from hold

Type AA next to a job in the Application, and press ENTER. Type AA next to any job in the Application press ENTER.

The status of each job in the Application is reset from APPLHOLD:

104

Getting Started with ESP

Listing a Job

Overview

You can list the predecessors and successors of a job from CSF with a single command.

L command to list a job

Type L next to the job, and press ENTER. Type L next to the job you want to display and press ENTER.

The details for that job are displayed:

Press END to return to CSF.

105

ESP Workload Manager

Holding and Releasing a Job

Overview

You can place a job on hold, until you are ready for it to run. Then you can release the job from its held state. You can perform each of these actions from CSF with a single command.

H command to hold a job

Type H next to the job, and press ENTER. Type H next to the job you want to place on hold:

Press ENTER. The status of the job changes to MANHOLD:

Continued on next page

106

Getting Started with ESP

Holding and Releasing a Job, Continued

A command to release a job

Type A next to job, and press ENTER. Type A next to the job you want to release and press ENTER.

The status is reset from MANHOLD:

107

ESP Workload Manager

Listing Job Statistics

Overview

You can list the statistics of a job that is displayed on CSF, using a single CSF command.

LJ command

Type LJ next to the job, and press ENTER. Type LJ next to the job whose statistics you want to see and press ENTER:

Detailed step-level statistics for the job are displayed:

Press END to return to CSF.

108

Getting Started with ESP

Inserting a Job

Overview

You can dynamically insert a job into an Application from CSF with a single command.

IJ command to insert a job

Type IJ next to the job you want to insert after, and press ENTER. Type IJ next to the job prior to where you want to insert the job:

Press ENTER. The Insert an Object panel appears:

Continued on next page

109

ESP Workload Manager

Inserting a Job, Continued

IJ command to insert a job continued

Type Y to specify a predecessor. Press ENTER. The Define Predecessors panel appears:

IJ command to insert a job, continued

Press ENTER again to update the CSF display. The inserted job appears in the list:

110

Getting Started with ESP

Summary

In this chapter

In this chapter, you should have learned how to:  List an Application  Hold and release an Application  List a job  Hold and release a job  List job statistics  Insert a job.

111

ESP Workload Manager

Glossary

Terms

The following table shows some ESP terms, and their definitions: Term Application Calendar CLANG ESP Procedure Definition A group of related jobs defined to ESP, telling ESP what work to run, and how. A collection of definitions of holidays, special days, and special periods. A highlevel language for controlling logic flow in an ESP Procedure. A collection of stored instructions that tells ESP to perform an action. One of these actions may be to create an Application. The Procedure is executed by ESP when invoked by an Event. An Event is a set of instructions that tells ESP what action to perform, when and where to look for its instructions (e.g. a member in a Procedure library). A VSAM data set used to store Event definitions. A named set of records stored or processed as a unit An ESP facility for monitoring a jobs progress at any stage of processing and for taking action at significant points. An ESP facility to track job data in real time as jobs are processed. A method to communicate with ESP using TSO or ISPF. Individual commands are entered and ESP responds to the commands. Some ESP commands are valid only in line mode. A method to communicate with ESP using TSO or ISPF, producing scrollable output from ESP. A list of Events to execute, sorted in time sequence. An MVS facility that ESP uses to manage and control requests amongst its components. An integer or character string whose value is substituted at processing time. To cause execution (for example, to trigger an Event). Normally Monday through Friday excluding holidays.

Event

EVENTSET File Job monitor

Job tracking Line mode

Page mode Schedule Subsystem Symbolic variable Trigger Workdays

112

Getting Started with ESP

Index

A A command ........................................................... 107 AA command ........................................................ 104 accessing ESP ......................................................... 34 analyzing the Event case study A ....................................................... 42 APPL....................................................................... 65 Applications ............................................................ 26 analying .............................................................. 64 creating......................................................... 54, 65 definition .......................................................... 112 editing................................................................. 94 invoking........................................................ 66, 96 simulating ........................................................... 72 B Batch processing........................................................... 22 C calendars ................................................................. 19 definition .......................................................... 112 system................................................................. 19 Case study A dependencies ...................................................... 55 Case study B............................................................ 94 CCCHK................................................................... 97 characteristics ESP procedure.................................................... 29 CLANG (Control Language)................................... 19 definition .......................................................... 112 command line ISPF.................................................................... 34 commands ENDDEF ............................................................ 42 EVENT............................................................... 42 in an Event.......................................................... 27 INVOKE ............................................................ 28 issuing ................................................................ 46 SCHEDULE ................................................. 28, 42 SEND ................................................................. 42 communicating with ESP ........................................ 20 concepts .................................................................. 30 55 Consolidated Status Facility.................................... 84 creating an Application ..................................... 54, 65 creating new CSF view............................................ 86 criteria

Event .................................................................. 39 CSF ......................................................................... 84 filtering............................................................... 89 views .................................................................. 86 CSF commands ..................................................... 106 A ..................................................................... 107 AA.................................................................... 104 HA.................................................................... 103 IJ ..................................................................... 109 L ..................................................................... 105 LA .................................................................... 102 LJ ..................................................................... 108 D data set .................................................................... 55 data set triggering.................................................... 15 delaying submission of a job ................................... 97 DELAYSUB ........................................................... 97 dependencies case study A ....................................................... 55 ensuring .............................................................. 14 descriptive name Event name (Eventid) ......................................... 28 E Edit Event panel issuing an MVS operator command ................... 48 submitting a job .................................................. 51 editing an Application ............................................. 94 Editor ISPF.................................................................... 21 ELSE....................................................................... 98 ENDDEF................................................................. 42 ENDJOB ................................................................. 65 ensuring dependencies ............................................ 14 ESP accessing ............................................................ 34 introducing ......................................................... 13 ESP procedure characteristics ..................................................... 29 EVENT ................................................................... 42 Event Schedule panel sending a message .............................................. 39 Eventid .................................................................... 28 Events...................................................................... 27 analyzing, case study A ...................................... 42 criteria ................................................................ 39 definition .......................................................... 112 name ................................................................... 28 naming................................................................ 36

113

ESP Workload Manager


stored in an EVENTSET .................................... 28 triggering ............................................................ 43 EVENTSET definition .......................................................... 112 Events stored in .................................................. 28 example DELAYSUB statement ...................................... 97 IF, THEN, ELSE statements .............................. 98 NOTIFY statement ............................................. 98 F features of ESP.................................................. 14, 18 file definition .......................................................... 112 filtering CSF display ............................................... 89 H H command ........................................................... 106 HA command ........................................................ 103 Help menu................................................................... 22 History reporting ..................................................... 16 holding a job ......................................................... 106 holding an Application.......................................... 103 I IF 98 IJ command ........................................................... 109 InfoServ................................................................... 19 inserting a job........................................................ 109 INVOKE ................................................................. 28 invoking an Application .................................... 66, 96 ISPF command line ................................................. 34 ISPF editor .............................................................. 21 issuing MVS command ........................................... 46 J 55 JCLLIB ................................................................... 65 job output ............................................................... 108 status................................................................... 84 submitting........................................................... 49 JOB ......................................................................... 65 job monitor definition .......................................................... 112 job tracking ............................................................. 16 definition .......................................................... 112 L L command ........................................................... 105 LA command......................................................... 102 line mode definition .......................................................... 112 listing a job............................................................ 105 listing an Application ............................................ 102 listing job output ................................................... 108 LJ command .......................................................... 108 M MEMBER ............................................................... 98 member name .......................................................... 95 Menu help using ................................................................... 22 modeling feature...................................................... 17 MVS commands issuing ................................................................ 46 N naming an Event...................................................... 36 naming JCL member ............................................... 98 NORUN .................................................................. 98 NOTIFY.................................................................. 98 notifying a user........................................................ 98 P page mode definition .......................................................... 112 Page mode panel ................................................................... 21 Page Mode .............................................................. 21 Panel Edit Event..................................................... 48, 51 Event Schedule................................................... 39 Page Mode.......................................................... 21 prefix Event name (Eventid) ......................................... 28 procedure ................................................................ 29 Procedure definition .......................................................... 112 R RELEASE ............................................................... 65 releasing a job ....................................................... 107 releasing an Application........................................ 104 Reporting history................................................................. 16 scheduled-activity............................................... 16 REXX...................................................................... 19 RUN ........................................................................ 65 run criteria, specifying............................................. 60 S sample Applications .......................................... 26, 95 schedule definition .......................................................... 112 SCHEDULE...................................................... 28, 42 schedule criteria ...................................................... 18 55

114

Getting Started with ESP


scheduled execution description .......................................................... 37 Scheduled-activity reporting ................................... 16 scheduling jobs........................................................ 54 seeing job status ...................................................... 84 SEND ...................................................................... 42 sending a message ................................................... 34 simluating next occurrence .................................................. 73 simulating an Application .................................................... 72 end of month................................................. 77, 78 simulation description of...................................................... 74 starting jobs............................................................. 82 statements APPL.................................................................. 65 CCCHK .............................................................. 97 DELAYSUB....................................................... 97 ENDJOB ............................................................ 65 IF, THEN, ELSE ................................................ 98 in an ESP procedure ........................................... 29 JCLLIB............................................................... 65 JOB .................................................................... 65 MEMBER .......................................................... 98 NORUN.............................................................. 98 NOTIFY ............................................................. 98 RELEASE .......................................................... 65 RUN ................................................................... 65 Submitting JCL ..................................................................... 16 submitting a job....................................................... 49 subsystem definition .......................................................... 112 successors, specifying ............................................. 60 symbolic variables................................................... 15 definition .......................................................... 112 System calendar ...................................................... 19 T tailoring CSF display............................................... 89 testing an Application ............................................. 72 THEN...................................................................... 98 trigger definition .......................................................... 112 triggering Events ............................................... 43, 82 TSO line commands creating an Event ................................................ 28 U UCMID (unit console module ID) description .......................................................... 47 user data sets ........................................................... 19 using menu help ...................................................... 22 W workday definition .......................................................... 112

115

ESP Workload Manager

116

Getting Started with ESP

Readers Comment Form

We want to hear from you!

Please use this form to communicate your comments about this publication, its organization or subject matter with the understanding that Cybermation may use or distribute whatever information you supply in any way it believes appropriate without incurring any obligation to you.

If your comment does not need a reply (for example, pointing out a typing error), check this box and do not include your name and address below. If your comment is applicable, we will include it in the next revision of the manual.

If you would like a reply, check this box. Be sure to print your name and address below. Page Number(s) Comment(s)

Name _______________________________________________ Company _____________________________________________ Address ______________________________________________ Fax: _________________________

117

ESP Workload Manager

Mail this form to: Cybermation Inc. 80 Tiverton Court Markham, Ontario L3R 0G4 Attn: Documentation Dept. or Fax it to: Documentation Dept. (905) 479-4614

118

Getting Started with ESP

Readers Comment Form

We want to hear from you!

Please use this form to communicate your comments about this publication, its organization or subject matter with the understanding that Cybermation may use or distribute whatever information you supply in any way it believes appropriate without incurring any obligation to you.

If your comment does not need a reply (for example, pointing out a typing error), check this box and do not include your name and address below. If your comment is applicable, we will include it in the next revision of the manual.

If you would like a reply, check this box. Be sure to print your name and address below. Page Number(s) Comment(s)

Name _______________________________________________ Company _____________________________________________ Address ______________________________________________ Fax: _________________________

119

ESP Workload Manager

Mail this form to: Cybermation Inc. 80 Tiverton Court Markham, Ontario L3R 0G4 Attn: Documentation Dept. or Fax it to: Documentation Dept. (905) 479-4614

120