Error Recovery. Robelle Suprtool 5.7

Below you will find brief information for Suprtool 5.7. Suprtool is a powerful data management utility for extracting, sorting, and manipulating data from various sources. It offers functionalities such as database editing, data export, and multidataset access.

PDF

Document

126 • Suprtool 5.7 for MPE

If you use Control-Y during a Put, Delete, or Update operation, the database locks are still in effect. Do not walk away from your terminal without answering YES or

NO to the "stop" question. If you are Deleting records, you should continue the task unless you don't want the output file. With the output file, you can recover the records back into the dataset by using the Put command.

When you hit Control-Y, MPE must fix Suprtool's stack markers so that you resume where the interrupt occurred. With MPE V, we have received reports of invalidstack-marker aborts in Suprtool, when using Control-Y while reading a dataset. This is probably because the stack-marker format changed in MPE V, and Control-Y has trouble finding the proper one when Suprtool is in Privileged Mode. There is not much you can do except to avoid Control-Y while reading a dataset.

Error Recovery

There are several errors that can occur during a Suprtool "task":

1. The output file fills up.

2. There are invalid packed-decimal or zoned-decimal digits in the input record.

3. There is a duplicate key when writing to a KSAM file.

4. An attempt is made to delete a master dataset entry which still has associated detail entries.

5. Suprtool tries to Put a record to a detail dataset that does not have an associated master entry.

6. An attempt is made to add a master dataset entry which already exists.

7. An attempt is made to delete a dataset record that has changed.

For errors 4 through 7:

If Set Ignore is Off (default), Suprtool prints an error message and stops processing the input file. For KSAM errors, the standard file information display is printed. For

IMAGE errors, Suprtool prints whatever information is available on the record that caused the DBDELETE, DBPUT, or DBUPDATE error (when Set Dumponerror

On).

The information from IMAGE errors may include the input record number, the output record number and the data values of the record. Suprtool uses the current options of the List command to print the data values. If no List command was specified, Suprtool uses the List defaults.

To only see a summary of IMAGE errors that occurred, turn Set Dumponerror Off.

To continue processing, even when errors occur, turn Set Ignore On.

Suprtool Commands