Function calls for PL/I

QMF provides two function calls for PL/I: DSQCIPL and DSQCIPX. Both calls are described in the communications macro DSQCOMML.

DSQCIPL syntax

This call is for QMF commands that do not require access to application program variables. Use this call for most QMF commands.

 CALL DSQCIPL(DSQCOMM,
              CMDLTH,
              CMDSTR)

The parameters have the following values:

DSQCOMM

The interface communications area.

CMDLTH

Length of the command string CMDSTR.

CMDSTR

QMF command to run; it is an uppercase character string of the length specified by CMDLTH.

DSQCIPX Syntax

This call is for the three commands that do require access to application program variables: START and the extended formats of GET GLOBAL and SET GLOBAL.

The syntax for this call is:

 CALL DSQCIPX(DSQCOMM,
              CMDLTH,
              CMDSTR,
              PNUM,
              KLTH,
              KWORD,
              VLTH,
              VALUE,
              VTYPE)

The parameters have the following values:

DSQCOMM

The interface communications area.

CMDLTH

Length of the command string CMDSTR. It is an integer FIXED BIN(31) parameter.

CMDSTR

QMF command to run. It is an uppercase character string of the length specified by CMDLTH.

PNUM

Number of command keywords. It is an integer FIXED BIN(31) parameter.

KLTH

Length of each specified keyword. It is an integer FIXED BIN(31) parameter or parameter array.

KWORD

QMF keyword or keywords. Each is a character or structure of characters whose lengths are the same as specified by KLTH. You can use an array of characters, if all of the keywords have the same length. QMF assumes that the keywords are in contiguous storage and are not separated by any special separator characters.

VLTH

Length of each value associated with the keyword. It is an integer FIXED BIN(31) parameter or parameter array.

VALUE

Value associated with each keyword. Its type is specified in the VTYPE parameter, and can be a character, structure of characters, integer FIXED BIN(31) parameter, or parameter array. If you have character values, QMF assumes that the values are in contiguous storage, not separated by any special separator characters.

VTYPE

QMF data type of the value string VALUE. VTYPE can have one of two values, which are provided in the communications macro, DSQCOMML:

• DSQ_VARIABLE_CHAR for character values.
• DSQ_VARIABLE_FINT for integer FIXED BIN(31) values

All of the values specified in the VALUE field must have the data type specified in VTYPE.