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

• Listing Resources

• Adding and Modifying a Master Resource

• Using a Resource Master Determination Exit

• Listing Jobs Defined for a Resource

• Listing Jobs Currently Using a Resource

• Deleting a Master Resource

Related 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

---

Listing Resources

To list available resources

• Select the option Resources from the System Services Menu.

  A Resources screen appears with a list of resources which are already defined to the system:

  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.

This section covers the following topics:

Columns: Resource Master List

The columns of the Resources screen are described in the following table:

Column	Meaning
Cmd	One-character line command input field. See Line Commands: Resources.
Resource	Name of resource. This can reflect real resources or can describe a fictitious resource. In the field beginning with an asterisk (*), just beneath this heading, you use an asterisk as wildcard to enter selection criteria for the resource names.
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 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 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 resource master determination exit.

Adding and Modifying a Master Resource

To add a new master resource

1. On the Resources screen, press 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, press 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. Press PF5 (Save) to save the modified resource. Press 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 of the Resource Definition 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 values:
	U	Not reusable, quantitative. Amount of resource used by job is not released at job completion (e.g.: Paper)
	R	Reusable, quantitative. Amount of resource used by job is released at job completion (e.g.: Address Space)
	N	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 U and R. The field is protected and shown as information 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	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.
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. See the field help. The exit execution can be forced with a line command.
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 SYSDBA / RMD-PARM.
Exit enabled	The resource master determination user exit is only used if it is enabled by by entering Y (Yes) in this field. If enabled, the initial value of the resource cannot be set manually. N (No) disables the user exit.
Exit Check Interval	The 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	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 (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 exit is 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 master resource 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 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.

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.

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

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

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:

  05.11.08 ***** Entire Operations ***** 09:40:20 Active Resource Usage ------------------------------------------------------------------------------ Resource R-20 Type R Quantity initial 777.00 used by total used 20.01 Cmd Owner Network Run Job D A Begin _ SN RES-PRQ 165 J1 J 18.06 09:38 20.00 _ SN RES-PRQ 165 J2 J 18.06 09:38 0.01 _ _ _ _ _ _ _ _ _ _ ******************************* 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.

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	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).
Total Used Quantity	Sum of all amounts of single usages of the resource.
Cmd	Line command input field: see Line Command: Active Resource Usage.
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. 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. 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 Master Resource

To delete a master resource

1. Enter D in the line command input field of the selected resource in the list of resources and press ENTER. A window opens in which you can confirm deletion by entering the resource name.

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

• in any job master definition

• in any active job.