MEDINF command operands

NAME(medinf_name)

Specifies a name for the media information. Specify a value between 1 and 8 alphanumeric characters. This value is used to match the recorded volume information to the MEDINF installation defined media information. The values defined for MEDIATYPE, RECORDINGFORMAT, and CAPACITY are taken if the assigned media information for a volume matches medinf_name.

Default: None.

MEDIATYPE(mediatype_id,mediatype_name)

Use this operand to identify the internally-used mediatype_id to be converted to the externally-used mediatype_name in reports and in the output of the DFSMSrmm TSO subcommands. Also, use this operand to identify the externally-used mediatype_name to be converted to the internally-used mediatype_id that is recorded in the control data set when used as input to RMM TSO subcommands.

When you specify multiple MEDINF entries that use the same mediatype_id, but with different mediatype_name values, the first such MEDINF entry is used for the internal-to-external conversion. The remaining values are synonyms used for external-to-internal conversions.

mediatype_id is a number in the range from 1 to 255.

mediatype_name is 1 to 8 alphanumeric or national characters.

Default: None. When you do not specify the MEDIATYPE operand, DFSMSrmm displays a mediatype_id of 0 and mediatype_name of *.

RECORDINGFORMAT(recordingformat_id,recordingformat_name)

Use this operand to identify the internally-used recordingformat_id to be converted to the externally-used recordingformat_name in reports and in the output of the DFSMSrmm TSO subcommands. Also, use this operand to identify the externally-used recordingformat_name to be converted to the internally-used recordingformat_id that is recorded in the control data set when used as input to RMM TSO subcommands.

When you specify multiple MEDINF entries that use the same recordingformat_id, but with different recordingformat_name values, the first such MEDINF entry is used for the internal-to-external conversion. The remaining values are synonyms used for external-to-internal conversions.

recordingformat_id is a number in the range from 1 to 255.

recordingformat_name is 1 to 8 alphanumeric or national characters.

Default: None. When you do not specify the RECORDINGFORMAT operand, DFSMSrmm displays a recordingformat_id of 0 and recordingformat_name of *.

CAPACITY(capacity)

Specifies the media capacity in MB available on the non-IBM media that has a media type mediatype_id and a recording format recordingformat_id. Specify a value from 0 to 4294967295.

When you specify a capacity value, DFSMSrmm uses that value to set the capacity of a volume when the volume is added or when the recording format or media type of the volume is manually changed. When new data is written on a volume, DFSMSrmm uses your specified capacity only if the tape drive does not return the volume capacity.

Do not specify the CAPACITY operand on a MEDINF command that specifies the same MEDINF NAME and MEDIATYPE mediatype_id and RECORDINGFORMAT recordingformat_id as an earlier MEDINF command. If you do, an information message EDG0243I is issued at start-up time, the CAPACITY operand is ignored, and the capacity from the earlier entry used instead. When you use synonyms, use the CAPACITY operand only when the combination of MEDINF NAME, MEDIATYPE mediatype_id, and RECORDINGFORMAT recordingformat_id are unique.

Default: When you do not specify the CAPACITY operand, DFSMSrmm displays a capacity of 0.

REPLACE(PERM | TEMP | AGE | WMC)

Use this operand to identify the policies for replacement of volumes based on such values as read and write errors, age, and numbers of times written. Volumes are identified for replacement when one or more of the policy values are met or exceeded.

Do not specify the REPLACE operand on a MEDINF command that specifies the same MEDINF NAME and MEDIATYPE mediatype_id and the RECORDINGFORMAT recordingformat_id as an earlier MEDINF command. If you do, an information message EDG0243I is issued at start-up time, the REPLACE operand is ignored, and the replace policy from the earlier entry is used instead. When you use synonyms, only use the REPLACE operand if the combination of MEDINF NAME, MEDIATYPE mediatype_id and RECORDINGFORMAT recordingformat_id are unique.

When you add or modify a volume replacement policy, DFSMSrmm does not implement it retrospectively. Volumes that are already set with the REPLACE release action are not reprocessed and the action reset. In order to have DFSMSrmm reconsider the policy for all non-pending release volumes, you first have to manually change the REPLACE release action to SCRATCH, and then run EXPROC processing.

When you do not specify replacement policies with MEDINF, DFSMSrmm uses the built-in value of REPLACE(PERM(1)).

You can specify a global REPLACE based on MEDINF NAME. For example:

MEDINF NAME(VEND1) REPLACE(PERM(1) AGE(20))

This policy is applied to all other MEDINF commands that specify the same NAME(VEND1), but do not specify the REPLACE operand. This is enough to override the built-in value of PERM(1) for all media with a MEDNINF name of VEND1.

For IBM media, the hard-coded default of PERM(1) can be overridden by coding a single MEDINF in parmlib. For example:

MEDINF NAME(IBM) REPLACE(PERM(0))

This example disables replacement for IBM media. To implement your own chosen replacement policies, customize the command, and then add it to DFSMSrmm parmlib.

You can also specify a media-level policy for all media of a certain type. You do this by specifying the MEDIATYPE operand without the RECORDINGFORMAT operand, such as the following example:

MEDINF NAME(IBM) MEDIATYPE(1,CST) REPLACE(AGE(30))

This example sets a default value to be used for all media with a mediatype_id of 1.

You can override the global and media level policies by specifying the REPLACE operand for a specific media type and recording format combination.

No matter how you define the MEDINF commands in parmlib, DFSMSrmm LISTCONTROL always lists a REPLACE policy for each MEDINF entry. The way DFSMSrmm determines the values is:

REPLACE is specified on the MEDINF command.
A media level REPLACE policy was specified.
A global REPLACE policy was specified.
The default of REPLACE(PERM(1)) is used.

When inventory management determines the policy to use, it does so as follows:

An exact match to the combination of MEDINF NAME, MEDIATYPE mediatype_id, and RECORDINGFORMAT recordingformat_id.
A match on the combination of MEDINF NAME and MEDIATYPE mediatype_id to a media-level policy.
A match to a global policy based on MEDINF NAME alone.
The default of REPLACE(PERM(1)) is used.

PERM(count)

Use this operand when your policy is to be based on permanent I/O errors. DFSMSrmm compares your value with the sum of permanent read and write errors over the life of the volume.

The value range is 0 to 99999. Specify 0 to disable replacement based on permanent errors.

There is no default value.

TEMP(count)

Use this operand when your policy is to be based on temporary I/O errors. DFSMSrmm compares your value with the sum of temporary read and write errors over the life of the volume.

The value range is 0 to 99999. Specify 0 to disable replacement based on temporary errors.

There is no default value.

AGE(years)

Use this operand when your policy is to be based on the age of the volume. DFSMSrmm compares your value with the volume creation, and current date and time.

The value range is 0 to 99999. Specify 0 to disable replacement based on age.

There is no default value.

WMC(count)

Use this operand when your policy is to be based on how many times the volume is mounted for output and written to. DFSMSrmm compares your value with the write mount count for the volume.

The valid value range is 0 to 65535. Specify 0 to disable replacement based on volume write mount count. Values in the range 65536 to 99999 are accepted, but have the same effect as specifying 0 (replacement based on volume write mount count is disabled).

There is no default value.