C2.05. FMS Subroutine XXDANN

RSDANN
RNDANN
CHDANN
CSDANN
CNDANN

PURPOSE: Convert A(N,N) to FMS Format

Create a FMS matrix file from a full incore matrix A(LDA,N).

SYNOPSIS


	CALL RSDANN (A, LDA, N, LUA)

	CALL RNDANN (A, LDA, N, LUA)

	CALL CHDANN (A, LDA, N, LUA)

	CALL CSDANN (A, LDA, N, LUA)

	CALL CNDANN (A, LDA, N, LUA)

INPUT PARAMETERS:

A(LDA,N) = Real array (RSDANN, RNDANN).
A(LDA,N) = Complex array (CHDANN, CSDANN, CNDANN).
Full matrix containing your data.
LDA = Integer.
Leading dimension of array A. Usually N, but must be at least as large as N.
N = Integer.
Number of equations.

OUTPUT PARAMETERS:

A(LDA,N) = Real array (RSDANN, RNDANN).
A(LDA,N) = Complex array (CHDANN, CSDANN, CNDANN).
Matrix data in FMS format.
LUA(25) = Integer array.
FMS Matrix File Attribute List.

FMS PARAMETERS:

The following FMS Parameters are especially important to this routine:

Parameter Description
IPRI Assembly print code

Parameter	Description
IPRI	Assembly print code

DESCRIPTION:

This subroutine reformats a full incore matrix A(LDA,N) into FMS format and computes the matrix file attribute list LUA(25). It provides an efficient and easy to use interface between FMS and existing application programs which are processing full incore matrices.

The matrix data in array A(LDA,N) is moved to provide contiguous vectors for FMS processing. The segment table file LUA(4) is generated incore in FMS managed memory. The matrix file attributes LUA(25) are computed to point to an incore file whose data is stored in A.

Because FMS moves the data in array A, you must not change this data after calling this subroutine. If your program performs a nonlinear analysis, which requires updating terms in A, the old file should be closed by calling FMSCM and a new file created by calling this subroutine after the array A is regenerated.

The array A must be aligned on a natural boundary.