Descriptions and Formulas

KRH_No_Mig_Vol_Available The action request a dataset failed with a return code = 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. The default configuration has the following SQL syntax:

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

This situation is evaluated every minute.

KRH_Duplicate_DSN_In_MCDS The migration request of a dataset failed with a return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'MIGRATE' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 6 ) ) 

This situation is evaluated every minute.

KRH_Mig_Copy_Already_Exist The migration request of a dataset failed with return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'MIGRATE' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 12 ) ) 

This situation is evaluated every minute.

KRH_Data_Set_In_Use The action requested on a dataset 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'MIGRATE' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 19 ) ) 

This situation is evaluated every minute.

KRH_No_Space_In_Mig_Vol The migration request of a dataset failed with return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'MIGRATE' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 37 ) ) 

This situation is evaluated every minute.

KRH_L0_Vol_Not_Available The action request on a data set failed with a return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'MIGRATE' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 66 ) ) 

This situation is evaluated every minute.

KRH_Migration_Held The migration request of a dataset failed with return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'MIGRATE' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 74 ) ) 

This situation is evaluated every minute.

KRH_Unsupported_Data_Set The action request on a data set failed with a return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'MIGRATE' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 99 ) ) 

This situation is evaluated every minute.

KRH_Cant_Mv_Bkup_Miss_Vol The backup request for a dataset failed with a return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 4 ) ) 

This situation is evaluated every minute.

KRH_No_Vol_For_Bkup The action request on a dataset failed with a return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 5 ) ) 

This situation is evaluated every minute.

KRH_Data_Set_In_Use The action request on a dataset failed with a return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 19 ) ) 

This situation is evaluated every minute.

KRH_DS_Not_Elig_For_Bkup The backup request on a dataset failed with a return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 20 ) ) 

This situation is evaluated every minute.

KRH_Ext_Record_Missing The migration request of a dataset failed with return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 31 ) ) 

This situation is evaluated every minute.

KRH_No_Space_On_Bkup_Vol The backup request of a dataset failed with a return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 37 ) ) 

This situation is evaluated every minute.

KRH_Bkup_Funct_Disabled The backup request for the data set failed with return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 40 ) ) 

This situation is evaluated every minute.

KRH_Bkup_Failed_For_DSN The backup request for a data set failed with a return code = 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 dataset, 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 58 ) ) 

This situation is evaluated every minute.

KRH_Backup_Held The backup request for a data set failed with a return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 74 ) ) 

This situation is evaluated every minute.

KRH_BCDS_Record_Not_Found The backup request for a data set failed with a return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 80 ) ) 

This situation is evaluated every minute.

KRH_Fail_In_Bkvol_Dump The action request a volume failed with a return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND  ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 84 ) ) 

This situation is evaluated every minute.

KRH_Unsupported_Data_Set The action request on a data set failed with a return code = 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 ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND ( *VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 99 ) ) 

This situation is evaluated every minute.

KRH_Error_Editing_CDS The action request on a data set failed with a return code = 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 ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 1 ) ) 

This situation is evaluated every minute.

KRH_Mig_Vol_Not_Avail The action request on a data set failed with a return code = 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 ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 3 ) ) 

This situation is evaluated every minute.

KRH_No_Pri_Vol_Avail The action request on a data set failed with a return code = 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 ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 4 ) ) 

This situation is evaluated every minute.

KRH_Request_Vol_Not_Avail The action request on a data set failed with a return code = 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 ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 21 ) ) 

This situation is evaluated every minute.

KRH_Insuff_Sp_On_Trg_Vol The action request on a data set failed with a return code = 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 ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 24 ) ) 

This situation is evaluated every minute.

KRH_No_Unit_Avail The action request on a data set failed with a return code = 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 ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 50 ) ) 

This situation is evaluated every minute.

KRH_Cant_Recover_w_NewName The backup request for a data set failed with a return code = 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 ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 57 ) ) 

This situation is evaluated every minute.

KRH_Recover_Failed The action request on a data set failed with a return code = 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 ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 58 ) ) 

This situation is evaluated every minute.

KRH_Recall_Delete_Held The action request on a data set failed with a return code = 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 ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 74 ) ) 

This situation is evaluated every minute.

KRH_Restore_Failed The action request on a data set failed with a return code = 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 ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 88 ) ) 

This situation is evaluated every minute.

KRH_Recall_Recover_Error The action request on a data set failed with a return code = 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 ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECALL' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 99 ) ) 

This situation is evaluated every minute.

KRH_No_Pri_Vol_Avail The action request on a data set failed with a return code = 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 ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECOVER' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 4 ) ) 

This situation is evaluated every minute.

KRH_No_Uni_Avail The action request on a data set failed with a return code = 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 ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECOVER' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 50 ) ) 

This situation is evaluated every minute.

KRH_Recover_Failed The action request on a data set failed with a return code = 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 ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECOVER' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 58 ) ) 

This situation is evaluated every minute.

KRH_Existing_DS_Delete_Err Deletion request of a data set failed with a return code = 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 ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECOVER' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 59 ) ) 

This situation is evaluated every minute.

KRH_Recall_Delete_Held Action request on a data set failed with a return code = 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 ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECOVER' ) *AND ( *VALUE KRH_LOG_RECALL_DETAIL.RETCODE *EQ 74 ) ) 

This situation is evaluated every minute.

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

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

This situation is evaluated every minute.

See also:

Organization of the Predefined Workspaces