The maintenance functions provided for the Resource Master metanode are used to define master resource definitions to Entire Operations. You can specify certain amounts of any of these resources as a prerequisite for job submission. Entire Operations does not submit the job until the specified amount is available.
This document covers the following topics:
Basic purpose: Using Resources in the Concepts and Facilities documentation
Basic use and summary of resource features: Resources in the User's Guide
Use as a prerequisite condition for jobs: Handling Prerequisite Resources for a Job and Viewing and Modifying Resources Used by Active Jobs in the User's Guide
To list all available functions for the Resource Master metanode
In the object workspace, select the Resource Master metanode and open the context menu.
The following functions are available:
| Function | Shortcut | Description |
|---|---|---|
| List | F8 | Opens the Resource Master List window with a list of all available resources: see Listing Resources. |
| New | CTRL+N | See Viewing, Adding and Modifying a Master Resource. |
| Refresh | F5 | See Refreshing Object Lists - Refresh Functions in the User's Guide. |
| Filter | F3 | See Filtering Objects - Filter Function in the User's Guide. |
| Export | --- | Opens the Export Objects window to export all items of the metanode Resource Master: see Exporting Objects in the Import/Export Functions documentation. |
| Set Drag And Drop Function | -- | See Drag & Drop in the User's Guide. |
To list all available functions for a Resource Master instance
In the object workspace, select a Resource Master instance and open the context menu.
The following functions are available:
| Function | Shortcut | Description |
|---|---|---|
| Open | CTRL+O | See Viewing, Adding and Modifying a Master Resource. |
| Display | CTRL+D | See Viewing, Adding and Modifying a Master Resource. |
| Where used | --- | See Listing Jobs Defined for a Resource. |
| Active Usage | --- | See Listing Jobs Currently Using a Resource. |
| Delete | DELETE | See Deleting a Master Resource. |
| Export | --- | Opens the Export Objects window to export a user: see Exporting Objects in the Import/Export Functions documentation. |
| Add to Workplan | --- | See Add to Workplan. |
| Set Drag And Drop Function | -- | See Drag & Drop in the User's Guide. |
To list available resources
In the object workspace, select the Resource Master metanode and choose List from the context menu, or press F8.
A Resource Master List window similar to the example below opens:
The window contains a list of resources defined in Entire Operations (the list is empty if no resources are defined).
The columns are explained in Columns: Resource Master List.
This section covers the following topics:
The columns of the Resource Master List window are described in the following table:
| Column | Meaning | |
|---|---|---|
| Resource | Name of resource. This can reflect real resources or can describe a fictitious resource. | |
| Type | Type of resource. Possible values: | |
U |
Not reusable, quantitative. | |
R |
Reusable, quantitative. | |
N |
Not quantitative (absolute) | |
| For a more information, see the field Type described in Fields and Columns: Resource Definition. | ||
| Initial Qty | Total amount of the resource defined to the system. | |
| Used Qty | Amount of resource currently used by running jobs. | |
| Exit Library | Natural library of the resource
determination user exit.
The fields and functions available for user exit usage are described in Fields: Resource Definition and Functions: Resource Definition. |
|
| Member | Natural object of the resource
determination user exit.
The fields and functions available for user exit usage are described in Fields: Resource Definition and Functions: Resource Definition. |
|
| E | User exit enabled. Possible values: | |
Y |
The user exit is enabled. | |
N |
The user exit is not enabled. | |
| Call Time | Date and time of the last
invocation of the resource master determination user exit.
See also Date and Time Formats in the User's Guide. |
|
Note:
The usage of resources can be restricted to read-only access in your
user profile as described in Monitoring
Functions in the section User
Maintenance.
To view a resource master definition
In the object workspace, select a Resource Master instance.
From the context menu, choose , or press CTRL+D.
A Display Resource Master window opens. The read-only fields contained in the window correspond to the fields of the Maintenance Resource Master window. They are described in Fields: Resource Definition.
To create a resource master
In the object workspace, select .
From the context menu, choose , or press CTRL+N.
A Create new Resource Master window similar to the example below opens:
Enter the required definitions.
The input fields available are described in Fields: Resource Definition.
For the functions available, see Functions: Resource Definition.
When you are finished, choose .
The resource master definition is saved.
When you open the newly created resource in the Maintenance Resource Master window, the additional pages Defined in Jobs and Active Usage are available. They are described in Listing Jobs Defined for a Resource and Listing Jobs Currently Using a Resource, respectively.
To modify a resource master definition
In the object workspace, select a Resource Master instance.
From the context menu, choose , or press CTRL+O.
A Maintenance Resource Master window similar to the example below opens:
The fields contained in the window are explained in Fields: Resource Definition. The functions available are explained in Functions: Resource Definition.
The fields of the Display/Maintenance/Create new Resource Master window are described in the following table:
| Field | Meaning | |
|---|---|---|
| Resource | Name of the resource. User must specify this name when using this resource as a prerequisite for a job. | |
| Type | Type of resource.
Possible selection options: |
|
| Quantitative, not reusable | Not reusable, quantitative. Amount of resource used by job is not released at job completion (e.g.: Paper) | |
| Quantitative, reusable | Reusable, quantitative. Amount of resource used by job is released at job completion (e.g.: Address Space) | |
| Not quantitative (binary) | Not quantitative. Resource is either entirely available or not available (e.g.: a database or printer) | |
| Initial Quantity | The initial quantity defined for
resources of the type Quantitative, not
reusable and Quantitative, reusable.
The field is protected and shown as information only if the amount of the resource is determined by a resource master determination exit. Note: |
|
| Used Quantity | Protected field showing the amount of the resource currently in use. This value is useful when you wish to modify an existing resource. If you are defining a new resource, this field should show zero. | |
| User exit page: | The tabbed page User exit is used to define a determination user exit routine. | |
| User Exit | If a
resource master determination exit is
defined, the initial value of the resource is determined at each invocation of
the routine.
The user exit is invoked during prerequisite checks for the resource. Between two exit calls, at least the check interval must have been passed by. The exit is used only if it is enabled. If the exit is enabled, the manual setting of the initial value is disabled. It is possible to pass parameters to the exit. |
|
| Library | The Natural Library in which the
user exit resides.
This library should be different from the Entire Operations system library. |
|
| Parameter | The content of this field is
passed to the resource master determination exit, in the field
NOPXPL-A / P-RMD-PARAMETER.
Symbols may be used. The escape character is the global
activation escape character. The symbols must reside in the global table
|
|
| User exit enabled | The resource master determination
user exit is only used if it is enabled by marking this check
box.
If enabled, the initial value of the resource cannot be set manually. If this check box is not marked, the user exit is disabled. |
|
| User exit check interval | The minimum interval between two determinations of the resource. The overhead of resource determinations increases with smaller intervals. | |
| Maximum number of jobs that will be awakened from passive waiting | The maximum number of jobs to
awake from a passive wait state.
You can specify a maximum number to limit the storage used by resources. This is useful for large networks where many active jobs require the same resource. When the maximum number is reached, jobs remain in the wait queue until enough resource storage is available to process further jobs. If zero ( |
|
| Last Value Determination | Date and time of the last
determination of the resource amount by the resource master determination exit
(if exit is defined).
See also Date and Time Formats in the User's Guide. |
|
| Defined in Jobs page: | This page is not available in a
Create new Resource Master window.
The tabbed page Defined in Jobs shows a list of the jobs in which the selected resource is defined as a prerequisite resource. |
|
| Active Usage page: | This page is not available in a
Create new Resource Master window.
The tabbed page Active Usage shows a list of active jobs which are currently using a resource. |
|
The following functions are available on the User exit page of the Maintenance Resource Master window:
| Function | Meaning |
|---|---|
| Opens a window where you can edit the user exit. | |
| Calculates the total quantity currently used by a resource. The calculated value helps you control consistent usage of the resource and adjust the initial quantity defined for a resource if required. | |
| Invokes the resource master determination exit. |
A resource amount determination exit can be defined for each master resource. This also covers the so-called physical resources.
When the exit is invoked, the currently available amount of the resource is returned. The return of the initial amount is optional.
Initial amounts will not be used for normal prerequisite resource checks.
One exit can be used for several (e.g., similar) master resources, because the name of the resource is passed as an input parameter to the exit.
The user may check whatever he needs to determine the resource amount. He may invoke Entire System Server views and / or check any database contents.
Note:
The user is responsible for the performance of the coded
exit.
After the exit is invoked, the new available quantity will be stored in the resource master record. Triggering of passive waiters will only be done if the new quantity is different from the old one.
Resource Master Determination Exits can be enabled and disabled. If use of the exit is disabled for a resource, it behaves like a resource without exit.
For the common parameter list for user exits, see Parameters Used for Different Call Places in the section Common User Exit Parameter Data Area NOPXPL-A in the User's Guide.
The common user exit parameter data area contains:
Return code (out)
OK, determination successful
Resource cannot be determined (permanent)
Resource cannot be determined (temporary)
Parameter(s) missing
Return text (out)
Resource name (in)
Timestamp for which the evaluation is to be made (in). (Usually
*TIMX will be passed.)
Current maximum amount as known to Entire Operations (in)
Currently used amount (in)
New maximum amount (out)
New used amount (out).
To view all jobs defined for a resource
In the object workspace, select a Resource Master instance and choose Where Used from the context menu.
Or:
In the
window, select the tab.
A Defined in Jobs page similar to the example below opens:
The page shows a list of the jobs in which the selected resource is defined as a prerequisite resource.
The fields and columns on the page are described in Field and Columns: Resource Defined in Jobs.
The fields and columns on the Defined in Jobs page are described in the following table:
| Field/Column | Meaning |
|---|---|
| Resource | Name of the resource. |
| Initial Quantity | The initial quantity, as defined in the master resource definition (see Fields: Resource Definition). |
| Type | The type, as defined in the master resource definition (see Fields: Resource Definition). |
| Owner | The owner, network, network version and job in which the resource is defined as a prerequisite. |
| Network | |
| Version | |
| Job | |
| Quantity | The amount which is required by this job. |
| Dealloc. | Deallocation mode.
See Resource Deallocation Modes in the User's Guide for details. |
| D.if not ok | Deallocation if the job does not
end ok.
See Resource Deallocation Modes in the User's Guide for details. |
To view all active jobs using a resource
In the object workspace, select a Resource Master instance and choose Active Usage from the context menu.
Or:
In the
window, select the tab.
The Active Usage page of the Display/Maintenance Resource Master window similar to the example below opens:
This page shows a list of active jobs that use partial quantities of the resource.
The fields and columns on the page are described in Fields and Columns: Active Resource Usage.
The fields and columns on the Active Usage page of the Display/Maintenance Resource Master window are described in the following table:
| Field/Column | Meaning |
|---|---|
| Resource | Name of the resource. |
| Type | The type, as defined in the master resource definition (see Fields: Resource Definition). |
| Initial Quantity | The initial quantity, as defined in the master resource definition (see Fields: Resource Definition). |
| Used Quantity | Sum of all amounts of single usages of the resource. |
| Owner | The owner, network and run number of the active job by which the resource is allocated. |
| Network | |
| Run | |
| Job | |
| D | Deallocation mode.
See Resource Deallocation Modes in the User's Guide for details. |
| A | Allocated by resource API.
|
| Begin | Date and time of the allocation.
See also Date and Time Formats in the User's Guide. |
| Quantity | Allocated quantity. |
To delete a master resource
In the object workspace, select a Resource Master instance.
Open the context menu and choose Delete, or press DELETE.
A confirmation window opens.
Choose Yes to confirm the deletion or No to cancel the action.
Note:
The deletion of a master resource is allowed only if the resource
is no longer used
in any job master definition
in any active job.