Example creating special resources
About this task
Follow these
steps to create the TAPES resource:
- Select option 6 from the MAINTAINING DATA BASES menu (EQQODBSP - Maintaining databases).
Figure 1. EQQODBSP - Maintaining databases EQQODBSP ------------------ MAINTAINING DATA BASES --------------------------- Select one of the following: 1 WS - Work station descriptions 2 CALENDAR - Calendar descriptions 3 PERIOD - Period descriptions 4 AD - Application descriptions 5 OI - Operator instructions 6 SPECRES - Special resource descriptions 7 ETT - Event triggered tracking criteria 8 JD - Job descriptions 9 JCLVAR - JCL variable tables 10 RUN CYCLE - Run cycle groups - 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.
Figure 2. EQQQDTOP - Maintaining special resources EQQQDTOP --------------- MAINTAINING SPECIAL RESOURCES ------------------------ Select one of the following: 1 BROWSE - Browse a special resource 2 CREATE - Create a special resource 3 LIST - List special resources for further processing (browse, modify, copy, delete and create)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.
Figure 3. EQQQDLSL - List of special resources EQQQDLSL ----------------- LIST OF SPECIAL RESOURCES --------- Row 1 to 4 of 4 Enter the CREATE command above to create a new resource, or, enter any of the row commands below: B - Browse, M - Modify, C - Copy, D - Delete Row Special Specres A Qty Num cmd Resource group ID Ivl ''' HEIDE.ISPF.PROFILE Y 1 1 ''' HEIDE.OPCESA.EQQDUMP Y 1 1 ''' PAYROLL.DATABASE Y 1 1 ''' RITZMAN.DSCLOSE.TEST Y 1 1 ******************************* Bottom of data ********************************The CREATING A SPECIAL RESOURCE panel is displayed:
Figure 4. EQQQDCRP - Creating a special resource EQQQDCRP ---------------- CREATING A SPECIAL RESOURCE ----------------------- Select one of the following: 1 INTERVALS - Specify intervals 2 WS - Modify default connected work stations SPECIAL RESOURCE ===> tapes_______________________________________ TEXT ===> tape drives__________________________________ SPECRES GROUP ID ===> sample__ Hiperbatch ===> N DLF object Y or N USED FOR ===> B Planning and control C , P , B or N ON ERROR ===> F_ On error action F , FS , FX , K or blank ON COMPLETE ===> _ On complete action Y , N , R or blank MAX USAGE LIMIT ===> 3____ Max number of allocations before usage reset MAX USAGE TYPE ===> N Status change type Y, N or R Defaults QUANTITY ===> 8_____ Number available 1-999999 AVAILABLE ===> Y Available Y or N - 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.
Figure 5. EQQQDWML - Modifying connected work stations for a special resource EQQQDWML - MODIFYING CONNECTED WORK STATIONS FOR A SPECIAL RES Row 1 to 2 of 2 Enter/Change data in the rows, and/or enter any of the following row commands: I(nn) - Insert, R(nn),RR(nn) - Repeat, D(nn),DD - Delete Special resource : TAPES Text : tape drives on CPU1 and STC1 Row Ws cmd ''' CPU1 ''' STC1 ******************************* Bottom of data ********************************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.
Figure 6. EQQQDIML - Modifying intervals for a special resource EQQQDIML -------- MODIFYING INTERVALS FOR A SPECIAL RESOURCE - Row 1 to 3 of 3 Enter any of the row commands below: I(nn) - Insert, R(nn),RR(nn) - Repeat, D(nn),DD - Delete, or, S - Work stations Special resource : TAPES Text : tape drives on CPU1 and STC1 Row Day of From To Qty A cmd week or Date Time Time ''' STANDARD______ 08.00 22.00 6_____ _ ''' SATURDAY______ 00.00 22.00 ______ _ ''' SUNDAY________ 08.00 10.00 ______ N ******************************* Bottom of data ******************************** - 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
Scommand 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.Figure 7. EQQQDWML - Modifying connected work stations for a special resource EQQQDWML - MODIFYING CONNECTED WORK STATIONS FOR A SPECIAL RES Row 1 to 1 of 1 Enter/Change data in the rows, and/or enter any of the following row commands: I(nn) - Insert, R(nn),RR(nn) - Repeat, D(nn),DD - Delete Special resource : TAPES Text : tape drives on CPU1 and STC1 Interval : SATURDAY 00.00 24.00 Row Ws cmd ''' CPU1 ******************************* Bottom of data ******************************** - 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 |
HCL Workload Automation for Z uses,
in order of priority:
- 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.