Function calls for Assembler language

QMF provides one function call, DSQCIA, for Assembler-language programs. The function call has two formats: regular syntax and extended syntax.

DSQCIA, regular syntax

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

     CALL DSQCIA,(DSQCOMM,CMDLTH,CMDSTR),VL

The parameters have the following values:

DSQCOMM: The interface communications area
CMDLTH: Length of the command string (CMDSTR); a FULLWORD parameter
CMDSTR: The QMF command issued on the function call; an uppercase character string of the length specified by CMDLTH

VL is the Assembler VARIABLE LIST statement.

DSQCIA, extended syntax

This extended-syntax format of the DSQCIA function call is for the QMF commands that require access to application program variables: START, TRACE, and the extended formats of GET GLOBAL and SET GLOBAL.

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

The parameters have the following values:

DSQCOMM

The interface communications area.

CMDLTH

The length of the command string (CMDSTR); a FULLWORD parameter.

CMDSTR

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

PNUM

The number of command keywords or trace areas; a FULLWORD parameter.

KLTH

The length of each specified keyword or trace title; a FULLWORD parameter or array of FULLWORD parameters.

KWORD

QMF keyword, keywords, or address of trace titles; a character, array of characters, or array of addresses to trace titles whose lengths are specified by KLTH.

VLTH

The length of each value that is associated with the keyword or trace title; a FULLWORD parameter or array of FULLWORD 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, array of characters, FULLWORD parameter, or array of FULLWORD 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 interface communications area, DSQCOMMA:

DSQ_VARIABLE_CHAR for character values
If VTYPE is DSQ_VARIABLE_CHAR, then VALUE is not validated.
DSQ_VARIABLE_FINT for integer values
If VTYPE is DSQ_VARIABLE_FINT, then VALUE is validated, and VALUE must be an integer.

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

VL is the Assembler VARIABLE LIST statement.