

            mapsu (2) --- map standard unit to file descriptor       03/23/80


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 file_des function mapsu (std_unit)
                 file_des std_unit

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Mapsu'  is  used  to  map  standard  units  (such as STDIN,
                 STDOUT, and ERROUT) to the file descriptor  associated  with
                 the  file to which they are currently equivalent.  It is not
                 intended for general use.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 'Mapsu' checks the file unit mapping  information  contained
                 in   the  Subsystem  I/O  common  area.   If  the  parameter
                 'std_unit' is one of the following:

                       STDIN       STDOUT
                       STDIN1      STDOUT1
                       STDIN2      STDOUT2
                       STDIN3      STDOUT3
                       ERRIN       ERROUT

                 then the function return is the file descriptor  correspond-
                 ing  to these standard units; otherwise, the function return
                 is the same as the value of 'std_unit'.

                 Note that if the standard port mapping table contains a cir-
                 cular definition, the file descriptor of the user's terminal
                 will be returned.























            mapsu (2)                     - 1 -                     mapsu (2)


