Monarch 9460 READ

5-70 Command Reference

READ

Purpose Copies the current record from the lookup file into the appropriate working buffer.

Syntax READ

record

[

( table-name )

] [

,

[

invalid label

] [

, valid label

] ]

Process The READ command copies the current record into the appropriate working buffer,

specified by

record

. After the script copies the current record into the buffer, the

pointer advances to the next

record

in the file.

Table-name

selects which lookup

table to read.

Record

can be one of the following:

Record

Description

LOOKUP Copies the Lookup Table record into the Lookup

Buffer

Rule: A successful read increments the file pointer to the next record.

Optional Fields

Invalid

and

valid labels

are discussed in "Script Flow" at the beginning of this

chapter. The exception is as follows:

If there is no record to read or the current record is pointing to a different record

type, and

invalid label

is defined, control passes to that label.

Example

This example shows how the software copies the current lookup table record into

the lookup table buffer. Control passes to the next line.

READ LOOKUP

See Also

BSEARCH

QUERY

SEEK

Contents

Main Page TABLE OF CONTENTS Page Page Page OVERVIEW How to Use this Manual A Review of Terms Page USING THE SOFTWARE System Requirements Quick Reference Operators Handbook Installing the Software Getting Started Page Saving a File About Projects 1. 2. 3. Building Projects Changing the Download Settings If you select COM1 - COM4: 4. If you select LPT1 LPT2: 5. Downloading a Project Editing Existing Projects Page PRINTER PROCEDURES Displaying the Ready Prompt No Application Loaded Application 1. Loading Applications Restarting Existing Applications Loading New Applications PROGRAM STRUCTURE Functions Starting a Script Files and Buffers Lookup Table Definition Temporary Storage Definition Printer Definition Scope of Field Names Script Flow Control Comments in a Script Data Storage Data Coding COMMAND REFERENCE Programming Conventions Field Names Keywords Page Special Characters Script Flow When a label is NOT defined... When a label is defined... Functional Relationships Math Commands Script Control Commands Compiler Directives Data Manipulation Commands File Management Commands Input/Output Commands ADD APPVERSION ARGREAD ASC AUTOSTART AVAILABLEDATA BITCLEAR BITMASK BITSET BITSHIFT BITTEST BSEARCH CALL param1, param2, ,paramX Example 1 Param param Page CHARTYPE CHECK Page CHR CLEAR item Example 2 Example 1 Item CLOSECOMM COMPARE CONCAT CSTRIP DATATYPE DEC DEFINE Field-type data-typ field-type Data-type Page DELAY DISABLE DIVIDE ENABLE EXIT FETCH FIELDLEN FIXDATA Buffer-field1 Example Buffer Field1 GENERATE GET HOTKEY IF buffer-field2 Buffer-fields buffer-fields Page INC INCLUDE INSERT JUMP label Example LABELCOUNT LEFT LINKFILE file-name Example 1 format-name\file-name LOCATE LOWER LSTRIP MACRO Page MID MOVE Page MULTIPLY OPENCOMM PAD PARSE , valid label Example valid labels Invalid PRINT QUERY Page READ RESTORESCREEN RETURN RIGHT RSTRIP SAVESCREEN SEEK SUB SWITCH Page SYSSET parameter2 function, parameter1, and parameter2 parameter2 parameter1 Function/Description Parameter1 Parameter2 Example TOKEN TSTRIP UPPER VALIDATE , valid label Example valid labels Invalid WHILE buffer-field1 comparison buffer-field2 Comparison Buffer-field Page Page SAMPLE SCRIPT A Page Page Page INDEX A B C D F G H I J Q R S T