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 similar to 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

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 of time (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.

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 similar to 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 the 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 similar to 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.