The workdir option on the Configuration menu allows you to see where the working directory used by dmaudit is currently located and gives you the option of moving the directory to a new location. Because the contents of the previous working directory are not preserved during the move, you should only change the location of the directory if you do not intend to use any current snapshot.

To see where the working directory is, type workdir at the Configuration menu prompt.

If you do not have a current snapshot, dmaudit responds with the following:

Currently the working directory 'working_dir' exists within directory
'/usr/tmp'.

Do you wish to change the location of the working directory (y/n)?

If you do have a current snapshot, dmaudit instead responds with the following:

Currently the working directory 'working_dir' exists within directory
'/usr/tmp'.

Changing the location of the working directory at this point will cause your
current snapshot to be discarded. Do you still wish to continue (y/n)?

If you answer n to either question, dmaudit returns immediately to the Configuration menu. If you reply y, dmaudit responds with the following:

Please enter the full path name of an existing directory in which subdirectory
'working_dir' can be created (<CR> to quit):

Enter the full path name of the new directory you want to use. dmaudit verifies that the directory you specified exists. If it does not, or if any other errors are detected, dmaudit describes the nature of the error and then prompts you for a new directory path name.

If at any time you decide not to change the directory, press ENTER to return to the Configuration menu. The original working directory and its contents remain unchanged.

After you have entered a valid path name, dmaudit creates the new working directory, removes the previous directory, and returns you to the Configuration menu.

The filesys option on the Configuration menu is useful when you want to see which file systems dmaudit searches for migrated files, or when you want to add to or subtract from that list. If you enter filesys, you see the following:

SELECT FILE SYSTEMS TO BE SEARCHED
----------------------------------

The following menu allows you to look at and modify the list of file systems to
be scanned by this program when it searches for every migrated file in the
system.

Select:
   <view>   View the current file system scan list
   <edit>   Edit a fresh copy of the file system scan list
   <up>     Return to the previous menu

This menu is very similar to the File System Selection menu displayed during the initial configuration of dmaudit. The view option lets you see the current file system list, and edit allows you to change the list.

Unlike the initial configuration display, this menu does not have an accept option. Instead, any changes to the file system list take effect when you next return to the Main menu. dmaudit must discard any current snapshot when the file system list is modified; if you select edit while a snapshot exists, you are asked to confirm your actions:

Editing the file system scan list at this point will cause your current
snapshot to be discarded. Do you still wish to continue (y/n)?    

A reply of n leaves the current file system scan list unchanged.

---

Note: If you do decide to use edit, be very careful to ensure that all file systems that contain migrated files appear in your new list.

---

“The opt_full and opt_part Options ” in Chapter 7, gives an example of a particular kind of error which can be corrected in one of two ways. The example shows a bfid set with no database entry but the dual-state user file indicates that the online copy of the file is valid.

The bfid set that has one or more invalid database entries (or has no database entry at all) and has a valid copy (online or offline) of the file can be corrected by doing one of the following:

dmaudit uses the first method by default, but you have the option of changing that default value using the invalid selection on the Configuration menu.

If you select invalid, the following menu appears:

SELECT WHETHER INVALID/MISSING MSP COPIES CAN BE REPLACED
    ---------------------------------------------------------
    If this program discovers a file that has
        (a) one or more invalid database entries  or
        (b) no database entries at all
    and also has
        (a) at least one good database entry    and/or
        (b) a good online copy,
    it uses one of the following methods to clean up the discrepancies.


    1. Replace the invalid/missing database entries by recalling the file
       ( or using a good online copy ) and remigrating it to all MSPs whose
       original copies were invalid/missing.

       This method is used by those sites that have a requirement that any
       migrated file must have back-up copies on a particular set of MSPs.

    2. Remove the invalid database entries, leaving any good MSP copies as
       the only back-up copies of the file.   If no valid database entries
       remain, the file becomes a regular file.

       This method is acceptable to some sites, and has the advantage of
       minimizing the amount of MSP activity (such as tape mounts) and
       file system activity (such as file recalls) generated during the
       recovery phase of this program.


    Currently, invalid MSP daemon database entries will be replaced during
    database recovery.


    Select:

       <1>    Replace invalid ( or missing ) MSP daemon database entries
       <2>    Remove invalid MSP daemon database entries
       <up>   Return to the previous menu


    Please enter your selection:

The menu shows you the default method that will be used in all future runs of dmaudit and gives you the option of changing that default. Enter up if you do not want to change the default; otherwise, select the number corresponding to the method you want to use.

Even if you do change the default value, you still will be shown the opt_part and opt_full options when such errors occur, so you still will always have the option of overriding the default value at that time.

The dmfconf option on the Configuration menu displays information from the DMF configuration file that defines the configuration of DMF at your site.

dmaudit collects and saves this information every time a new snapshot is taken, so the dmfconf display is actually showing you the DMF configuration at the time the last snapshot was taken.

The following example illustrates the format of the output of the dmfconf selection. After the information has been displayed, dmaudit automatically returns to the Configuration menu:

DATA MIGRATION CONFIGURATION
----------------------------
Data migration home directory:          /dmf/home
Data migration binaries directory:      /etc/dmf/dmbase/etc

Server name:                            daemon
Server home directory:                  /dmf/home/daemon
Server spool directory:                 /dmf/spool/daemon

Data migration daemon process ID:       68565

MSP name   MSP type     MSP home directory    MSP spool directory
--------   --------     ------------------    -------------------
red        dmatmsp      /dmf/home/red         /dmf/spool/red
dsk        dmdskmsp                           /dmf/spool/dsk
dlt7000m   dmatmsp      /dmf/home/dlt7000m    /dmf/spool/dlt7000m

CONFIGURATION MENU
------------------
You may examine or change any of the configuration options below. Changes take
effect when you return to the main menu.

Select:
   <workdir>   Change the location of the working directory
   <filesys>   View or edit the list of file systems that will be scanned
   <invalid>   Choose whether invalid MSP copies are to be removed
   <backup>    Choose whether backups of removed files must be completed
   <dmfconf>   Display the current DMF configuration
   <remove>    Remove all configuration and snapshot information
   <up>        Return to the main menu

Please enter your selection:

If for some reason you want to remove your dmaudit working directory and configuration file and begin again as if you had never used dmaudit, you can use the remove option on the Configuration menu. The remove option gives you the ability to remove both the working directory and the configuration file used by dmaudit. If you enter this option, you are asked to confirm your actions:

All configuration and snapshot information maintained by this program will be
removed. Do you still wish to continue (y/n)?

If you answer y, all dmaudit configuration and snapshot information is removed, and dmaudit then silently exits. The next time that you run dmaudit you must reconfigure it.