AIF_GETVM

Obtains a pointer and a locator to mapped HDS workspace

Description:

This routine obtains and file maps a temporary array of a given data type and dimensions via HDS. A pointer to the mapped work array is returned, as is a locator so that the temporary array may be annulled when no longer required.

Invocation

CALL AIF_GETVM( TYPE, NDIM, DIMS, PNTR, WKLOC, STATUS )

Arguments

TYPE = CHARACTER ∗ ( ∗ ) (Given)
The HDS data type of the temporary array.
NDIM = INTEGER (Given)
The number of dimensions of the work array.
DIMS( NDIM ) = INTEGER (Given)
The dimensions of the temporary array.
PNTR = INTEGER (Returned)
The pointer to the mapped temporary array.
WKLOC = CHARACTER ∗ ( DAT__SZLOC )(Returned)
The HDS locator to the temporary array.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:

The current HDS tuning parameter MAP is stored, so that the temporary array may be accessed via file mapping, and upon exit restored to its former value.