iX V6.5 (30391-90011)

414 Chapter8

Using the Database Utilities

DBUNLOAD

Writing Errors

If an unrecoverable write error occurs, DBUNLOAD prints the message:

UNRECOVERABLE WRITE ERROR, RESTARTING AT BEGINNING OF VOLUME

and attempts to recover by starting the current volume again. It also sends this message to

the system operator (where z is the logical device number of the unit):

WRITE PROBLEMS TRY ANOTHER VOLUME ON LOGICAL DEVICE

If an excessive number of non-fatal write errors occur, DBUNLOAD again attempts to recover

from the beginning of the volume after printing the following message on the $STDLIST

and sends the same message to the system operator as described for unrecoverable errors

above:

EXCESSIVE WRITE ERROR RECOVERIES, RESTARTING AT BEGINNING OF VOLUME

Example (Session Mode)

:RUN DBUNLOAD.PUB.SYS

WHICH DATABASE? ORDERS

DATA SET 1: 3 ENTRIES EXPECTED, 3 ENTRIES PROCESSED.

DATA SET 2: 11 ENTRIES EXPECTED, 11 ENTRIES PROCESSED.

END OF VOLUME 1, 0 WRITE ERRORS RECOVERED

DATABASE UNLOADED

END OF PROGRAM

Example (Job Mode)

:JOB MGR.ACCOUNTA

Initiate job.

:RUN DBUNLOAD.PUB.SYS

Initiate execution of DBUNLOAD.

ORDERS

Specify database name.

:EOJ

Initiate end of job.

Because the user in this example is the database creator, a maintenance word is not

provided. The DBUNLOAD program is executed in chained mode by default because no entry

is speciﬁed.

As the job executes, the following information is printed on the $STDLIST: