3.17.4.1.10 Trace (Opnum 16)

  • Article

The Trace method is received by the server in an RPC_REQUEST packet. In response, the server MUST set the represented Message.TracingRequested.

 [propput] HRESULT Trace(
   [in] long Trace
 );

Trace: A long integer that specifies the trace method for the message. This parameter corresponds to the MQMSGTRACE (section 2.2.2.13) 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 lTrace input parameter is NOT a valid MQMSGTRACE enumeration value:

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

  • Set the represented Message.TracingRequested to the value that maps to the MQMSGTRACE enum contained in the lTrace input.