TACL Reference Manual - NonStopTools

1 HP NonStop tacl . Reference Manual Abstract This publication describes the syntax and use of the HP Tandem Advanced Command Language ( tacl ) variables, commands, and built-in functions. Product Version T9205D46, T9205H01. Supported Release Version Updates (RVUs). This publication supports and all subsequent J-series RVUs, and all subsequent H-series RVUs, and all subsequent G-series RVUs, and and all subsequent D-series RVUs, until otherwise indicated by its replacement publications. Additionally, all considerations for H-series throughout this Manual will hold true for J-series also, unless mentioned otherwise.

2 Part Number Published 429513-017 August 2013. Document History Part Number Product Version Published 429513-013 T9205D46, T9205H01 November 2010. 429513-014 T9205D46, T9205H01 August 2011. 429513-015 T9205D46, T9205H01 February 2012. 429513-016 T9205D46, T9205H01 August 2012. 429513-017 T9205D46, T9205H01 August 2013. Legal Notices Copyright 2013 Hewlett-Packard Development Company Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR and , Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the Government under vendor's standard commercial license.

3 The information contained herein is subject to change without notice. The only warranties for HP. products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Export of the information contained in this publication may require authorization from the Department of Commerce. Microsoft, Windows, and Windows NT are registered trademarks of Microsoft Corporation. Intel, Itanium, Pentium, and Celeron are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

4 Java is a trademark of Oracle and/or its affiliates. Motif, OSF/1, UNIX, X/Open, and the "X" device are registered trademarks and IT DialTone and The Open Group are trademarks of The Open Group in the and other countries. Open Software Foundation, OSF, the OSF logo, OSF/1, OSF/Motif, and Motif are trademarks of the Open Software Foundation, Inc. OSF MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THE OSF MATERIAL PROVIDED. HEREIN, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. OSF shall not be liable for errors contained herein or for incidental consequential damages in connection with the furnishing, performance, or use of this material.

5 1990, 1991, 1992, 1993 Open Software Foundation, Inc. This documentation and the software to which it relates are derived in part from materials supplied by the following: 1987, 1988, 1989 Carnegie-Mellon University. 1989, 1990, 1991 Digital Equipment Corporation. 1985, 1988, 1989, 1990 Encore Computer Corporation. 1988 Free Software Foundation, Inc. 1987, 1988, 1989, 1990, 1991 Hewlett-Packard Company. 1985, 1987, 1988, 1989, 1990, 1991, 1992 International Business Machines Corporation. 1988, 1989 Massachusetts Institute of Technology. 1988, 1989, 1990 Mentat Inc. 1988 Microsoft Corporation.

6 1987, 1988, 1989, 1990, 1991, 1992 SecureWare, Inc. 1990, 1991 Siemens Nixdorf Informationssysteme AG. 1986, 1989, 1996, 1997 Sun Microsystems, Inc. 1989, 1990, 1991 Transarc Corporation. This software and documentation are based in part on the Fourth Berkeley Software Distribution under license from The Regents of the University of California. OSF acknowledges the following individuals and institutions for their role in its development: Kenneth Arnold, Gregory S. Couch, Conrad C. Huang, Ed James, Symmetric Computer Systems, Robert Elz. 1980, 1981, 1982, 1983, 1985, 1986, 1987, 1988, 1989 Regents of the University of California.

7 Printed in the US. HP NonStop tacl Reference Manual Glossary Index Figures Tables Legal Notices What's New in This Manual xvii Manual Information xvii New and Changed Information xvii About This Manual xix Audience xix Organization xix Related Reading xx Notation Conventions xxii HP Encourages Your Comments xxvi 1. Overview of tacl . Using tacl Interactively 1-1. Developing tacl Programs 1-2. Language Features 1-3. Program Development Tools 1-4. Using tacl With Other Subsystems 1-4. 2. Lexical Elements Character Set 2-1. Data 2-1. variable Names 2-1. Upshifting 2-1. Special Characters 2-2.

8 Metacharacters 2-2. Separator Characters 2-5. Question Mark (?) 2-6. Ampersand (&) 2-6. Template Characters 2-6. Operators 2-8. Constants 2-8. Hewlett-Packard Company 429513-017. i Contents 3. Expressions Text Constants 2-8. String Constants 2-9. Reserved Words 2-9. Comments 2-10. 3. Expressions Operators 3-1. Arithmetic Operations 3-2. Logical Operations 3-2. 4. Variables An Overview of tacl Variables 4-1. variable Names 4-2. variable Levels 4-3. Declaring a variable 4-3. Specifying a Level of a variable 4-4. Deleting a variable 4-5. Accessing variable Contents 4-5. Using a variable as an Argument 4-6.

9 TEXT Variables 4-6. Sample Declarations 4-6. ALIAS Variables 4-6. Sample Declarations 4-7. Limitations 4-7. MACRO Variables 4-7. Macro Arguments 4-8. Sample Declarations 4-8. ROUTINE Variables 4-9. Routine Arguments 4-9. Sample Declaration 4-10. Comparing Argument Handling in Macros and Routines 4-11. STRUCT Variables 4-12. Elements of STRUCT Variables 4-12. Limitations on the Use of STRUCT Variables 4-12. Declaring a Structure Body 4-13. Declaring a Simple Data Item 4-15. Declaring an Array Data Item 4-18. Declaring a Substructure 4-19. Declaring FILLER Bytes 4-20. Redefining a Structure 4-23.

10 HP NonStop tacl Reference Manual 429513-017. ii Contents 5. Statements and Programs Setting or Altering Structured Data 4-25. Accessing Structured Data 4-26. DIRECTORY Variables 4-28. Declaring a Directory variable 4-29. Accessing a Directory variable 4-29. Directories Supplied With tacl 4-30. DELTA Variables 4-30. 5. Statements and Programs Function Calls 5-1. Directives 5-5. ?BLANK Directive 5-6. ?FORMAT Directive 5-6. ?SECTION Directive 5-8. ? tacl Directive 5-9. tacl Programs 5-9. Program Structure 5-10. How tacl Interprets Statements 5-11. Creating Program Files 5-12. Handling tacl Errors 5-21.