putlin (2) --- put a line on a file                      03/25/82


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function putlin (line, fd)
                 character line (ARB)
                 file_des fd

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Putlin'  is  the  primary  Subsystem  output  routine.  The
                 character string supplied as the first argument is placed on
                 the file specified by the  second  argument.   The  function
                 return is OK if the write was successful, ERR otherwise.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 'Putlin'  first calls 'mapsu' to map any standard unit which
                 may have been supplied on the call  to  a  file  descriptor.
                 The  file  specified by this descriptor is checked to insure
                 writeability.  If the last operation on the given  file  was
                 not  a  'putlin',  'flush$'  is  called  to place the file's
                 buffer in the empty state.  Depending  on  the  device  type
                 associated  with  the  file,  one  of  the  device dependent
                 drivers 'dputl$' (for disk files) or 'tputl$' (for  terminal
                 files)  is  called  to perform the actual data transfer.  No
                 data transfer takes place for the null  device  (/dev/null).
                 The  function  return  is  the  value returned by the device
                 dependent driver chosen, and is OK for a  successful  trans-
                 fer, ERR for an unsuccessful transfer.


            _C_a_l_l_s

                 mapsu, dputl$, tputl$, flush$


            _S_e_e _A_l_s_o

                 mapsu (2), dputl$ (6), tputl$ (6), putch (2), getlin (2)
















            putlin (2)                    - 1 -                    putlin (2)