Function calls for COBOL

QMF provides one function call for the COBOL language: DSQCIB. The function call has two formats: DSQCIB and DSQCIB (extended format).

DSQCIB

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

     CALL DSQCIB USING DSQCOMM CMDLTH CMDSTR

The parameters have the following values:

DSQCOMM: The interface communications area
CMDLTH: Length of the command string (CMDSTR); an integer parameter
CMDSTR: QMF command to run; an uppercase character string of the length specified by CMDLTH

DSQCIB (extended format)

This call has an extended syntax for the QMF commands that require access to application program variables: START, TRACE, and the extended formats of GET GLOBAL and SET GLOBAL.

     DSQCIB USING
            DSQCOMM CMDLTH CMDSTR
            PNUM KLTH KWORD VLTH VALUE VTYPE

The parameters have the following values:

DSQCOMM

The interface communications area.

CMDLTH

The length of the command string (CMDSTR); an integer parameter.

CMDSTR

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

PNUM

The number of command keywords or trace areas; an integer parameter.

KLTH

The length of each specified keyword or trace title; an integer parameter or an array of integer parameters.

KWORD

QMF keyword, keywords, or address of trace titles.

Each is a character, array of characters, or array of addresses to trace titles whose lengths are specified by KLTH. If all the keywords have the same length, you can use an array of characters.

VLTH

The length of each value that is associated with the keyword or trace title; an integer parameter or an array of integer parameters.

VALUE

The value that is associated with each keyword or the address of a value that is associated with a trace title.

Its type is specified in the VTYPE parameter, and can be a character, an array of characters, an integer parameter, or an array of integer parameters. For trace data, VTYPE must be FINT.

VTYPE

Data type of the contents of the VALUE parameter.

This parameter has one of two values, which are provided in the communications area, DSQCOMMB:

DSQ-VARIABLE-CHAR for character values
DSQ-VARIABLE-FINT for integer values

All values that are specified in the VALUE field must have the data type that is specified by VTYPE.