[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 CA-Clipper Real Mode Linker--BLINKER.EXE
 Features high-speed linking, dynamic overlaying, caching of overlay,
 compression of the symbol table, and "burning" the CLIPPER environment
 variable
------------------------------------------------------------------------------

 Blinker Commands

     Script file(s) are specified on the command line and default to an
     extension of .LNK.  They may be nested, and more than one may be used on
     the command line, for example:

     BLINKER @Defaults @Other LIB Mylib VERBOSE

     This command line instructs Blinker to read the script file DEFAULTS.LNK
     followed by the script file OTHER.LNK.  It also instructs Blinker to use
     the library MYLIB.LIB and to display a VERBOSE listing of the .OBJ files
     being processed.  The full names of the commands, or any unique
     abbreviation of the words which comprise the commands, may be used
     although it is recommended that at least three letters be used for
     clarity.  For example, the command BLINKER OVERLAY OPSIZE 40 can be
     abbreviated to BLI OVE OPS 40.

     Most Blinker commands may be specified in any order, at any point in the
     link script file.  Typically the first FILE statement should specify the
     .OBJ containing the main program procedure.

     # ...

     Indicates text as a script file comment.  Any line in the script file
     beginning with the character # is treated as a comment and is ignored by
     Blinker.  If the # ... character occurs within a line, the rest of the
     line is ignored.

     // ...

     Indicates text as a script file comment.  Any line in the script file
     containing the characters // is treated as a comment and is ignored by
     Blinker.  If the // ... characters occur within a line, the rest of the
     line is ignored.

     @<scriptname>

     Specify the name of a script file.  Blinker supports nested script files
     of any size to a depth of 5 levels.  The processing of nested script
     files is similar to a program function call.

     BEGINAREA

     Specifies the start of a dynamic overlay area to the linker.  Each
     BEGINAREA should have a corresponding ENDAREA to indicate the end of the
     overlay area.

     BLINKER CACHE EMS <nuMax[%]>
        [, <nuMinLeave[%]>]

     Specifies the amount of EMS (LIM version 4.0 and higher) memory to be
     used for the overlay cache.  Two numeric parameters are used to specify
     the amount of EMS memory to be allocated and the amount to be left for
     program use.  Both parameters may be specified as either a number of KB,
     or as a percentage of the total available EMS.

     BLINKER CACHE XMS <nuMax[%]>
        [, <nuMinLeave[%]>]

     Specifies the amount of XMS (version 2.0 and higher) memory to be used
     for the overlay cache.  Two numeric parameters are used to specify the
     amount of XMS memory to be allocated and the amount to be left for
     program use.  Both parameters may be specified as either a number of KB,
     or as a percentage of the total available XMS.

     BLINKER CLIPPER PAGE ON | OFF

     Enables/Disables automatic CA-Clipper 5.3 code paging.

     BLINKER ENVIRONMENT CLIPPER <cName>

     Changes the name of the CA-Clipper environment variable from the default
     setting of "CLIPPER" to any string of up to 16 characters, and thus
     avoids the remote site settings for the CLIPPER environment variable.

     BLINKER ENVIRONMENT NAME <cName>

     Specifies the name of the environment variable for Blinker runtime
     options.  By default, if the argument is not specified, the default
     setting is BLINKER.

     BLINKER ENVIRONMENT OVERRIDE

     Commands Blinker to allow the CA-Clipper environment variables set using
     the BLINKER EXECUTABLE CLIPPER command to be overridden at application
     run time by the settings of the CLIPPER environment variable.  When
     doing this, you may want to consider renaming your CLIPPER environment
     variable with the command BLINKER ENVIRONMENT CLIPPER.

     BLINKER EXECUTABLE CLIPPER <cEnvironmentstring>

     Burns default values for the CA-Clipper runtime environment variables
     into the executable file.  Those settings set using the BLINKER
     EXECUTABLE CLIPPER command take precedence over those set with the SET
     CLIPPER command.

     BLINKER EXECUTABLE NODELETE

     Creates .EXE regardless of unresolved externals, although the resulting
     .EXE is not guaranteed to operate correctly.

     BLINKER LINK EMS ON | OFF

     Controls whether or not EMS memory is used at link time by the virtual
     memory system within Blinker.

     BLINKER LINK PAGEFRAME ON | OFF

     Controls the use of the EMS pageframe by Blinker at link time by the
     virtual memory system within Blinker.

     BLINKER LINK XMS ON | OFF

     Controls whether or not XMS memory is used at link time by the virtual
     memory system within Blinker.

     BLINKER MESSAGE DUPLICATES

     Causes Blinker to generate the 1004 link-time warning message for all
     duplicate symbols within libraries encountered at link time.

     BLINKER MESSAGE NOBLINK

     Disables the blinking eyes which are displayed while Blinker is running.

     BLINKER MESSAGE NOWARNING

     Suppresses the display of Blinker link-time warning messages 1001 to
     1100.

     BLINKER MESSAGE WINK [LEFT]

     Enables single eye winking during linking.  If no parameter is entered,
     the right eye will wink (from Blinker.s point of view, i.e., from inside
     the screen looking out).  The parameter LEFT causes the left eye to
     wink.

     BLINKER OVERLAY OPSIZE <nuSize>

     Requests a size for the overlay pool at run time in KB.  It can be set
     to any value between 12KB and 128KB.  The default operating size is
     40KB.

     BLINKER OVERLAY PAGEFRAME ON | OFF

     Allows the overlay manager to utilize the expanded memory pageframe for
     the overlay pool (maximum size 64Kb), on machines equipped with LIM EMS
     (3.2 or higher) expanded memory boards or emulators.

     BLINKER OVERLAY THRESHOLD <nuLimit>

     Sets the threshold size below which code specified to be overlaid will
     be moved back to the root section of the program.

     BLINKER OVERLAY UMB ON | OFF

     Used in conjunction with a suitable XMS driver it allows the Blinker
     overlay manager to execute overlays in upper memory blocks above 640KB.

     BLINKER PROCEDURE DEPTH <nuDepth>

     Specifies maximum depth of CA-Clipper procedure nesting.  This depth is
     the number of procedure calls that are executed before a procedure
     return.

     DEFINE <symbol>[, <symbol> ...]

     Specifies symbols to be excluded at link time and points them to a dummy
     routine in the overlay manager.

     DEFLIB

     Uses default library search records to locate and link libraries which
     are specified within an object module.

     ECHO [ON | OFF |] [<cString>]

     ECHO ON <cString> turns on echoing of the script file to the screen,
     with the first line displayed being <cString> if it is specified.  ECHO
     OFF turns off echoing to the screen of the script file and ignores the
     rest of the line.

     ENDAREA

     Specifies the end of an overlay area to the linker, as described in the
     BEGINAREA section.

     EXTDICTIONARY

     Specifies that Blinker should use the extended dictionary that is
     appended to library files by some librarian utility programs.

     FILE [d:][path]<filename>
        [, [d:][path]<filename> ...]

     Specifies to the linker the names of one or more .OBJ files to be
     included in the output file at that point.

     LIBRARY [d:][path]<libname>
        [, [d:][path]<libname> ...]

     Specifies one or more program libraries required by the program.

     MAP [=[d:][path]<filename>] [S][,A]

     Requests a segment map of the executable.

     MIXCASE

     Causes Blinker to treat all publics and externals as case sensitive at
     link time, rather than converting them to UPPERCASE.

     MODULE <module> [,<module> ...]
        [FROM <libname>]

     Specifies placement of individual library modules regardless of whether
     the originating libraries or object modules are specified within an
     overlay area or not.

     MURPHY

     Causes the overlay manager to attempt to force any inadvertent overlay
     errors (programming errors) to manifest themselves during testing or
     debugging.

     NOBELL

     Suppresses the beep upon completion of link.

     NODEFLIB

     Ignores default library search records which are encountered within
     object modules.

     NOEXTDICTIONARY

     Disables processing of extended library dictionaries.

     NOTABLEOFCONTENTS

     Disables processing of library table of contents.

     OUTPUT [drive:][path]<filename>

     Specifies the name of the output executable file to be created by the
     linker.

     READONLY

     Specifies executable file will be set to read-only status.

     SEARCH [d:][path]<libname>
        [, [d:][path]<libname> ...]

     Prioritizes all symbols in the specified libraries.

     SECTION INTO <ovlname>
        [FILE [d:][path]<filename>
        [, [d:][path]<filename>...] ]

     Specifies files to be placed in an external overlay.

     STACK <nuSize>

     Specifies to Blinker in HEXADECIMAL the stack size in bytes required by
     the program .EXE file.

     UPPERCASE

     Specifies to the linker that all symbols should be converted to
     uppercase before being added to the symbol table.

     VERBOSE [0 | 1 | 2]

     Displays status information during linking.

     WORKFILE [d:][path]<filename>

     Specifies drive, path, and file name of the temporary WORKFILE to use at
     link time if one is required.

 Linker Function

     nuValue := BLIVERNUM()

     Returns the Blinker version number as an integer containing the version
     number of Blinker used to link the program.

See Also: SET CLIPPER SET LIB SET OBJ SET TMP
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson