This function creates a new object in the document repository from the contents of filename. The function is intended to be used to add graphic files to the repository. To move an SGML, XML or HTML document into the repository, use the document bursting function (for example, dobj_burst).

The sesshdl parameter is a session handle. The objectname parameter specifies the name for the new object in the repository. Use the folder parameter to specify a destination location (in the repository) for the new object. Use the rendition parameter to specify the type of data that is being saved. The rendition must match one of the Notations declared in your DTD.

The ud parameter can be used to pass user defined information to a callback; strings must match the adapter encoding. Refer to Repository API Callback functions for more information on using callbacks with the Repository API functions.

The function returns a logical ID on sucess.

If the operation fails, the function writes error data to $main::ioerr and returns a zero (0).