pxfstrget(3F)

NAME
     PXFSTRGET - Allows values stored in individual components of a
     structure to be extracted and used

SYNOPSIS
     INTEGER jhandle, ilen, ierror
     CHARACTER*(n) compnam, value
     CALL PXFSTRGET (jhandle, compnam, value, 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
     F77 compiler.

     The routine PXFSTRGET allows character values stored in individual
     components of a structure to be extracted and used.

     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 are arguments to PXFSTRGET:

     jhandle   An input integer that references a structure.  jhandle
               should have been created with PXFSTRUCTCREATE.

     compnam   An input character variable that is the name of a component
               of the structure.  compnam is case-sensitive.

     value     An output character variable.  Upon successful completion,
               value is set to the value stored in the component of jhandle
               referenced by compnam.  If the length of the data being
               stored is less than the declared length of value, value is
               padded with blanks.

               The structures and components that may be accessed through
               PXFSTRGET are described on the man page for the related PXF
               routine.  For example, the PXFUNAME man page describes the
               components for the utsname structure.

     ilen      An output integer variable.  ilen is set to the actual
               length of the data assigned to value.  If the length of
               value is insufficient to contain the data being returned,
               the data is truncated, and ilen contains the original length
               of the data before truncation.  In this case, ierror is set
               to ETRUNC.

     ierror    An output integer variable.  Upon successful completion of
               PXFSTRGET, ierror is set to 0.  If any of the following
               conditions occur, ierror is set to the corresponding value:

               ENONAME        Component name is not defined for the
                              specified structure.

               ETRUNC         The actual length of the data to be copied to
                              value was longer than the declared length of
                              value.

               EBADHANDLE     If jhandle is an invalid handle or has an
                              incorrect handle type (UNICOS and UNICOS/mk
                              systems only).

SEE ALSO
     PXFSTRUCTCREATE(3F), PXFUNAME(3F)

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