DB2 graphic QMF Version 8

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 CMDST- 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 delimiters.

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

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


Go to the previous page Go to the next page

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright IBM Corporation 1982,2004 Copyright IBM Corporation 1982, 2004
timestamp Last updated: March, 2004