MQ_PUT1_EXIT - Put one message

 


Exit providers can supply an  MQ_PUT1_EXIT  function to intercept the  MQPUT1  call.

 

Syntax


 MQ_PUT1_EXIT  (pExitParms, pExitContext, pHconn, ppObjDesc,
ppMsgDesc, ppPutMsgOpts, pBufferLength, ppBuffer, pCompCode, pReason)

 

Parameters

The  MQ_PUT1_EXIT  call has the following parameters.

 

pExitParms (PMQAXP) - input/output

Exit parameter structure.

 

pExitContext (PMQAXC) - input/output

Exit context structure.

 

pHconn (PMQHCONN) - input/output

Connection handle.

 

ppObjDesc (PPMQOD) - input/output

Object descriptor.

 

ppMsgDesc (PPMQMD) - input/output

Message descriptor.

 

ppPutMsgOpts (PPMQPMO) - input/output

Options that control the action of  MQPUT1 .

 

pBufferLength (PMQLONG) - input/output

Length of the message in ppBuffer.

 

ppBuffer (PPMQVOID) - input/output

Message data.

 

pCompCode (PMQLONG) - input/output

Completion code.

 

pReason (PMQLONG) - input/output

Reason code qualifying pCompCode.

 

C invocation

MQ_PUT1_EXIT (&ExitParms, &ExitContext, &Hconn,
             &pObjDesc, &pMsgDesc, &pPutMsgOpts,
             &BufferLength, &pBuffer, &CompCode,
             &Reason);

The parameters passed to the exit are declared as follows:

PMQAXP    pExitParms;     /* Exit parameter structure */
PMQAXC    pExitContext;   /* Exit context structure */
PMQHCONN  pHconn;         /* Connection handle */
PPMQOD    ppObjDesc;      /* Object descriptor */
PPMQMD    ppMsgDesc;      /* Message descriptor */
PPMQPMO   ppPutMsgOpts;   /* Options that control the action of MQPUT1 */
PMQLONG   pBufferLength;  /* Length of the message in pBuffer */
PPMQVOID  ppBuffer;       /* Message data */
PMQLONG   pCompCode;      /* Completion code */
PMQLONG   pReason;        /* Reason code qualifying CompCode */