next up previous 203
Next: DAT_UPDAT - Force HDS update
Up: Subroutine Specifications
Previous: DAT_DELET - Delete an object associated with a parameter


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 program's 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



next up previous 203
Next: DAT_UPDAT - Force HDS update
Up: Subroutine Specifications
Previous: DAT_DELET - Delete an object associated with a parameter

HDSPAR - HDS Parameter Routines
Starlink User Note 224
A J Chipperfield
10 February 2000
E-mail:ussc@star.rl.ac.uk

Copyright © 2000 Council for the Central Laboratory of the Research Councils