Share via

3.10.4.1.13 Journal (Opnum 19)

  • Article

The Journal method is received by the server in an RPC_REQUEST packet. In response, the server returns a value that specifies the journaling level of the referenced queue.

 [propget] HRESULT Journal(
   [out, retval] long* plJournal
 );

plJournal: A pointer to a long that corresponds to one of the MQJOURNAL (section 2.2.2.4) enumeration values.

Return Values: The method MUST return S_OK (0x00000000) on success or an implementation-specific error HRESULT on failure.

When processing this call, the server MUST abide by the following contract:

  • If IsRefreshed is FALSE call Refresh (section 3.10.4.1.29).

  • If Refresh returns a value other than S_OK (0x00000000), return the HRESULT returned by Refresh and take no further action.

  • If IsApplicationQueue is False or refQueue.Journaling equals False:

    • Set the plJournal output parameter to the MQ_JOURNAL_NONE (0x00000000) value of the MQJOURNAL enumeration.

  • Else:

    • Set the plJournal output parameter to the MQ_JOURNAL (0x00000001) value of the MQJOURNAL enumeration.

  • Return S_OK (0x00000000), and take no further action.