3.1.7.1.24 Write Directory

  • Article

This event MUST be generated with the following arguments:

  • iDirectoryObject: The DirectoryObject ADM element instance to be written to the directory.

  • iAttributeList (Optional): An array of strings containing the names of the directory attributes associated with iDirectoryObject to be updated to the directory. If this argument is not supplied, all directory attributes will be updated.

Return Value:

rStatus: A DirectoryOperationResult that indicates the result of this directory operation.

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

  • Generate the Write Directory ([MS-MQDSSM] section 3.1.6.7) event<29> with the arguments supplied for this event.

    • If the rStatus returned from processing of the invoked event is DirectoryOperationResult.DirectoryNotConnected:

      • Set the DirectoryOffline ADM attribute of the QueueManager ADM element instance to True.

      • Start the Directory Online Timer (section 3.1.2.5) if it is not active already.

      • Set rStatus to DirectoryOperationResult.DirectoryNotConnected.

    • Else:

      • Set rStatus to the rStatus returned from the invoked event.

  • If the rStatus returned by the Write Directory event is set to DirectoryOperationResult.Success:

    • If iDirectoryObject is of type Queue (section 3.1.1.2) and iDirectoryObject.QueueType is PublicQueue:<30>

    • Else if iDirectoryObject is of type QueueManager (section 3.1.1.1):<31>

      • Generate a Send Change Notification ([MS-MQCN] section 3.3.4.1) event with the following arguments:

        • iOperation := QueueManagerUpdate

        • iDirectoryObject := iDirectoryObject