Binder Manual - NonStopTools

1 Binder ManualAbstractThis Manual describes Binder , the product that reads, links, and produces object files. This Manual is a user's guide and reference Manual for software developers who need to link and modify object VersionT9621 at and D30 Supported Release Version Updates (RVUs)This Manual supports and all subsequent D-series RVUs, and all subsequent G-series RVUs, and and all subsequent H-series RVUs until otherwise indicated in a new NumberPublished528613-003 July 2005 Document History Part NumberProduct VersionPublished48509 Binder C30 September 1991085670 Binder D10 January 1993109641 Binder D30 December 1994528613-001 Binder D30 August 2004528613-003T9621 2005 Hewlett-Packard Company 528613-003iBinder ManualGlossaryIndexFiguresTablesWhat s New in This ManualviiManual InformationviiNew and Changed InformationviiAbout This ManualixNotation

2 Conventionsix1. IntroductionDefinition of binding1-1 Forms of Binder1-2 BINSERV1-2 BIND1-3 Languages Used with Binder1-4 Relation of Binder to Crossref, Inspect, and the Accelerator1-52. Using BinderRunning Binder2-1 Manual Operation2-1 Command File Operation2-2 Examples2-2 Defining the Target File2-3 Specifying Input File Names2-3 Specifying the Target File Order2-4 Binding Modules2-5 Binding Rules2-6 Examples2-9 Binding COBOL85 and FORTRAN Programs2-10 Binding C Programs2-11 Binding Pascal Programs2-12 Binding Mixed-Language Programs2-13 Parameter Checking for a Mixed-Language Bind2-14 Binding SQL Program Files2-14 Resolving External References2-16 ContentsBinder Manual 528613-003ii2.

3 Using Binder (continued)2. Using Binder (continued)Specifying a Different Volume for Binder Work Files2-17 When Using BIND2-18 When Using BINSERV2-18 Specifying the Swap Volume for Pascal and C Programs2-18 Generating Output Listings2-19 Target File Statistics2-19 Load Maps2-21 Cross-Reference Lists2-253. BIND CommandsSummary of Most Commonly Used Commands3-2 How to Use BIND Commands Efficiently3-3 Searching for Files3-3 Replacing Procedures3-3 Turning off Load Maps3-4 Binding without Fixups3-4 Syntax Conventions for Name Lists as Command Elements3-4 ADD Command3-6 ALTER Command3-9 BUILD Command3-10CD Command3-14 CHANGE Command3-15 CLEAR Command3-18 COMMENT Command3-18 DELETE Command3-19 DUMP Command3-20 ENV Command3-22 EXIT Command3-22FC Command3-22 FILE Command3-23 HELP Command3-23 INFO Command3-24 LIST Command3-27 LMAP

4 Command3-31 LOG Command3-31 MODE Command3-32 MODIFY Command3-33 MOVE Command3-35 ContentsBinder Manual 528613-003iii3. BIND Commands (continued)3. BIND Commands(continued)OBEY Command3-37 OUT Command3-38 RENAME Command3-39 REPLACE Command3-40 RESELECT Command3-42 RESET Command3-44 SATISFY Command3-46 SELECT Command3-48 SET Command3-56 SHOW Command3-65 STRIP Command3-73 SYSTEM Command3-75 VERIFY Command3-75 VOLUME Command3-764. Object File StructureCode Blocks, Entry Points, and Data Blocks4-1 Code Blocks4-1 Primary and Secondary Entry Points4-2 Data Blocks4-4 Object File Format4-8 Header4-9 Code Region4-9 Data Region4-11 Accelerator Region4-11 Inspect Region4-11 Binder Region4-115.

5 Binder Input and OutputThe Input Control Lists5-1 Creating the Input Control Lists5-2 How Binder Uses the Input Control Lists5-3 The Target File5-8 Target File Attributes5-8 How Binder Builds the Target File5-11 ContentsBinder Manual 528613-003iv6. User Libraries6. User LibrariesBinding User-Library Procedures6-1 Object File Format6-2 Preventing Binder Resolution of Library Calls6-2 Compilation-Time Binding6-2 Command-Driven Binding6-2 Specifying a User Library6-3 Restrictions on User Libraries6-3 Shared Run-Time Libraries6-4 Building Applications That Use SRLs6-4 Using Binder Commands With SRLs6-4 Reserving Space With the SET RESERVE Command6-57.

6 Guardian File Names and TACL CommandsDisk File Names7-1 Parts of a Disk File Name7-2 Partial File Names7-3 Logical File Names7-4 Internal File Names7-4 TACL Commands7-4 TACL DEFINE Commands7-5 Substituting a File Name7-5 TACL DEFINE Names7-5 Setting DEFINE CLASS Attributes7-6 TACL PARAM Commands7-7 PARAM BINSERV Command7-7 PARAM SAMECPU Command7-7 PARAM SWAPVOL Command7-8 PARAM SYMSERV Command7-8 Using PARAM Commands7-8 TACL ASSIGN Commands7-9 ContentsBinder Manual 528613-003v8. Binder Messages8. Binder MessagesError Messages and Warnings8-1 Completion Codes8-289.

7 Syntax SummaryGlossaryIndexFiguresFigure : Compilation-Time Binding1-3 Figure : Command-Driven Binding1-4 Figure References2-17 Figure File Statistics2-20 Figure Entry Point Map for Entry Points and Code Blocks2-22 Figure Point Map by Location for Multiple Code Segments2-23 Figure Load Maps for Data Blocks2-24 Figure for Read-Only Data Blocks2-25 Figure Listing2-26 Figure of the Binder Object File Format4-8 TablesTa b l e 1 -1 .Languages used with Binder1-4Ta b l e 2 - 1 .Target File Specifications built by Binder2-4Ta b l e 2 - 2.

8 Binder Grouping of ENV Directive Parameters2-7Ta b l e 2 - 3 .Run-Time Environment Resulting From Binding Modules2-9Ta b l e 2 - 4 .Commands that Produce Listings2-19Ta b l e 2 - 5 . Binder Statistics2-20Ta b l e 2 - 6 .Information Included in Load Maps for Entry Points2-22Ta b l e 2 - 7 .Information Included in Load Maps for Data Blocks2-24Ta b l e 3 - 1 .Commonly Used BIND Commands3-2Ta b l e 3 - 2 .Syntax Conventions for Named Lists3-4Ta b l e 3 - 3 .Resulting Target Processor Type3-62Ta b l e 4 - 1 .Code Block Attributes4-2Ta b l e 5 - 1.

9 Commands That Create Control Lists5-2Ta b l e 5 - 2 .Target File Attributes5-9Ta b l e 6 - 1 . Binder Commands Used With Shared Run-Time Libraries6-5Ta b l e 8 - 1 . Binder Completion Codes8-28Ta b l e 9 - 1 . Binder Command Summary9-1 ContentsBinder Manual 528613-003viBinder Manual 528613-003viiWhat s New in This ManualManual InformationBinder ManualAbstractThis Manual describes Binder , the product that reads, links, and produces object files. This Manual is a user's guide and reference Manual for software developers who need to link and modify object VersionT9621 at and D30 Supported Release Version Updates (RVUs)This Manual supports and all subsequent D-series RVUs, and all subsequent G-series RVUs, and and all subsequent H-series RVUs until otherwise indicated in a new History New and Changed InformationThis revision describes the changes and additions made to the D30 product version of Binder (T9621) and the Binder Manual .

10 This revision also incorporates support for T9621 on TNS/E systems running software. Summary of ChangesThis edition of the Manual includes previously undocumented warnings and messages for the Binder product. The changes include: This publication has been updated to reflect new product NumberPublished528613-003 July 2005 Part NumberProduct VersionPublished48509 Binder C30 September 1991085670 Binder D10 January 1993109641 Binder D30 December 1994528613-001 Binder D30 August 2004528613-003T9621 2005 What s New in This ManualBinder Manual 528613-003viiiSummary of Changes Because the product names are changing over time, this publication might contain both HP and Compaq product names.