General Format and Usage

General Format and Usage

This section describes the callable modules in DSILIB:DSILIB.OLB. Most of these routines are used to support the screen handling system but there are other miscellaneous routines that provide easy program access to common functions.

Each section lists the parameters used in calling the module. Unless otherwise specified, all numeric parameters are passed by reference and all string parameters are passed by descriptor. This is the default passing mechanism for most higher level languages.

For each parameter the data type of the parameter and the access mode by the module is given. The access mode is as follows:

R- Module only reads the value of the parameter
W- Module writes to the parameter
RW- Module both reads and writes the parameter

All of the examples used in this section are in VAX Basic. The include file DSILIB:ENTER_BASIC.INC also contains declarations for all the modules so that the compiler can detect errors in calling the modules, such using with the wrong number of parameters, which would be a fatal run time error, and using the wrong data type, which usually allows a program to run but can result in side effects that are difficult to debug.