DAT_EXIST

Return a locator associated with a parameter

Description:

An HDS locator for the data object associated with the specified parameter is returned. The parameter system will attempt to associate an object if one is not already associated. This operation is identical with DAT_ASSOC except under error conditions. When there is an error, DAT_EXIST reports the error and returns the status value immediately, whereas DAT_ASSOC repeatedly attempts to get a valid locator. If the named object does not exist, status PAR__ERROR is returned.

The object will be opened with the appropriate ACCESS mode. If ACCESS is incompatible with the access mode specified for the parameter in the programs Interface File, status SUBPAR__ICACM will be returned.

Invocation

CALL DAT_EXIST ( PARAM, ACCESS, LOC, STATUS )

Arguments

PARAM=CHARACTER() (given)
program parameter name
ACCESS=CHARACTER() (given)
Access mode, READ, WRITE or UPDATE (case insignificant)
LOC=CHARACTER() (returned)
Locator to the associated data object
STATUS=INTEGER (given and returned)
Global status