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.
This document covers the following topics:
Resources (maintenance of resource masters) - Administration documentation
Viewing and Modifying Resources Used by Active Jobs - Active Job Networks
You can specify certain amounts of a defined resource master as a prerequisite for job submission. Entire Operations does not submit the job until the specified amount is available.
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 maintenance functions of the Resource Master metanode described in the Administration documentation.
Resources can be
Quantitative or absolute;
Reusable or not reusable.
Some examples of resources are listed below:
| Resource | Type |
|---|---|
| Print forms | Quantitative, not reusable |
| Main storage | Quantitative, reusable |
| Line to a remote machine | Absolute |
| Availability of a device | Absolute |
This section covers the following topics
Prerequisite resources are allocated for all job types (including ) and for all kinds of temporary dummy jobs. You can set an allocation mode to disallow resource allocation for temporary dummy jobs.
The following rules apply for the ordering of resource allocations:
If a resource is requested by the same owner, network, job, but different runs (at the same time), the active job with the lowest run number or earliest activation time will get the resource first.
If several different jobs of one active network or of several active networks wait for the same resource: The available quantity of the resource will be allocated to as many as possible jobs in parallel, but under the restriction of item 1.
If a resource waiter with a higher priority is found during a
prerequisite resource check, the message Res.
resource available, other jobs have
priority will be written to the log. It is followed by
Res. resource - waiting with higher
priority: and one or several lines with context information.
The available amount of a resource can be determined by the usage of an exit. A resource master determination exit (described in the Administration documentation) will be invoked by the Entire Operations Monitor before prerequisite resource checks.
Resource master 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. For more information, see Handling of Resource Allocations (NOPURE2N) in the section List of Available Entire Operations API Routines.
A resource is usually allocated for the duration of job execution.
If you want to allocate a resource for a longer time, you can change the resource deallocation mode set for a job as described in Resource Deallocation Modes.
The reasons and rules for resource allocation or deallocation are described in the following section:
Retention period of condition reached
A resource is deallocated if the retention period for an active condition is reached.
Deallocation mode set
If you want to allocate a resource for a longer time, you can change the resource deallocation mode set for a job as described in Resource Deallocation Modes.
Deactivated network or job
If an active network or job is deactivated, all resources allocated by it are deallocated too.
This is performed regardless of the defined deallocation mode.
This means that even resources with deallocation mode
K (keep until explicit release) are released in such cases.
Database cleanup performed
Resources are deallocated when an automatic cleanup of the active database is performed (see also Defaults for Time Ranges described in the Administration documentation).
Allocation kept for jobs that ended not ok
It is possible to prevent a resource from deallocation if a
job ended not ok. This can be used, for example, to keep a
resource during a recovery for an unsuccessful run.
See the option Deallocate if job not ok in the Resource Prerequisite window described in Columns and Fields: Prerequisite Resource Definitions in the section Job Maintenance.
Forced deallocation
You can force freeing of a resource allocation.
All current resource allocations can be inquired in usage lists. From these active resource usage lists it is possible to force the deallocation of a given resource allocation.
For further information, see Listing Jobs Currently Using a Resource in the section Resources in the Administration documentation.
Use this feature with care. Be aware that one or several active jobs may be started immediately, which were way for this resource.
Allocation or deallocation determined by API
Resources can be allocated for a job by an API call. These additionally allocated resources are 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.
For more information, see Handling of Resource Allocations (NOPURE2N) in the section List of Available Entire Operations API Routines.
All resource allocations and deallocations are logged (see also the section Log Information).
This section describes the resource allocation modes that can be set for the prerequisite resource defined for a job (see also Displaying, Modifying and Adding a Prerequisite Resource Definition). Allocation modes are also indicated on resource lists.
| Mode/Selection Option | Explanation |
|---|---|
A
Always |
Allocate the resource (default). |
T
Only if the active job does not become a temporary dummy job |
Do not allocate the resource if the job executes as a temporary dummy job. |
This section describes the resource deallocation modes that can be set for the prerequisite resource defined for a job (see also Displaying, Modifying and Adding a Prerequisite Resource Definition). Deallocation modes are also indicated on resource lists.
| Mode/Selection Option | Explanation |
|---|---|
J
After job termination |
Release resource at job
termination (default).
The resource is released when the allocating job terminates. |
N
After network termination |
Release resource at
network termination.
The resource is released when the Entire Operations Monitor detects that all jobs of a job network are terminated. The resource is released also if a currently executing network is being deactivated. Note: |
E
Keep until network termination |
Release resource at
network termination, but release earlier after an erroneous job.
The resource is kept until network termination. If any
job ends |
K
Keep until explicit release |
Keep resource until
manual release.
The resource is not released automatically at job or network termination. If the retention period for active conditions is reached, the resource is released automatically. |
To list all prerequisite resources defined for a job
In the Maintenance Job Master window, open the tabbed page Resources:
The table in the window lists all resources defined as prerequisites for the job. The table columns are described in Columns and Fields: Prerequisite Resource Definitions.
To find out where a predefined resource is used
From the table on the Resources page, select the required resource.
Choose .
A Where used Condition window similar to the example below opens:
If invoked for a job master definition: Shows the usage of this resource as a prerequisite in all job master 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 to the fields and columns of the Defined in Jobs page. They 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
From the table on the tabbed page , select the resource definition you want to view or change and choose .
A Resource Prerequisite window similar to the example below opens:
Make your definitions. The input fields and selection options available in the window are described in Columns and Fields: Prerequisite Resource Definitions.
Choose when you are finished.
To add a prerequisite resource definition for a job
On the tabbed page , choose .
A Resource Prerequisite window similar to the previous example opens.
Make your definitions. The input fields and selection options available in the window are described in Columns and Fields: Prerequisite Resource Definitions.
Choose when you are finished.
The following table explains the columns on the Resources page and the corresponding input fields/options of the Resource Prerequisite window:
| Column | Input Field | Description | |
|---|---|---|---|
| Resource | Resource name | Name of the resource as defined in Entire Operations and listed in the Resource Master List window (see Resources in the Administration documentation). | |
| T | n/a | Resource type as defined for the resource master: see the description of the Type field in the section Resources (Administration documentation). | |
| Quantity | 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. |
|
| A | Allocation Mode | Allocation mode of this prerequisite resource: see Resource Allocation Modes. | |
| D | Deallocation Mode | Deallocation mode of this prerequisite resource: see Resource Deallocation Modes. | |
| DNO | Deallocate if Job not ok | Applies to
deallocation mode
After job termination
only.
Deallocate if job is |
|
Y
|
The resource is always deallocated after
job termination, even if the job ended not ok.
|
||
N
|
The resource is not deallocated if the
job ended not ok. (However, the job will still be deallocated at
network termination.)
|
||
|
Input option: select this check box if you want to deallocate the job. |
|||
| Allocated | Allocated | 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. |
|
To delete a resource definition
From the table on the tabbed page , select the resource definition you want to remove and choose .
The selected resource is deleted for this job master.