The RM.1 Job Resource Management panel lets you list, add, update, or delete resource connections by job. The panel generates the VRM static type J and R records that are maintained on the database.
To display the panel, enter:
To exit the panel:
-------------------------- CA-7 JOB RESOURCE MANAGEMENT ----------------------- FUNCTION ====> (FORMAT,LIST,UPD) JOB: LIST-SCHID: PAGE 0001 OPT SCHID RESOURCE NAME STEPNAME TYPE FREE OPTIONS: A=ADD D=DELETE U=UPDATE *=PROCESSED ?=ERROR PROGRAM: RSC1 MSG-INDX: 00 -- RM.1 -- yy.ddd / hh:mm:ss MESSAGE: ENTER FUNCTION, TRANSFER OR ENTER A COMMAND ON THE TOP LINE
This panel contains the following fields:
Specifies the function to perform. Value must be the name of some other panel or one of the following values:
Clears the panel of user input data.
Lists the resources that are connected to the specified job and schedule ID.
Performs the updating option that is indicated by the OPT parameter that follows.
Batch keyword: Positional parameter
Specifies the job name on which the indicated function is performed.
Limits: 1 to 8 alphanumeric characters
Batch keyword: JOB
(Optional) Applies only to the LIST function. A SCHID value of 0 applies to connections for all schedules and therefore is listed with connections for any schedule ID requested. Schedule IDs on each detail line apply to that line only.
Default: Null (causes connections for all schedule IDs to appear).
Limits: 1 to 3 numeric characters from 0 through 999
Batch keyword: Not applicable
Used with the UPD function, denotes the type of connection operation. The operation codes are A (add), U (update), and D (delete).
Batch keyword: OPT
(Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message issued by CA WA CA 7 Edition.
Default: 0 (indicates that the requirement holds for all schedule IDs)
Limits: 1 to 3 numeric characters from 0 through 999
Batch keyword: SCHID
Specifies the resource name being connected to the job.
Limits: 1 to 44 characters. The first character must be nonblank and no embedded blanks.
Exception: If the resource connection is made to a resource count resource, the resource name can be from 1 to 39 characters followed by a / (slash) and a 1 to 4 numeric value indicating the number of occurrences for the resource that the job will use.
Batch keyword: RSRC
(Optional) Specifies the resource is freed at the conclusion of the named job step. Not valid for types ASX and CRQ.
Limits: 1 to 8 alphanumeric characters
Batch keyword: STEP
Note: The stepname field applies to the first occurrence of the stepname encountered in the job stream. This includes any reference to the stepname embedded in a PROC.
If a job is restarted in a step after this STEPNAME, the resource does not go through free processing until the job completes.
A step flush condition does not post the STEPNAME process.
Determines the usage of the resource by the job. The valid resource usage types are:
Specifies an address space resource. This controls the submission of the job based on the status of an address space.
Note: The address space resource requirement is only valid on the host CPU where CA WA CA 7 Edition is executing.
Specifies a corequisite resource. The job cannot be submitted if the resource is active or inactive (see the FREE option). The corequisite resource must be activated or deactivated using the PRSQA or PRSQD command. This can be performed in an online or batch environment.
Specifies an exclusive resource. Only one job can be active with this resource.
Specifies a resource count resource. This controls the submission of the job based on the number of available occurrences within a resource count type resource when adding a resource count resource connection. The resource name can be from 1 to 39 characters followed by a / (slash) and a 4-character numeric value indicating the number of resource occurrences this job will use.
Specifies a shared resource. Multiple jobs can be active with the same resource.
Specifies a variable definition. It does not define a necessary resource condition for the job. The FREE value will be forced to N. The resource name for such a resource must conform to the following format:
x Defines the name of an IBM WLM scheduling environment (1 to 16 characters). This value should follow IBM conventions governing names of scheduling environments.
Batch keyword: TYPE
Determines how VRM manages resource availability at job submission and job/step completion. Different values are supported depending upon the type of resource defined.
For shared and exclusive resources the following FREE options are supported. There is no default.
Specifies the resource is only freed if any step in the job abends (abend or condition code checking).
Specifies the resource is freed when job ends, either successfully or unsuccessfully. If the STEPNAME parameter is specified, free the resource when the specified step completes, either successfully or unsuccessfully.
Specifies do not free the resource at successful job completion. The resource can be freed with the PRSCF command. A cancel of the job also frees the resource.
Specifies to free the resource at successful job completion. If the STEPNAME parameter is specified, free the resource when the specified step completes successfully (does not abend).
For corequisite resources, the following FREE options are supported:
Specifies the job is submitted only if the resource is active (as established by the PRSQA command). This is the default.
Specifies the job is submitted only if the resource is not active.
For address space resources, the following FREE options are supported:
Specifies the job is submitted only if the resource is active on the same system as CA WA CA 7 Edition. The resource name is assumed to be a jobname or started task name running on the system. This is the default.
Specifies the job is submitted only if the resource is not active on the same system as CA WA CA 7 Edition. The resource name is assumed to be a jobname or started task name running on the system.
For variable resources, the FREE option is not used and is always set to N regardless of any value specified.
For resource count resources, the following FREE options are supported. There is no default.
Specifies the resource count is only decremented when the job abends.
Specifies the resource count is decremented when the job completes, either successfully or unsuccessfully. If the STEPNAME parameter is specified, the resource count is decremented when the specified step completes, either successfully or unsuccessfully.
Specifies the resource count is not decremented when the job completes. The PRSCF command can be used to decrement the resource count. A cancel of the job also decrements the resource count.
Specifies the resource count is decremented when the job or step ends successfully. If the STEPNAME parameter is specified, the resource count is decremented when the specified step completes successfully (does not abend).
Batch keyword: FREE
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|