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 */



© IBM Corporation 1994, 2002. All Rights Reserved