asa(1)                MPE/iX Shell and Utilities                asa(1)
  ______________________________________________________________________

  NAME
       asa -- interpret ASA/FORTRAN carriage control

  SYNOPSIS
       asa [file...]

  DESCRIPTION
       Historically, print-outs created by ASA/FORTRAN programs use the
       first character of each line to control the spacing between that
       line and the previous one.  For example, if the first character
       is a blank, the rest of that line immediately follows the previ-
       ous line; if it is a 1, that line should begin on a new page, and
       so on.

       The purpose of asa is to read input in this format and write it
       out in a normal text format, using newlines, formfeeds, and car-
       riage returns to achieve the same effects as the ASA/FORTRAN car-
       riage control characters.

       If you specify files on the command line, asa reads input from
       these files; otherwise, it reads the standard input.  asa writes
       output to the standard output.

       This utility does not copy newline characters in the input to the
       output.  Instead, it uses the first character of each line to
       determine how to print the rest of the line.  asa interprets the
       first character as follows, where line is the rest of the line
       after the first character.

       Blank outputs a single newline character before printing line.

       0     outputs two newline characters before printing line.

       1     outputs a formfeed (start a new page) before printing line.

       +     outputs a carriage return before printing line, (overprint-
             ing the previous line).

  DIAGNOSTICS
       Possible exit status values are:

       0  Successful completion.

       1  Failure due to any of the following:
            -- write error on the standard output
            -- the inability to open the input file

       2  Unknown option specified on the command line.

                                                                       1

  asa(1)                MPE/iX Shell and Utilities                asa(1)
  ______________________________________________________________________

  Messages

       Message:  asa: write error on standard output: system error
       Cause:    See syserror(3).
       Action:   See syserror(3).

       Message:  asa: input file "filename": system error
       Cause:    See syserror(3).
       Action:   See syserror(3).

       Message:  Unknown option "-option"
       Cause:    You specified an option that is not valid for asa.
       Action:   Check the DESCRIPTION section of this man page for a
                 list of valid asa options.

  PORTABILITY
       POSIX.2.  x/OPEN Portability Guide 4.0.  UNIX System V.

  MPE/iX NOTES
       For information on how the current MPE/iX implementation may
       affect the operation of this utility, see Appendix A, MPE/iX
       Implementation Considerations.

                                                                       2