The functions described in this section are used to list and define single or multiple resources for a job that are a prerequisite for submitting the job.
Before you can define a resource as a prerequisite for a job, it must be defined as resource master to Entire Operations. You define resources to Entire Operations by using the Resources maintenance functions described in the Administration documentation.
This document covers the following topics:
Maintenance of a resource master: Resources in the Administration documentation
Basic use and summary of resource features: Resources in the section System Overview
To list prerequisite resources specified for a job
On the Job
Maintenance screen, enter L in
the line command input field next to the required job.
Press ENTER.
A Prerequisite Resources (Master) screen similar to the example below opens:
17-04-05 ***** Entire Operations ***** 17:50:36
Prerequisite Resources (Master)
------------------------------------------------------------------------------
Owner EXAMPLE Network B60-FLOW Version Job JOB-06
Run from to required
Cmd Run Job Resource T Quantity D DNO allocated
_ HUGO U 5.00 J Y
_ PARA-1 R 10.00 N Y
_ WILLI U 20.00 K Y
******************************* Bottom of Data *******************************
D Delete M Modify R Master Definition W Where Used
Enter--PF1----PF2----PF3----PF5---------PF7----PF8-----------------------------
Help Add End Save Up Down |
The screen lists all resources specified for the job as prerequisites. The columns contained in the window are described in Columns and Fields: Prerequisite Resource Definitions.
To find out where a predefined resource is used
In the Cmd column of the
Prerequisite
Resources screen, enter the line command
W (Where Used) next to the required resource.
Press ENTER.
A Resource defined in Jobs window opens with a list of all owners, networks and jobs that use the selected resource.
If invoked for a master job definition: Shows the usage of this resource as a prerequisite in all master job definitions.
If invoked for an active job definition: Shows the current usage of this resource by active jobs.
The fields and columns contained in the window correspond are described in Field and Columns: Resource Defined in Jobs in the section Resources in the Administration documentation.
To display or modify the prerequisite resource definition of a
job
In the Prerequisite
Resources screen, type M
(Modify) in the line command input field next to the resource you want to view
or modify.
Press ENTER.
A Prerequisite Resource Definition (Master) window similar to the example below opens:
17-04-06 ***** Entire Operations ***** 17:55:11
Prerequisite Resources (Master)
------------------------------------------------------------------------------
Owner EXAMPLE Network B60-FLOW Version Job JOB-06
Run from t +-------------------------------------------------------+
Cmd Run Job ! !
m ! Prerequisite Resource Definition (Master) !
_ ! !
_ ! Resource ===> HUGO________________ !
! Required Quantity ===> 5.00______ !
! !
! Deallocation Mode ===> J !
! Deallocate if Job not ok ===> Y !
! Allocated at ===> !
! !
! Enter-PF1---------PF3---------PF5---------------- !
! Help End Save !
+-------------------------------------------------------+
******************************* Bottom of Data *******************************
D Delete M Modify R Master Definition W Where Used
Enter--PF1----PF2----PF3----PF5---------PF7----PF8-----------------------------
Help Add End Save Up Down |
The fields are described in Columns and Fields: Prerequisite Resource Definitions.
To add a prerequisite resource definition for a job
In the Prerequisite Resources list screen, press PF2 (Add).
A Prerequisite Resource Definition window opens.
The input fields and options available in the window are described in Columns and Fields: Prerequisite Resource Definitions.
To delete a prerequsite resource
In the Prerequisite
Resources screen, type D
(Delete) in the line command input field next to the resource you want to
remove.
Press ENTER.
The selected resource is deleted for this job master.
The following table explains the columns contained in the Prerequisite Resources list screen and the corresponding input fields (if available) of the Prerequisite Resource Definition window.
| Column/Field/Option | Description | |
|---|---|---|
| Cmd | One-character line command input field. Possible options: | |
D
|
Delete a prerequisite resource definition for this job. | |
M
|
Modify a prerequisite resource definition for this job. | |
R
|
Display the master resource definition. | |
W
|
View where a prerequisite resource definition is used. | |
| Resource (name) | Name of the resource as defined in Entire Operations and listed
on the
Resources
screen (see
Resources in the Administration
documentation).
Input field: You can use a wildcard ( |
|
| T | Resource type.
For details, see the description of the Type field in Fields: Resource Definition in the section Resources (Administration documentation). |
|
| (Required) Quantity | Resource quantity required for job
execution.
Input field: Enter the resource quantity required for job execution. Entire Operations does not submit the job until this amount of resource is available. |
|
| D | Deallocation mode of this prerequisite resource: see Resource Deallocation Modes. | |
| Deallocation Mode | ||
| DNO | Applies to
deallocation mode
J
only.
Deallocate if job is |
|
Y
|
The resource will always be deallocated after job termination,
even if the job ended not ok.
|
|
| Deallocate if Job not ok | N
|
The resource will not be deallocated if the job ended not
ok. (However, the job will still be deallocated at network termination.)
|
Input option:
Enter Y or N as required.
|
||
| Allocated (at) | Applies to active prerequisite
resources only.
Date and time when the resource was allocated for the current job. If the resource has not yet been allocated or if it has already been deallocated, this field is empty. See also Date and Time Formats. |
|
Note:
Resource allocations will be deallocated if the retention period
for an active condition is reached.
| Mode/Input Value | Explanation |
|---|---|
J
|
Release resource at job
termination (default).
The resource is released when the allocating job terminates. |
N
|
Release resource at network
termination.
The resource will be released when the Entire Operations Monitor detects that all jobs of a job network are terminated. The resource will be released also if a currently executing network is being deactivated. Note: |
E
|
Release resource at network
termination, but release earlier after an erroneous job.
The resource will be kept until network termination. If any job
ends |
K
|
Keep resource until manual
release.
The resource will not be released automatically at job or network termination. If the retention period for active conditions is reached, the resource will be released automatically. |
The following additional rules apply:
If an active network or job is deactivated, all the resources
allocated by it will be released too. This will be performed regardless of the
defined deallocation mode. This means that even resources with deallocation
mode K (keep) will be released in such cases.
Master resource amounts can be modified by API calls. Note that this is possible only if the amount is not determined by a resource master determination exit.
Resources can be allocated for a job by an API call. These additionally allocated resources will be handled in the same way as defined prerequisite resources.
Resources can be deallocated by API calls. Preliminary releases of resources are allowed for deallocation modes.
All resource allocations and deallocations will be logged.
For more information, see Handling of Resource Allocations (NOPURE1N) in the section List of Available Entire Operations API Routines.