Basic ESP Schedule Monitor Training

Download as doc, pdf, or txt
Download as doc, pdf, or txt
You are on page 1of 11
At a glance
Powered by AI
The document outlines various steps for signing on to ESP, creating and customizing ESP views, changing time dependencies and requesting jobs.

You can update, delete, replicate, and select views. You can also filter views to customize what is displayed.

You can change the sort order by typing SO and the presentation order by typing PR from the command line in ESP. This allows you to sort and arrange the fields in your ESP view.

BASIC

ESP
SCHEDULE
MONITOR
TRAINING
1. How to sign on to ESP
Sign on to ETSO from a 3270 emulator session.
From the ISPF Primary Option Menu type ‘ESP’ on the command line.
Choose Option ‘C’ for Consolidated Status Facility.
2. How to create ESP views.
From ESP; Consolidated Status Facility or ‘CSF’ Type ‘V’
Go beside your general view and type ‘R’ to replicate the view.
Give your new view a name and description.
Go beside your new view type ‘S’ to select it.
When your view comes up type ‘FI’ on the command line to filter.
From this screen you will be able to customize your view as you wish.
Hit Enter to save your view.
3.Customizing ESP Views
To Update a view: Go into ESP CSF. Type ‘V’ on the command line.
Go beside the view you wish to update and type ‘U’. Make the desired change.
To delete a view: Go beside the view you wish to delete and place a ‘D’ beside it.
To replicate a view: Go beside the view you wish to replicate and type ‘R’ beside it.
To select a view: Place an ‘S’ beside the view you wish to select.
To change your presentation order type PR from the command line in ESP. Each view you have
set-up has it’s own presentation order. Type PR on the command line after selecting the view you
wish to change the presentation order for. This action will bring up the following panel.
Field Sort Sort Pres Pres Pres
Description Order Seq Order Len Title

Jobname ===> 1
Application ===> 3
Account Number ===>
Appl Generation ===> 5
Appl Def Seq ===>
DJC Jobnet ===>
Subapplication ===> 4
P-Node ===> 5a
Qualifier ===> 2
Status ===> 7
User Status ===>
System Status ===>
Tag ===> 8
Scheduled Time ===> 6
Event Name ===> 8b
Job Number ===> 8a
Hold Count ===> 6b
Job Start Time ===> 6a
Job End Time ===>
Completion Code ===>
Auth String ===>
Wob Type ===> 9
Agent Name ===>
DManager Name ===>
Put the fields in the order you wish for them to be in. Put a number in the presentation column, 1
will be the first field on the left of your view. As the numbers increase the fields go further out to
the right of your view. If you look at the example above you will see that Jobname is first, Jobqual
and so on. The fields would go from left to right like below.
Jobname Jobqual Appl Subappl AGen PNode Scheduled Start Time HC Status
You may also change your sort order. From the command line in CSF you can type SO. This
command will take to the same screen as the PR command. If you have nothing in your sort order
fields, it defaults to sort by jobname. You may want to sort by application generation if you are
looking at an applwait situation. You may want to sort by start time if you wanted to see what jobs
have been executing the longest.
ESP has colors that can be defined to help differentiate between job statuses. For example you
may want to see your jobs in a failed status in RED. You may to see jobs in an executing status in
green and so on. Just type CO from the command line in ESP:CSF. The following screen will
come up.
Job Status Colour Highlight Intensity
Scheduled ===> ===> ===>
Predecessor Appl Wait ===> ===> ===>
Waiting for Predecessors ===> ===> ===>
Ready or Resource Wait ===> ===> ===>
Submitted ===> ===> ===>
Executing ===> ===> ===>
Overdue ===> ===> ===>
Failed ===> ===> ===>
Task Awaiting Post ===> ===> ===>
Complete ===> ===> ===>
Bypassed ===> ===> ===>
Available Colors: Blue Green Pink Red
Turq White Yellow
Highlighting: None Blink Reverse Uscore
Intensity: Low High
Just type a color in the field provided that you would like to see the job status to left displayed in.
At the bottom of the display you can see the colors you have to choose from. You also can have a
status underlined by using the uscore in the highlighted field. You also have blink and reverse to
choose from. Colors can be an important monitoring tool. After monitoring for a while you will
begin to associate certain colors with certain job statuses.
4.Explanation of PNODES
A. Applhold: By putting ‘applhold’ in your pnode field it will show you all of the ESP
applications that are currently on Application Hold.
When an application is on applhold, no jobs can start to execute in that application until it is
released. An application can be triggered on hold or can be placed on applhold manually.
B. Applwait: Put ‘applwait’ in your pnode field. It will show you all of the ESP applications that
are currently in application wait
An application wait comes about when an application loads and the previous application with
the same name has not finished. Each time an application loads it is given a generation
number. An application in applwait will not start to execute until the previous generation
finishes.
C. Complete: Pnode complete will show all entries in ESP that are completed. When a job
finishes or task does its function it will go into a completed status.
D. Exec: Pnode Exec will show all entries in ESP that are in an executing status. Objects are
executing when they are running on a system.
E. External: Pnode External will show all entries in ESP that are external (Links to another
application) Externals allow a job in one application to release a job in a different application.
F. Fail: Pnode Fail will show all of the entries in ESP that are in a failed or suberror status.
G. Input: Pnode Input will show all jobs in ESP that are in an input submitted status. Jobs are
input submitted when their predecessors are complete but the job is waiting for an initiator.
Jobs could be waiting in the input queue for the following reasons: The business unit held.
The initiators are drained. All of the initiators the job in question is waiting on are in use. The
job is on hold in the input queue.
H. Manhold: Pnode Manhold will show all entries in ESP that are in a manhold status and are not
waiting for predecessors.
I. Predwait: Pnode Predwait will show all entries in ESP that are waiting for predecessors.
J. Ready: Pnode Ready will show the jobs in ESP that are eligible or queued for submission.
Jobs are eligible for submission if they are not held or waiting for resources or waiting for
predecessors.
K. Reswait: Pnode Reswait will show all ESP entries that are in a status of waiting for resources.
L. Sancwait: Pnode Sancwait will show all ESP entries that are in a status of Subpplication wait.
( The previous generation of the sub-application in question has not finished.)
M. Subdelay: Pnode Subdelay will show all ESP entries in a status of submission delayed.
N. Suberror: Pnode Suberror will show any ESP jobs that have a submission error. Some of the
most common suberrors are when there is no jcl for the job, the scriptname does not exist,
there is an error in the application, the job card in the jcl is not correct
O. Task: Pnode Task will show tasks that require manual completion.
P. Waiting: Pnode Waiting will show any ESP entries waiting for a specific delayed submission
time.
5. Explanation of an Application:
A. An application is a group of workload objects. Jobs can be grouped together to form an
application by Business unit. By which platform they run on. By what type of jobs. By which
department they are running for etc.
6. Explanation of a Sub-Application:
A. A group of workload objects in an application that can be displayed or controlled without
affecting or viewing the entire application. Or put more simply it is a smaller group of
workload objects within the application. You can filter on or issued commands to sub-
application without viewing or affecting the entire application.

7. Core Esp Views


1. Overdue View:
To create the OVERDUE view:
Tab down to your general view and type R (Replicate)
Enter the following information:
New View Name ===> OVER
Description ===> OVERDUE JOBS
No Items to Display Message ===>
Press enter
Type S (Select)
Type FI (Filter)
You should now be on the ESP Consolidated Status: Filter Specification for View
screen
Fill in the following:
Overdue ===> Y
Bypassed ===> N
Press Enter to save
The Overdue view will show Esp workload objects that have waited past there normal
execution times.
Overdue view should be monitored every 15 minutes
2. Failed View:
To create the FAILED view:
Tab down to your general view and type R (Replicate)
You will see the following:
New View Name ===>
Description ===>
No Items to Display Message ===>
Enter the following information:
New View Name ===> FAILED
Description ===> FAILED JOBS
No Items to Display Message ===>
Press enter
Type S (Select)
Type FI (Filter)
You should now be on the ESP Consolidated Status: Filter Specification for View
screen
Fill in the following:
Failed ===> Y
Press Enter to save
The Failed view will show all jobs that have failed or have a suberror.
3. How to create the AWAIT view:
Tab down to your general view and type R (Replicate)
Enter the following information:
New View Name ===> AWAIT
Description ===> APPLHOLD - APPLWAIT - SANCWAIT
No Items to Display Message ===>
Press enter
Type S (Select)
Type FI (Filter)
You should now be on the ESP Consolidated Status: Filter Specification for View
screen
Fill in the following:
P-Node ===> APPL- ===> SANC-
Press Enter to save
Await view will show applications and sub-application that are waiting on previous
generations or are on application hold.
4. How to create the CRITICAL view:
Tab down to your general view and type R (Replicate)
Enter the following information:
New View Name ===> CRIT
Description ===> CRITICAL JOBS
No Items to Display Message ===>
Press enter
Type S (Select)
Type FI (Filter)
You should now be on the ESP Consolidated Status: Filter Specification for View
screen
Fill in the following:
Tag ===> CRITICAL
Completed ===> N
Bypassed ===> N
Press Enter to save
The critical view will show jobs that are not complete and are in the Wrangler and
Jeanswear critical path.
5. How to create the EXEC view:
Tab down to your general view and type R (Replicate)
Enter the following information:
New View Name ===> EXEC
Description ===> EXECUTING - INPUT SUBMITTED
No Items to Display Message ===>
Press enter
Type S (Select)
Type FI (Filter)
You should now be on the ESP Consolidated Status: Filter Specification for View
screen
Fill in the following:
P-Node ===> EXEC ===> INPUT
Press Enter to save
Exec view will show jobs that are executing or input submitted.
6. How to create the READY view:
Tab down to your general view and type R (Replicate)
Enter the following information:
New View Name ===> READY
Description ===> QUEUED FOR SUBMISSION
No Items to Display Message ===>
Press enter
Type S (Select)
Type FI (Filter)
You should now be on the ESP Consolidated Status: Filter Specification for View
screen
Fill in the following:
P-Node ===> READY
Press Enter to save
Ready view will show jobs that are queued for submission
7. How to create the LONGRUN view:
Tab down to your general view and type R (Replicate)
Enter the following information:
New View Name ===> LONG
Description ===> JOBS RUNNING LONGER THAN 3 HRS
No Items to Display Message ===>
Press enter
Type S (Select)
Type FI (Filter)
You should now be on the ESP Consolidated Status: Filter Specification for View
screen
Fill in the following:
Freeform filter ===> Y
Press enter
Type the following:
(STIME < TIME(REALNOW LESS 3 HOURS) AND STIME > TIME(01:00 JAN 1,
2000)) AND INCOMPLETE AND PNODE NE 'TASK' AND NOT_BYPASSED
Press F3 to save
Longrun view will show jobs that have not completed and it’s been three hours or more
since their start time.
8. How to Create Agent view:
Tab beside your general view and type R (replicate)
Enter the following information:
New View Name ===> Agent
Description ===> Jobs that are agent notified.
Press enter
Select your agent view
Type FI to filter
Fill in the following:
Freeform Filter ===> Y
Press Enter
Type the following:
(STATUS EQ 'AGENT NOTIFIED' OR STATUS(1,6) EQ 'UNABLE' OR
STATUS(1,4) EQ 'CODE'
OR STATUS(1,6) EQ 'RELEAS' OR STATUS(1,5) EQ 'SCHED' OR STATUS(1,6) EQ
'STATUS' OR STATUS(1,9) EQ 'SAP_READY')
Press F3 to save
Agent view will show jobs that are agent notified, unable to connect, have a system error,
are released at sap, are schedule at sap, and rfc issues at sap.
9. How to Create Reswait view:
Tab beside your general view and type R (replicate)
Enter the following information:
New View Name ===> RESWAIT
Description ===> Jobs that are waiting for resources.
Press enter
Select your Reswait view
Type FI to filter
Fill in the following:
Res wait ===> Y
Press Enter to save.
Reswait view will show jobs that are waiting for resources.
NOTE: EVERY RESOURCE WAIT IS NOT A PROBLEM. Use LR command to check to see what
resources the job in question is waiting on.
8. ESP Commands
A. How to Restart a job.
Place a R beside the job in ESP you wish to restart. Press Enter. This will bring up the
following panel.
Object ******** in Application ******** for generation ****
Dsname ===> Original library
Member ===> and/or member if blank
User1 ===>
User2 ===> User variables to be passed to
User3 ===> ESPPROC or JCL
User4 ===>
From Step ===> Starting Step.Procstep
To Step ===> Ending Step.Procstep
Restart ===> N ESP Encore for restart, Y or N
Jobid ===> JES Jobid of job being restarted
Do you wish to enter ENCPARM statements? ===> N (Y or N)
Press ENTER to resubmit object or enter END to terminate request

In the panel above you can fill in a different DSNAME and or MEMBER if they are different
from the original that was submitted.
B. How to Release a job from manhold.
Place an A beside the job you wish to release and press enter.
C. How to release a sub-application from hold.
Place an AS beside any job within the sub-application and press enter.
D. How to release an application from hold.
Place an AA beside any job in the application and press enter.
E. How complete a job.
Place a C beside the job you wish to complete and press enter.
F. How complete a sub-application
Place CS beside any job within the sub-application and press enter.
G. How to complete an application
Place a CA beside any job in the application you wish to complete and press enter.
H. How to bypass a job.
Place BY beside the job you wish to bypass and hit enter.
How to bypass a sub-application
Place a BYS beside a job in the sub-application you with to bypass and hit enter.
J. How to unbypass a job
Place UB beside the job you with to unbypass
K. How to unbypass a sub-application
Place UBS beside a job in the sub-application you with to unbypass and press enter.
L. How to list historic job index entries for a job.
Go beside the job you with to see history for and place a LI beside it and press enter.
M. How to set user status
Go beside the job you wish to change the user status for and place SUS beside it and hit enter.
N. How to hold a job.
Go beside the job you wish to hold and type H beside it and press enter.
O. How to hold a sub-application
Tab beside one of the jobs in the sub-application that you wish to hold. Type HS beside the
job and hit enter.
P. How to hold an application
Go beside one of the jobs in the application use with to hold. Type HA beside the job and hit
enter.
Q. How to hold a job with a reason
Filter on the job you wish to hold. Type HR beside the job. This will bring up another panel.
Enter the HOLD reason ===>
(The HOLD reason is placed in the User Status field)

Press ENTER to proceed with the HOLD request


Press END to cancel the request
Type the reason for the job being held on the line provided.

R. How to display job relationships


Filter on the job you wish see job relationships for and type L beside it. Hit enter.
S. How to display a sub-application
Filter on the sub-application you wish to display. Type LS beside one of the jobs in the sub-
application. Press enter.
T. How to display an application
Filter on the application you wish to display. Tab beside one of the jobs in the application and
type LA. Hit enter.
U. How to list resources
Display jobs waiting for resources. Tab beside the job you wish to display the resource for
and type LR. Hit Enter
V. How to drop resources
Filter on the job you wish to drop the resources for and type DR beside the job and hit enter.
W. How to display time dependencies
Filter on the job you wish to display the time dependency for. Type RT beside it. Hit enter.
X. How to insert a job
Filter on an application that corresponds with the job you wish to insert. (Remember two jobs
in the same application can not have the same jobname unless they have a different qualifier.
Place IJ beside one of the jobs in the application. This action will bring up the following
screen.
Object insertion into Application *******1.522
Object name ===>
Subappl ===> Tag ===>
JCL Dsname ===>
Member ===>
Predecessors ===> N Y if predecessors are required
Successors ===> N Y if successors are required
Type ===> J J Job, T Task, L Link, M Manual, X External
On-Request ===> Y if object is an ON-REQUEST object
Hold ===> Y if object is to be placed in MANUAL HOLD
Conditional ===> Y if object is a conditional object
More inserts ===> N Y if more jobs are to be inserted
Fill in the appropriate fields, then press ENTER to accept or enter END command
to cancel the request.
Fill in the Object name (job name)
JCL Dsname
Member
If you are adding predecessors and/or successors to this job you will have to change the
predecessors => from N to Y and/or successors => from N to Y.
If you place a Y in the predecessors field the following screen will come up.
Enter the name(s) of dependent Workload Object(s) and condition of
the dependency. If more space is needed the screen will be repeated
after pressing ENTER.
Conditional dependency is entered as follows:
BLANK or N - normal termination
A - abnormal termination
U - any termination
-------------------------------------------------------------------------
Job name Condition Job name Condition
-------------------------------------------------------------------------
===> ===>
===> ===>
===> ===>
===> ===>
===> ===>
===> ===>
===> ===>
===> ===>
===> ===>
Fill in the appropriate fields, then press ENTER to accept or enter END
command to cancel the request.
Add your predecessors in the spaces provided.
If you place a Y in the successor field the following screen will come up.
Enter the name(s) of dependent Workload Object(s) and condition of
the dependency. If more space is needed the screen will be repeated
after pressing ENTER.
Conditional dependency is entered as follows:
BLANK or N - normal termination
A - abnormal termination
U - any termination
-----------------------------------------------------------------------
Job name Condition Job name Condition
Fill in the appropriate fields, then press ENTER to accept or enter END
command to cancel the request.
Fill in the appropriate successors and hit enter.
There are also two other commands used for inserting a job from ESP;CSF.
IJA command inserts a job after the job you entered the command IJA beside. The IJA
command makes the job you entered the command IJA beside a predecessor to the job you are
inserting. IJB command inserts a job before the job you entered the command IJB beside. The
IJB command makes the job you entered the IJB command beside a successor to the job you
are inserting

Y. How to manually request a scheduled job


Filter on the scheduled job you wish to request. Tab beside the job and type RQ and hit enter.
The status of the job will change from request to requested.
Z. How to unrequest a requestable job in ESP.
Filter on the requested job and tab beside it. Type UR and press enter.
AA. How to unwait a job
Filter on the job you wish to unwait. Type UW next to it and hit enter.
BB. How to unwait a sub-application
Filter on the sub-application you intend to unwait. Tab beside one of the jobs in the sub-
application and type UWS and hit enter.
CC. How to unwait an application
Filter on the application you intend to unwait. Tab beside one of the jobs in the application
and type UWA and hit enter.
DD. How to drop predecessor dependencies
Filter on the job you want to drop the dependencies for. Tab beside the job type L and hit
enter. This action will bring a screen like the one below. Type D beside the predecessor
dependency you wish to drop.
You may enter a D in front of any incomplete predecessor to drop a dependency. Hit enter.
JOB ********
PREDECESSORS
******JD
******HD
SUCCESSORS
******HD
EE. How to Reset time dependencies
Filter on the job you wish to reset the time dependencies for. Tab beside the job and type RT
and hit enter. This action will bring up a screen similar to the one below.
Earliest submit time ===> 04.00.02 FRI 16 JUN 2000
Late submit time ===>
Overdue time for job start ===>
Overdue time for job end ===>
Abandon execution at ===>
Abandon dependencies at ===>
Abandon resources at ===>
Update any required time fields. Press ENTER to proceed or enter END to
cancel the request.
Delete the time in the earliest submit time and type in now and hit enter.
FF. How to edit copyjcl
Filter on the job you need to edit copyjcl for. Tab beside it and type EC and hit enter. This
will bring up the copyjcl remember. Make changes needed and F3 to save.
GG. How to browse copyjcl
Filter on the job you need to browse copyjcl for. Tab beside it and type BC and hit enter. This
will bring up the copyjcl remember.
HH. How to edit a job from ESP
Filter on the job you wish to edit. Tab beside the job type EJ and hit enter. This will bring up
the jcl of the job.
II. How to browse a job from ESP
Filter on the job you wish to edit. Tab beside the job type BJ and hit enter. This will bring up
the jcl of the job.
JJ. How to browse a procedure
Filter on the application you wish to browse the procedure for. Tab beside a job in the
application and type BP and hit enter. This action will bring up the proc in which the ESP
application resides.
KK. How to get to SDSF from ESP.
Filter on the job you wish to see the sdsf output for and type SD beside the job in ESP. Hit
enter. This will being up the job in sdsf.

You might also like