"@(#)chkobs.txt	1.2	2007/02/02 NGS"
----------------------------------------------------------------------
            DOCUMENTATION for NGS program chkobs

     formerly released as "NEWCHKOB VERSION 1.3.8 MARCH 1995"
----------------------------------------------------------------------


PROGRAM FUNCTION:
----------------------------------------------------------------------
Purpose:  To perform a check for correct structure and syntax
on a horizontal Blue Book Observation data set.

NGS program chkobs is based upon the Federal Geodetic Control Committee's 
publication Input Formats and Specifications of the
National Geodetic Survey Data Base (Blue Book), vol. I, chapter two, 
September, 1994.  This edition of the blue book redefined the
SSN as a four digit number.  All references to a suffix were deleted.

Chkobs requires a horizontal Blue Book (Vol 1) observation data set 
and produces a list of error messages as output.  You
should edit your data set until you are satisfied with the
results of a subsequent run.

Many error messages are simply warnings or informational
messages and may not warrant a correction to the data set.
This program does not update the Blue Book Observation data 
set, that must be done by editing the data set.


PROGRAM OPERATION:
----------------------------------------------------------------------

A. INPUT

   1.  A standard Blue Book observation data set.

   2.  User specified output filename

   3.  Abbreviation file - a sequential file of abbreviations of
       contributors of geodetic control data and is equivalent to
       Blue Book vol. I, Annex C. This file is named CONTRIB.DAT.
       This file should reside in either the current directory, or in a
       directory defined in the system's path during the program run.

   4.  Potential error file - is a direct access file and is named
       NEWERROR.DIR.
       This file should reside in either the current directory, or in a
       directory defined in the system's path during the program run.

       CONTRIB.DAT and NEWERROR.DIR will be supplied to the user and are
       automatically accessed when running the program.

B.  OUTPUT

    1.  A successful run will have an output listing consisting
of error and  warning messages along with an image of the actual
record that initiated the message.  Typically, the message
identifies the specific record columns that are in question.

This is an example of an output from a Newchkob ver 1.3.8 run:

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

NGS program chkobs  Version: 2.1    Date(ccyy/mm/dd): 2006/10/31
Page    1   processing input file - pacs.bbk



 Datum                   Ellipsoid       a         1/f       b
 NAD 1983               GRS 1980         6378137.0029825722            

 -------------------------------------------------------------------------------


1                                                                            2



 Summary of Record Counts:

 Number of *10* Records =      1
 Number of *11* Records =      0
 Number of *12* Records =      1
 Number of *13* Records =      1
 Number of *20* Records =      5
 Number of *21* Records =      0
 Number of *22* Records =     16
 Number of *25* Records =      0
 Number of *26* Records =      0
 Number of *27* Records =      0
 Number of *28* Records =      0
 Number of *29* Records =      0
 Number of *30* Records =      0
 Number of *31* Records =      0
 Number of *32* Records =      0
 Number of *40* Records =      3
 Number of *41* Records =      0
 Number of *42* Records =      3
 Number of *45* Records =      0
 Number of *46* Records =      0
 Number of *47* Records =      0
 Number of *50* Records =      0
 Number of *51* Records =      0
 Number of *52* Records =      4
 Number of *53* Records =      0
 Number of *54* Records =      0
 Number of *55* Records =      0
 Number of *60* Records =      0
 Number of *61* Records =      0
 Number of *70* Records =      3
 Number of *80* Records =      7
 Number of *81* Records =      0
 Number of *82* Records =      6
 Number of *83* Records =      2
 Number of *84* Records =      7
 Number of *85* Records =      0
 Number of *86* Records =      0
 Number of *90* Records =      5
 


1                                                                            3


          1         2         3         4         5         6         7         8
 12345678901234567890123456789012345678901234567890123456789012345678901234567890
 --------------------------------------------------------------------------------

 052 CC 50-50 LOCAL TIME ZONE INVALID,  A-I, K-Z ALLOWED SEE ANNEX H             
 000070*22*000101                             123000002    V08  111253200    0085

 063 CC 69-72 SEC OF HOR DIRECTION INVALID FLOATING POINT NUMBER                 
 000083*22*000102                                  0010    V04  15606330o    0120

 039 CC 69-72 SEC INITIAL DIRECTION INVALID FLOATING POINT NUMBER                
 000090*20*000201      04        0100000800221     0001    V09  00000000o    0080

 432  PERIPHERAL POINT HAS NO DISTANCE CONNECTION WITH ITS PARENT STATION        
 000280*82*0004RANDELL RM 1                        0001                          

 411       THIS STATION IS UNPOSITIONABLE (LESS THAN TWO ENTRIES)                
 000280*82*0004RANDELL RM 1                        0001                          

 Summary from program Newchkob:
 Number of records in input file =    66, Number of errors found =     5

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

    2.  An unsuccessful run may occur from an I/O error and not
have any output.  Examples of an unsuccessful run due to I/O
errors:

"Error in opening input blue book file" 

     Possible resolution:  incorrect file name indicated.

"Error in opening program output file" 

     Possible resolution:  This should be a new file and should
not exist prior to this run, you may have a duplicate filename.

"Error in opening direct access error message file - NEWERROR.DIR"

     Possible resolution:   The file may not be on the
default disk. 

"Error in opening temp direct access output blue book file"

     Possible resolution:  This is a temporary file used only for
the duration.  There may be a duplicate filename.

"Error in opening temp sequential output error file"

     Possible resolution:  This is a temporary file used only for
the duration.  There may be a duplicate filename.


C.  EXECUTING CHKOBS

   Hardware requirements:

   a.  At least one floppy disk drive and a hard disk
                      or
       two floppy disk drives.
   b.  At least 276K of main memory.
   c.  The 8087 math co-processor.
   d.  A printer (80 characters/line).

The user will be supplied with a floppy disk containing 3 files:

    CHKOBS.EXE, CONTRIB.DAT and NEWERROR.DIR 

The user should load these onto the PC's hard disk.

If you do not have a hard disk, the drive that this disk is
inserted into should be set as the default drive.

   To execute: 
   enter  CHKOBS   
   with no parameters and function and usage are displayed: 

   NGS program chkobs   Version: x.x    Date(ccyy/mm/dd): 20xx/xx/xx
     Checks a horizontal (Vol 1) bluebook observation dataset 
     for correct structure and syntax
   Usage: chkobs <input bbk filename> <output filename>

   Supply the input and output filenames to run the program.


   The output will exist on the user specified file.
   This file can be reviewed with any text editor.

   Review printed listing of error messages, edit the input data set
   and then run Newchkob again.  Continue this procedure until all of
   the error messages have been corrected or addressed to your
   satisfaction.


chkobs.txt - end
----------------------------------------------------------------------

