NAME

     ikp_cat - icon processing system cat implementation

SYNOPSIS

     ikp_cat [ -l logfile ]

DESCRIPTION

     ikp_cat provides a mechanism for concatenating a  number  of
     input  streams onto a single output stream within the ikp(1)
     icon processing interface, and is generally invoked within a
     custom process of ikp.

     ikp_cat examines all of its file  descriptors  to  determine
     which descriptors are open for reading and which descriptors
     are open for writing. The highest numbered descriptor  which
     is opened as read/write or write-only will be used to output
     diagnostic messages. The  next-highest  numbered  descriptor
     which  is opened as read/write or write-only will be used to
     output the concatenated input streams. All other descriptors
     which  are opened as read/write or read-only will be used to
     read input. Input descriptors are  read  from  in  ascending
     numerical  order,  beginning  with the lowest-numbered input
     descriptor  and  ending  with  the  highest-numbered   input
     descriptor.  Each  input stream is read in its entirety from
     beginning to end of file before the  next  input  stream  is
     read.

     The above ordering of input, output and diagnostic  descrip-
     tors  was chosen for consistency with the ikp custom process
     type, which by default uses a consecutive sequence  of  file
     descriptors  for input, output and diagnostic output in that
     order. The connectors of a custom  process  used  to  invoke
     ikp_cat may be safely connected to files or other processes,
     or grounded to disable input on any particular descriptor.

OPTIONS

     -l logfile
          Output diagnostic messages into the specified logfile.

SEE ALSO

     ikp(1)

AUTHOR

     Roger Davis, January 1990.

COPYRIGHT

     copyright 2001, Amoco Production Company
               All Rights Reserved
          an affiliate of BP America Inc.