MQeFieldsPutArrayOfByte, MQeFieldsPutArrayOfShort, MQeFieldsPutArrayOfInt, MQeFieldsPutArrayOfLong, MQeFieldsPutArrayOfFloat, MQeFieldsPutArrayOfDouble

Description
Puts an array of 8, 16, 32, or 64 bit integers, floats or doubles into a single field in an MQeFields object. Return '0' on success, '-1' on error.

Syntax
#include <hmq.h> 
#include <hmqHelper.h> 
MQEINT32 MQeFieldsPutArrayOfByte( MQEHSESS hSess, 
						MQEHFIELDS hFlds, 
                 MQECHAR * pName, MQEBYTE * pByte, 
                 MQEINT32 n, MQEINT32 * pCompCode, 
                 MQEINT32 * pReason) 
 
MQEINT32 MQeFieldsPutArrayOfShort( MQEHSESS hSess, 
						MQEHFIELDS hFlds, 
                 MQECHAR * pName, MQEINT16 * pShort, 
                 MQEINT32 n, MQEINT32 * pCompCode, 
                 MQEINT32 * pReason) 
 
MQEINT32 MQeFieldsPutArrayOfInt( MQEHSESS hSess, 
						MQEHFIELDS hFlds, 
               	MQECHAR * pName, MQEINT32 * pInt, 
                	MQEINT32 n, MQEINT32 * pCompCode, 
               	MQEINT32 * pReason) 
 
MQEINT32 MQeFieldsPutArrayOfLong( MQEHSESS hSess, 
						MQEHFIELDS hFlds, 
                 MQECHAR * pName, MQEINT64 * pLong, 
                 MQEINT32 n, MQEINT32 * pCompCode, 
                 MQEINT32 * pReason) 
 
MQEINT32 MQeFieldsPutArrayOfFloat( MQEHSESS hSess, 
						MQEHFIELDS hFlds, 
                 MQECHAR * pName, MQEFLOAT * pFloat, 
                 MQEINT32 n, MQEINT32 * pCompCode, 
                 MQEINT32 * pReason) 
 
MQEINT32 MQeFieldsPutArrayOfDouble( MQEHSESS hSess, 
						MQEHFIELDS hFlds, 
                 MQECHAR * pName, MQEDOUBLE * pDouble, 
                 MQEINT32 n, MQEINT32 * pCompCode, 
                 MQEINT32 * pReason)

Parameters

MQEHSESS hSess - input
The session handle, returned by MQeInitialize.

MQEHFIELDS hFlds - input
A handle to an MQeFields object.

MQECHAR * pName - input
A null terminated string containing the name of the field. A null or a zero length string is invalid.

MQEBYTE * pByte - input
An array of bytes.

MQEINT16 * pShort - input
An array of 2 byte integers.

MQEINT32 * pInt - input
An array of 4 byte integers.

MQEINT64 * pLong - output
An array of 8 byte integers.

MQEFLOAT * pFloat - input
An array of floats.

MQEDOUBLE * pDouble - input
An array of doubles.

MQEINT32 n - input
The number of elements to put. If '0', the number of elements in the field is returned.

MQEINT32 * pCompCode - output
MQECC_OK, MQECC_WARNING or MQECC_ERROR.

MQEINT32 * pReason - output
If the returned *pCompCode equals MQECC_ERROR, *pReason may have any of the following values:

MQE_EXCEPT_INVALID_HANDLE

Return Value

MQEINT32
Returns '0' on success or '-1' on failure.

Example
#include <hmq.h>
#include <hmqHelper.h>
static MQECHAR const * FieldsType = 
			"com.ibm.mqe.MQeFields";
MQEHSESS  hSess;
MQEINT32  compcode;
MQEINT32  reason;
MQEHFIELDS hFlds;
MQEBYTE  bytes[4];
MQEFLOAT  floats[2];
MQEDOUBLE doubles[2];
MQEINT16  shorts[2];
MQEINT32  ints[3];
MQEINT64  longs[2];
MQEINT32  rc;
 
hSess  = MQeInitialize("MyAppsName", 
								&compcode, &reason);
hFlds  = MQeFieldsAlloc( hSess, FieldsType, 
				&compcode, &reason);
 
*(MQEINT32 *)bytes = 0x30313233;
rc    = MQeFieldsPutByte( hSess, hFlds, 
									"b", 4, [0], 
               				&compcode, 
									&reason); 
floats[0]= 2.55;
floats[1]= 3.14;
rc    = MQeFieldsPutFloat( hSess, hFlds, 
										"f", 2, [0], 
               					&compcode, 
										&reason); 
doubles[0]= 2.3413453231e-63;
doubles[1]= 3.3413453231e-44;
rc    = MQeFieldsPut( hSess, hFlds, 
								"d", [0], 2, 
             				&compcode, 
								&reason); 
shorts[0]= 32000;
shorts[1]= 32020;
rc    = MQeFieldsPutArrayOfShort( hSess, hFlds, "sh", 
												[0], 2, 
                  						&compcode, 
												&reason); 
ints[0] = 2000100000;
ints[1] = 2000020000;
ints[2] = 2000003000;
rc    = MQeFieldsPutArrayOfInt( hSess, hFlds, 
												"int", 
												[0], 3, 
                 						&compcode, 
												&reason); 
longs[0].hi = 265;
longs[0].lo = 2000000000;
longs[1].hi = 2000000000;
longs[1].lo = 255;
rc    = MQeFieldsPutArrayOfLong( hSess, hFlds, "lg", [0], 2, 
                  &compcode, &reason); 

See Also


© IBM Corporation 2002. All Rights Reserved