"@(#)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