pxfgetlogin(3F)

NAME
     PXFGETLOGIN - Gets user name

SYNOPSIS
     SUBROUTINE PXFGETLOGIN (s, ilen, ierror)
     CHARACTER*n s
     INTEGER ilen, ierror

IMPLEMENTATION
     UNICOS, UNICOS/mk, and IRIX systems

STANDARDS
     IEEE standard interface for FORTRAN 77

DESCRIPTION
     On IRIX systems, this routine is in libfortran.so which is linked by
     default when compiling programs with the MIPSpro 7 Fortran 90 compiler
     or when compiling programs with the -craylibs option to the MIPSpro
     7.2 F77 compiler.

     The PXFGETLOGIN routine uses the cuserid(3C) function to fill s with
     the user login name associated with the calling process.

     When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
     UNICOS, UNICOS/mk, or IRIX systems, all arguments must be of default
     kind unless documented otherwise.  On UNICOS and UNICOS/mk, default
     kind is KIND=8 for integer, real, complex, and logical arguments; on
     IRIX, the default kind is KIND=4.

     The following is a list of valid arguments for this routine:

     s         An output character variable or array element for the user's
               login name.

     ilen      An output integer variable containing the length of s.

     ierror    An output integer variable that contains zero if the user's
               login name was successfully acquired or nonzero if
               PXFGETLOGIN was unsuccessful.

     The PXFGETLOGIN routine may return the ETRUNC error value if the
     length of s is smaller than the length of the user's login name.

EXAMPLES
     In this example, PXFGETLOGIN is called and the returned user login
     name is printed.

              program pxftest
              character*16 s
              integer ilen, ierror

        c     find the user name associated with this process
              CALL PXFGETLOGIN(s, ilen, ierror)
              print *,'user name = ',s,' length = ',ilen,' error = ',ierror

              end

SEE ALSO
     cuserid(3C)

     Application Programmer's Library Reference Manual, publication SR-
     2165, for the printed version of this man page.