CHKEXPBRM (Check Expired Media for BRM)
Note: To use this command, have the 5722-BR1 (Backup Recovery and Media Services for iSeries) licensed program installed. For detailed information on the parameters of this command, see the online help.
CHKEXPBRM Command syntax diagram
Purpose
The Check Expired Media for BRM (CHKEXPBRM) command is used to check to see if there is enough expired media to satisfy the media requirements of a save operation. The command calculates the media of a specified media class available for a save operation, taking into account the location of the media based on the location specified in the media policy or a location that you specify. You can calculate the available media for single or multiple media classes, with single or multiple location combinations depending on the values that you specify in the command.
For instance, if you specified 20 in the Required volumes field, FMT2GB in the Media class field and *HOME in the Location field, you would have one media class, location combination. If you changed the Location field to *ANY, you could potentially receive messages about media class availability for each of the locations that you have set up that have the specified media class. If you had a situation where you specified *MEDPCY in the Required volumes field, *CTLGRP in the Media policy field and *ALL in the Control group field, then you would expect to have multiple media class, location combinations. The command returns messages that specify whether enough media is available for each media class, location combination.
This command works in conjunction with the value specified in the Required volumes field. The value can be a specified number of volumes or a special value for media policy. The number of available volumes calculated by the CHKEXPBRM command is compared against the value in the Required volumes field. If the expired media calculated by the CHKEXPBRM command is greater than or equal to the Required volumes field value, the save operation can continue. If the value is less, then the save operation is canceled.
The number of expired volumes can also be checked by user jobs using the CHKEXPBRM command. For example, the CHKEXPBRM command could be incorporated into a job scheduler and used to determine at various times if there is enough expired media available for a save operation.
This command is used by all BRMS save operations.
Example for CHKEXPBRM
Example 1: Checking on Available Volumes
CHKEXPBRM EXPMED(50) MEDCLS(FMT2GB) LOC(*HOME)In this example, you are checking to see if there are 50 expired volumes of media class FMT2GB available for a save operation at the home location.
Error messages for CHKEXPBRM