Flag Parameters
The parameters and values that you can use in a call subsystem statement are specific to each subsystem or application. Many of these parameters are equivalent to the flags that you use when you call the subsystem directly from the operating system command line.
You can pass flags to the subsystem in two ways:
• Use parametername as a keyword synonym for a flag.
To specify the flag, use the format:
parametername = value
• Use flags = 'flag_list'
where flag_list is a list of flags enclosed in single quotes. Separate individual flags in the list with blanks or tabs. Flag designations in this format are identical to those specified in the command line version of the subsystem call.
Both methods of passing flags are shown in the following example where tblfld is the 4GL synonym for the -t flag. You can call Query-By-Forms (QBF) with the -t flag using either of the following statements:
call qbf(tblfld = 'customer');
or
call qbf(flags = '-tcustomer');
You can use both of these formats in the same statement. However, do not pass the same flag twice.
For most subsystem calls, you can use the flags parameter to pass the value of any flag, including those that do not have defined 4GL keyword synonyms (parameternames). However, you cannot pass the -u flag to a called subsystem. (You can specify this flag only when you initially connect to a database at the start of the underlying application.)
The flags parameter does not exist for calls to the application subsystem. Also, calls to the Terminal Monitor (call sql) can use the flags parameter only for a few limited flags (for more information, see the call sql statement in
Subsystem Types (see
Subsystem Types)).