TMSCRIPT.DOC

                                      
                                                       
                                 
                                         
                                              
                                              
                                  
                                                            
                                                            
                                                            




                           Telemate Script Language

                                 Version 4.12



                      By  Tsung Hu, White River Software





                 Copyright (c) 1988-1993 White River Software.

                              All rights reserved.


TELEMATE SCRIPT                                     TABLE OF CONTENTS    i

TABLE OF CONTENTS

INTRODUCTION                                                             1
    Using TMS.EXE, the Script Compiler  . . . . . . . . . . . . . . . .  1
    To Run a Script . . . . . . . . . . . . . . . . . . . . . . . . . .  1
    What Is Your Name . . . . . . . . . . . . . . . . . . . . . . . . .  2

DATA TYPES                                                               3
    Integer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
    String  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
    Character . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
    Boolean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
    Date  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
    Time  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4

VARIABLES                                                                5
    Variable Identifiers  . . . . . . . . . . . . . . . . . . . . . . .  5
    Variable Declarations . . . . . . . . . . . . . . . . . . . . . . .  5
    Predefined Variables  . . . . . . . . . . . . . . . . . . . . . . .  5
       CONNECTED  . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
       FOUND  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  6
       SUCCESS  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  6
       LOGGING  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
       WIDTH  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
       HEIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  8

EXPRESSIONS                                                              9
    Rule Of Precedence  . . . . . . . . . . . . . . . . . . . . . . . .  9
    Arithmetic Operators  . . . . . . . . . . . . . . . . . . . . . . .  9
    Boolean Operators . . . . . . . . . . . . . . . . . . . . . . . . .  9
    Relational Operators  . . . . . . . . . . . . . . . . . . . . . . . 10

STATEMENTS                                                              11
    Comment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
    Assignment Statement  . . . . . . . . . . . . . . . . . . . . . . . 11
    If Statement  . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
    Switch Statement  . . . . . . . . . . . . . . . . . . . . . . . . . 12
    While Loop  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
    Repeat Loop . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
    Exit Statement  . . . . . . . . . . . . . . . . . . . . . . . . . . 14
    #include Directive  . . . . . . . . . . . . . . . . . . . . . . . . 15

PROCEDURES                                                              16
    Procedure Declaration . . . . . . . . . . . . . . . . . . . . . . . 16
    Parameter Declaration . . . . . . . . . . . . . . . . . . . . . . . 17
    Calling Procedure and Parameter Passing . . . . . . . . . . . . . . 17
    Nested Procedures and Scope of Variables  . . . . . . . . . . . . . 18
    Return Statement  . . . . . . . . . . . . . . . . . . . . . . . . . 19

BUILT IN PROCEDURES BY CATEGORY                                         20
    Console I/O . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
       Print Statement  . . . . . . . . . . . . . . . . . . . . . . . . 20
    COM I/O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
       Put Statement  . . . . . . . . . . . . . . . . . . . . . . . . . 21
       Waitfor Statement  . . . . . . . . . . . . . . . . . . . . . . . 21

TELEMATE SCRIPT                                    TABLE OF CONTENTS    ii


    File Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
    String Handling . . . . . . . . . . . . . . . . . . . . . . . . . . 22
    Miscellaneous Routines  . . . . . . . . . . . . . . . . . . . . . . 22

BUILT IN PROCEDURES                                                     23
    Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
    Append  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
    At  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
    Atoi  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
    ChDir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
    Clear COM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
    Clear Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
    Clear Text  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
    Close . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
    ComInCount  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
    ComOutCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
    Concat  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
    Create  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
    Date  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
    Delay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
    Delete  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
    Dial  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
    Dos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
    ExitTelemate  . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
    FileExist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
    FileSize  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
    Get . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
    GetCh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
    HangUp  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
    Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
    Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
    InputCh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
    Itoa  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
    Keystroke . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
    Length  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
    LoadFon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
    LoadKey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
    LoadMac . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
    LoadPad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
    LogOff  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
    LogOn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
    LogPause  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
    LogResume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
    Open  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
    Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
    Put . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
    Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
    Read  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
    ReadCh  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
    Receive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
    Rename  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
    Script  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
    Seek  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
    Send  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
    Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
    Stop  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

TELEMATE SCRIPT                                   TABLE OF CONTENTS    iii


    StrDel  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
    StrIns  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
    StrPos  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
    StrSet  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
    SubStr  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
    Tell  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
    Time  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
    Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
    Waitfor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
    WaitUntil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
    When  ...