Restore an Individual $STDLIST or Report from a Backup Set

 

The first step in restoring an individual file is to determine which POSIX filename to restore.  This is easily done with the SHOWDELETELOG command in the STATUS program. 

 

Always sign on as MGR.NSD in the PUB group when performing maintenance in the NSD account.  Parts of this document may sound complex, but just follow along.  You can’t really hurt anything.  You may leave the JobPak job running while performing these commands.

 

The SHOWDELETELOG command displays which $STDLISTs and reports have been deleted from JobPak, when they were deleted, and their POSIX filename.  The limit for each deletion log is 100,000 records, and after the log is filled, it is renamed and a new log is created. 

 

The current deletion log is always named DELTELOG.PUB.NSD, and prior deletion logs are named DLOG####.PUB.NSD.  Do a LISTF in the PUB group to see what their names are.

 

The SHOWDELETELOG command defaults to displaying the current deletion log.  You may optionally specify the name of a previous DLOG#### file on the command line.

 

If you are using both JobRescue and ElectroPage, then both reports and $STDLISTs will be displayed by the SHOWDELETELOG command.  The syntax for displaying only $STDLISTs is:

 

        >>SHOWDELETELOG  $STDLIST:MYJOB,MYUSER.MYACCT

 

Note the colon character after the spoolfilename.  This delineates it from the name of the job.  To search for a deleted report you would replace the word $STDLIST with the spoolfile report name.

 

To display deleted $STDLISTs from the 2nd deletion log, you would use:

 

        >>SHOWDELETELOG $STDLIST:MYJOB,MYUSER.MYACCT  LOG=DLOG0002.PUB.NSD

 

Once you have entered the command the display will look something like:

 

Posix-Base-Filename   Job#   FileDes  JobName  User.Account      Saved  Purged

A.89394.989000546.cmp J5     $STDLIST MYJOB    MYUSER.MYACCT     080504 081010

A.89458.989255365.cmp J3     $STDLIST MYJOB    MYUSER.MYACCT     080507 081013

A.89486.989342097.cmp J10    $STDLIST MYJOB    MYUSER.MYACCT     080508 081014

 

Note the filename on the left.  It may have a “.cmp” on the end or it may not.  The “Purged” date should help you in locating which backup set you will restore from.  The dates are YYMMDD format.  Obviously you would want to pick a backup set created after the file was saved, but before it was deleted.

 

The syntax for restoring is shown for standard MPE STORE/RESTORE.  If you use other backup software then you will have to adjust the syntax accordingly.

 

The are two examples given, one where the NSD/files# directories are on the system volume set, and the other where they are stored on a user volume set.  Use the appropriate syntax.  Note the @ after the last digit in the filename – this allows restoration regardless of the “.cmp” which may be at the end.  If you use the wrong syntax, don’t worry, nothing bad will happen except that nothing will be restored and you’ll have to do it again.

 

To restore the job named MYJOB, saved on 080507 as shown in the example above, where it was stored on the system volume set, sign on as MGR.NSD and use this syntax:

 

RESTORE ; /NSD/files#/A.89458.989255365@ ; SHOW

 

And for a user volume set use:

 

RESTORE ; /NSD/USERVOL/files#/A.89458.989255365@ ; SHOW

 

Make sure you use the “SHOW” syntax so that you can see the name of the file being restored.  The directory name and the end of the filename are important in the next steps.  Make a note of the name of the file that was restored.  You will need to supply the whole filename with the directory in the next syntax.  The filename displayed by the restoration will have a specific “files” directory and the end of the filename may or may not have a “.cmp” on it.  Always use the filename and path information displayed from the restore.

 

Now that the file is restored, to get it back into the STATUS program use the following command (in the STATUS program).   Always use the /NSD/files syntax even if you restored using /NSD/USERVOL/files syntax.  Do not insert the USERVOL directory name.  Again, you can’t hurt anything here, it’s just that nothing will happen if the syntax isn’t right.  As a rule, the number of the files directory corresponds to the last digit in the first set of numbers in the filename.

 

            STATUS

      >>RETRIEVE /NSD/files8/A.89458.989255365.cmp 

 

The file is now accessible in the STATUS program.  It will most likely be deleted after the next merge cycle because it is dated older than the normal retention allows.  To prevent this you may use the NEWDATE syntax, which will give the file a current date and prevent it from being removed so soon.

 

            >>RETRIEVE /NSD/files8/A.89458.989255365.cmp NEWDATE

 

To find the file in the STATUS program, as it may not be in a log, use the SHOWALL syntax:

 

            >>SHOWALL MYJOB,MYUSER.MYACCT

 

Note the file number so that you may open it.

 

 

Call or write us at support@nobix.com with any questions.