MWW -- WDB Tape to WDB Master Files

Transfers World Databank data from mag tape to master World Databank .SEQ and .REL disk files.

PARAMETERS

MWW is controlled by the following global parameters: 

Name     Prompt                                  Count     Type
WD2DIR   World Databank II Directory             0-64      Char
CONT     Continent: NA/SA/EU/AS/AF               1-2       Char

WD2DIR

Specifies directory where the input files reside. 

 EASI>WD2DIR="...string..."

CONT

Specify the continent that is to be put on master disk file: 

 EASI>CONT="NA"
options: 

                "NA" - North America
                "SA" - South America
                "EU" - Europe
                "AS" - Asia
                "AF" - Africa

TAPE FORMAT

The World Databank II tapes are produced by the Central Intelligence Agency -- Office of Geographic and Cartographic Research, and are available through the U.S. Department of Commerce at the following address: 

        Computer Products Support Office
        National Technical Information Service
        U.S. Department of Commerce
        5285 Port Royal Road
        Springfield, VA 22161

        (703) 557-4850  TELEX 89-9405
The data is divided into 5 geographic areas, each available separately (on a separate tape). The tapes are 9-track, 1600 BPI, odd parity, EBCDIC. The 5 geographic areas and their respective files (data is broken down into various forms by file) are:

Volume 1: North America 

            File 1: CIL (Coastlines, Islands, and Lakes)
                 2: RIV (Rivers)
                 3: BDY (International Boundaries)
                 4: PBY (Internal Boundaries)
Volume 2: South America 

            File 1: CIL (Coastlines, Islands, and Lakes)
                 2: RIV (Rivers)
                 3: BDY (International Boundaries)
Volume 3: Europe 

            File 1: CIL (Coastlines, Islands, and Lakes)
                 2: RIV (Rivers)
                 3: BDY (International Boundaries)
Volume 4: Africa 

            File 1: CIL (Coastlines, Islands, and Lakes)
                 2: RIV (Rivers)
                 3: BDY (International Boundaries)
Volume 5: Asia 

            File 1: CIL (Coastlines, Islands, and Lakes)
                 2: RIV (Rivers)
                 3: BDY (International Boundaries)
The format of the data is in 20-byte records which form line indicators and Lat/Long pairs. For example: 

                 11111111112         11111111112
        1234567890123456789012345678901234567890
        +---------------------------------------
        3015010 1    66    0364559N 12 319E    1
20 unit records 

        Columns  1 -  7  Line Segment Number
                 8 -  9  Rank
                10 - 15  Number of Points in Line
                16 - 20  Zeros

        Columns  1 -  7  Latitude  (DDMMSSI)
                 8 - 15  Longitude (DDDMMSSI)
                16 - 20  Point Number
The preceding information has been taken from the WDB II General Users Guide by Alexander J. Gourney.

FILE FORMAT

The .SEQ and .REL files produced by this program are currently system dependent direct (random) access files that act as an intermediate step in transferring date into PCIDSK vector segments. The .SEQ file contains information about the vectors and pointers to the beginning of the coordinate data. The coordinates themselves are stored in the .REL file.

SEQ file

Each line of the file is composed as follows: 

 LINEID,RANK,POINTS,START,LLAT,LLNG,ULAT,ULNG

 LINEID  (Int)   is the ID number of the line.
 RANK    (Int)   is the rank of the line (refer to WDB Users
                 Guide for more information on RANK).
 POINTS  (Int)   is the number of coordinate pairs in this
                 line.
 START   (Int)   is the start record number in the .REL file
                 of the coordinate data for this line.
 LLAT    (Real)  is the lower latitude  boundary of the line.
 LLNG    (Real)  is the lower longitude boundary of the line.
 ULAT    (Real)  is the upper latitude  boundary of the line.
 ULNG    (Real)  is the upper longitude boundary of the line.

REL file

The file is composed as follows: Each record contains up to 50 Lat/Lng pairs in REAL format, with vectors having more than 50 coordinate pairs spanning several records. The starting record number for each vector is stored as START in the appropriate record in the SEQ file. 

 v1y01,v1x01, v1y02,v1x02, ... ,v1y50,v1x50
 v1y51,v1x51, v1y52,v1x52, ... ,v1yk ,v1xk
 v2y01,v2x01, v2y02,v2x02, ... ,v2ym ,v2xm
 v3y01,v3x01, v3y02,v3x02, ... ,v3y50,v3x50
 v3y51,v3x51, v3y52,v3x52, ... ,v3yn ,v3xn
   :     :      :     :    ...    :     :
The preceding example shows the first three vectors in the REL file with example lengths of: 

 100    >       Vector-1        >       50      length = k
  50    >       Vector-2                        length = m
 100    >       Vector-3        >       50      length = n

DETAILS

MWW is a task that reads World Databank tapes and stores the data on a series of relative and sequential files.

Before you run MWW, you must be aware that the output files will will be given names in accordance with the PACE parameters WDFF, WDSB, and WDRB.

WDFF is the front of the filespec (i.e., the part in front of the filename). For instance, this might contain the device and account in the syntax of your operating system.

WDRB and WDSB are the backs or extensions of the relative and sequential files respectively.

Note: If MWW aborts because of a tape drive error or an internal read error, delete the files that were read and rerun MWW. In reading the tape, different read errors may happen in different parts of the tape during separate runs. MWW can recover from some read errors. If there were any recoverable read errors in the program run, a warning is displayed after the program completes. The type of read error, the action taken, and possible results are as follows:

EXAMPLE

For instance, if you want the North American continent:

...First mount the correct mag tape... 

 EASI>CONT="NA"
 EASI>WDFF=" ...the syntax of your system...
 EASI>WDRB=" ... "
 EASI>WDSB=" ... "
 EASI>RUN MWW
Depending on your system, the output files may have the following names: 

 PCI:[WDB]NA?.SEQ        - VAX/VMS
 PCI:[WDB]NA?.REL        - VAX/VMS
 D:\DEMO\NA?.SEQ         - PC
 D:\DEMO\NA?.REL         - PC
 /pci/wdb/NA?.SEQ        - UNIX Systems
 /pci/wdb/NA?.REL        - UNIX Systems
NA represents the continent name. The "?" will be replaced by a number ranging from 1 to 4, depending on what sort of World Data Bank information is contained in the file.

The information associated with each number is: 

 1 - (coastline, islands and lakes)
 2 - (rivers)
 3 - (international boundaries)
 4 - (internal boundaries) only for North America
Each file is direct access. For the .SEQ file, the record length is 32 bytes; for the .REL file the record length is 400 bytes. Each file is unformatted.

About PCI Help Gateway