DFSMShsm Error Detail Report
The DFSMShsm Error Detail Report shows all unsuccessful actions that were processed by DFSMShsm during the specified time period, with error codes and a description of the error.
| Purpose | Reports all unsuccessful actions during a time period |
|---|---|
| Data source | Log extract file(s) |
| Initial order | Ascending on type of action, system ID, data set name, date, and time |
| Report name verb | ERROR_DETAIL |
| Member name | SRMBR005 |
The report classifies DFSMShsm actions into seven categories. The report entries are sorted first on the category value, so that all migration actions are displayed together, all recall actions are displayed together, and so on, and then sorted on system ID, data set name, and date/time. The default sorting can be overridden by using the SORT command or report customization; the report can be isolated to a single action or action type by filtering on the category or action fields.
See the DFSMShsm report option keywords and report matrix for a list of the report option keywords that are available on this report.
The following table provides action and category descriptions found in the Error Detail report.
Action and category descriptions
DFSMShsm action | Action code | Category code |
|---|---|---|
Migration ML0 to ML1 ML1 to ML2 ML0 to ML2 Failed migrate | MIGRATE 0->1 MIGRATE 1->2 MIGRATE 0->2 MIGRATE SPCMGMT | MIGRATION |
Recall ML1 to ML0 ML2 to ML0 | RECALL 0<-1 RECALL 0<-2 | RECALL |
Backup daily Spill Failed backup | DAILY BACKUP SPILL BACKUP BACKUP | BACKUP |
Recovery | RECOVERY | RECOVERY |
Volume dump | FULL VOL DUMP | DUMP |
Restore data set volume | VOL/DS RESTORE | RESTORE |
Delete migrated data set Delete data set by age Data set deleted by age Failed delete Scratched by SPCMGMT Recycle backup Recycle migration volume | DELETE MIG DS DS DEL BY AGE EXPIRED DELETE SCRATCH RECYCLE BACKUP RECYCL MIG VOL | OTHER |
Note
Although many data fields are displayed in the error report, some of the fields might be empty, depending on what data had been collected by DFSMShsm when the error occurred.
If SHOWCAT(Y), data sets that are no longer cataloged show dashes in the current volume fields. These data sets might have been deleted and might not need to be considered for corrective action.
The following table presents a field list for the DFSMShsm Error Detail Report.
Field list for the DFSMShsm Error Detail Report
Column heading | Field name | Description |
|---|---|---|
Data setname | DSN | Data set name. |
Brief Error Description | ERRDESC | Short error description is preceded by a category abbreviation, as follows: M migrationB backup, dumpR restore, recover, recallO all other actions |
Func Category | FUNCCAT | Functional category assigned for the purpose of sorting actions into groups. |
Rtn Code | RTNCODE | DFSMShsm return code. |
Rea Code | REACODE | DFSMShsm reason code, if any. |
Action | ACTION | Description of the DFSMShsm action. |
Current Volume | CURVOL | First or only volume on which the data set currently resides. If the data set is migrated, MIGRAT is shown; if the data set is no longer cataloged, dashes are shown; VSAM clusters are shown with *VSAM*. If SHOWCAT(N) is specified, this field is blank. |
From Volume | FROMVOL | Volume from which the data set was processed. |
To Volume | TOVOL | Volume to which the data set was processed. |
Last Used Date | LSTUSEDT | Date the data set was last used. |
Date Char | DATECHAR | Date the data set was last changed. |
Time Char | TIMECHAR | Time the data set was last changed. |
Age | AGE | Number of days since the data set was last referenced or used. |
Size Read | SIZER | Size, in megabytes, of the data set as it was read. Zero is reported for zero-length data sets; 1MB is reported for data sets less than 1 megabyte in size. (This field is usually zero for errored actions.) |
Size Writ | SIZEW | Size, in megabytes, of the data set as it was written. Zero is reported for zero-length data sets; 1MB is reported for data sets less than 1 megabyte in size. (This field is usually zero for errored actions.) |
Mgmt Class | MGMTCLAS | Current management class of DFSMS-managed data set. If the data set is not DFSMS-managed or is no longer cataloged, the class is not shown. Note that this information is taken from the catalog at the time the report is generated and might not be the same as when the DFSMShsm action was actually processed. If SHOWCAT(N) is specified, this field is blank. |
Stor Class | STORCLAS | Current storage class of DFSMS-managed data set. If the data set is not DFSMS-managed or is no longer cataloged, the class is not shown. Note that this information is taken from the catalog at the time the report is generated and might not be the same as when the DFSMShsm action was actually processed. If SHOWCAT(N) is specified, this field is blank. |
Pool Storgroup | STOGROUP | Pool or storage group: the pool or DFSMS storage group to which the data set’s volume belongs. For pools, the name is preceded by P:; for DFSMS storage groups, the name is preceded by S:. Note that this information is taken from the system at the time the report is generated and might not be the same as when the DFSMShsm action was actually processed. If SHOWCAT(N) is specified, this field is blank. |
Data Class | DATACLAS | Current data class of DFSMS-managed data sets. If the data set is not DFSMS-managed or is no longer cataloged, the class is not shown. Note that this information is taken from the catalog at the time the report is generated and might not be the same as when the DFSMShsm action was actually processed. If SHOWCAT(N) is specified, this field is blank. |
User ID | USERID | ID of the user associated with the job that caused the DFSMShsm action. |
Job Name | JOBNAME | Name of the job that caused the DFSMShsm action. |
Dsorg | DSORG | Data set organization of the data set. |
Syst ID | SYSTID | ID of the system on which the DFSMShsm action ran. |
The following figure provides a sample of the DFSMShsm Error Detail Report that was run by using the following filters:
ERROR_DETAIL,
NMBRDAYS(180),
SYSTEMID(SYSA),
CONTEXT(SYSACAS3),
SYSPRINT(RPTPRINT)DFSMShsm Error Detail Report
Produced By MainView SRM DFHSM Error Detail Report Page: 1
BMC Software, Inc. Generated:01/19/2005(2005.019)@08:12
Func Rtn Rea Action Current From
Data set name Brief error description Category Code Code Volume Volume
To Last Used Date Time Age Size Size Mgmt Stor Pool/ Data User Job Dsorg Syst
Volume Date (Char) (Char) (read) (writ) Class Class Stogroup Class ID Name ID
------------------------------------------------------------------------------------------------------------------------------------
BB.JCL.LIB M:DATA NOT ELIGIBLE FOR MI MIGRATION 20 4 MIGRATE 0->1 EMP003
NA 2005/01/18 05:31:38 1,257 0 0 SYSA
====================================================================================================================================
BITHAP.BBISPRNT M:UNSUPPORTED DATA SET MIGRATION 99 4 MIGRATE 0->1 BSDW11
NA 2005/01/18 09:01:35 253 0 0 SYSA
====================================================================================================================================
BMCALV1.QA.TPNS.LOG3.GDG.G0081V00 M:DATA SET NOT CATALOGED MIGRATION 30 0 MIGRATE 0->1 BSDW12
NA 2005/01/18 09:01:37 271 0 0 SYSA
====================================================================================================================================
BMCALV1.QA.TPNS.LOG3.GDG.G0084V00 M:DATA SET NOT CATALOGED MIGRATION 30 0 MIGRATE 0->1 BSDW08
NA 2005/01/18 09:01:06 195 0 0 SYSA
====================================================================================================================================
BMCALV1.QA.TPNS.LOG3.GDG.G0219V00 M:DATA SET NOT CATALOGED MIGRATION 30 0 MIGRATE 0->1 BSDW08
NA 2005/01/18 09:01:06 257 0 0 SYSA
********************************************************** End of Report ***********************************************************
Comments
Log in or register to comment.