page. The size of an Alpha page is CPU-specific. The initial set of Alpha systems uses an 8 KB page. The page size used is that of the current link operation. (See the /BPAGE qualifier.) The number of pages must be equal to or greater than the value specified in the parameter. 2 GSMATCH Sets match control parameters for a shareable image and specifies the match algorithm. This option allows you to control whether executable images that link with a shareable image must be relinked each time the shareable image is updated and relinked. Format GSMATCH=keyword,major-id,minor-id GSMATCH=EQUAL,link-time-derived-major-id,link-time-derived-minor-id (default) 3 Option_Values keyword Identifies the match algorithm used by the image activator. Specify one of the following keywords: Keyword Meaning EQUAL Directs the image activator to allow the image to map to the referenced shareable image when one condition is met: o the major and minor ID for the shareable image, as saved at link time in the image file, are equal to the IDs found in the actual shareable image file at activation time. LEQUAL Directs the image activator to allow the image to map to the referenced shareable image when two conditions are met: o the major ID for the shareable image, as saved at link time in the image file, is equal to the major ID found in the actual shareable image file at activation time o the minor ID for the shareable image, as saved at link time in the image file, is less than or equal to the minor ID found in the actual shareable image file at activation time. ALWAYS Directs the image activator to unconditionally allow the image to map to the referenced shareable image: o regardless of the values of the major and minor ID for the shareable image, as saved at link time in the image file, and the values of the IDs found in the actual shareable image file at activation time. Note that you must still specify values for the major ID and minor ID parameters to satisfy the requirements of the option syntax. major-id Specifies the major identification number. minor-id Specifies the minor identification number. When a shareable image is created without specifying a GSMATCH= option, the linker by default creates one. It sets the EQUAL match control and uses portions of the image creation time, as a binary value, for the major and minor IDs. In general this is sufficient to set a unique value for the IDs each time the shareable image is linked. On I64, the linker uses bits 40 through 54 of the binary time value for the major ID and bits 8 through 39 for the minor ID. On Alpha and VAX, the linker uses bits 32 through 46 of the binary time value for the major ID and bits 16 through 31 for the minor ID. 2 IDENTIFICATION Sets the image-id field in the image file. The image identification usually holds a version number of the image, but can be used for any text to identify the generated image. Format IDENTIFICATION=id-name 3 Option_Values id-name The maximum length of the identification character string is 15 characters. If the string contains characters other than uppercase and lowercase A through Z, the numerals 0 through 9, the dollar sign, and the underscore, enclose it in quotation marks. 2 IOSEGMENT Specifies the amount of space to be allocated for the image I/O segment, which holds the buffers and OpenVMS RMS control information for all files used by the image. Format IOSEGMENT=number-of-pagelets[,[NO]P0BUFS] IOSEGMENT=0,NOP0BUFS (default) 3 Option_Values number-of-pagelets Specifies the number of pagelets (512-byte units) to be allocated for the image I/O segment. By default, the operating system uses the value set by the IMGIOCNT system parameter to determine the size of the image I/O space. [NO]P0BUFS By default, the operating system allocates the I/O segment in the P1 region of the process space and, if additional space is needed, at the end of the P0 region. If you specify NOP0BUFS, you deny OpenVMS RMS additional pages in the P0 region. 2 ISD_MAX Alpha and VAX systems. Specifies the maximum number of image sections allowed in the image. Format ISD_MAX=number-of-image-sections ISD_MAX=96 (default, approximate value) 3 Option_Values number-of-image-sections The maximum number of image sections that may be created. You can specify the value in hexadecimal (%X), decimal (%D), or octal (%O) radix. The default is decimal radix. 2 NAME Sets the image-name field in the image file. The image name is used on Alpha and VAX systems to resolve self-references in the shareable image list. Format NAME=image-name 3 Option_Values image-name A character string up to 39 characters in length. If the name contains characters other than uppercase and lowercase A through Z, the numerals 0 through 9, the dollar sign, and the underscore, enclose it in quotation marks. 2 PROTECT Specifies that the segments (I64) or image sections (Alpha) in one or more clusters in a shareable image should be protected from user-mode or supervisor-mode write access. Format PROTECT=YES/NO PROTECT=NO (default) 3 Option_Values YES Enables protection for all the clusters defined in subsequent lines in the options file by the CLUSTER= option or the COLLECT= option, up to a line containing another PROTECT= option. NO Disables protection for all clusters specified on subsequent lines of a linker options file by the CLUSTER= option or the COLLECT= option, up to the line containing another PROTECT=YES option. Protection is disabled by default. 2 PSECT_ATTRIBUTE Specifies the attributes of a program section. Format PSECT_ATTRIBUTE=psect-name,attribute-keyword[,...] 3 Option_Values psect-name Specifies the name of the program section whose attributes you want to set. The name may be a character string up to 31 characters in length. attribute-keyword One or more attributes, identified by a keyword or a number, separated by commas. 2 RMS_RELATED_CONTEXT Enables or disables RMS related name context processing. This is also known as file specification "stickiness." The default is to have RMS related name context processing enabled. This default applies at the start of each options file regardless of the setting in a previous options file. The related name context itself (the collection of data structures RMS maintains to supply the most recently specified fields) does not carry over from one linker options file to the next. That is, previously specified fields in the previous options file are not used to fill in absent fields for file specifications in the current options file. Format RMS_RELATED_CONTEXT=YES/NO RMS_RELATED_CONTEXT=YES (default) 3 Option_Values YES Enables RMS related name context processing. If an option RMS_ RELATED_CONTEXT=NO is in effect, its saved related name context is restored. If RMS related name context processing is already enabled, this option has no effect. RMS related name context processing is enabled by default. Therefore command line file specifications are processed with RMS related name context. Also, RMS related name context processing is enabled at the start of each options file. The related name context is limited to a single options file. That is, the saved related name context is cleared at the start of each options file. NO Disables RMS related name context processing. If an option RMS_ RELATED_CONTEXT=YES is in effect, the current name context is saved for a possible future RMS_RELATED_CONTEXT=YES option. If RMS related name context processing is already disabled, specifying RMS_RELATED_CONTEXT=NO has no effect. 2 STACK Specifies the size of the user-mode stack. Format STACK=number-of-pagelets STACK=20 (default) 3 Option_Values number-of-pagelets Specifies the size of the stack in pagelets (512-byte units). 2 SYMBOL Directs the linker to define an absolute global symbol with the specified name and assign it the specified value. You can use this option to specify a link-time constant. Format SYMBOL=symbol-name,symbol-value 3 Option_Values symbol-name A character string up to 31 characters in length. symbol-value The value you want to assign to the symbol. An absolute global symbol has a fixed numeric value and is therefore not relocatable. Thus, the value must be a number. On I64, the numeric value is a 64-bit value. 2 SYMBOL_TABLE I64 and Alpha systems. Specifies whether the linker should include global symbols in a symbol table file produced in a link operation in which a shareable image is created. By default, the linker includes only universal symbols in a symbol table file associated with a shareable image. Format SYMBOL_TABLE=GLOBALS/UNIVERSALS SYMBOL_TABLE=UNIVERSALS (default) 3 Option_Values GLOBALS Specifies that the linker should include global symbols and universal symbols in the symbol table file associated with the shareable image. UNIVERSALS Specifies that the linker should include only universal symbols in the symbol table file associated with the shareable image. 2 SYMBOL_VECTOR I64 and Alpha systems. Declares universal symbols in shareable images. Format SYMBOL_VECTOR=([alias/]name=entry-type[,...]) 3 Option_Values alias Optionally specifies an alias name for the symbol you want to declare universal. When specified, the alias name appears in the global symbol table (GST) of the image and values associated with the name specified in the symbol-name parameter appear in the symbol vector of the image. Note that you can specify alias names only for symbol vector entries declared using the DATA or PROCEDURE keywords. For more information about symbol vector entry types, see the following table. name Specifies the name of the symbol or the name of a program section in the shareable image that you want to declare universal. entry-type Specifies the type of the symbol vector entry. The following table lists the types of symbol vector entries supported by the linker along with the keyword you use to specify them: Keyword Function DATA Creates a symbol vector entry for data (relocatable or constant). The linker creates an entry for the symbol in the GST of the shareable image. PROCEDURE Creates a symbol vector entry for a procedure and creates an entry for the symbol in the GST of the shareable image. PRIVATE_DATA Creates a symbol vector entry for data; however, the linker does not create an entry for the data in the GST of the shareable image. Thus, the symbol is not available for other modules to link against. PRIVATE_ Creates a symbol vector entry for a procedure; PROCEDURE however, the linker does not create an entry for the procedure in the GST of the shareable image. Thus, the symbol is not available for other modules to link against. PSECT Creates a symbol vector entry for a program section and creates an entry for the program section in the GST of the shareable image. SPARE Use this keyword to create a placeholder. SPARE allows you to preserve the order of the symbol vector entries when you need to create an upwardly compatible shareable image. The SPARE keyword is used alone; it is not preceded by a symbol name and equal sign. 2 UNIVERSAL VAX systems only. Declares a symbol in a shareable image as universal, causing the linker to include it in the global symbol table of a shareable image. Format UNIVERSAL=symbol-name[,...] 3 Option_Values symbol-name The name of the symbol or symbols you want to declare universal.