4 Creating Objects

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.