A GCL Programmer's Manual ASCALE 7000 DPS7000/XT NOV Job Control and IOF REFERENCE 47 A2 36UJ 05 DPS7000/XTA NOVASCALE 7000 GCL Programmer's Manual Job Control and IOF August 1999 BULL CEDOC 357 AVENUE PATTON B.P.20845 49008 ANGERS CEDEX 01 FRANCE REFERENCE 47 A2 36UJ 05 The following copyright notice protects this book under Copyright laws which prohibit such actions as, but not limited to, copying, distributing, modifying, and making derivative works. Copyright Bull SAS 1996, 1999 Printed in France Suggestions and criticisms concerning the form, content, and presentation of this book are invited. A form is provided at the end of this book for this purpose. To order additional copies of this book or other Bull Technical Publications, you are invited to use the Ordering Form also provided at the end of this book. Trademarks and Acknowledgements We acknowledge the right of proprietors of trademarks mentioned in this book. Intel® and Itanium® are registered trademarks of Intel Corporation. Windows® and Microsoft® software are registered trademarks of Microsoft Corporation. UNIX® is a registered trademark in the United States of America and other countries licensed exclusively through the Open Group. Linux® is a registered trademark of Linus Torvalds. The information in this document is subject to change without notice. Bull will not be liable for errors contained herein, or for incidental or consequential damages in connection with the use of this material. Preface Scope and This manual explains the GCL interface with GCOS 7 in interactive and batch Objectives modes. Intended This publication is intended for all GCOS 7 users. It complements the information Readers given in the IOF Terminal User's Reference Manual to which the reader must refer for detailed information on the set of system-level commands, directives and utilities. Other aspects for handling the system are treated in the IOF Programmer's Manual. Prerequisites It describes all the essential GCL functions. The primitives dealt with are in GPL and COBOL, and where applicable, the FORTRAN and C language equivalents are given. Structure Section 1 describes the general requirements of programming in GCL and the creation of new GCL commands. Section 2 treats GCL in terms of basic commands, system variables and builtin functions. Section 3 deals with command management and how to handle libraries, their members and the workspace. Section 4 describes how to use GCL in accessing GCOS files and lists the commands available. Section 5 deals with the GCL batch job and the parametrization of statements and input enclosures. Section 6 treats aspects for TRACE and DEBUG facilities when handling GCL procedures. Section 7 describes primitives and the use of help texts for assuring the Programmatic Interface for GCL translation. 47 A2 36UJ Rev05 iii GCL Programmer's Manual Bibliography GCOS 7 System Administrator's Manual (V7) ........................................ 47 A2 41US GCOS 7 System Operator's Guide (V7)................................................... 47 A2 47US GCOS 7 System Administrator's Guide (V8 and V9)............................... 47 A2 54US GCOS 7 System Operator's Guide (V8 and V9) ...................................... 47 A2 53US IOF Terminal User's Reference Manual Part 1....................................................................................................... 47 A2 38UJ Part 2....................................................................................................... 47 A2 39UJ Part 3....................................................................................................... 47 A2 40UJ IOF Programmer's Manual ..................................................................... 47 A2 37UJ JCL Reference Manual .............................................................................47 A2 11UJ JCL User's Guide .................................................................................... 47 A2 12UJ GPL Reference Manual ...........................................................................47 A2 35UL GPL User's Guide....................................................................................47 A2 36UL GPL System Primitives Reference Manual..............................................47 A2 34UL C Language User's Guide........................................................................47 A2 60UL C Language Primitives Reference Manual..............................................47 A2 64UL COBOL 85 Reference Manual.................................................................47 A2 05UL COBOL 85 User's Guide .........................................................................47 A2 06UL FORTRAN 77 Reference Manual ............................................................47 A2 15UL FORTRAN 77 User's Guide.....................................................................47 A2 06UL GCOS 7 File Recovery Facilities User's Guide ......................................47 A2 37UF Text Editor User's Guide .........................................................................47 A2 05UP FULL Screen Editor User's Guide ..........................................................47 A2 06UP Library Maintenance Reference Manual.................................................47 A2 01UP Library Maintenance User's Guide .........................................................47 A2 02UP Data Management Utilities User's Guide ...............................................47 A2 26UF iv 47 A2 36UJ Rev05 Preface Syntax The following notation is used in syntax formats: Notation ITEM Capitals represent a keyword that is to be entered as-is. item Small italics represent a metalanguage term for which the user supplies a value. In the following, the non-italic item represents either a keyword or a metalanguage term: [ item ] An item within square brackets is optional. { item1 } { item2 } or { item1 | item2 | item3 } { item3 } A set of items within braces: − either in a column − or in a line separated by | means one item must be selected. The default, if any, heads the list and is underlined. ... An ellipsis indicates that the item it follows may be repeated. 47 A2 36UJ Rev05 v GCL Programmer's Manual vi 47 A2 36UJ Rev05 Table of Contents 1. Introduction 1.1 Command Language....................................................................................................... 1-1 1.1.1 Purpose of Command Language....................................................................... 1-1 1.1.2 Objects............................................................................................................... 1-2 1.1.3 Variables and Expressions ................................................................................ 1-2 1.2 Global Variables.............................................................................................................. 1-4 1.2.1 Declaring Global Variables ................................................................................ 1-5 1.2.2 Assigning Values to Variables ........................................................................... 1-9 1.2.3 Types ............................................................................................................... 1-11 1.2.4 References to Variables .................................................................................. 1-12 1.3 Expressions................................................................................................................... 1-14 1.4 Reading and Writing Values ......................................................................................... 1-16 1.5 Stored Sequences of GCL ............................................................................................ 1-18 1.5.1 ALTER_INPUT Command............................................................................... 1-19 1.5.2 EXECUTE_GCL Command............................................................................. 1-20 1.6 STARTUP Sequences .................................................................................................. 1-21 1.6.1 IOF Startups .................................................................................................... 1-21 1.6.2 Batch Startups ................................................................................................. 1-23 1.7 Creating New GCL Commands .................................................................................... 1-24 1.7.1 Domains, Libraries and Search Rules ............................................................. 1-24 1.7.2 MAINTAIN_COMMAND................................................................................... 1-27 1.7.3 GCL Procedures .............................................................................................. 1-28 1.7.4 Example 1: Creating a Directive ...................................................................... 1-32 1.7.5 Example 2: Creating a new IOF Command..................................................... 1-34 1.8 Absentee Jobs .............................................................................................................. 1-36 47 A2 36UJ Rev05 vii GCL Programmer's Manual 1.9 SYS.SPOOL Files......................................................................................................... 1-37 1.9.1 Purpose of SYS.SPOOL Files ......................................................................... 1-37 1.9.2 Use of SYS.SPOOL Files ................................................................................ 1-37 1.9.3 Number of SYS.SPOOL