Example creating special resources
About this task
- Select option 6 from the MAINTAINING DATA BASES menu (EQQODBSP - Maintaining databases).
- Select
option 3 (LIST) on the MAINTAINING SPECIAL RESOURCES menu
(EQQQDTOP - Maintaining special resources). You can select
option 2 (CREATE) instead, but option 3 gives you a chance to see
the resources that already exist.
When you select 3 (LIST), you see the SPECIFYING SPECIAL RESOURCE LIST CRITERIA panel, where you can filter the resources shown in the list. To list all resources, enter * (asterisk) in the SPECIAL RESOURCE and SPECRES GROUP ID fields.
- In the LIST OF SPECIAL
RESOURCES panel (EQQQDLSL - List of special resources ),
enter the CREATE command.
The CREATING A SPECIAL RESOURCE panel is displayed:
- Type values in the fields on the CREATING A SPECIAL
RESOURCE panel:
- SPECIAL RESOURCE
- The name of the resource, up to 44 characters. The name of the special resource is translated to uppercase. You can include national characters in the name, but you are recommended not to include % and *, because HCL Workload Automation for Z uses these for filtering and searching in the panels. It is also good practise not to use the comparison operators: greater-than symbol (>), less-than symbol (<), caret (^), equals sign (=), or blank spaces. These might by used in search arguments passed by programming interface programs.
- TEXT
- A description of the resource, up to 46 characters.
- SPECRES GROUP ID
- The resource group, up to 8 characters. The group ID is for selecting subsets of resources in the panel (a list filter).
- HIPERBATCH
- Whether the resource represents a Data Lookaside Facility (DLF) object, Y or N. See Setting the global values.
- USED FORr
- Whether the resource is used
for:
- P
- Planning, when the current plan is extended
- C
- Control, when an operation starts
- B
- Both planning and control
- N
- Neither planning nor control
- ON ERROR
- What
happens if an operation that allocates this resource ends in error (and does
not have an overriding keep-on-error specification in the operation
definition):
- F
- Free the full allocation of this resource, both those allocated exclusive and those allocated shared
- FS
- Free the full shared allocation of this resource
- FX
- Free the full exclusive allocation of this resource
- K
- Keep the full allocation of this resource
- Blank
- Use the value specified in the ONERROR keyword of the RESOPTS statement. For details, refer to Customization and Tuning.
You might want critical jobs to keep their resources even when they fail, so that there is no delay waiting for resources when they are restarted.
The QUANTITY and AVAILABLE values, at the bottom of the panel, apply to intervals where a quantity or availability is not specified, and apply also to time ranges where there is no interval specified. You can save time by specifying the normal quantity and availability here, and specifying only the exceptions in intervals.
- ON COMPLETE
- The value to
which the global availability is reset after the operation that uses
the resource completes. It can be one of the following:
- Y
- Sets the global availability to Yes.
- N
- Sets the global availability to No.
- R
- Sets the global availability to blank.
- Blank
- Uses the system default, according
to the following order:
- The On Complete value set at operation definition level, if not blank.
- The On Complete value set at special resource definition level, if not blank.
- The ONCOMPLETE or DYNONCOMPLETE keyword value, respectively set for the not dynamically added resources or the dynamically added resources, in all the other cases.
- MAX USAGE LIMIT
- The number of allocations of this resource after which the resource global availability is changed to the value specified by Max Usage Type.
- MAX USAGE TYPE
- The
value to which the global availability of the resource is reset, when
its maximum usage limit is reached:
- Y
- Sets the global availability to Yes.
- N
- Sets the global availability to No.
- R
- Sets the global availability to blank.
- QUANTITY
- 1 to 999999.
- AVAILABLE
- Whether the resource is available, Y or N.
- Enter option 2 on the command line to specify
the default connected
workstations. The MODIFYING CONNECTED WORK STATIONS FOR A SPECIAL
RESOURCE panel, shown in EQQQDWML
- Modifying connected work stations for a special resource ,
is displayed.
When creating the resource, you see an asterisk (*) in the Ws column. This means that the resource is connected, by default, to all workstations. If you want to restrict the resource to named workstations, specify them as shown for TAPES in EQQQDWML - Modifying connected work stations for a special resource .
Note: When an operation is switched to an alternate workstation, when the primary workstation is offline, the operation is still allowed to allocate the resource; the alternate workstation does not have to be in the list of connected workstations. Be sure to check that the resource is physically accessible from the alternate workstation. - Save the default connected workstations by pressing PF3 (End).
- Enter option 1 on the command line of the CREATING A SPECIAL RESOURCE panel to create availability intervals. The MODIFYING INTERVALS FOR A SPECIAL RESOURCE panel, shown in EQQQDIML - Modifying intervals for a special resource , is displayed.
- Type values in the fields of the MODIFYING INTERVALS
FOR A SPECIAL
RESOURCE panel:
- Day of week or Date
- Specify a date in the format
specified in the OPTIONS panel, or
one of these:
- STANDARD (meaning default for the days not mentioned)
- MONDAY
- TUESDAY
- WEDNESDAY
- THURSDAY
- FRIDAY
- SATURDAY
- SUNDAY
- From time and To time
- Specify a time range, with times in the format specified in the OPTIONS panel.
- Qty
- The quantity of the resource in the time interval being specified. The default quantity and availability are those specified in step 4.
- A
- Available (Y) or unavailable (N).
Note: You cannot alter intervals that you have already modified in the current plan, the daily planning job never replaces a changed interval with values from the database. - Enter
the
S
command beside the Saturday interval row to specify that STC1 operations cannot use the resource on that day. The MODIFYING CONNECTED WORK STATIONS FOR A SPECIAL RESOURCE panel, shown in EQQQDWML - Modifying connected work stations for a special resource, is displayed. - Specify the CPU1 resource only. Press PF3 (End) to return to the MODIFYING INTERVALS FOR A SPECIAL RESOURCE panel.
- When you have specified all the intervals, press PF3 (End) to return to the CREATING A SPECIAL RESOURCE panel.
- Press PF3 (End) again to save the resource definition.
Where values are taken from for each interval shows the origin of each value in some intervals for the TAPES resource: whether from the default values, the STANDARD interval, or from a specific interval.
Time | Quantity | Availability | Workstations |
---|---|---|---|
Monday 00.00 to 07.59 | Default | Default | Default |
Monday 08.00 to 22.00 | Standard | Default | Default |
Monday 22.01 to 24.00 | Default | Default | Default |
Saturday | Default | Default | Interval |
Sunday 00.00 to 07.59 | Default | Default | Default |
Sunday 08.00 to 10.00 | Default | Interval | Default |
Sunday 10.01 to 24.00 | Default | Default | Default |
- A specific date and time, if specified
- A specific day and time, if specified
- The STANDARD entry
- The default values
A more specific interval overrides the standard interval and the default values.