next up previous 203
Next: DAT_CANCL - Cancel association between a parameter and a data object
Up: Subroutine Specifications
Previous: Subroutine Specifications


DAT_ASSOC - 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. In the event of a failure, an error message will be displayed and another attempt made (usually by prompting the user). Up to five attempts will be made, after which status PAR__NULL will be 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_ASSOC ( PARAM, ACCESS, LOC, STATUS )

Arguments:

PARAM=CHARACTER*(*) (given)
Name of program parameter
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_CANCL - Cancel association between a parameter and a data object
Up: Subroutine Specifications
Previous: Subroutine Specifications

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