Change Job MLB Attributes (CHGJOBMLBA)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Job MLB Attributes (CHGJOBMLBA) command allows a user to change the media library resource allocation attributes for a job.
Restrictions:
- The job being changed must use the same user profile as the user issuing the command, or the issuer must have job control special authority (*JOBCTL).
- Only a user with job control special authority (*JOBCTL) can change the resource allocation priority.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| JOB | Job name | Single values: * Other values: Qualified job name |
Optional, Key, Positional 1 |
| Qualifier 1: Job name | Name | ||
| Qualifier 2: User | Name | ||
| Qualifier 3: Number | 000000-999999 | ||
| MLB | Library device | Name, *ALL | Optional, Key, Positional 2 |
| RSCALCPTY | Resource allocation priority | 1-99, *SAME, *DEV, *JOB | Optional |
| INLMNTWAIT | Initial mount wait time | 1-600, *SAME, *DEV, *JOB, *IMMED, *NOMAX | Optional |
| EOVMNTWAIT | End of volume mount wait time | 1-600, *SAME, *DEV, *JOB, *IMMED, *NOMAX | Optional |
| Top |
Job name (JOB)
Specifies the name of the job whose attributes are being changed.
Single values
- *
- The job whose information is changed is the job from which this command is entered.
Qualifier 1: Job name
- name
- Specify the job name of the job whose attributes are to be changed.
If no job qualifier is given, all jobs currently in the system are searched for the job name. If more than one occurrence of the specified name is found, a qualified job name must be specified.
Qualifier 2: User
- name
- Specify the user name of the job whose attributes are to be changed.
Qualifier 3: Number
- 000000-999999
- Specify the job number of the job whose attributes are to be changed.
| Top |
Library device (MLB)
Specifies the name of the tape media library device whose attributes are to be changed. The device name must have been created previously on the system using the Create Device Media Library (CRTDEVMLB) command.
- *ALL
- The attribute change is to apply to all the media library devices.
- name
- Specify the name of the tape media library device whose attributes are to be changed.
| Top |
Resource allocation priority (RSCALCPTY)
Specifies the media library device resource allocation priority for this job. If the resource allocation priority has not been changed for a media library device for the job, *DEV is used.
- *SAME
- The value does not change.
- *DEV
- The resource allocation priority will be retrieved from the device description.
- *JOB
- The priority of the job is used as the resource allocation priority.
- 1-99
- Specify the priority this job is given when requesting a resource, from 1 (highest) through 99 (lowest).
| Top |
Initial mount wait time (INLMNTWAIT)
Specifies the maximum amount of time a request will wait for the allocation of a tape resource for the initial mount. If the initial mount wait time has not changed for a media library device for the job, *DEV is used.
- *SAME
- The value does not change.
- *DEV
- The initial mount wait time will be retrieved from the device description.
- *JOB
- The initial mount wait time is determined by rounding the default wait time attribute of the job requesting the allocation to the next highest minute.
- *IMMED
- The request will not wait for a tape resource to become available.
- *NOMAX
- The request will wait until a tape resource is available.
- 1-600
- Specify the number of minutes a request will wait for allocation of a tape resource.
| Top |
End of volume mount wait time (EOVMNTWAIT)
Specifies the maximum amount of time a request will wait for allocation of a tape resource to mount the next volume. If the end of volume mount wait time has not changed for a media library device for the job, *DEV is used.
- *SAME
- The value does not change.
- *DEV
- The end of volume mount wait time will be retrieved from the device description.
- *JOB
- The end of volume mount wait time is determined by rounding the default wait time attribute of the job requesting the allocation to the next highest minute.
- *IMMED
- The request will not wait for a tape resource to become available.
- *NOMAX
- The request will wait until a tape resource is available.
- 1-600
- Specify the number of minutes a request will wait for allocation of a tape resource.
| Top |
Examples
Example 1: Changing the resource allocation priority for the current job
CHGJOBMLBA RSCALCPTY(50)
This command changes the resource allocation priority for all tape media library devices for the current job to 50.
Example 2: Changing the initial mount wait time for a specific job
CHGJOBMLBA JOB(002345/USERX/QDFTJOBD) INLMNTWAIT(2)
This command changes the initial mount wait time for all tape media library devices for the specified job to 2 minutes.
Example 3: Changing the resource allocation priority for all tape media libraries used by the current job
CHGJOBMLBA MLB(*ALL) RSCALCPTY(50)
This command changes the resource allocation priority for all tape media library devices for the current job to 50.
Example 4: Changing the resource allocation priority for a specific tape media library used by the current job
CHGJOBMLBA MLB(TAPMLB01) RSCALCPTY(50)
This command changes the resource allocation priority for TAPMLB01 for the current job to 50.
| Top |
Error messages
*ESCAPE Messages
- CPF1069
- End of duplicate names.
- CPF1070
- Job &3/&2/&1 not found.
- CPF1343
- Job &3/&2/&1 not valid job type for function.
- CPF1344
- Not authorized to control job &3/&2/&1.
- CPF6708
- Command ended due to error.
- CPF6745
- Device &1 not a media library device.
- CPF67B5
- &3/&2/&1 not authorized to change attribute.
- CPF9814
- Device &1 not found.
- CPF9825
- Not authorized to device &1.
| Top |