Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Parameter

Qualifiers

/BRIEF

/CONTIGUOUS

/CROSS_REFERENCE

/DEBUG

/EXECUTABLE

/FULL

/HEADER

/INCLUDE

/LIBRARY

/MAP

/OPTIONS

/P0IMAGE

/PROTECT

/SELECTIVE_SEARCH

/SHAREABLE

/SYMBOL_TABLE

/SYSLIB

/SYSSHR

/SYSTEM

/TRACEBACK

/USERLIBRARY

HELP LINK — MicroVMS 4.5B

Produces one executable or shareable image from one or more
object modules and shareable images.

Format
 LINK file-spec,...

Additional information available:

ParameterQualifiers

Parameter

file-spec
 Specification(s) of input file(s) containing object modules,
 libraries, and/or options.  To specify a shareable image as
 an input file, you must use an options file or a shareable
 image library.  An object file cannot be qualified by /LIBRARY,
 /INCLUDE, or /OPTIONS. A library file must be qualified by
 /LIBRARY or /INCLUDE. An options file must be qualified by
 /OPTIONS.  File types default to OBJ for object files, OLB
 for object libraries or shareable image libraries, and OPT
 for options files. Wildcard characters are not permitted.

Qualifiers

Additional information available:

/BRIEF/CONTIGUOUS/CROSS_REFERENCE/DEBUG/EXECUTABLE
/FULL/HEADER/INCLUDE/LIBRARY/MAP/OPTIONS/P0IMAGE
/PROTECT/SELECTIVE_SEARCH/SHAREABLE/SYMBOL_TABLE
/SYSLIB/SYSSHR/SYSTEM/TRACEBACK/USERLIBRARY

/BRIEF

 Generates a map containing an object module synopsis, an image
 synopsis, and LINK run statistics. This qualifier applies only
 when /MAP is specified, and is incompatible with /FULL and
 /CROSS_REFERENCE.

/CONTIGUOUS

 /NOCONTIGUOUS (default)
 Allocates contiguous blocks for the image file or reports an error.

/CROSS_REFERENCE

 /NOCROSS_REFERENCE (default)
 Generates a symbols cross-reference section in the map instead of
 a symbols-by-name section. This qualifier applies only if /MAP is
 specified and is incompatible with /BRIEF.

/DEBUG[=file-spec]

 /NODEBUG (default)
 Makes global symbols available to the debugger at program run time
 and executes the image under debugger control (unless RUN /NODEBUG
 is specified).  The /DEBUG qualifier requires /TRACEBACK -- a
 specification of /NOTRACEBACK is discarded when /DEBUG is specified.
 The optional file specification names a user-supplied debugger module
 to take the place of the default VAX/VMS Symbolic Debugger.  Note that
 a user-supplied debugger is linked into the image, while the VAX/VMS
 Symbolic Debugger does not become part of the image until run time.
 The file type for the file specification defaults to OBJ.

/EXECUTABLE[=file-spec] (default)

 /NOEXECUTABLE
 Produces an executable image.  The file specification defaults
 to the name of the input file (or the first input file) and a
 file type of EXE. If this qualifier follows a file, the file
 specification defaults to the name of the preceding file with
 a file type of EXE.  No wildcards are allowed.  A specification
 of /SYSTEM in addition to /EXECUTABLE=file-spec produces a system
 image with the name specified by /EXECUTABLE.  A specification
 of /NOEXECUTABLE or /EXECUTABLE=NL: causes the link operation to
 take place without producing an executable image;  since some
 qualifiers are invalid with /NOEXECUTABLE, /EXECUTABLE=NL: is
 generally preferred.  If you do not specify /EXECUTABLE, /SHAREABLE,
 or /SYSTEM, a specification of /EXECUTABLE is assumed.

/FULL

 Generates a map containing an object module synopsis, a module
 relocatable reference synopsis, a program section synopsis, a
 symbols-by-name section, an image section synopsis, and a
 symbols-by-value section.  The full map includes information on
 modules taken from the default object library
 SYS$LIBRARY:STARLET.OLB and default shareable image library
 SYS$LIBRARY:IMAGELIB.OLB. This qualifier applies only if /MAP is
 specified and is incompatible with /BRIEF.

/HEADER

 Creates a header for system images (executable and shareable
 images always have headers). This qualifier applies only if
 /SYSTEM is specified.

/INCLUDE=(module-name,...)

 Indicates that the qualified file is an object or shareable
 image library and that the specified modules are to be
 included in the image.  If only one module is specified, you
 can omit the parentheses.  This qualifier does not search the
 library for unresolved references;  to search the library, specify
 the /LIBRARY qualifier.  No wildcards are allowed.  A file
 specification qualified by /INCLUDE cannot be qualified by any
 other qualifier except /LIBRARY.

/LIBRARY

 Qualifies file-spec.
 Indicates that the qualified file is an object or shareable
 image library to be searched for unresolved references. If a
 reference is resolved, that module is included in the image.
 No references are resolved for modules specified after the
 library name on the command line. The linker must begin operating
 with a module;  therefore, do not specify a library as the first
 file specification unless you also qualify it with /INCLUDE.
 A file specification qualified by /LIBRARY cannot be qualified by
 any other qualifier except /INCLUDE.

/MAP[=file-spec] (default in batch mode)

 /NOMAP (default in interactive mode)
 Generates a map of the image.  The file specification defaults
 to the name of the input file (or the first input file) and a
 file type of MAP. If this qualifier follows a file, the file
 specification defaults to the name of the preceding file with
 a file type of MAP.  If /MAP is specified without /BRIEF,
 /CROSS_REFERENCE, or /FULL, the map contains an object module
 synopsis, a program section synopsis, a symbols-by-name section,
 an image synopsis, and LINK run statistics.

/OPTIONS

 Qualifies file-spec.
 Indicates that the qualified file is a text file containing
 options.  The default file type is OPT.  A file qualified
 by /OPTIONS cannot be qualified by any other qualfier.  The
 options file can contain additional file specifications and/or
 link options.  The file specifications in the options file may
 be qualified with the /INCLUDE, /LIBRARY, /SELECTIVE_SEARCH, or
 /SHAREABLE qualifiers.  (You cannot qualify a file specification
 with /SHAREABLE on the LINK command line.)  An options file
 cannot contain command qualifiers or the /OPTIONS file qualifier.
 commas are required.  See Section DCL for more information on
 options.

/P0IMAGE

 Places the entire image, including the user stack and
 RMS buffers, in P0 address space.

/PROTECT

 Generates a shareable image that is protected from user
 mode and supervisor mode WRITE access (implies that the
 image can execute privileged change mode instructions
 even when it is linked into a nonprivileged executable image).
 To protect particular sections of the image, use the PROTECT
 link option (see /OPTIONS qualifier).  The /PROTECT qualifier
 applies only if /SHAREABLE is specified;  it cannot
 be used with /EXECUTABLE or /SYSTEM.

/SELECTIVE_SEARCH

 Qualifies file-spec.
 Excludes from the image any global symbols defined in the
 qualified object module but not referenced by preceding object
 modules.

/SHAREABLE[=file-spec]

 /NOSHAREABLE (default)
 Positional Qualifier.
 Generates a shareable image with the specified name; file type
 defaults to EXE.  When used as a command qualifier, the file name
 defaults to the name of the input file (or the first input file).
 When used as a parameter qualifier, the file name defaults to the
 name of the preceding file. Wildcards are not allowed.  This
 qualifier is incompatible with /DEBUG, /SYSTEM, and /TRACEBACK,
 and overrides /EXECUTABLE.  In an options file, /SHAREABLE is
 a parameter qualifier indicating that the qualified file is a
 shareable image.  When used in an options file, /SHAREABLE cannot
 take a value.

/SYMBOL_TABLE[=file-spec]

 /NOSYMBOL_TABLE (default)
 Generates a symbol table file containing the image's global
 (executable and system images) or universal (shareable images)
 symbols. The symbol table file is in object module format and can
 be used with subsequent LINK commands to provide the symbol
 definitions to other images.  The file specification defaults
 to the name of the input file (or the first input file) and a
 file type of STB. If this qualifier follows a file, the file
 specification defaults to the name of the preceding file with
 a file type of STB.  No wildcards are allowed.

/SYSLIB (default)

 /NOSYSLIB
 Searches the default shareable image library
 SYS$LIBRARY:IMAGELIB.OLB and default object library
 SYS$LIBRARY:STARLET.OLB in that order for unresolved references
 (after all input modules and object libraries are searched).  If
 /NOSYSLIB and /SYSSHR are specified, /SYSSHR is ignored.

/SYSSHR (default)

 /NOSYSSHR
 Searches the default shareable image library
 SYS$LIBRARY:IMAGELIB.OLB for unresolved references (after all
 input modules and object libraries are searched). If /SYSLIB and
 /NOSYSSHR are specified, only SYS$LIBRARY:STARLET.OLB is searched.
 To search only SYS$LIBRARY:IMAGELIB.OLB, specify /NOSYSLIB and use
 the /LIBRARY qualifier to search SYS$LIBRARY:IMAGELIB.OLB.

/SYSTEM[=base-address]

 /NOSYSTEM (default)
 Generates a system image with a base address as specified. If
 /HEADER is specified and the base address is not a page boundary,
 the base address is rounded up to the next highest page boundary.
 Base-address defaults to hexadecimal 80000000. The name of the
 image is as specified for /EXECUTABLE. This qualifier is
 incompatible with /DEBUG and /SHAREABLE.

/TRACEBACK (default)

 /NOTRACEBACK
 Enables the debugger and the traceback facility to translate
 virtual addresses into subroutine names and source line
 numbers; displays traceback information when an error occurs.
 /DEBUG overrides /NOTRACEBACK.

/USERLIBRARY[=(level,...)]

 /NOUSERLIBRARY
 Searches the object libraries equated to the logical names
 LNK$LIBRARY, LNK$LIBRARY_1, LNK$LIBRARY_2, and so on (without
 a break, up to LNK$LIBRARY_999) for unresolved references, at
 the following levels:

 PROCESS    Process logical names
 GROUP      Group logical names
 SYSTEM     System logical names
 ALL        Equivalent to (PROCESS, GROUP, SYSTEM)
 NONE       Equivalent to /NOUSERLIBRARY

 Omission of this qualifier or specification of /USERLIBRARY
 without any levels gives a default of ALL.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026