MQCFIL64 - 64-bit integer list parameter

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

The MQCFIL64 structure describes a 64-bit integer list parameter. Following the links to the declarations is a description of the fields making up the MQCFIL64 structure:

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

Type

Description:

Indicates that the structure is a MQCFIL64 structure describing a 64-bit integer list parameter.

Data type:

MQLONG.

Value:

MQCFT_INTEGER64_LIST: Structure defining a 64-bit integer list.

StrucLength

Description:	Length in bytes of the MQCFIL64 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:	0 or greater.

Values

Description:	Array of values for the parameter identified by the Parameter field.
Data type:	(MQINT64 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 MQCFIL64 in a larger structure, and declare additional fields following MQCFIL64, to represent the Values field as required.

For COBOL, additional fields should be declared as:

    PIC  S9(18)

For PL/I, additional fields should be declared as FIXED BINARY SIGNED with a precision of 63.

For System/390 assembler, additional fields should be declared D (double word) in the DS declaration.

C language declaration

typedef struct tagMQCFIN64 {
  MQLONG  Type;         /* Structure type */
  MQLONG  StrucLength;  /* Structure length */
  MQLONG  Parameter;    /* Parameter identifier */
  MQLONG  Count;        /* Count of parameter values */
  MQINT64 Values[1];        /* Parameter value */
 } MQCFIL64;

COBOL language declaration

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

PL/I language declaration

dcl
 1 MQCFIL64 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 language declaration ( IBM i only)

     D*..1....:....2....:....3....:....4....:....5....:....6....:....7..
     D* MQCFIL64 Structure
     D*
     D* Structure type 
     D  IL64TYP                1      4I 0 INZ(25)
     D* Structure length 
     D  IL64LEN                5      8I 0 INZ(16)
     D* Parameter identifier 
     D  IL64PRM                9     12I 0 INZ(0)
     D* Count of parameter values 
     D  IL64CNT               13     16I 0 INZ(0)
     D* Parameter values -- first element 
     D  IL64VAL               17     16    INZ(0)

S/390 assembler-language declaration ( z/OS only)

MQCFIL64                         DSECT
MQCFIL64_TYPE                    DS   F        Structure type
MQCFIL64_STRUCLENGTH             DS   F        Structure length
MQCFIL64_PARAMETER               DS   F        Parameter identifier
MQCFIL64_COUNT                   DS   F        Parameter value high
MQCFIL64_LENGTH                  EQU  *-MQCFIL64 Length of structure
                                 ORG  MQCFIL64
MQCFIL64_AREA                    DS   CL(MQCFIL64_LENGTH)

Parent topic: Structure data types