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:

    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, we 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
Parent topic: Structure data types