MQDLTMP - Delete message property

The MQDLTMP call deletes a property from a message handle and is the inverse of the MQSETMP call.

• Syntax
• Parameters
• RPG Declaration

Syntax

MQDLTMP (Hconn, Hmsg, DltPropOpts, Name, CompCode, Reason)

Parameters

The MQDLTMP call has the following parameters:

HCONN (10-digit signed integer) - Input

This handle represents the connection to the queue manager. The value must match the connection handle that was used to create the message handle specified in the HMSG parameter.

If the message handle was created using HCUNAS then a valid connection must be established on the thread deleting the message handle otherwise the call fails with RC2009.

HMSG (20-digit signed integer) - input

This is the message handle containing the property to be deleted. The value was returned by a previous MQCRTMH call.

DLTOPT (MQDMPO) - Input

See the MQDMPO data type for details.

PRNAME (MQCHARV) - input

The name of the property to delete. See Property names for further information about property names.

Wildcards are not allowed in the property name.

CMPCOD (10-digit signed integer) - output

The completion code; it is one of the following:

CCOK

Successful completion.

CCWARN

Warning (partial completion).

CCFAIL

Call failed.

REASON (10-digit signed integer) - output

The reason code qualifying CMPCOD.

If CMPCOD is CCOK:

RCNONE

(0, X'000') No reason to report.

If CMPCOD is CCWARN:

RC2471

(2471, X'09A7') Property not available.

RC2421

(2421, X'0975') An MQRFH2 folder containing properties could not be parsed.

If CMPCOD is CCFAIL:

RC2204

(2204, X'089C') Adapter not available.

RC2130

(2130, X'0852') Unable to load adapter service module.

RC2157

(2157, X'086D') Primary and home ASIDs differ.

RC2219

(2219, X'08AB') MQI call entered before previous call completed.

RC2009

(2009, X'07D9') Connection to queue manager lost.

RC2481

(2481, X'09B1') Delete message property options structure not valid.

RC2460

(2460, X'099C') Message handle not valid.

RC2499

(2499, X'09C3') Message handle already in use.

RC2046

(2046, X'07FE') Options not valid or not consistent.

RC2442

(2442, X'098A') Invalid property name.

RC2111

(2111, X'083F') Property name coded character set identifier not valid.

RC2195

(2195, X'0893') Unexpected error occurred.

For more information about these codes, see API reason codes.

RPG Declaration

     C*..1....:....2....:....3....:....4....:....5....:....6....:....7..
     C                     CALLP     MQDLTMP(HCONN : HMSG : DLTOPT :
                                        PRNAME : CMPCOD : REASON)

     DMQDLTMP          PR                  EXTPROC('MQDLTMP')
     D* Connection handle 
     D HCONN                         10I 0 VALUE
     D* Message handle 
     D HMSG                          20I 0 VALUE
     D* Options that control the action of MQDLTMP 
     D DLTOPT                        12A
     D* Property name 
     D PRNAME                        32A
     D* Completion code 
     D CMPCOD                        10I 0 
     D* Reason code qualifying CompCode 
     D REASON                        10I 0