Returns the name of a local file that contains the specified poid using the read option opts. An opts entry of one (1) reads the file as “read-only”; an opts entry of two (2) reads the file as “read\write”.

Use the optional rendition parameter to specify the desired rendition when retrieving the contents of a graphic object. 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.

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