3.1.7.1.1 Open Cursor

This event MUST be generated with the following argument:

• iQueueDesc: A reference to the OpenQueueDescriptor (section 3.1.1.16) ADM element instance that refers to the Queue (section 3.1.1.2) ADM element instance on which the Cursor (section 3.2) ADM element instance is to be created.

Return Value:

• rCursor: A reference to the Cursor ADM element instance that was created.

The queue manager MUST perform the following actions to process this event:

• If iQueueDesc.QueueReference is NULL:

  • Set rCursor to NULL.

  • Take no further action.

• Instantiate a new Cursor ADM element instance, referred to as newCursor, and:

  • Add the Cursor ADM element instance referenced by newCursor to iQueueDesc.CursorCollection.

  • Generate the Initialize (section 3.2.7.1) event on the Cursor ADM element instance referenced by newCursor with the following inputs:

    • iQueueDesc := iQueueDesc

• Set rCursor to the Cursor ADM element instance referenced by newCursor.