Messages DSHG00 through DSHGxx

This group includes messages for the Control-D, Control-D/Image, and Control-D/Page on Demand products.

DSHG80I CLEANING OF MIGRATED USER REPORTS LIST FILE STARTED

Explanation: This information message indicates that the CTVCLMIG utility, which cleans entries from the Migrated User Report List file, has started.

Corrective Action: No action is required.

DSHG82E LOCATE ERROR FOR "dsn", RC=rc

Explanation: The CTVCLMIG utility encountered a CDAM file name that could not be found in the catalog. The dsn data set may have been deleted or uncataloged.

The dsn data set is ignored.

Corrective Action: Check the output of the CTVCLMIG utility, and try to resolve the problem.

DSHG83I CLEANING OF MIGRATED USER REPORTS LIST FILE ENDED OK

Explanation: This information message indicates that the CTVCLMIG utility, which cleans entries from the Migrated User Report List file, has ended without errors.

Corrective Action: No action is required.

DSHG84S CLEANING OF MIGRATED USER REPORTS LIST FILE ENDED WITH ERRORS

Explanation: The CTVCLMIG utility, which cleans entries from the Migrated User Report List file, ended with errors. The problem is described by earlier messages.

The utility ends with a return code of 08.

Corrective Action: Check the earlier error messages, correct the problem, and rerun the job.

DSHG85S INVALID INPUT PARAMETER

Explanation: An invalid parameter was specified in the PARM field of the EXEC JCL statement activating the CTVCLMIG utility and passed to the CTVCLMIG utility. The only valid parameter values are MIG or blank.

The utility ends with a return code of 08.

Corrective Action: Correct the JCL and rerun the job.

DSHG86W NOLOCATE OPTION IS NOT ALLOWED WHEN TAPE LIST IS REQUIRED

Explanation: The NOLOCATE parameter was specified for the CTVCLMIG utility while the utility was being used to produce a list of expired tapes. To produce a list of expired tapes, CTVCLMIG must issue a LOCATE option for migrated files.

LOCATE is issued for the migrated files.

Corrective Action: Refer to the INCONTROL for z/OS Utilities Guide to determine what parameters are required for CTVCLMIG to produce a list of current tapes. Adjust the utility parameters as necessary and rerun CTVCLMIG.

DSHG88I READING SYSDATA RECORDS

Explanation: This information message indicates that the CTVCLMIG utility started reading SYSDATA records. To calculate the time used for this stage of the utility, compare the time stamp of this message with the time stamp of the next DSHG8AI message.

Corrective Action: No action is required.

DSHG89I num SYSDATA RECORDS READ

Explanation: This information message indicates the number of records in the SYSDATA file.

Corrective Action: No action is required.

DSHG8AI DELETING USER RECORDS

Explanation: This information message indicates that the CTVCLMIG utility started deleting user records. To calculate the time used for this stage of the utility, compare the time stamp of this message with the time stamp of message the next DSHG8BI message.

Corrective Action: No action is required.

DSHG8BI DELETING SYSDATA RECORDS

Explanation: This information message indicates that the CTVCLMIG utility started deleting SYSDATA records. To calculate the time used for this stage of the utility, compare the time stamp of this message with the time stamp of the next DSHG8CI message.

Corrective Action: No action is required.

DSHG8CI num USER RECORDS READ

Explanation: This information message indicates the total number of records that have been read.

Corrective Action: No action is required.

DSHG8DE SYSDATA RECORD NOT FOUND FOR USER RECORD userName jobName ODATE= recordOdate UKEY= recordKey

Explanation: During a run of the CTVCLMIG utility, Control-V found a USER record with no matching SYSDATA record. Unless requested by means of the NOSYS parameter, the utility scans all user records in the Migrated User Report file, and checks if each has a matching SYSDATA record. If a SYSDATA record is not found, this message is issued and the user record is deleted.

The variables in this message are:

• userName - User name for the report entry.
• jobName - Job name for the report entry.
• recordOdate - ODATE for the report entry.
• recordKey - Full key for the report entry.

The user record is deleted. IOA should not be able to delete SYSDATA records from the User screen.

Corrective Action: Investigate the cause of this error. This error may indicate a problem with the SORT utility used by the CTVCLMIG utility.

DSHG8EE SYSDATA RECORD NOT FOUND FOR INDEX RECORD jobName ODATE = odate XKEY = key

Explanation: During a run of the CTVCLMIG utility, Control-V found an index record with no matching SYSDATA record. The CTVCLMIG utility scans all index records in the Migrated User Report List file and checks if they have a matching SYSDATA record.

The variables in this message are:

• jobName - the job name for the index record
• odate - the ODATE for the index record
• key - the index key for the index record

The index record and the index file are deleted. IOA should not be able to delete SYSDATA records from the User Report List screen.

Corrective Action: Investigate the cause of this error. If the cause is not found, contact BMC Customer Support.

DSHG8FE USER RECORD IS NOT FOUND FOR SYSDATA RECORD jobName ID jobId ODATE= odate XKEY= counter

Explanation: The Migrated User Report file contains an "orphan" SYSDATA record, meaning a record that is not referred to by any USER record.

This message might also be issued when the CTVCLMIG utility is called with the NOSYS parameter set to S.

The variables in this message are:

• jobName - the name of the job to which the orphan SYSDATA record belongs
• jobId - the MVS identifier of the job to which the orphan SYSDATA record belongs
• odate - the originating date of the report to which the orphan SYSDATA record belongs
• counter - the counter part of the orphan SYSDATA record key

The orphan SYSDATA record is removed from the Migrated User Report file.

Corrective Action: No action is required.

DSHG8GE CONTROL-M/TAPE API START ERROR RC= rc REASON= rsn URC= urc

Explanation: An error occurs when the CTVCLMIG utility tries to start the Control-M/TAPE interface CTTAPI.

The variables in this message are:

• rc - return code from CTTAPI
• rsn - reason code from CTTAPI
• urc - user reason code from CTTAPI

The CTVCLMIG utility ends with a return code of 08.

Corrective Action: Perform the following steps:

1. Examine the return and reason code to identify the problem. Refer to message CTT203I for an explanation of these codes.
2. Correct the problem.
3. Rerun the utility.

DSHG8HE CTT SCRATCH ERROR dsname VOL= volser LAB= label RC= rc REASON= rsn URC= urc

Explanation: An error occurs when the CTVCLMIG utility calls CTTAPI to scratch data set dsname stored on volume volser with seq.number label.

The variables in this message are:

• dsname - the data set name
• volser - the volume name
• label - the sequence number of the volume
• rc - return code from CTTAPI
• rsn - reason code from CTTAPI
• urc - user reason code from CTTAPI

The CTVCLMIG utility continues to work.

Corrective Action: Perform the following steps:

1. Examine the return and reason code to identify the problem. Refer to message CTT203I for an explanation of these codes.
2. Contact your INCONTROL administrator.

DSHG8IE CTT SCRATCH ERROR VOLSER= volser RC= rc REASON= rsn URC= urc

Explanation: An error occurs when the CTVCLMIG utility calls CTTAPI to scratch volume volser.

The variables in this message are:

• volser - the volume name
• rc - return code from CTTAPI
• rsn - reason code from CTTAPI
• urc - user reason code from CTTAPI

The CTVCLMIG utility continues to work.

Corrective Action: Perform the following steps:

1. Examine the return and reason code to identify the problem. Refer to message CTT203I for an explanation of these codes.
2. Contact your INCONTROL administrator.

DSHG8KE PARAMETER CTT IS SPECIFIED WHEN CONTROL-M/TAPE IS NOT ACTIVE

Explanation: The user specified the CTT parameter to the CTVCLMIG utility to notify Control-M/Tape of deleted Control-V data sets or released volumes, but Control-M Tape is not active in the system.

The CTVCLMIG utility ends with a return code of 08.

Corrective Action: Start the CTTINIT procedure to activate Control-M/TAPE. Then rerun the CTVCLMIG utility.

DSHG8ME PARAMETER CTT IS SPECIFIED WHEN PARAMETER CTVINTR IN CTTPARM IS NONE

Explanation: The user specified the CTT parameter to the CTVCLMIG utility to notify Control-M/Tape of deleted Control-V datasets or released volumes, but parameter CTVINTR in the CTTPARM member is set to NONE.

The CTVCLMIG utility ends with a return code of 08.

Corrective Action: Check the CTTPARM member. Refer Control-M/Tape experts to set the needed value of the parameter CTVINTR. Then rerun the CTVCLMIG utility.

DSHG8NE INVALID EXPDATE PARAMETER

Explanation: An invalid date is specified in the EXPDATE parameter or this parameter is specified in the PROD mode, although it should be specified in the TEST mode only.

The CTVCLMIG utility ends with a return code of 12.

Corrective Action: Correct the EXPDATE parameter and rerun the utility.

DSHG8PW FILE dsName MOVED FROM vsavol TO catvol OUTSIDE OF CONTROL-V

Explanation: The CTVCLMIG utility detected an expired migrated file, which was moved from the tape volume to which it was migrated to another volume outside of Control-V. This warning message is issued when the utility runs in the modes LOC=NOLOCATE and TAPELIST=YES.

The variables in this message are:

• dsName - Migrated dataset name.
• vsavol - Volume serial number to which the file was migrated.
• catvol - Volume serial number where the file currently resides.

Corrective Action: This message warns the user that the list of expired tapes issued by the utility can be incorrect. The user should try to find out if the vsavol tape volume has been completely moved to catvol, or only some files have been moved to catvol. In the first case, the list of expired tapes issued by the utility is correct and the message can be ignored. In the second case, the message means that the list of expired tapes issued by the utility can be incorrect and should not be used. If the migrated files are moved from one tape volume to another outside of Control-V, CTVCLMIG can issue a correct list of expired tapes in LOC=LOCATE mode only.