Home

 

Fields

 

Type (MQLONG)

Structure type.

This indicates that the structure is an MQCFIL structure describing an integer-list parameter. The value must be:

MQCFT_INTEGER_LIST

Structure defining an integer list.

StrucLength (MQLONG)

Structure length.

This is the length in bytes of the MQCFIL structure, including the array of integers at the end of the structure (the Values field). The length must be a multiple of four, and must be sufficient to contain the array; any bytes between the end of the array and the length defined by the StrucLength field are not significant.

The following constant gives the length of the fixed part of the structure, that is the length excluding the Values field:

MQCFIL_STRUC_LENGTH_FIXED

Length of fixed part of command format integer-list parameter structure.

Parameter (MQLONG)

Parameter identifier.

This identifies the parameter whose values are contained in the structure. The values that can occur in this field depend on the value of the Command field in the MQCFH structure; see MQCFH - PCF header for details.

The parameter is from the following groups of parameters:

• MQIA_*

• MQIACF_*

• MQIAMO_*

• MQIACH_*

Count (MQLONG)

Count of parameter values.

This is the number of elements in the Values array; it must be zero or greater.

Values (MQLONG×Count)

Parameter values.

This is an array of values for the parameter identified by the Parameter field. For example, for MQIACF_Q_ATTRS, this is a list of attribute selectors (MQCA_* and MQIA_* values).

The way that this field is declared depends on the programming language:

• For the C programming language, the field is declared as an array with one element. Storage for the structure must be allocated dynamically, and pointers used to address the fields within it.

• For the COBOL, PL/I, RPG, and System/390 assembler programming languages, the field is omitted from the structure declaration. When an instance of the structure is declared, include MQCFIL in a larger structure, and declare additional fields following MQCFIL, to represent the Values field as required.

 

Parent topic:

MQCFIL - PCF integer list parameter

pc14970_

 

Home