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.
