HP 3000 Manuals HP 3000 Manuals
COBOL/HP-UX Operating Guide for the Series 700 and 800 HP 9000 Computers Printed in U.S.A. HP Part No. B2433-90009 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 B3157-90004 * COBOL/HP-UX Language Reference Manual Vol. 1 & 2 (part number B2433-90007) * COBOL/HP-UX Operating Guide (part number B2433-90009) * COBOL/HP-UX Compatibility Guide (part number B2433-90011) replaces B3157-90010 * COBOL/HP-UX Error Messages (part number B2433-90013) replaces B3157-90004 * COBOL/HP-UX Master Index (part number B2433-90015) * COBOL/HP-UX Pocket Guide (part number B2433-90017) 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 B2437-90006) * Installing and Updating HP-UX (part number B2437-90003) * How HP-UX Works: Concepts for the System Administrator (part number B1862-90005) * Programming on HP-UX (part number B2355-90025) * HP Symbolic Debugger User's Guide (part number 31508-90003) Preface Micro Focus COBOL is a system for developing and running COBOL programs. This manual describes operating procedures for the UNIX resident releases of the Micro Focus COBOL system. Audience It is assumed that you are familiar with the COBOL language. Additionally, some experience of the UNIX operating system is desirable. To get the most out of the information in this Operating Guide, you already should have read the Getting Started book included with this product and installed the software. Related Publications Other manuals in the Micro Focus COBOL document set are: * Getting Started * Language Reference * Error Messages * 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, the Enter key is not explicitly shown; it is treated as implicit that Enter must be pressed at the end of the line. * Hexadecimal numbers are enclosed in quotation marks and preceded by a lower-case "x"; for example, x"9D". * The term "window" means a delineated area of the screen normally smaller than the full screen. 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 printed in non-italics are the actual words you must enter. You must enter them in the exact case in which they appear. * 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 ellipses (...) 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 which are compatible with UNIX System V, Release 3 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 system environments, you should refer to your Release Notes for details of the commands you need 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. Where examples showing environment variables do not specifyically show them being exported to the shell, it is treated as implicit that envionment variables are exported. * The keys described in this documentation are not available in 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 manual. This will not affect the operation of your software. About This Manual The material in this manual is essentially technical, describing all the options available to you when using the software supplied in this product. It supplements the Language Reference, which describes the COBOL syntax available for use with this product, and concentrates on the effects of using particular syntax in the UNIX environment. Part Structure This manual is divided into a number of parts, each part containing a number of chapters all related to a specific topic. The chapters are numbered sequentially through the manual. The parts are: I. COBOL Program Development This part goes through the procedures needed to produce and run executable files from COBOL source code. It covers all the available options for compiling, debugging, generating, linking and running. It also describes the COBOL system library routines available and includes guidelines for writing more efficient programs. II. File Handling This part discusses the file handling provided by this COBOL product. Additional information required for the effective use of files with this system is also included. III. Screen, Keyboard and Device Handling This part describes the facilities available in this product for communicating with the screen, keyboard and other system devices. It explains how to get the best from the product in using the facilities available. IV. Additional COBOL System Features This part describes the following facilities that provide enhanced functionality for this system: Communications Module, H2CPY, Integrated Preprocessor, National Language Support and Run-Time Configuration. V. Appendices This part describes advanced programming features, compatibility issues, system limits and programming restrictions and UNIX key usage. Advanced user and reference material relating to information described in some chapters in the manual is also supplied. Chapter Structure Each chapter in this manual (except for the Introduction to each part) is dedicated to a system component. The chapters are ordered alphabetically within their Part to help you to locate information. To find the chapter on a particular component, you can either use the main Table of Contents or flip through the book until you find the relevant chapter title shown on the right-hand edge of each page. Each chapter begins with a brief abstract describing the function of the component followed by these sections: * Table of Contents The Table of Contents at the beginning of each chapter contains a more complete description of the chapter than is shown in the main Table of Contents. * Overview The Overview contains an expanded description of the component, including its purpose and features. * Operation The Operation section describes any preparation that needs to be done before using the component and then explains how to activate and use the software. Some chapters may contain some additional sections which give detailed information beyond the basic operating instructions. Some chapters also have related appendices, providing advanced user or reference material. These appendices are cross referenced in the relevant chapters.