C2.02. FMS Subroutine FMSOV2

FMSOV2

PURPOSE: Open User Array Vector File

To create a FMS vector file for direct access to the array X(NUMEQ,NUMVEC), which is dimensioned in your program.

SYNOPSIS


CALL FMSOV2 (NUMEQ, IDTYPE, NUMVEC, X, LDX, LUX)

INPUT PARAMETERS:

NUMEQ = Integer.
Number of equations (terms) in the vector.
IDTYPE = Integer.
Data type (1=real, 2=complex)
NUMVEC = Integer.
Number of vectors (records) on the file.
X(LDX,NUMVEC) = Real array (IDTYPE=1)
X(LDX,NUMVEC) = Complex array (IDTYPE=2)
Array in your program for storing vector data.
LDX = Integer.
Leading dimension of array X. Usually NUMEQ, but must be at least as large as NUMEQ.

OUTPUT PARAMETERS:

LUX(25) = Integer array.
FMS Vector File Attribute List for the incore data stored in array X.

DESCRIPTION:

This subroutine creates a FMS vector file attribute list LUX(25) which addresses the array X(NUMEQ, NUMVEC) in your program. It provides an efficient and easy to use interface when the vector data remains in memory during FMS processing. You should use this subroutine whenever there are only a few vectors.

When using this subroutine, it is not necessary to create the vector file by calling FMSOV, or to read and write the vector data. FMS performs all operations directly on the vector data contained in array X.

The array X must be aligned on a natural address boundary.