sess_share
sess_share (sesshdl , OID_start, OID_end, folder[, ud])
Shares a range of elements (from OID_start to OID_end) as an object within the indicated session sesshdl. If necessary, the adapter will burst the selected range of elements according to the current burst configuration. The folder parameter is a string representing the path and name of the parent directory for the document to be created. sess_share uses the following bursting rules to determine whether an XML inclusion or entity reference should be used when creating a new object:
1. If the document type-specific burst configuration contains an object boundary rule for the element with an objecttype of entity or xinclude, that value is used.
2. If the first rule doesn't apply, and the createdefaults element in the system-wide burst configuration specifies a filereference attribute, that value is used.
3. If neither of these rules applies, then the value of the -filereference set option is used.
Included objects will always be parsed (the parsed attribute is not set, so it defaults to xml).
The ud parameter passes user defined data through to the adapter-specific implementation of this function.
If sesshdl, OID_start, or OID_end are invalid, or the operation fails, the function places error data in $main::ioerr and returns a zero (0). If successful, the function returns the ACL document object handle for the new document object.
The
dobj_close function must be called to close the document object after it has been processed.
Related Topics