MQCFIL - Integer list parameter

Use this page to view the structure of an MQCFIL parameter and the declarations for the following programming languages: C, COBOL, PL/I, RPG/ILE, S/390 assembler, and Visual Basic

The MQCFIL structure describes an integer list parameter. Following the links to the declarations is a description of the fields making up the MQCFIL structure:

C language
COBOL language
PL/I language ( z/OS® only)
RPG/ILE language ( IBM® i only)
System/390 assembler-language ( z/OS only)
Visual Basic language ( Windows only)

Type

Description:

Indicates that the structure type is MQCFIL and describes an integer-list parameter.

Data type :

MQLONG.

Value:

MQCFT_INTEGER_LIST: Structure defining an integer list.

StrucLength

Description: Length in bytes of the MQCFIL structure, including the array of integers at the end of the structure (the values field).

Data type : MQLONG.

Parameter

Description:

Identifies the parameter with a value that is contained in the structure.

Data type :

MQLONG.

Count

Description: Number of elements in the Values array.

Data type : MQLONG.

Values: Zero or greater.

Values

Description: Array of values for the parameter identified by the Parameter field.

Data type : MQLONG x Count

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, you must include MQCFIL in a larger structure, and declare additional fields following MQCFIL, to represent the Values field as required.

C language declaration

typedef struct tagMQCFIL {
  MQLONG  Type;         /* Structure type */
  MQLONG  StrucLength;  /* Structure length */
  MQLONG  Parameter;    /* Parameter identifier */
  MQLONG  Count;        /* Count of parameter values */
  MQLONG  Values[1];    /* Parameter values - first element */
 } MQCFIL;

COBOL language declaration

**   MQCFIL structure
  10 MQCFIL.
**    Structure type
   15 MQCFIL-TYPE        PIC S9(9) BINARY.
**    Structure length
   15 MQCFIL-STRUCLENGTH PIC S9(9) BINARY.
**    Parameter identifier
   15 MQCFIL-PARAMETER   PIC S9(9) BINARY.
**    Count of parameter values
   15 MQCFIL-COUNT       PIC S9(9) BINARY.

PL/I language declaration

dcl
 1 MQCFIL based,
  3 Type        fixed bin(31), /* Structure type */
  3 StrucLength fixed bin(31), /* Structure length */
  3 Parameter   fixed bin(31), /* Parameter identifier */
  3 Count       fixed bin(31); /* Count of parameter values */

RPG/ILE declaration ( IBM i only)

     D*..1....:....2....:....3....:....4....:....5....:....6....:....7..
     D* MQCFIL Structure
     D*
     D* Structure type
     D  ILTYP                  1      4I 0
     D* Structure length
     D  ILLEN                  5      8I 0
     D* Parameter identifier
     D  ILPRM                  9     12I 0
     D* Count of paramter valuee
     D  ILCNT                 13     16I 0

S/390 assembler-language declaration

MQCFIL                         DSECT
MQCFIL_TYPE                    DS   F        Structure type
MQCFIL_STRUCLENGTH             DS   F        Structure length
MQCFIL_PARAMETER               DS   F        Parameter identifier
MQCFIL_COUNT                   DS   F        Count of parameter values
MQCFIL_LENGTH                  EQU  *-MQCFIL Length of structure
                               ORG  MQCFIL
MQCFIL_AREA                    DS   CL(MQCFIL_LENGTH)

Visual Basic language declaration

Type MQCFIL
  Type As Long         ' Structure type
  StrucLength As Long  ' Structure length
  Parameter As Long    ' Parameter identifier
  Count As Long        ' Count of parameter value
End Type