HP 3000 Manuals HP 3000 Manuals
HP Link Editor/XL Reference Manual Printed in U.S.A. 900 Series HP 3000 Computers HP Part No. 32650-90030 Edition Fourth E1290
________________________________________________________________________ |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.| | | |This document contains proprietary information which is protected by | |copyright. All rights are reserved. No part of this document may be | |photocopied, reproduced or translated to another language without the | |prior written consent of Hewlett-Packard Company. | ________________________________________________________________________ copyright (c)1987, 1988, 1989, 1990 by Hewlett-Packard Company Printed 19901201 Print History The following table lists the printings of this document, together with the respective release dates for each edition. The software code printed alongside the current edition date indicates the version level at the time the manual was issued. Many product releases do not require changes to the document. Therefore, do not expect a one-to-one correspondence between product releases and document editions. First Edition November 1987 Second Edition October 1988 Third Edition October 1989 Fourth Edition December 1990 HP30315A.04.00 Preface This manual describes the HP Link Editor/XL subsystem and how you use it with 900 Series HP 3000 computer systems. The manual assumes that you are an experienced programmer, but not necessarily familiar with "linkers" and "loaders". This manual contains the following chapters: Chapter 1 Gives an overview of HP Link Editor/XL - what it is, when to use it and how it works. This chapter also summarizes the differences between Link Editor/XL and its MPE counterpart, the MPE V Segmenter. Chapter 2 Contains a simple tutorial to help you become familiar with the primary functions of HP Link Editor/XL. Since HP Link Editor/XL differs substantially from the MPE V Segmenter, this chapter helps those familiar with MPE V to quickly understand the difference. Chapter 3 Describes the files used by HP Link Editor/XL and gives the rules for entering Link Editor/XL commands. Chapter 4 Discusses the HP Link Editor/XL commands that create and display executable program files. Chapter 5 Discusses the HP Link Editor/XL commands that create and maintain relocatable libraries. Chapter 6 Discusses the HP Link Editor/XL commands that create and maintain executable libraries. Chapter 7 Discusses advanced ways to use HP Link Editor/XL. Appendix A Lists warning and error messages, along with their remedial actions. Appendix B Explains how HP COBOL II/XL programs interface with HP Link Editor/XL. Appendix C Explains how HP FORTRAN 77/XL programs interface with HP Link Editor/XL. Appendix D Explains how HP Pascal/XL programs interface with HP Link Editor/XL. Appendix E Explains how HP C/XL programs interface with HP Link Editor/XL. Appendix F Compares HP Link Editor/XL to the MPE V Segmenter. Appendix G Contains the HP Link Editor/XL command summary. Additional Documentation This manual does not discuss the MPE XL operating system in detail. Only those aspects relevant to HP Link Editor/XL are mentioned. Similarly, details about compiling a program using HP COBOL II, HP FORTRAN 77, HP Pascal, and HP C are only discussed to the extent that they affect how you use HP Link Editor/XL. See the appropriate operating system or language manual for complete information about those subjects. The following is a partial list of the operating system and language manuals: ---------------------------------------------------------------------- | | | Manual Title Manual Number to Use | | Part Number to | | Order Manual | | | ---------------------------------------------------------------------- | | | MPE XL Commands Reference Manual 32650-90003 32650-60002 | | | | MPE XL Intrinsics Reference Manual 32650-90028 32650-60013 | | | ---------------------------------------------------------------------- | | | HP COBOL II/XL Reference Manual 31500-90001 31500-60001 | | | | HP COBOL II/XL Reference Manual 31500-90005 31500-60001 | | Supplement | | | | HP COBOL II/XL Programmer's Guide 31500-90002 31500-60002 | | | ---------------------------------------------------------------------- | | | HP FORTRAN 77/XL Reference Manual 31501-90010 31501-60002 | | | | HP FORTRAN 77/XL Programmer's Guide 31501-90011 31501-60004 | | | ---------------------------------------------------------------------- | | | HP Pascal Reference Manual 31502-90001 31502-60005 | | | | HP Pascal Programmer's Guide 31502-90002 31502-60006 | | | ---------------------------------------------------------------------- | | | HP C/XL Reference Manual 92434-90001 31506-60001 | | | | HP C/XL Library Reference Manual 30026-90001 31506-60001 | | | | HP C Programmer's Guide 92434-90002 31506-60002 | | | ---------------------------------------------------------------------- | | | HP Symbolic Debugger/XL User's Guide 31508-90003 31508-60003 | | | | HP Symbolic Debugger/XL Quick 31508-90005 31508-60004 | | Reference Guide | | | ---------------------------------------------------------------------- Conventions CASE In a syntax statement, commands and keywords must be entered in exactly the order shown, though you can enter them in either uppercase or lowercase. For example: SHOWJOB can be entered as any of the following: showjob ShowJob SHOWJOB It cannot, however, be entered as any of the following: shojwob Shojob SHOW_JOB italics In a syntax statement, a word in italics represents a parameter or argument that you must replace with an actual value. In the following example, you must replace filename with the name of the file: RELEASE filename punctuation In a syntax statement, punctuation characters (other than brackets, braces, vertical bars, and ellipses) must be entered exactly as shown. In the following example, the parentheses and colon must be entered: ( filename):( filename) underlining Within an example that contains interactive dialog, user input and user responses to prompts are indicated by underlining. In the following example, "yes" is the user's response to the prompt: Do you want to continue? >> yes { } In a syntax statement, braces enclose required elements. When several elements are stacked within braces, you must select one. In the following example, you must select either ON or OFF: SETMSG {ON } {OFF} Commands listed in braces are called command lists throughout this manual. [ ] In a syntax statement, brackets enclose optional elements. In the following example, ,TEMP can be omitted: PURGE filename[,TEMP] When several elements are stacked within brackets, you can select one or none of the elements. In the following example, you can select devicename or deviceclass or neither. The elements cannot be repeated. SHOWDEV [devicename ] [deviceclass] [...] In a syntax statement, horizontal ellipses enclosed in brackets indicate that you can repeatedly select the element(s) that appear within the immediately preceding pair of brackets or braces. In the example below, you can select itemname zero or more times. Each instance of itemname must be preceded by a comma: [, itemname] [...] In the example below, you only use the comma as a delimiter if itemname is repeated; no comma is used before the first occurrence of itemname: [ itemname] [,...] |...| In a syntax statement, horizontal ellipses enclosed in vertical bars indicate that you can select more than one element within the immediately preceding pair of brackets or braces. However, each particular element can only be selected once. In the following example, you must select A, AB, BA or B. The elements cannot be repeated. {A}|...| {B} ...: In an example, horizontal or vertical ellipses indicate where portions of the example have been omitted. _ In a syntax statement, the space symbol _ shows a required blank. In the following example, modifier and variable must be separated with a blank: SET [( modifier)]_( variable); The symbol indicates a key on the keyboard. For example, RETURN represents the carriage return key. CNTL char CNTL char indicates a control character. For example, CNTLY means you press the control key and the Y key simultaneously. base prefixes The prefixes %, #, and $ specify the numerical base of the value that follows: %num specifies an octal number # num specifies a decimal number $ num specifies a hexadecimal number If no base is specified, decimal is assumed. Bits ( bit:length) When a parameter contains more than one piece of data within its bit field, the different data fields are described in the format Bits ( bit:length) bit is the first bit in the field and length is the number of consecutive bits in the field. For example, Bits (13:3) indicates bits 13, 14, and 15:
![[]](../../pic3k/M011499/FFN23c50.gif)