uttplbas.wbb - Load Data Template from BASIS Data Dictionary

Syntax

CALL "uttplbas.wbb", dict$, fl$, control$, tpl$, errmsg$

Description

This low-level routine is designed to quickly return a template for a file defined in the BASIS data dictionary, which is a directory that contains the BASIS data files, LOCAT.1, FIELD.1, and TYPDEF.1. This program works directly with the dictionary files. There is no need to initialize the extended utility or data dictionary environments.

Parameter

Description

dict$

Name of the directory where the dictionary files are stored. If empty, the files must be accessible through normal PREFIX-based directory searching.

fls$

Name of the file of the dictionary to be loaded.

control$

Internally tracks open file channels used by this program. It should be null when this routine is first called, and passed unchanged to additional calls of this program. To close the channels manually, the channel values are stored in control$ in the 2-byte binary increments dec(control$(1,2)), dec(control$(3,2)), and dec(control$(5,2)).

tpl$

Returns the data template for the specified file.

errmsg$

Error message to return if the template generation failed for any reason.