ENFORM User's Guide

Interface Procedures
Host Language Interface
058058 Tandem Computers Incorporated 6–5
restart-flag
INT:value, is used when there is more than one query to be run by the host
application program. A nonzero value causes the existing query processor to
begin the next query with a new parameter and assign list, which is more
economical than creating a new query processor for each query. When the
existing query processor is used to begin the next query, the parameter values for
ctlblock, process-name, cpu, and priority for the ENFORMSTART procedure must be
identical to those for the initial call to the ENFORMSTART procedure or they must
not be used.
A zero value for restart-flag causes a new query processor to be created. It is more
expensive to start up a new query processor for each query run.
param-list
INT:ref, is a pointer to the parameter (name:value) list in a form equivalent to the
PARAM message generated by the Command Interpreter. See the GUARDIAN
Operating System Programmer’s Guide for the correct format.
assign-list
INT:ref, is a pointer to a sequence of one or more ASSIGN messages, each
formatted as an ASSIGN message by the Command Interpreter. See the
GUARDIAN Operating System Programmer’s Guide for the correct format. These
messages are preceded by a one-word header that contains a number equal to the
total messages (31 or fewer messages) in the list.
Assign-list is used to override the physical filename or names for input files to the
query. Any physical filename not expanded in the ASSIGN message will use the
default volume and subvolume. If that is undesirable, the host language program
must fill in the correct volume or subvolume after receiving ASSIGN messages
from the Command Interpreter and before passing assign-list to ENFORMSTART.
When assign-list is not used, the Tandem physical filename compiled into the
query is used.
Assign-list can contain generic file names. Refer to the ENFORM Reference Manual
for information about generic files. If the generic file QUERY-QPSTATUS-
MESSAGE is specified from a host language program, ENFORM uses the message
text from $SYSTEM.SYSTEM.ENFORMMK. There is no way to specify a new
message table from a host language program.
The physical filename and its exclusion specification (Shared, Protected, or
Exclusive) can be overridden. When not overridden, the query processor always
opens the physical input files with shared mode.