CHGJOBMLBA (Change Job Media Library Attributes)

CHGJOBMLBA Command syntax diagram

 

Purpose

The Change Job Media Library Attribute (CHGJOBMLBA) command allows a user to change the media library resource allocation attributes for the specified job. More information about using this command is in the Use tape library article in the Information Center.

 

Restrictions

1. The job being changed must have the same user profile as the user issuing the command, or the issuer must have job control special authority (*JOBCTL).
   
2. Only a user with job control special authority (*JOBCTL) can change the RSCALCPTY value.

 

Optional Parameters

JOB

Specifies the job whose media library attributes are to be changed. If no job qualifier is given, a search for the simple job name is made of all of the jobs currently in the system. If duplicates of the specified name are found, a list of messages that contains the qualified job names of all duplicates is displayed.

A job identifier is a special value or a qualified name with up to three elements. For example:

*
job-name
user-name/job-name
job-number/user-name/job-name

More information on this parameter is in Commonly used parameters.

*: This job whose information is changed is the job from which this command is entered.

job-name: Specify the name of the job whose attributes are being changed. If no job qualifier is given, all of the jobs currently in the system are searched for the simple job name. If duplicates of the specified name are found, a qualified job name must be specified.

user-name: Specify the name of the user of the job whose attributes are being changed.

job-number: Specify the number of the job whose attributes are being changed.

MLB

Specifies the tape media library device whose attributes are to be change.

*ALL: The attribute change is to apply to all the media library devices.

tape-media-library-device-name: Specify a tape media library device whose attributes are to be changed.

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: Retrieve the value from the device description.

*JOB: The priority of the job is used as the resource allocation priority.

resource-allocation-priority: Specify the priority this job is given when requesting a resource. Valid values range from 1 (highest) through 99 (lowest).

INLMNTWAIT

Specifies the maximum amount of time a request will wait for allocation of a tape resource for the initial mount. If the initial mount wait time has not been changed for a media library device for the job, *DEV is used.

*SAME: The value does not change.

*DEV: Retrieve the value from the device description.

*JOB: The allocation 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.

initial-mount-wait-time: Specify the number of minutes a request will wait for allocation of a tape resource. Valid values range from 1 through 600 minutes.

EOVMNTWAIT

Specifies the maximum amount of time a request will wait for allocation of a tape resource for the end of volume mount. If the end of volume mount wait time has not been changed for a media library device for the job, *DEV is used.

*SAME: The value does not change.

*DEV: Retrieve the value from the device description.

*JOB: The allocation 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.

end-of-volume-mount-wait-time: Specify the number of minutes a request will wait for allocation of a tape resource. Valid values range from 1 through 600 minutes.

Examples for CHGJOBMLBA

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.

Error messages for CHGJOBMLBA

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