HP 3000 Manuals

Silhouette Reference Manual

>RECOVER 

The >RECOVER command rebuilds a database from the backup and the current
logfile.

SYNTAX 

     >RECOVER [configfile] [,optionword]

The syntax of the >RECOVER command depends upon whether the command is
issued in a job stream or interactively.  If it is issued with the INFO=
option of the MPE :RUN command in a UDC, and the recovery is occurring in
a job stream, enter:

     >RECOVER configfile,optionword 

In an interactive session, to specify the configuration file name with
the >SYSTEM command, enter:

     :RUN SILMP.PUB.SYS 

     HP30302 (A.01.00)  Silhouette Manager Program
     (C) COPYRIGHT Carolian Systems International Inc. 1984
     >SYSTEM configfile 
     >RECOVER 

PARAMETERS 

configfile          The name of the configuration file to be recovered.

optionword          The >RECOVER command option to be used.  The available options
                    are:

REPORT              The REPORT option word instructs Silhouette to read the logfile
                    records and produce a normal recovery report without making any
                    changes to the database.  This option generates a report
                    describing the current state of the database.

NOROLLBACK          The NOROLLBACK option word instructs Silhouette to perform a
                    normal recovery without removing incomplete transactions from the
                    database.  The recovered database may be internally inconsistent,
                    but will contain every transaction contained in the logfile.

          (cont.) 

NOROLLFWD           The NOROLLFWD option word instructs Silhouette to consider only
                    the current state of the databases.  For example, any new log
                    records are ignored and any incomplete transactions are rolled
                    back from the current log record.

DISCUSSION 

If the >RECOVER command is issued with no option word, Silhouette
performs the equivalent of the >SWITCH command including the normal
>SWITCH command report.  The database is rebuilt and all incomplete
transactions are removed.  To ensure that recovery using this method is
correct, you must either provide an appropriate SAVE file or establish
that the logfile contains only records which have not already been
applied to the database.

The >RECOVER command checks the configuration file for the name of the
system SAVE file.  If the SAVE file exists, the >RECOVER command uses the
SAVE file record numbers to decide which records in the logfile to
process.  If the SAVE file does not exist, the >RECOVER command processes
all records in the logfile.

EXAMPLE 

The following example shows using the >RECOVER command without any
options.

     HP30302 (A.01.00)  Silhouette Manager Program
     (C) COPYRIGHT Carolian Systems International Inc. 1984
     >SYSTEM configfile
     >RECOVER
     Do you wish to mount a Silhouette transaction tape (Y/N) ?
     N
     #J5
     The recovery was started successfully for configfile. (MPMSG 67)
     >

ADDITIONAL DISCUSSION 

See Chapter 5.

MPE/iX 5.0 Documentation