Parallel Engineering and Scientific Subroutine Library for AIX Version 2 Release 3: Guide and Reference

PGEFREE--Deallocates Space for a Dense Vector

This sparse utility subroutine deallocates space that is used for a dense vector.

Syntax

On Entry

x

is a pointer to the dense vector x.

Scope: local

Type: required

Specified as: a pointer to an assumed-shape array with shape (:), containing long-precision real numbers.

desc_a

is the array descriptor for the sparse matrix A.

Type: required

Specified as: the derived data type DESC_TYPE.

Notes and Coding Rules

1. Before you call this subroutine, you must have called PGEALL.
2. You must deallocate b, x, sparse matrix A, and preconditioner data structure prcs before you deallocate the array descriptor desc_a.

Error Conditions

Computational Errors

None

Resource Errors

None.

Input-Argument and Miscellaneous Errors

Stage 1:  

1. desc_a has not been initialized.

Stage 2:  

1. The BLACS context is invalid.

Stage 3:  

1. This subroutine was called from outside the process grid.

Stage 4:  

1. The process grid is not np × 1.
2. The pointer x is not associated and therefore cannot be deallocated.