Resources

#### Search Results

Search

# Resources

The maintenance functions provided in System Services 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:

- Listing Resources

- 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

## Listing Resources

To list available resources

- From the System Services Menu, select the Resources option and press ENTER.

  A Resources screen like the example below appears:

       12.03.16                ***** Entire Operations *****                12:42:31
       Owner     EXAMPLE                 Resources
       Selection A_________
      -------------------------------------------------------------------------------
       Cmd Resource            Type  Initial        Used Exit     Exit     E  Call
           *-------------------          Qty         Qty Library  Member      Time
        _  AA-XIT               R      10.00             EOR-T531 AA-X0RES Y 13:37
        _  AAAAA                R     123.00             XSETABO1 JCL-2    N
        _  AAAAB                R     456.00                               N
        _  AAAAC                R     789.00
        _  AA1                  R       0.00
        _  ADA-1                N       0.00             EOR531   RMDDBID  Y 15:25
        _  ADA-9                N       1.00             EOR531   RMDDBID  Y 14:22
        _  ADAPROD1             R       0.00
        _  APBAMF-NEXT-JOB      R      10.00                               N
        _  APS-ASSEMBLE         R       1.00
        _  ATEST                U       0.00             AAAA     S        N
       *********************************** m o r e **********************************
       D Delete   E Edit Exit       M Modify   J Defined in Jobs   W Active Usage
       C Check Usage   X Invoke Determination Exit
       Command => ____________________________________________________________

      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Add   End         Save        Up    Down                    Menu

  The screen 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 Resources screen are described in the following table:

Column | Meaning
--- | ---
Cmd | Line command input field. For possible commands, see Line Commands: Resources.
Resource | Name of the resource. This can reflect real resources or can describe a fictitious resource. In the line below the column heading, you can enter selection criteria for the range of names to be listed. See Specifying Filter Criteria in the User's Guide.
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 commands available for user exit usage are described in Fields: Resource Definition and Special PF Keys: Resource Definition.
Exit Member | Natural object of the resource determination user exit. The fields and commands available for user exit usage are described in Fields: Resource Definition and Special PF Keys: 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.

You can maintain resources using available line commands and PF keys.

### Line Commands: Resources

Line Command | Meaning
--- | ---
`D` | Delete resource.
`E` | Edit user exit.
`J` | Show the definition as prerequisite resource for jobs: see Listing Jobs Defined for a Resource.
`M` | Modify selected resource definition.
`W` | Show active resource usage: see Listing Jobs Currently Using a Resource. This line command opens a screen which shows the current usage of the resource by active jobs.
`C` | Check usage. 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.
`X` | Invoke the resource master determination exit.

## 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 add a new resource master

1. On the Resources screen, choose PF2 (Add).

   A Resource Definition window opens.

2. Enter the required definitions.

   The fields and special PF keys available are described in the sections Fields: Resource Definition and Special PF Keys: Resource Definition.

3. When you are finished, choose PF5 (Save) to save the new resource definition.

To modify a resource

1. On the Resources screen, enter `M` in the line input field next to the required resource and press ENTER.

   A Resource Definition window opens with the current resource definition:

       +--------------------------------------------------------+
       |                                                        |
       |                  Resource Definition                   |
       |                                                        |
       |          Resource ==> BOA-RES_____________             |
       |              Type ==> R                                |
       |  Initial Quantity ==> 20.00_____                       |
       |     Used Quantity ==> 0.00                             |
       |                                                        |
       |  Resource Amount is determined by                      |
       |  Exit      ==> ________  in Library ==> ________       |
       |  Parameter ==> ____________________________________    |
       |                        Exit enabled ==> N (Y/N)        |
       |                 Exit Check Interval ==> ______ Min.    |
       |    Maximum number of jobs that will                    |
       |    be awakened from passive waiting ==> ______         |
       |     Last Value Determination ==>                       |
       |                                                        |
       | Enter-PF1---------PF3---------PF5---PF6-------------   |
       |       Help        End         Save  Determ.            |
       +--------------------------------------------------------+

2. You can modify the resource definition by replacing the current values. Choose PF5 (Save) to save the modified resource. Choose PF3 (End) to return to the list of resources.

   For explanations of the input fields and commands available, see Fields: Resource Definition and Special PF Keys: Resource Definition.

### Fields: Resource Definition

The fields in the Resource Definition 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 values:
`U` | Not reusable, quantitative. The amount of the resource (e.g., paper) used by a job is not released at job completion.
`R` | Reusable, quantitative. The amount of the resource (e.g., address space) used by a job is released at job completion.
`N` | 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 `U` and `R`. 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.
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. See the field help. The exit execution can be forced with a line command.
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`.
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 values:
`Y` | Enables the user exit.
`N` | Disables the user exit.
Exit Check Interval | Minimum interval between two determinations of the resource. The overhead of resource determinations increases with smaller intervals. A resource determination can be forced at any time by the line command `X` in the resource list.
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.

### Special PF Keys: Resource Definition

The following special PF keys are available as commands in the Resource Definition window:

PF Key | Meaning
--- | ---
PF3 | Close window; return to resource master list.
PF5 | Save definition.
PF6 | Force resource determination by exit. Invokes the resource master determination exit to determine the current amount of the resource. See also Using a 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 jobs defined for a resource

- On the Resources screen, enter the line command `J` next to the required resource and press ENTER.

  A Resource defined in Jobs screen like the example below appears:

      06.11.08               ***** Entire Operations *****                    09:16:48
                                Resource defined in Jobs

      1.20
       ------------------------------------------------------------------------------
       Resource R-20
                                  Initial Quantity  Type
       defined in                           777.00  R
       Owner      Network    Job          Quantity  Dealloc.  D.if not ok
       SN         RES-PRQ    J1              20.00
       SN         RES-PRQ    J2               0.01

       ******************************* Bottom of Data *******************************

      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help        End                     Up    Down

  The screen shows a list of jobs in which the selected resource is defined as a prerequisite resource.

  The fields and columns on the screen 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 screen 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

- On the Resources screen, enter the line command `W` next to the required resource and press ENTER.

  An Active Resource Usage screen like the example below appears:

       04.12.19                ***** Entire Operations *****                11:44:37
                                   Active Resource Usage
       ------------------------------------------------------------------------------
       Resource HUGO                 Type R                                Quantity
                                                      A          initial    1900.00
           used by                                    P       total used      10.00
       Cmd Owner      Network      Run Job        A D I Begin
        _  SAG        B60-FLOW       5 JOB-01     A K   03.12 17:14            5.00
        _  SAG        B60-FLOW       7 JOB-06     A K   04.12 10:26            5.00

       ******************************* Bottom of Data *******************************
        F Force Release

      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help        End                     Up    Down

  This screen shows a list of active jobs which are currently using a resource.

  The fields and columns on the screen are described in Fields and Columns: Active Resource Usage.

This section covers the following topics:

- Fields and Columns: Active Resource Usage

- Line Command: Active Resource Usage

### Fields and Columns: Active Resource Usage

The fields and columns on the Active Resource Usage screen 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).
Total Used Quantity | Sum of all amounts of single usages of the resource.
Cmd | Line command input field. For possible line commands, see Line Command: Active Resource Usage.
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.

### Line Command: Active Resource Usage

Line Command | Meaning
--- | ---
`F` | Force release of the resource. To be used for a manual release of a resource allocation. Be aware that this may cause the submission of jobs, which wait for this resource.

## Deleting a resource master

To delete a resource master

1. On the Resources list screen, enter `D` (Delete) in the line command input field next to the resource you want to delete, and press ENTER.

   A confirmation window opens.

2. Enter the resource name and press ENTER to perform the deletion and close the window.

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

- Listing Resources
- 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