HELP LINK — MicroVMS 4.6
Produces one executable or shareable image from one or more object modules and shareable images. Format LINK file-spec,...
Additional information available:
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.