Function call for REXX

The callable interface is accessed by using normal REXX function calls. QMF provides an external subroutine called DSQCIX, which is used to run all SAA Query commands.

DSQCIX Linear Syntax

call DSQCIX cmd parmlist

• cmd is a QMF command written as an uppercase character string.
• parmlist is a list of parameter and value pairs, as shown in the following diagram:

      .-+---+--------------.
      | '-,-'              |
      V                    |
>>-(----parmname--=--value-+--+---+----------------------------><
                              '-)-'

The entire command, including the parmlist, should be passed to QMF as a single REXX variable written as a character string. This string must be enclosed in quotation marks (' ') or (" "). When using REXX variables as part of the command string, don't enclose the argument. For example:

CALL DSQCIX "RUN QUERY NAME (&ECN="REXAUG",CONFIRM=YES)"

parmname

Name of a parameter.

value

Value that is to be associated with the parameter name specified by parmname.

Examples:

call DSQCIX "RUN QUERY Q1"
call DSQCIX "PRINT REPORT (FORM=F1"
call DSQCIX "EXIT"

In the parmlist, the same results occur whether the following elements are present or not:

Comma (.) between parameters

A space produces the same result

Closing parenthesis ())

Not required

Equal sign (=) between parmname and value

A space produces the same result

Each of the following would produce the same result.

call dsqcix "SET GLOBAL (abc=17, def=26"
call dsqcix "SET GLOBAL ( abc=17 def=26"
call dsqcix "SET GLOBAL ( abc=17 , def=26)"
call dsqcix "SET GLOBAL (abc 17 def=26)"