Function calls for Assembler language

The function call for assembler language has two formats: DSQCIA and DSQCIA extended syntax.

DSQCIA

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

QMF command to execute; 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 is for the three QMF commands that require access to application program variables: START 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

Length of the command string, CMDSTR; a FULLWORD parameter

CMDSTR

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

PNUM

Number of command keywords; a FULLWORD parameter

KLTH

Length of each specified keyword; a FULLWORD parameter or array of FULLWORD parameters

KWORD

QMF keyword or keywords; a character or structure of characters whose lengths are the same as specified by KLTH

VLTH

Length of each value associated with the keyword; a FULLWORD parameter or array of FULLWORD parameters

VALUE

Value associated with each keyword. Its type is specified in the VTYPE parameter, and can be a character, structure of characters, FULLWORD parameter, or array of FULLWORD parameters.

VTYPE

QMF data type of the value string VALUE. This type has one of two values, which are provided in the communications macro, 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 specified in the VALUE field must have the data type specified in VTYPE.

VL is the assembler VARIABLE LIST statement.