Descriptions and Formulas

KRH_BCDS_Record_Not_Found

The backup request for a data set failed with RC = 80 ERROR FINDING BCDS RECORD - A return code = 80 indicates BCDS RECORD NOT FOUND and the backup for the data set failed. It is recommended that you perform an audit of the Backup Control Data Set, review the reported errors and apply the corrective action. A return code = 80 indicates BCDS RECORD NOT FOUND and the backup for the data set failed. It is recommended that you perform an audit of the Backup Control. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 80 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Backup_Held

The backup request for a data set failed with RC = 74 BACKUP HELD - A return code = 74 indicates that the backup for this data set failed because backup processing was being held in DFSMShsm. If backup processing is held in error, issue HSEND RELEASE BACKUP to allow backup processing to begin again then re-try the migration request. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 74 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Bkup_Failed_For_DSN

The backup request for a data set failed with RC = 58 BACKUP FAILED FOR DATABASE - A return code = 58 indicates a backup failed for a specific data set. It is recommended that you verify the integrity of the data set in question and verify the availability of any prior backups. To verify the integrity of the data set, open/close the data set which verifies access the data. Additional actions could include re-creating the data set in question, auditing the data set, or attempting to dump or print the data in question. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 58 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Bkup_Funct_Disabled

The backup request for the data set failed with RC = 40 BACKUP FUNCTION DISABLED - Verify that the DFSMShsm backup function is not stopped or disabled. If the DFSMShsm backup function is stopped, issue the HSEND RELEASE BACKUP command. You will also want to report this incident to your DFSMShsm Administrator. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 40 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Cant_Mv_Bkup_Miss_Vol

The backup request for a data set failed with RC = 4 CAN'T MOVE BACKUP, MIGVOL NOT AVAILABLE - Verify that space is available on ML1 volumes. If no ML1 space is available, add additional volumes or migrate data sets directly to ML2. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 4 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Cant_Recover_w_NewName

The backup request for a data set failed with RC = 57 CANNOT RECOVER WITH NEWNAME - Return code = 57 suggests a recover with a newname was unsuccessful. Correct and verify the newname and then re-issue the command. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 57 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_DS_Not_Elig_For_Bkup

The backup request on a data set failed with RC = 20 DATA SET NOT ELIGIBLE FOR BACKUP - Verify the data set being requested for backup is eligible for backup. Additional recommendation is to issue the HBACKDS command to force a backup copy or to monitor and review the next day's successful backup report. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 20 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Data_Set_In_Use

The action requested on a data set had a return code = 19 DATA SET IN USE - Verify the data set is not in use and re-issue the failing request (HMIGRATE or HBACKUP). Additional recommendation would be verifying that the scheduled DFSMShsm Automatic functions are scheduled correctly. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'MIGRATE' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 19 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Data_Set_In_Use

The action request on a data set failed with RC = 19 DATA SET IN USE - Verify that the data set is not in use and re-issue the failing request (HMIGRATE or HBACKUP). Additional recommendation is to verify that the scheduled DFSMShsm Automatic functions are scheduled correctly. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 19 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Duplicate_DSN_In_MCDS

The migration request of a data set failed with RC = 6 DUPLICATE DSN IN MCDS - It is recommended that you audit your Migration Control Data Set and correct reported errors. After you have corrected the reported errors, issue the HMIGRATE command to force the migration. If the request fails, review failure and take appropriate actions. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'MIGRATE' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 6 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Error_Editing_CDS

The action request on a data set failed with RC = 1 UNKOWN ERROR TYPE - Verify all catalog and DFSMShsm chains and records are healthy and accurate. If problem persists contact IBM Support. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 1 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Existing_DS_Delete_Err

Deletion request of a data set failed with RC = 59 EXISTING DS DELETE ERR - A delete was requested and failed. Verify all chains and records are healthy and accurate. If problem persists contact IBM Support. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECOVER' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 59 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Ext_Record_Missing

The migration request of a data set failed with RC = 31 EXTENTION RECORD MISSING IN TTOC - It is recommended that you audit the TTOC (tape) in error. When the audit is complete, re-issue the request. If the problem persists contact IBM Support. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 31 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Fail_In_Bkvol_Dump

The action request a volume failed with RC = 84 FAILURE IN BACKVOL DUMP PROCESS - This is a critical BACKVOL DUMP error. Review and correct cause for failure and re-issue BACKVOL request. If problem persists contact IBM Support The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 84 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Insuff_Sp_On_Trg_Vol

The action request on a data set failed with RC = 24 INADEQUATE SPACE ON TARGET VOLUME - Verify there is available space on target volume. When space is available on target volume, re-issue request. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 24 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_L0_Vol_Not_Available

The action request on a data set failed with RC = 66 L0 VOLUME NOT AVAILABLE - Verify that the L0 volume is online and accessible. When the volume is available, re-issue the request. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'MIGRATE' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 66 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Mig_Copy_Already_Exist

The migration request of a data set failed with RC = 12 MIGRATION COPY ALREADY EXISTS - It is recommended that you audit your Migration Control Data Set. DFSMShsm is trying to migrate a data set that is already migrated. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'MIGRATE' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 12 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Mig_Vol_Not_Avail

The action request on a data set failed with RC = 3 MIG VOL NOT AVAILABLE - DFSMShsm is issuing a recover command and the migration volume copy cannot be found. Verify that the attributes of the data set are correct. It is also recommended you audit you Backup Control Data Set. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 3 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Migration_Held

The migration request of a data set failed with RC = 74 MIGRATION HELD - Verify and restart the Migration process using HSEND RELEASE MIGRATION. You should also notify your DFSMShsm Administrator of the error. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'MIGRATE' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 74 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_No_Mig_Vol_Available

The action request a data set failed with RC = 5 NO MIGRATION VOLUME AVAILABLE - Verify there is space available in your migration pool. When there is sufficient available space in the migration pool, re-issue the request. Additional actions could be to migrate the data set directly to tape if the data set is too large for the migration pool.123456987984376986239632964324NO MIGRATION VOLUME AVAILABLE - Verify there is space available in your migration pool. When there is sufficient available space in the migration pool, re-issue the request. Additional actions could be to migrate the data set directly to tape if the data set is too large for the migration pool.123456987984376986239632964324NO MIGRATION VOLUME AVAILABLE - Verify there is space available in your migration pool. When there is sufficient available space in the migration pool, re-issue the request. Additional actions could be to migrate the data set directly to tape if the data set is too large for the migration pool.123456987984376986239632964324 The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'MIGRATE' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 5 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_No_Pri_Vol_Avail

The action request on a data set failed with RC = 4 NO PRI VOL AVAILABLE - A request for recall was issued for a data set and no primary volume was available. Verify that there is a primary volume available and then re-issue the request. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 4 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_No_Pri_Vol_Avail

The action request on a data set failed with RC = 4 NO PRI VOL AVAILABLE - A request for recall was issued for a data set and no primary volume was available. Ensure that there is a primary volume available and then re-issue the request. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECOVER' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 4 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_No_Space_In_Mig_Vol

The migration request of a data set failed with RC = 37 NO SPACE ON MIG VOL - DFSMShsm tried to migrate a data set to the L1 pool and there was no space available. It is recommended that you either make space available in the pool (by adding new volumes) or migrate the data set directly to ML2. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'MIGRATE' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 37 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_No_Space_On_Bkup_Vol

The backup request of a data set failed with RC = 37 NO SPACE ON BACKUP VOL - DFSMShsm tried to migrate a data set to the L1 pool and there was no space available. It is recommended that you make space available in the pool by adding new volumes. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 37 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_No_Uni_Avail

The action request on a data set failed with RC = 50 NO UNIT AVAIL - DFSMShsm tried to recover a data set and found a problem with the UNIT Address. Verify the UNIT address and re-issue the command. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECOVER' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 50 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_No_Unit_Avail

The action request on a data set failed with RC = 50 NO UNIT AVAIL - DFSMShsm tried to recover a data set and found a problem with the UNIT Address. Verify the UNIT address and re-issue the command. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 50 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_No_Vol_For_Bkup

The action request on a data set failed with RC = 5 NO VOLUME AVAILABLE FOR BKUP - DFSMShsm tried to back up a data set and found no volume available. Verify that there is available space in your ML1 pool and there are tape volumes available. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 5 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Recall_Delete_Held

The action request on a data set failed with RC = 74 RECALL:DELETE HELD - DFSMShsm issues a recall of a data set and failed because the RECALL function is held. Issue the HSEND RELEASE RECALL command, and report this to your DFSMShsm Administrator. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 74 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Recall_Delete_Held

Action request on a data set failed with RC = 74 RECALL:DELETE HELD - DFSMShsm issues a recall of a data set and failed because the RECALL function is held. Issue the HSEND RELEASE RECALL command and report this to your DFSMShsm Administrator. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECOVER' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 74 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Recall_Recover_Error

The action request on a data set failed with RC = 99 RECALL: RECOVERY ERROR - A request is being asked of DFSMShsm for a UNSUPPORTED data set. Correct the data set attributes and re-issue the request. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 99 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Recall_Recovery_Err

Action request on a data set failed with RC = 99 RECALL: RECOVERY ERROR - A request is being asked of DFSMShsm for a UNSUPPORTED data set. Correct the data set attributes and re-issue the request. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECOVER' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 99 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Recover_Failed

The action request on a data set failed with RC = 58 RECOVER FAILED - A recover request was issue and failed by DFSMShsm. It is recommended that you verify there is a valid backup of the data set failing the request. If the problem persists contact IBM Support. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 58 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Recover_Failed

The action request on a data set failed with RC = 58 RECOVER FAILED - A recover request was issue and failed by DFSMShsm. It is recommended that you verify there is a valid backup of the data set that failed the request. If the problem persists contact IBM Support. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECOVER' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 58 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Request_Vol_Not_Avail

The action request on a data set failed with RC = 21 REQUESTED VOLUME UNAVAIL - A RECALL or RECOVER request was submitted to DFSMShsm and volume being requested is not available. Verify that the requested volume is available and then re-submit the request. If the problem persists contact IBM support. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 21 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Restore_Failed

The action request on a data set failed with RC = 88 RESTORE FAILED - A recover command was issued and failed. It is recommended that you verify a valid backup exists and re-issue the command if available. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_LOG_RECALL_DETAIL.ACTION *EQ 1,'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 88 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Unsupported_Data_Set

The action request on a data set failed with RC = 99 UNSUPPORTED DATA SET - A request was set to DFSMShsm on a data set that is unsupported. Corrective action could include re-allocating the data set, correcting the attributes, or opening and closing the data set. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'MIGRATE' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 99 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

KRH_Unsupported_Data_Set

The action request on a data set failed with RC = 99 UNSUPPORTED DATA SET - A request was set to DFSMShsm on a data set that is unsupported. Corrective action could include re-allocating the data set, correcting the attributes or opening and closing the data set. The default configuration has the following SQL syntax:

*IF ( ( *STR KRH_RETURN_CODE_SUMMARY.ACTION *EQ 1,'BACK-UP' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 99 ) ) 

This situation is evaluated every 1 minute.

This situation is available for distribution.

Related topics:

Organization of the predefined workspaces