"bbaccur2.doc - 1.5 - 2002/09/13"
----------------------------------------------------------------------------
         DOCUMENTATION FOR NGS PROGRAM  bbaccur2
----------------------------------------------------------------------------

 TO EXECUTE:
   Command line usage:
     bbaccur2 <input filename> <output filename>
   where:
   <input filename>  ADJUST output file
   <output filename> at the user's discretion

   Windows DOS box usage:
     bbaccur2  (user is queried for filenames)


 FUNCTION:
   Program bbaccur2 reads an ADJUST output file, and
   extracts accuracy data for easy inspection and review:
    - the baseline distance between two stations
      (meters; decimal parts are truncated)
    - internal accuracy of the baseline distance (unitless)
    - external accuracy of the baseline distance (unitless)
    - the designation of each station            (30 characters max)
   and prints these in a table format to an output file.

   Internal accuracies are 10 digits, real format.
   External accuracies are 10 digits, real format.

   If the ADJUST data file has QQ records, then this program also extracts:
    - Station Serial Numbers (SSN) for the From and To stations.
    - Survey Order

   This program works for adjust output files, with or without QQ records.
   There are seperate print functions, and header strings for each case.

   The output file is 122 characters wide for the case with no QQ records.
   The output file is 126 characters wide for the case with    QQ records.
   A form feed and a new header is printed to the output file each 60 lines,
   with a page number printed at the top left corner of the new page.
   The "Length Relative Accuracies" type (apriori or aposteriori)
   is as written in the ADJUST output file.

   This program is intended for use with input files containing
   Station Serial Numbers (SSN) of either 4 or 5 digits.

   Program bbaccur2 is intended to supercede programs bbaccur and bbaccur5.
   These programs are no longer supported by NGS.


 INPUT:
   An output file from program ADJUST, eith with or without QQ records.
   This program tests the second, "PROGRAM ADJUST" record, for format type.
   The Adjust version from the third record is only reported, not tested.


 OUTPUT:
   Computer display shows the program run status, similar to:
     NGS program bbaccur2   version: 1.5    date(ccyy/mm/dd): 2002/09/13

     Local system run time: Date: Fri Sep 13, 2002  Time: 15:02:19 pm
     Input  filename:       adjust_out
     Output filename:       bbaccur2.out
     Adjust file ver:       4.16

   If the program is run thru a PC  window, the display time is quite short.
   If the program is run from a DOS window or Unix, the status is displayed.
   The output file is sorted into increasing external accuracy.


 ERROR CHECKS:
   The program checks for the following errors:

   The program will always display the executable version and
   the date of the main source code module (bbaccur2.C).

   For the PC executable, the user can either:
    - enter no paramters, and the program will prompt for the filenames, or
    - enter the input filename and the the output filename.
   Any other number of input parameters
   results in display of detailed program function and usage.

   If the input file cannot be found as entered, then
   the program ends with an error message to display,
   and shows what input filename was entered.

   The second record is inspected for an offset control character
   that is different for PC and Unix versions.
   Failure to detect this control character results in the error message:
      Error: Not able to determine offset control
             See programmer(7).  Program ends
   This program is designed to work with all currently released versions 
   of bbaccur2, including versions 4.16 (public), 4.26, 4.291 (proposed),
   and success with other versions cannot be assured.



bbaccur2.doc - end
--------------------