asnqfile(3F)

NAME
     ASNQFILE, ASNQUNIT - Returns the assign options currently in effect
     for a file name or unit number

SYNOPSIS
     CALL ASNQFILE(file, attr, istat)

     CALL ASNQUNIT(iun, attr, istat)

IMPLEMENTATION
     UNICOS, UNICOS/mk, and IRIX systems

DESCRIPTION
     This routine is supported on IRIX systems for programs compiled with
     the MIPSpro 7 Fortran 90 compiler or compiled with the -craylibs
     option to the MIPSpro F77 compiler.

     ASNQFILE queries the assign environment for any assign options
     currently in effect for a file name.  ASNQUNIT queries the assign
     environment for any assign options currently in effect for a unit
     number.  The assign options may have been established earlier by the
     assign(1) command or the ASSIGN, ASNUNIT, or ASNFILE (see ASSIGN(3F))
     library routines.

     When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
     UNICOS, UNICOS/mk, or IRIX, 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.

     file      A character variable or array element containing the file
               name.

     attr      A character variable or array element that receives the
               option's value in the form of a character string.  If the
               options exceed the length of attr, istat is set to a
               positive error code.  If no assign options are found for the
               specified unit or file, ' ' is returned in attr.

     istat     An integer variable or array element that receives one of
               the following return statuses:

               0    Options were found for the specified file or iun

               -1   No options were found for the specified file or iun.

               >0   An error condition was encountered.  Use the explain(1)
                    command to obtain information about a particular error
                    code.

     iun       An integer variable or array element containing the unit
               number.

SEE ALSO
     ASNCTL(3F), ASSIGN(3F)

     assign(1) in the Application Programmer's I/O Guide

     explain(1) in the UNICOS User Commands Reference Manual

     Application Programmer's Library Reference Manual for the printed
     version of this man page.