Dynacomm Connectivity Series® Script Language Reference
Total Page:16
File Type:pdf, Size:1020Kb
DynaComm Connectivity Series® Script Language Reference DCS © 2012 by FutureSoft, Inc. All rights reserved. DynaComm Connectivity Series™ Script Language Reference This manual, and the software described in it, is furnished under a license agreement. Information in this document is subject to change without notice and does not represent a commitment on the part of FutureSoft. The software may be used or copied only in accordance with the terms of the agreement. No part of this manual may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, for any purpose other than the purchaser’s personal use without the written permission of FutureSoft, Inc. DynaComm, DynaComm Connectivity Series, DynaComm Client Option, and FutureSoft are registered trademarks of FutureSoft, Inc. All other trademarks are the property of their respective owners. 1986-2012 FutureSoft, Inc. E-Edition 14-2012 Document #E-DCSR9200 013009 Written and designed at: FutureSoft, Inc. (800) 989-8908 [email protected] http://www.futuresoft.com Contents 1 Introduction to the Script Language .......................................................................................................................................................15 DCS Script Language Overview .........................................................................................16 Creating, Compiling, and Executing a Script ...............................................................17 Commands, Functions and Arguments ..........................................................................20 Command Blocks ....................................................................................................................22 Line Continuation ...................................................................................................................23 Comments .................................................................................................................................24 Labels ..........................................................................................................................................25 Strings .........................................................................................................................................27 Numerics ....................................................................................................................................37 Booleans .....................................................................................................................................40 Special Argument Types .......................................................................................................43 Variable Creation .....................................................................................................................47 Symbols ......................................................................................................................................49 Operators ...................................................................................................................................54 Scoping Rules ..........................................................................................................................59 Parameter Passing & Subroutines ....................................................................................61 Tables, Records and Data Manipulation .........................................................................64 Menus .........................................................................................................................................71 DCS Windows & Window Handles ....................................................................................74 Event Handling - WAIT and WHEN Commands ...........................................................76 Dynamic Data Exchange - DDE ..........................................................................................78 Task Errors ..................................................................................................................................82 Converting Scripts from Previous Versions of DCS .....................................................84 2 Functions .......................................................................................................................................................87 Functions in Alphabetical Order .......................................................................................88 Table of Contents Table Functions by Category ..........................................................................................................92 ACTIVE ......................................................................................................................................96 ATTRIBUTES ............................................................................................................................97 BAND ........................................................................................................................................98 BNOT .........................................................................................................................................99 BOOL ......................................................................................................................................100 iii Contents, continued 2 Functions Functions, continued BOR .........................................................................................................................................101 BUFFER ..................................................................................................................................102 BUFFER, continued ...........................................................................................................103 BXOR ......................................................................................................................................104 CHR .........................................................................................................................................105 CONNECT .............................................................................................................................107 CONNECTMESSAGE ..........................................................................................................108 CONNECTRESULT ..............................................................................................................109 CURSOR ................................................................................................................................110 DATE .......................................................................................................................................111 (DDE) ADVISE ......................................................................................................................112 DECRYPT ...............................................................................................................................113 DEFAULTSESSIONHANDLE .............................................................................................115 (DIALOG) CHECKBOX .......................................................................................................116 (DIALOG) EDITTEXT ..........................................................................................................117 (DIALOG) LISTBOX .............................................................................................................118 (DIALOG) MESSAGEBOX..................................................................................................119 (DIALOG) RADIOGROUP .................................................................................................121 DIALOGHANDLE ................................................................................................................122 DIRECTORY ..........................................................................................................................123 DISKSPACE ...........................................................................................................................125 ENCRYPT ...............................................................................................................................126 EOF .........................................................................................................................................127 ERROR ....................................................................................................................................128 EXFLDATTR ..........................................................................................................................129 EXISTS ....................................................................................................................................134 FILESIZE ................................................................................................................................135 FILTER ....................................................................................................................................136 FLDATTR ...............................................................................................................................138 FLDATTREXPOS ..................................................................................................................140 FLDLEN .................................................................................................................................141