XLNT Reference Manual Version 5 Advanced Systems Concepts, Inc. Twelve Printing: November 2017 [V5.0 SP1] Eleventh Printing: July 2014 [V5.0] Tenth Printing: January 2006 [V4.0] Ninth Printing: April 2001 [V3.0] Eighth Printing: June 2000 [V2.0 SP4] Seventh Printing: September 1999 [V2.0 SP4] Sixth Printing: May 1999 [V2.0 SP3] Fifth Printing: February 1999 [V2.0 SP2] Fourth Printing: September 1998 [V2.0 SP1] Third Printing: May 1998 [V2.0] Second Printing: January 1998 (V1.1 (SP4)) First Printing: March 1997 (V1.1) The information in this document is subject to change without notice and should not be construed as a commitment by Advanced Systems Concepts, Inc. (ASCI). ASCI assumes no responsibility for any errors that may appear in this document. The software described in this document is furnished under license, and may only be used or copied in accordance with the terms of such license. The terms and conditions of license are furnished with the product in both hard copy as well as electronic form. ASCI logo and XLNT are registered trademarks of Advanced Systems Concepts, Inc. ASCI, XLNT logo are trademarks of Advanced Systems Concepts. Inc. Microsoft, Windows NT, ActiveX and Systems Management Server are trademarks of Microsoft Corporation. Copyright 1997-2017, Advanced Systems Concepts, Inc., Morristown, New Jersey, 07960, All Rights Reserved. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, recording or by any information storage and retrieval system, without the written permission of Advanced Systems Concepts, Inc. Table of Contents 1 LICENSE AGREEMENT ........................................................... 1 2 INTRODUCTION ...................................................................... 4 2.1 System Requirements ........................................................................................... 4 2.2 Software Requirements ........................................................................................ 4 2.3 Product Editions .................................................................................................... 5 2.4 Installation Procedure .......................................................................................... 7 2.4.1 Registry Entries ............................................................................................... 8 2.4.2 XLNT Console Window ................................................................................. 8 2.4.3 SET HOST Installation ................................................................................... 9 2.4.4 SET HOST Security and Registry ................................................................. 10 2.5 Support ................................................................................................................ 12 2.5.1 XLNT Support Programs .............................................................................. 12 3 USING XLNT .......................................................................... 13 3.1 Command Interpreter Processing ..................................................................... 13 3.2 Interacting with XLNT ....................................................................................... 13 3.2.1 XLNT Command Syntax .............................................................................. 15 3.2.2 Entering an XLNT Command ....................................................................... 15 3.2.3 Editing the XLNT Command Line ............................................................... 16 3.2.4 XLNT Mouse Handling ................................................................................ 16 3.3 Symbols ................................................................................................................ 18 3.3.1 Defining Foreign Commands ........................................................................ 19 3.3.2 Display and Deleting Symbols ...................................................................... 21 3.3.3 Declared Symbols ......................................................................................... 22 3.3.4 Implicit Symbols ........................................................................................... 24 3.3.5 Labels ............................................................................................................ 24 3.3.6 Supported Datatypes ..................................................................................... 25 3.3.7 Object Reference ........................................................................................... 30 3.4 Operators ............................................................................................................. 31 3.4.1 String Operators ............................................................................................ 31 3.5 Logical Values and Expressions ......................................................................... 33 3.5.1 Numeric Operators ........................................................................................ 34 3.5.2 Logical Operators .......................................................................................... 34 3.6 Functions .............................................................................................................. 34 3.7 Files and Directories ........................................................................................... 36 3.7.1 UNC Specifications....................................................................................... 36 3.7.2 FTP URL Specifications ............................................................................... 37 3.8 Date and Time Format ....................................................................................... 38 3.8.1 Absolute Time ............................................................................................... 38 3.8.2 Delta Time .................................................................................................... 39 3.8.3 Combination Time ........................................................................................ 40 3.9 Writing Procedures ............................................................................................. 41 3.9.1 Handling Error Conditions ............................................................................ 42 3.9.2 Handling Error Conditions from DOS/CMD Programs ................................ 44 3.9.3 Handling Control/C Interruptions ................................................................. 44 3.10 Command Procedure Input ............................................................................... 45 3.11 In-Script Data Processing ................................................................................... 46 3.12 Command Procedure Output ............................................................................ 47 3.13 Reading and Writing Files ................................................................................. 47 3.14 Controlling Execution Flow ............................................................................... 48 4 INTERACTIVE DEVELOPMENT ENVIRONMENT AND DEBUGGING FACILITY 51 4.1 Starting the IDE .................................................................................................. 51 4.2 Creating and Editing a Script ............................................................................ 52 4.3 Debugging an XLNT Script ............................................................................... 53 4.4 Tools and Customization of the IDE ................................................................. 57 5 XLNT AND DOS/WIN CMD .................................................... 60 6 USING XLNT AS A CGI ......................................................... 61 6.1 Extracting QUERY_STRING ............................................................................ 62 6.2 Installing the Sample CGI Script ....................................................................... 62 7 USING XLNT FOR ACTIVEX AND WINDOWS SCRIPTING HOST PROCESSING 66 8 USING XLNT FOR LOGON SCRIPT PROCESSING ............. 70 9 FILE-PROCESSING COMMAND SUMMARY ........................ 71 9.1 APPEND Command .......................................................................................... 71 9.2 CLOSE Command ............................................................................................. 73 9.3 COPY Command ............................................................................................... 74 9.4 CREATE Command .......................................................................................... 77 XLNT® Reference Manual ii 9.5 CREATE/DIRECTORY Command ................................................................. 78 9.6 DELETE Command .......................................................................................... 79 9.7 DELETE/SYMBOL Command ......................................................................... 81 9.8 DIFFERENCES Command ............................................................................... 82 9.9 DIRECTORY Command .................................................................................. 85 9.10 DISABLE ............................................................................................................. 90 9.11 DISCONNECT FILE Command ....................................................................... 91 9.12 DISCONNECT SESSION Command ..............................................................