The field descriptor data structure contains information about a field in
the MQeFields object. It is used as an input and an output parameter with MQeFieldsGetByArrayOfFd and as
an output parameter with MQeFieldsGetByIndex.
MQEFIELD {
MQEBYTE fd_datatype; /* Field data type */
MQEBYTE __pad; /* Unused padding byte */
MQEINT16 fd_namelen; /* Field name */
MQECHAR * fd_name; /* Pointer to the field name */
MQEBYTE * fd_data; /* Pointer to the field data */
MQEINT32 fd_datalen; /* Number of datatype elements in */
/* the field data */
MQEBYTE * fd_base; /* Base pointer (platform specific) */
};
- MQECHAR * fd_name
- A pointer to the null terminated string name of the field.
Application programs should use the following guidelines for field
names:
- At least 1 character long.
- Conform to the ASCII character set, (characters with values between 20 and
128)
- Should not include any of the characters
{}[]#():;,'=
- MQEINT32 fd_namelen
- The length of the fd_name. The input value
specifies the size (in MQECHAR) of the fd_name
buffer for operations that retrieve the name of a field. The output
value specifies the size (in MQECHAR) of the
fd_name of the field, for operations that retrieve the
name of a field. These sizes do not include a terminating
NULL.
- MQEBYTE fd_type
- The data type of the field data.
- MQEBYTE * fd_data
- A pointer to the field data.
- MQEINT32 fd_datalen
- The number of data elements (not bytes) in fd_data
. The input values of fd_datalen and
fd_datatype specify the size of the buffer provided by
fd_data (when not NULL). The output
value specifies the total number of elements for the field.
- MQEBYTE * fd_base
- The platform specific base pointer for data, should be NULL
unless specifically being used.
© IBM Corporation 2002. All Rights Reserved