NDF_TEMP - Obtain a placeholder for a temporary NDF

Description:

The routine returns an NDF placeholder which may be used to create a temporary NDF (i.e. one which will be deleted automatically once the last identifier associated with it is annulled). The placeholder returned by this routine may be passed to other routines (e.g. NDF_NEW or NDF_COPY) to produce a temporary NDF in the same way as a new permanent NDF would be created.

Invocation:

CALL NDF_TEMP( PLACE, STATUS )

Arguments:

PLACE = INTEGER (Returned)

Placeholder for a temporary NDF.

STATUS = INTEGER (Given and Returned)

The global status.

Notes:

• Placeholders are intended only for local use within an application and only a limited number of them are available simultaneously. They are always annulled as soon as they are passed to another routine to create a new NDF, where they are effectively exchanged for an NDF identifier.

• If this routine is called with STATUS set, then a value of NDF__NOPL will be returned for the PLACE argument, although no further processing will occur. The same value will also be returned if the routine should fail for any reason. The NDF__NOPL constant is defined in the include file NDF_PAR.