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.