Resources

#### Search Results

Search

# Resources

The maintenance functions provided for the Resource Master metanode are used to define resource master definitions to Entire Operations.

A resource master determines the maximum amount of usage available for executing all jobs that reference the resource. This amount is defined as a fixed value (initial quantity) in the resource master. Each resource must be defined as a resource master, before it can be used by a job.

Part of the amount (or the entire amount) specified for a resource can be defined as a prerequisite requirement for a single job or multiple jobs. This can be helpful, for example, to control execution of jobs that run at the same time.

The current amount of a resource master can be determined by an exit, which is periodically invoked by the Entire Operations Monitor. The exit can change the amount currently available for a resource, for example:

- If a requested symbol is not found;

- If a time limit set for job execution is reached;

- If not enough space is available for job execution.

For more information, see Using a Resource Master Determination Exit.

This document covers the following topics:

- Functions: Resource Master

- Listing Resources

- Viewing, Adding and Modifying a Resource Master

- Using a Resource Master Determination Exit

- Listing Jobs Defined for a Resource

- Listing Jobs Currently Using a Resource

- Deleting a resource master

#### Related Topic:

- 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

## Functions: Resource Master

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 | Open the Resource Master List window with a list of all available resources: see Listing Resources.
  New | CTRL+N | See Viewing, Adding and Modifying a Resource Master.
  Refresh | F5 | See Refreshing Object Lists in the User's Guide.
  Filter | F3 | See Filtering Objects in the User's Guide.
  Export | --- | Open 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 Resource Master.
  Display | CTRL+D | See Viewing, Adding and Modifying a Resource Master.
  Where used | --- | See Listing Jobs Defined for a Resource.
  Active Usage | --- | See Listing Jobs Currently Using a Resource.
  Delete | DELETE | See Deleting a Resource Master.
  Export | --- | Open 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.

## Listing Resources

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 like 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.

### Columns: Resource Master List

The columns of the Resource Master List window are described in the following table:

Column | Meaning
--- | ---
Resource | Name of the resource. This can reflect real resources or can describe a fictitious resource.
Type | Type of the resource. Possible values:
`U` | Not reusable, quantitative.
`R` | Reusable, quantitative.
`N` | Not quantitative (absolute).
For more information, see the Type field 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.

## Viewing, Adding and Modifying a Resource Master

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

1. In the object workspace, select a Resource Master instance.

2. From the context menu, choose Display, 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

1. In the object workspace, select Resource Master.

2. From the context menu, choose New, or press CTRL+N.

   A Create new Resource Master window like the example below opens:

3. Enter the required definitions.

   The input fields available are described in Fields: Resource Definition.

   For the functions available, see Functions: Resource Definition.

4. When you are finished, choose OK.

   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

1. In the object workspace, select a Resource Master instance.

2. From the context menu, choose Open, or press CTRL+O.

   A Maintenance Resource Master window like 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.

### Fields: Resource Definition

The fields in the Display/Maintenance/Create new Resource Master window are described in the following table:

Field | Meaning
--- | ---
Resource | Name of the resource. You must specify this name when using this resource as a prerequisite for a job.
Type | Type of the resource. Possible selection options:
Quantitative, not reusable | Not reusable, quantitative. The amount of the resource (e.g., paper) used by a job is not released at job completion.
Quantitative, reusable | Reusable, quantitative. The amount of the resource (e.g., address space) used by a job is released at job completion.
Not quantitative (binary) | Not quantitative. The resource is either entirely available or not available (e.g., a database or printer).
Initial Quantity | Initial quantity defined for resources of the type Quantitative, not reusable and Quantitative, reusable. The field is read-only if the amount of the resource is determined by a resource master determination exit. Note The initial quantity can be modified to a value which is less than the currently used quantity.
Used Quantity | Read-only field. Shows the amount of the resource currently in use. This value is useful when you wish to modify an existing resource. If you define a new resource, this field shows 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. The check interval set for the user exit specifies the period (in minutes) between two user exit calls. 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 | Natural library in which the user exit resides. This library should be different from the SYSEOR system library.
Parameter | The content of this field is passed to the resource master determination exit, in the field `P-RMD-PARAMETER` of the NOPXPL-A parameter data area (see User Exits in the User's Guide). Symbols may be used. The escape character is the global activation escape character. The symbols must reside in the global symbol table `RMD-PARM` of the owner `SYSDBA`.
User exit enabled | The resource master determination user exit is only used if it is enabled. If enabled, the initial value of the resource cannot be set manually. Possible check box settings:
checked | Enables the user exit.
unchecked | Disables the user exit.
User exit check interval | 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 | 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 (`0`) is specified (default), no limit applies.
Last Value Determination | Date and time of the last determination of the resource amount by the resource master determination exit (if 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 jobs in which the selected resource is defined as a prerequisite resource. See Listing Jobs Defined for a 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. See Listing Jobs Currently Using a Resource.

### Functions: Resource Definition

The following functions are available on the User exit page of the Maintenance Resource Master window:

Function | Description
--- | ---
Edit | Edit the user exit.
Check Usage | Calculate 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.
Invoke Exit | Invoke the resource master determination exit.

## Using a Resource Master Determination Exit

A resource amount determination exit can be defined for each resource master.

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) resource masters, because the name of the resource is passed as an input parameter to the exit.

You can check whatever you need to determine the resource amount. You can 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 the use of the exit is disabled for a resource, this resource behaves like a resource without exit.

#### Exit Parameter List

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 list 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, the Natural `*TIMX` system variable will be passed.)

- Current maximum amount as known to Entire Operations (in)

- Currently used amount (in)

- New maximum amount (out)

- New used amount (out)

## Listing Jobs Defined for a Resource

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 Maintenance Resource Master window, select the Defined in Jobs tab.

  A Defined in Jobs page like 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.

#### 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 | Initial quantity as defined in the resource master definition (see Fields: Resource Definition).
Type | Type of the resource as defined in the resource master definition (see Fields: Resource Definition).
Owner | Owner, network, network version and job in which the resource is defined as a prerequisite.
Network
Version
Job
Quantity | Amount which is requested 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.

## Listing Jobs Currently Using a Resource

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 Maintenance Resource Master window, select the Active Usage tab.

  The Active Usage page of the Display/Maintenance Resource Master window like 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.

This section covers the following topics:

- Fields and Columns: Active Resource Usage

### 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 | Type of the resource as defined in the resource master definition (see Fields: Resource Definition).
Initial Quantity | Initial quantity as defined in the resource master definition (see Fields: Resource Definition).
Used Quantity | Sum of all amounts of single usages of the resource.
Owner | Owner, network and run number of the active job by which the resource is allocated.
Network
Run
Job
A | Allocation mode. See Resource Allocation Modes in the User's Guide for details.
D | Deallocation mode. See Resource Deallocation Modes in the User's Guide for details.
API | Allocated by a resource API. `Y` indicates that this allocation was made by a resource API call: see NOPURE2N: Handle Resource Allocations in the User's Guide.
Begin | Date and time of the allocation. See also Date and Time Formats in the User's Guide.
Quantity | Allocated quantity.

## Deleting a resource master

To delete a resource master

1. In the object workspace, select a Resource Master instance.

2. Open the context menu and choose Delete, or press DELETE.

   A confirmation window opens.

3. Choose Yes to confirm the deletion or No to cancel the action.

Note:

The deletion of a resource master is allowed only if the resource is no longer used

- in any job master definition;

- in any active job.

### On this page

- Functions: Resource Master
- Listing Resources
- Viewing, Adding and Modifying a Resource Master
- Using a Resource Master Determination Exit
- Listing Jobs Defined for a Resource
- Listing Jobs Currently Using a Resource
- Deleting a resource master