Using explode.sh to Explode the NCOALink Files - VeriMove - 4.0

To explode the NCOA^Link files to your database location using explode.sh, follow these steps:

1. Browse to the location where you installed VeriMove and go to the Tables subfolder. For example, /PB/VeriMove/nlk/Tables.
2. Edit explode.sh as follows.
   1. Omit all quotes from path names. If you leave the INPUTDATAPATH= and NCOADATADESTINATION= values blank, you will be asked for this information in an interactive query mode.
      • Change SET INPUTDATAPATH= to the location of the NCOA^Link data.
      • Change SET NCOADATADESTINATION= to the path where you want to install the NCOA^Link data. This folder is automatically created if it does not already exist. For example, if you are installing the data to /PB/data/USPSDATA, specify SET NCOADATADESTINATION=/PB/data/USPSDATA.
   2. This item only applies if you are exploding the NCOA^Link data from a DVD.

      The explode.sh script defaults to the values required to explode the NCOA^Link data from a location (not DVD). To explode from a DVD, change set USEDVDLOAD=N to set USEDVDLOAD=Y.

   3. The last three items only affect Flat File databases and are otherwise ignored.
      • Change Set MVSONLY=N to Y only if you are installing on an MVS platform. This will avoid a preprocessing step that is needed for other platforms.
      • Change Set FLATSINGLE=N to Y if you are using the Single Flat File database.
      • Change Set FLATATOZ=Y to N if you set FLATSINGLE=Y and do not also want to use the 26 Flat File A-Z database.
   4. In addition, explode.sh includes the following fields for DVD loading:
      • Change exmount="" to the DVD mount command used for your system.
      • Change exunmount="" to the DVD unmount command used for your system.

        Examples of different types of mount and unmount commands are located in explode.sh.

3. Save and close explode.sh under a new name (for example, myexplode.sh) that will not be overwritten by future updates and installations.
4. Run your modified version of explode.sh.
5. One of the following messages displays.
   1. If you are exploding from a location, the following messages displays:

      **************************************

      NCOALink Database Installation Script.

      **************************************

      This script installs an NCOA^Link database from a download location onto your hard drive. This can require up to 20 GBytes of free space on your hard drive.

   2. If you are exploding from a DVD, the following messages displays:

      **************************************

      NCOALink Database Installation Script.

      **************************************

      This script installs an NCOA^Link database from two DVDs onto your hard drive. This can require up to 20 GBytes of free space on your hard drive.

6. The following message displays:
   1. If you are exploding from a location, the following messages displays:

      Folder dst is about to be loaded from the
NCOALink database found at location src

      ******************************************************
WARNING -- If you proceed from this point, all data in
folder dst will be erased first. You may type
Control-C to abort this process now without erasing anything. ******************************************************

   2. If you are exploding from a DVD, the following messages displays:

      Folder dst is about to be loaded from the
NCOALink database found on DVD src

      ******************************************************
WARNING -- If you proceed from this point, all data in
folder dst will be erased first. You may type
Control-C to abort this process now without erasing anything. ******************************************************

      The warning above only displays if the destination folder contains data.

7. The explode.sh process continues as follows:
   1. If you are exploding from a location, the following messages display:

      Copying from location (src) to dst
File copy complete.

   2. If you are exploding from a DVD, the following messages display:

      Insert NCOALink data DVD 1 from the USPS into Drive src

      Press any key to continue

      Copying DVD 1 (src) to dst
DVD 1 copy complete.

      Insert NCOA^Link data DVD 2 from the USPS into Drive src. Press any key to continue.

      Copying DVD 2 (src) to dst
DVD 2 copy complete.

8. After the NCOA^Link data has been copied, the .zip (zipped) files are automatically expanded. Then, the .szp (USPS-compressed) files are expanded. Afterward, a series of preprocesses and tests are performed. If there are errors, one of the following messages displays:

   **** FILE NOT FOUND: filename
   **** ERROR COPYING FILE: filename
   **** ERROR PROCESSING FILE: filename
   **** ERROR: message

   This message is followed by:

   FAILURE!!!
   Press any key to continue

9. If the message indicates that there is a file in the VeriMove installation folder missing, there was a problem with your NCOA^Link data explode process. There may have been a problem copying the NCOA^Link data from the source location.

   A process called "TestFileSha" produces a file called TablesTestFileSha.log in the parent folder of the folder containing these scripts. This file contains detailed descriptions of the tests performed and any errors that have occurred. If an error occurs, the following message displays:

   **** ERROR: Verifying Data File Signatures

   If you get this message, the data files indicated in the log file were corrupted. You may have corrupted NCOA^Link data and need to replace the download source (downloaded file or DVD).

10. If there are no problems with these various processes and tests, the following message displays to indicate that the process completed. You must still check the log file generated during the explode process to ensure the explode process ran error free.

    SUCCESS!!!
    Press any key to continue