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

  NAME
       frombyte -- convert a byte stream files to MPE record files

  SYNOPSIS
       frombyte -b [bytestream_file] record_file

  DESCRIPTION
       The frombyte utility copies a byte stream file to an MPE record
       file.  It creates either a fixed-record 80-byte ASCII file (MPE
       text file) or a fixed-record 120-word binary file.  If bytes-
       tream_file is omitted, frombyte reads from standard input.

       If more flexibility is needed in file conversions, refer to the
       description of FCOPY in the MPE/iX Reference Supplement
       (32650-90353) or the FCOPY Reference Manual (32212-90003).

  Options

       -b   creates a binary output file. If this option is not speci-
            fied, the output is an ASCII file.

  EXAMPLES
       To convert a byte stream file to an MPE text file, use the fol-
       lowing command:

          frombyte /usr/src/zork.c zork.c.sys

       The following example uses tar to create an archive of all files
       in the /usr/src directory and pipes the archive through frombyte
       to create an MPE binary file named tarfile.

          tar -cvf - /usr/src | frombyte -b tarfile

  DIAGNOSTICS

       0  Successful completion.

       1  An error occurred.

  Messages

       Message:  close of "filename" failed
       Cause:    An error occurred while closing the output file as a
                 new permanent file.
       Action:   Make sure that you have the necessary resources and
                 permissions to create a new permanent file.

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

                                                                       1

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

       Message:  unable to open output file "filename"
       Cause:    frombyte was unable to open the output file.  ACTION
                 Make sure that the necessary file system structures
                 exist and that you have appropriate permissions to cre-
                 ate a new file, or purge an existing file with the same
                 name if it exists.

       Message:  unknown option "-option"
       Cause:    You specified an option that is not valid for frombyte
       Action:   Check the DESCRIPTION section for a list of valid
                 frombyte options.

       Message:  write failed on output file "filename"
       Cause:    An error occurred while writing a record to the output
                 file.
       Action:   Make sure that there are sufficient system resources
                 available to write the file and that none of the file
                 system limits are being exceeded.

  PORTABILITY
       The frombyte utility is unique to MPE/iX Shell and Utilities.

  SEE ALSO
       tobyte(1)

  MPE/iX NOTES
       frombyte is available as both a built-in shell utility and an
       external utility.

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

                                                                       2