ENFORM User's Guide

Interface Procedures
Host Language Interface
6–4 058058 Tandem Computers Incorporated
TAL:
CALL ENFORMSTART ( ctlblock
, compiled-physical-filename
, buffer-length
, error-number
,[ restart-flag ]
,[ param-list ]
,[ assign-list ]
,[ process-name ]
,[ cpu ]
,[ priority ]
,[ timeout ]
,[ reserved-for-expansion ])
ctlblock
INT:ref, is an 18-word integer array control block which must be supplied for
global storage across the ENFORM procedure calls. This same storage is used in
ENFORMRECEIVE and ENFORMFINISH, and any subsequent calls to
ENFORMSTART. The host application program must not change this control
block between calls to ENFORM.
compiled-physical-filename
INT:ref, is a 12-word array that specifies the physical file containing the compiled
query. The file name must be specified as 24 characters in length with the:
$volume name specified as 8 characters (blank filled if necessary)
subvolume name specified as 8 characters (blank filled if necessary)
disc file name specified as 8 characters (blank filled if necessary)
Refer to the Guardian Operating System User’s Guide for the exact form of a Tandem
internal filename.
buffer-length
INT:value, is the length, in bytes, of the buffer that the process will use to receive
records via ENFORMRECEIVE. Buffer-length must be at least 6. If information in
addition to the error number is desired, buffer-length must be at least 30. See
Table 6-3 later in this section.
error-number
INT:ref, is assigned an error number if an error condition occurs in
ENFORMSTART or ENFORMRECEIVE. It is initialized to zero. Error-number
should be declared global to the ENFORM procedures so that it can be checked
after the ENFORMSTART or ENFORMRECEIVE procedures return. The error
messages are described later in this section.