Queue and Dequeue in DFC

Hans Henrik

Hi,

I want to create a job and an application which can use the Documentum queueing system using DFC.

The application is a rendition service as CTS is so unstable we can't use.

Problem is I can't find any documentation for the rules using the Documentum queueing system in the Developer documentation and any forums.

The rendition service is an existing service and it has to have the renditions request pushed to it.

So when a rendition is requested I want to put request in into the Documentum queue system and have a job push the request to rendition service. This way I avoid to halt Webtop is the rendition service is down and it is the job which will timeout and not affecting the users.

My current approach is queue items using the IDfSysObject.queue() to queue an object but I can't find a dequeue function as in API?

Also I can only find IDfQueueItem in DFC but it does not handle to queue system, so to pull the queue from my job, do I just query the dmi_queue_item for the event or is there a class in DFC to handle the queue system?

Hicham Bahi

What you call the Documentum queue system is actually the set of inboxes of all users declared in the repository. So to create a "queue", simply create a virtual user, e.g. similar to the default dm_autorender_win31 user used by CTS.

To queue an object for the user, use IDfSysObject.queue() as you correctly wrote. To dequeue an item, you must use IDfSession,dequeue() and pass the ID of the queue item. If you need to update the queue item (e.g. to ensure that multiple instances don't pick up the same item) you can use the setter methods followed by save.

There may be higher-level services (e.g. SBO) which you may use but I'm not sure which and how well documented they are. For example, there is a SBO called com.documentum.services.workflow.inbox.IInbox but I don't think it will be useful for what you want to do.