HP 3000 Manuals HP 3000 Manuals
COBOL/HP-UX Getting Started for the Series 700 and 800 HP 9000 Computers Printed in U.S.A. HP Part No. B2433-90005 Edition Third Edition E0293
(c) Copyright 1993 Hewlett-Packard Company. This document contains information which is protected by copyright. All rights are reserved. Reproduction, adaptation, or translation without prior written permission is prohibited, except as allowed under the copyright laws. Restricted Rights Legend Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in sub-paragraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause in DFARS 252.227-7013. Hewlett-Packard Company 3000 Hanover Street Palo Alto, CA 94304 U.S.A. Rights for non-DOD U.S. Government Departments and Agencies are as set forth in FAR 52.227-19(c)(1,2). Use of this manual and flexible disks(s) or tape cartridge(s) supplied for this pack is restricted to this product only. Additional copies of the programs can be made for security and back-up purposes only. Resale of the programs in their present form or with alterations, is expressly prohibited. (c)Copyright 1980, 1984, 1986 AT&T Technologies, Inc. UNIX is a registered trademark of UNIX System Laboratories Inc. in the U.S.A. and other countries. COBOL is an industry language and is not the property of any company or group of companies or group of organizations. No warranty, expressed or implied, is made by any contributor or by the CODASYL Programming Language Committee as to the accuracy and functioning of the programming system and language. Moreover, no responsibility is assumed by any contributor, or by the committee, in connection herewith. The authors and copyright holders of the copyrighted material used herein: FLOW-MATIC (Trademark for Sperry Rand Corporation) Programming for the Univac(R) I and II, Data Automation Systems copyrighted 1958, 1959, by Sperry Rand Corporation; IBM(R) Commercial Translator Form No. F28-8013, copyrighted 1959 by IBM; FACT, DS127A5260-2760, copyrighted 1960 by Minneapolis-Honeywell. have specifically authorized the use of this material in whole or in part, in the COBOL specifications. Such authorization extends to the reproduction and use of COBOL specifications in programming manuals or similar publications. The software described in this document is supplied under a license and may be used or copied only in accordance with the terms of such license, and in particular any warranty of fitness of Micro Focus software products for any particular purpose is expressly excluded and in no event will Micro Focus be liable for any consequential loss. Micro Focus has made every effort to ensure that this manual is correct and accurate, but reserves the right to make changes without notice at its sole descretion at any time. Micro Focus(R) is a registered trademark of Micro Focus Ltd. Micro Focus(TM), VS COBOL(TM), ANIMATOR(TM), LEVEL II COBOL(TM), LEVEL II COBOL/ET(TM), and Professional COBOL(TM) are trademarks of Micro Focus Ltd. IBM(R) is a registered trademark of International Business Machines Corporation. Systems Application Architecture(TM) is a trademark of International Business Machines Corporation Data General(R) is a registered trademark of Data General Corporation RM/COBOL(R) is a registered trademark of Ryan-McFarland Corporation. Microsoft(R) is a registered trademark of Microsoft Corporation UNIX(R) is a registered trademark of AT&T PANVALET(TM) is a trademark of Pansophic LIBRARIAN(TM) is a trademark of Computer Associates X/Open(R) is a registered trademark of the X/Open Company Limited in the UK and other countries. (c) Copyright 1978, 1992 by Micro Focus Ltd. All rights reserved. Printed February 1993 Legal Notices The information contained in this document is subject to change without notice. HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance or use of this material. Hewlett-Packard assumes no responsibility for the use or reliability of its software on equipment that is not furnished by Hewlett-Packard. Warranty A copy of the specific warranty terms applicable to your Hewlett-Packard product and replacement parts can be obtained from your local Sales and Service Office. Print History New editions are complete revisions of the manual. The dates on the title page change only when a new edition is printed. The software code printed alongside the date indicates the version level of the software product at the time the manual was issued. Many product updates and fixes do not require manual changes and, conversely, manual corrections may be done without accompanying product changes. Therefore, do not expect a one-to-one correspondence between product updates and manual updates. First Edition June 1991 35328B.04.50 Second Edition November 1991 35328B.06.25 Third Edition February 1993 B2433B.07.00 Additional Documentation The following documents are supplied with COBOL/HP-UX. * COBOL/HP-UX Implementation Notes for Series 700/800 (part number B2433-90001) * COBOL/HP-UX Getting Started (part number B2433-90005) replaces 35328-90002 * COBOL/HP-UX Language Reference Manual Vol. 1 & 2 (part number B2433-90007) replaces 35328-90001 * COBOL/HP-UX Operating Guide (part number B2433-90009) replaces 35328-90002 * COBOL/HP-UX Compatibility Guide (part number B2433-90011) replaces 35328-90003 * COBOL/HP-UX Error Messages (part number B2433-90013) replaces 35328-90002 * COBOL/HP-UX Master Index (part number B2433-90015) * COBOL/HP-UX Pocket Guide (part number B2433-90017) replaces 35328-90012 Refer to the following documents for more information on the HP-UX operating system: * HP-UX Reference (part number B2355-90033) * HP-UX System Administration Tasks Manual (part number B3108-90012) * Installing and Updating HP-UX (part number B3108-90006) * How HP-UX Works: Concepts for the System Administrator (part number B2355-90029) * Installing and Administering NFS Services (part number B1013-90009) * Programming on HP-UX (part number B2355-90026) * HP Symbolic Debugger User's Guide (part number B2355-90044) Your Getting Started Book This volume contains two books: * Getting Started with COBOL * Getting Started with Toolbox Each introduces you to the specified system, introduces the topic of installing it, describes how to use it, and guides you around the features, utilities and documentation it contains. Details of installation procedure are given in a separate Read This First card, as they may differ depending on your version of UNIX.
NOTE You need only read the Getting Started book for the COBOL system you have now acquired.
The two books appear in the order: COBOL, COBOL Toolbox. Each is identified by a grey tab printed on the right-hand edge of each page, so you can turn easily to the one you want. Each book is a complete book, containing its own Table of Contents and Index. Before turning to the appropriate book, please take time to read the information in the rest of this introduction. In particular, please note the following about licensing. Licensing Certain components of your COBOL system can be shipped on to your users to support your applications, provided you conform to the license agreement that accompanies this product. This is explained in detail in your Getting Started book. A list of the components covered is given in the section Shippable Components at the end of these introductory pages. COBOL and COBOL Toolbox The product you have acquired is one of two related products: * Micro Focus COBOL * Micro Focus COBOL Toolbox COBOL The main component of Micro Focus COBOL is the cob command. This calls the Compiler and the Native Code Generator to turn COBOL source into object code. This can be in .o files, in which case cob can then call the system linker to turn the object code into executable code, linking it with library routines provided to support the COBOL code. Alternatively it can be in one of two Micro Focus formats. It can be intermediate code, which is highly portable between Micro Focus systems on different environments, or generated code, which is optimized for your current environment. These formats are run using the cobrun command. Micro Focus COBOL also includes some programming tools, most notable of which is the Animator. This is a testing tool that lets you watch and alter the flow of control through your source code as your program is running. COBOL Toolbox Micro Focus COBOL Toolbox provides a menu-driven environment, called the Toolbox Development Environment, from which you invoke the components. All the component of Micro Focus COBOL are included. Also provided is an editor called the COBOL Editor, which you can use to write your source program. You can also use the Compiler and Animator from within the COBOL Editor. Toolbox includes many other tools and modules that extend the features available from within COBOL. You have the same choice as with Micro Focus COBOL, of producing object code in .o files, intermediate code, or generated code. Shippable Components Important CREATING, DISTRIBUTING AND LICENSING YOUR APPLICATIONS FOR INTERNAL USE AND RESALE When you build a statically linked executable version of your application, Micro Focus library routines are linked with it. For your application to execute on an end-user system, a Run-Time Environment must also be provided with it. A Run-Time Environment must also be provided if you distribute your application as intermediate code (.int) files or any combination of .int, .gnt, and statically linked executable files. An additional charge is payable to Micro Focus for distribution of copies of the Run-Time Environment. A further charge is payable to Micro Focus for distribution of copies of the Operating System Extensions. Please contact your Micro Focus Account Representative for details of these charges. Library routines are defined as those routines that are supplied in the following archive files: libcobol.a libasmcrtn.a libcobwin1.a libcrtn.a libfhutil.a libscreen.a libsupp.a Components which are supplied by Micro Focus as part of the product, other than those listed on the following pages, must not be reproduced or distributed. ------------------------------------------------------------------------- | | | COBOL Run-Time Environment: | | | | | | * BTRIEVE Interface (Btr2xfh) | | | | * CISAM v4 objects | | | | * COBOL Communications Module | | | | * Copy Protection Mechanism (Activate) (if supplied) | | | | * File Handler (EXTFH) | | | | * File Handler Utilities | | | | * Installation Script (install) | | | | * PANELS | | | | * Product Version File (cobver) | | | | * Run-time Trigger (cobrun) | | | | * Screen and Keyboard Handler (ADIS) | | | | * Screen and Keyboard Configuration Tools (adiscf and keybcf) | | | | * The run-time libraries that support industry-standard object | | files (.o), Micro Focus format object files (.int and .gnt), | | and executable files. | | | ------------------------------------------------------------------------- | | | Operating System Extensions: | | | | | | * COBOL System Library Routines (call-by-name with CBL_prefix) | | documented in Toolbox | | | | * Common Communications Interface (CCI) - CCITCP Protocol | | | | * Fileshare Version 2 | | | ------------------------------------------------------------------------- Micro Focus COBOL for UNIX Getting Started with COBOL Micro Focus(R) Issue 2 June 1992 Micro Focus has made every effort to ensure that this manual is correct and accurate, but reserves the right to make changes without notice at its sole discretion at any time. The software described in this document is supplied under a license and may be used or copied only in accordance with the terms of such license, and in particular any warranty of fitness of Micro Focus products for any particular purpose is expressly excluded and in no event will Micro Focus be liable for any consequential loss. Micro Focus(R) is a registered trademark of Micro Focus Limited. ANIMATOR(TM), CCI(TM), Co-Writer(TM), Directory Facility(TM), Operating System Extensions(TM), PANELS(TM), PANELS Version 2(TM), Run Time Environment(TM), RTE(TM), Structure ANIMATOR(TM), Toolbox(TM), Micro Focus COBOL(TM), Micro Focus COBOL Toolbox(TM), Micro Focus COBOL/2(TM), and Dialog System(TM) are trademarks of Micro Focus Limited. IBM(R) is a registered trademark of International Business Machines Corporation. IBM COBOL/2(TM), OS/2(TM), PS/2(TM), OS/VS COBOL, VS COBOL II, DOS/VS COBOL, and Systems Application Architecture(TM) are trademarks of International Business Machines Corporation. Microsoft Windows(TM) is a trademark of Microsoft Corporation. RM/COBOL(R) is a registered trademark of Ryan-McFarland Corporation. X/Open(R) is a registered trademark of X/Open Company Limited. UNIX(R) is a registered trademark of AT&T. Copyright(c) 1987, 1992 Micro Focus All Rights Reserved. Printed in U.S.A. Preface for COBOL for UNIX Micro Focus COBOL is a system for developing and running programs written in COBOL. The system supports COBOL as defined in American National Standard X3.23-1985, plus other dialects including IBM OS/VS COBOL, IBM VS COBOL II, COBOL/370, IBM SAA COBOL, X/Open COBOL, and many others. As a result this system can be used both for new program development and for COBOL programs that currently operate on other environments. Audience This book is intended for programmers already familiar with the COBOL language and with the operating system on which they will be using this product. It is for all programmers using this COBOL system, whether experienced with earlier versions or completely new to this system. Related Publications Other manuals in your document set are: * Language Reference * Error Messages * COBOL Operating Guide * Compatibility Guide * Pocket Guide * Master Index Notation In This Manual * Enter refers to the carriage return or Enter key. Where commands to be typed are shown, Enter is not explicitly shown; it is treated as implicit that it must be pressed at the end of the line. * F1=Help is not described in the documentation. Help is context sensitive and appears on each menu in the system. * Hexadecimal numbers are enclosed in quotation marks preceded by a lower-case "x"; for example, x"9D". The notation used to describe the format of command lines is as follows: * Words printed in italics are generic terms representing names to be devised by you. * Words not in italics are the actual words you must enter. You must type them in upper or lower case as shown. * Material enclosed in square brackets [ ] is optional. * When material is enclosed in braces { }, you must choose from the options within them. If there is only one option in the braces, the braces indicate repetition. * The ellipsis (...) follows { } or [ ] and means you can repeat the material in the { } or [ ]. The number of repetitions allowed is unlimited unless otherwise stated. If the ellipsis is used with [ ] the material can be omitted altogether. * If a command line will not fit across the page, it is continued on the next line; the continuation line is indented. UNIX Considerations * The term "UNIX" can be taken to mean all operating systems that are compatible with UNIX System V, Release 3.0 or later, complying with the System V Interface Definition (SVID). * The commands given in this manual are specifically for the UNIX operating system. For all other similar operating systems, see your Release Notes for the commands to use. You may also be referred to the Release Notes for other operating system specific details. * All command line formats and examples are for the standard UNIX shell, the Bourne shell. If you are using another shell, see your UNIX documentation for the appropriate formats. * The keys described in this documentation are not available on all environments. References to pressing keys such as function or status keys imply the logical pressing and releasing of these keys rather than the physical keystrokes. A chart listing how your actual keystrokes map onto the keys shown in the documentation is provided as an appendix to this book. * You may notice that what appears on your screen sometimes differs in minor ways from that illustrated in the manuals. This will not affect the operation of your software. Micro Focus COBOL Toolbox for UNIX Getting Started with Toolbox Micro Focus(R) Issue 1 June 1992 Micro Focus has made every effort to ensure that this manual is correct and accurate, but reserves the right to make changes without notice at its sole discretion at any time. The software described in this document is supplied under a license and may be used or copied only in accordance with the terms of such license, and in particular any warranty of fitness of Micro Focus products for any particular purpose is expressly excluded and in no event will Micro Focus be liable for any consequential loss. Micro Focus(R) is a registered trademark of Micro Focus Limited. ANIMATOR(TM), CCI(TM), Co-Writer(TM), Directory Facility(TM), Operating System Extensions(TM), PANELS(TM), PANELS Version 2(TM), Run Time Environment(TM), RTE(TM), Structure ANIMATOR(TM), Toolbox(TM), Micro Focus COBOL(TM), Micro Focus COBOL Toolbox(TM), Micro Focus COBOL/2(TM), and Dialog System(TM) are trademarks of Micro Focus Limited. IBM(R) is a registered trademark of International Business Machines Corporation. IBM COBOL/2(TM), OS/2(TM), PS/2(TM), OS/VS COBOL, VS COBOL II, DOS/VS COBOL, and Systems Application Architecture(TM) are trademarks of International Business Machines Corporation. Microsoft Windows(TM) is a trademark of Microsoft Corporation. RM/COBOL(R) is a registered trademark of Ryan-McFarland Corporation. X/Open(R) is a registered trademark of X/Open Company Limited. UNIX(R) is a registered trademark of AT&T. Copyright(c) 1987, 1992 Micro Focus All Rights Reserved. Printed in U.S.A. Preface for Toolbox Micro Focus COBOL Toolbox is a set of software tools, comprising Micro Focus COBOL, many additional utilities, and an integrated, menu-driven environment. The system supports COBOL as defined in American National Standard X3.23-1985, plus other dialects including IBM OS/VS COBOL, IBM VS COBOL II, COBOL/370, IBM SAA COBOL, X/Open COBOL, and many others. As a result this system can be used both for new program development and for COBOL programs that currently operate on other environments. Audience This book is intended for programmers already familiar with the COBOL language and with the operating system on which they will be using this product. It is for all programmers using this COBOL system, whether experienced with earlier versions or completely new to this system. Related Publications Other manuals in your document set are: * Language Reference * Error Messages * COBOL Operating Guide * Toolbox Operating Guide * Compatibility Guide * Pocket Guide * Master Index Notation In This Manual * Enter refers to the carriage return or Enter key. Where commands to be typed are shown, Enter is not explicitly shown; it is treated as implicit that it must be pressed at the end of the line. * F1=Help is not described in the documentation. Help is context sensitive and appears on each menu in the system. * Hexadecimal numbers are enclosed in quotation marks preceded by a lower-case "x"; for example, x"9D". The notation used to describe the format of command lines is as follows: * Words printed in italics are generic terms representing names to be devised by you. * Words not in italics are the actual words you must enter. You must type them in upper or lower case as shown. * Material enclosed in square brackets [ ] is optional. * When material is enclosed in braces { }, you must choose from the options within them. If there is only one option in the braces, the braces indicate repetition. * The ellipsis (...) follows { } or [ ] and means you can repeat the material in the { } or [ ]. The number of repetitions allowed is unlimited unless otherwise stated. If the ellipsis is used with [ ] the material can be omitted altogether. * If a command line will not fit across the page, it is continued on the next line; the continuation line is indented. UNIX Considerations * The term "UNIX" can be taken to mean all operating systems that are compatible with UNIX System V, Release 3.0 or later, complying with the System V Interface Definition (SVID). * The commands given in this manual are specifically for the UNIX operating system. For all other similar operating systems, see your Release Notes for the commands to use. You may also be referred to the Release Notes for other operating system specific details. * All command line formats and examples are for the standard UNIX shell, the Bourne shell. If you are using another shell, see your UNIX documentation for the appropriate formats. * The keys described in this documentation are not available on all environments. References to pressing keys such as function or status keys imply the logical pressing and releasing of these keys rather than the physical keystrokes. A chart listing how your actual keystrokes map onto the keys shown in the documentation is provided as an appendix to this book. * You may notice that what appears on your screen sometimes differs in minor ways from that illustrated in the manuals. This will not affect the operation of your software.