DAT_CREAT
may be used to create an object but note that it does not return a locator – a subsequent call
to DAT_ASSOC or DAT_EXIST is required before the object can be used. Only one object can be
created, its parents, if any, must already exist. If the parameter specifies a top-level object, any existing
container file will be overwritten but it is an error (DAT__COMEX
) to try to overwrite an existing
lower-level component.
The ACCESS
Field (see SUN/115) specified in the Interface Module for the program must be ‘WRITE’
or ‘UPDATE’, otherwise status SUBPAR_ICACM
will be returned.