3.17.4.1.14 Journal (Opnum 20)

  • Article

msdn link

The Journal method is received by the server in an RPC_REQUEST packet. In response, the server MUST set the represented Message.PositiveJournalingRequested and Message.NegativeJournalingRequested properties.

 [propput] HRESULT Journal(
   [in] long lJournal
 );

lJournal: A long integer that specifies the journaling setting for the message. This parameter corresponds to the MQMSGJOURNAL (section 2.2.2.12) enum.

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 follow these guidelines:

  • If the lJournal input parameter is NOT a valid MQMSGJOURNAL enumeration value or the combination of the MQMSGJOURNAL enumeration values (MQMSG_JOURNAL | MQMSG_DEADLETTER):

    • Return MQ_ERROR_ILLEGAL_PROPERTY_VALUE (0xC00E0018), and take no further action.

  • If the lJournal input parameter is equal to MQMSG_JOURNAL_NONE:

    • Set the represented Message.PositiveJournalingRequested to False.

    • Set the represented Message.NegativeJournalingRequested to False.

  • Else if the lJournal input parameter is equal to MQMSG_JOURNAL:

    • Set the represented Message.PositiveJournalingRequested to True.

    • Set the represented Message.NegativeJournalingRequested to False.

  • Else if the lJournal input parameter is equal to MQMSG_ DEADLETTER:

    • Set the represented Message.PositiveJournalingRequested to False.

    • Set the represented Message.NegativeJournalingRequested to True.

  • Else if the lJournal input parameter is equal to (MQMSG_JOURNAL | MQMSG_DEADLETTER):

    • Set the represented Message.PositiveJournalingRequested to True.

    • Set the represented Message.NegativeJournalingRequested to True.