ASNQFILE(3F) Last changed: 1-6-98
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 7.2 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 ALSOASNCTL(3F), ASSIGN(3F)assign(1) in the Application Programmer's I/O Guide, publication SG-
2168
explain(1) in the UNICOS User Commands Reference Manual, publication
SR-2011
Application Programmer's Library Reference Manual, publication SR-
2165, for the printed version of this man page.
