VMS Help
CXXLINK

 *Conan The Librarian

  The CXXLINK command lets you link your C++ application by completing the
  automatic template instantiation process and ensuring that the Standard
  Template Library run-time support and the exception handling run-time
  support are linked into your application as needed.  The syntax is as
  follows:

       CXXLINK file-spec [,...]

  1 - Command Parameters

  file-spec [,...]

  The CXXLINK facility is layered on top of the OpenVMS Linker utility.
  The CXXLINK command accepts the same parameters and qualifiers as the
  OpenVMS Linker utility. Refer to the online help for the OpenVMS
  Linker utility, HELP LINK, for more information.

  2 - Qualifiers

  Refer to the online help for the OpenVMS Linker utility, HELP LINK, for
  information. Additionally, the following qualifiers are accepted by the
  CXXLINK command:

   o  /[NO]LOG_FILE [=filename]

   o  /MODEL=[ANSI | ARM]

   o  /PREINST

   o  /PRELINK=(option[,option2])

   o  /REPOSITORY=(writeable-repository[,readonly-repository,...])

   o  /USE_LINK_INPUT[=filename]

   o  /VERSION

  3 - Obsolete Qualifiers

   The following qualifiers should no longer be used. Instead, use the
   corresponding /PRELINK=option qualifier.

 3.1 - /EXPAND

       /EXPAND (D)
       /NOEXPAND

  Controls whether CXXLINK displays unresolved C++ symbols in their
  mangled or demangled form. By default CXXLINK displays symbols in
  their demangled form.

  This qualifier is obsolete and may be removed in a future release
  to support new OpenVMS Link Utility qualifiers.

 3.2 - /TEMPLATE_PRELINK

       /TEMPLATE_PRELINK (D)
       /NOTEMPLATE_PRELINK

  Controls whether CXXLINK performs a partial link (no image output) to
  determine whether any unresolved template symbols need to be added
  to the LINK command.  If you know that your program does not use
  templates, you can specify /NOTEMPLATE_PRELINK to bypass this partial
  link and proceed directly to the final link.

  This qualifier is obsolete and may be removed in a future release
  to support new OpenVMS Link Utility qualifiers.  Please use
  /PRELINK=TEMPLATE_PRELINK instead.

4 - /LOG_FILE[=filename]

        /LOG_FILE[=filename]
        /NOLOG_FILE (D)

  Turns on verbose or verify mode to write each phase of
  instantiation to the specified log file. This option is
  useful as a debugging aid.

5 - /MODEL=[ANSI | ARM]

        /MODEL=ANSI (D)

  Link with /MODEL=ANSI versions of the C++ libraries.
  See CXX/MODEL=ANSI for details.

6 - /PREINST

        /PREINST (D)
        /NOPREINST

   Forces the standard library template instantiations in the
   user's repository to be preferred at link time over the ones in the
   standard library. This is useful, for example, if you want debugging
   versions of the instantiations. This option is useful only when used
   in conjunction with CXX/DEFINE=__FORCE_INSTANTATIONS.

7 - /PRELINK=(option[,option2])

  Specifies one or more prelink options. If multiple options are
  specified, they must be enclosed in parentheses and separated by
  commas.  You can specify the following options:

  USE_OBJECT_FILES (D)

  Tells CXXLINK not to use the CXX$LINK.OLB library found in a
  repository directory.  Instead, CXXLINK looks for the specific
  object files and adds them to the linker options file.

  Use of this qualifier also prevents CXXLINK from creating and
  populating a CXX$LINK.OLB object library in the repository
  directory.

  USE_OLB

  Tells CXXLINK to use the CXX$LINK.OLB found in a repository directory.
  Specifying this option might improve link-time performance but in
  some cases could produce unresolved template symbols.

  TEMPLATE_PRELINK (D)
  NOTEMPLATE_PRELINK

  Controls whether CXXLINK bypasses the template instantiation process. By
  default, CXXLINK performs at least one partial link to determine whether
  there are any unresolved template symbols that need to be instantiated.
  If you know that your program does not use templates, then you can
  specify /PRELINK=NOTEMPLATE_PRELINK to bypass this partial link and
  proceed directly to the final link.

  This qualifier has the same effect as specifying /TEMPLATE_PRELINK or
  /NOTEMPLATE_PRELINK.

  Because in the future, the OpenVMS Linker Utility might require that
  /TEMPLATE_PRELINK be removed, it is recommended that users
  modify their use of CXXLINK to use this new form of the qualifier.

  ADD_INCLUDE_LIBRARIES (D)
  NOADD_INCLUDE_LIBRARIES

  Controls whether, if initial link fails, CXXLINK adds to the linker
  options file the names of any object libraries specified on the command
  line using the /INCLUDE= syntax.

  CXXLINK also checks for any /INCLUDE= library when SYS$INPUT:/OPT
  is used.

  CXXLINK does not parse any other linker options file for /INCLUDE=
  syntax.

  Because of the order of dependencies between template instantiations and
  object files, the OpenVMS Linker Utility sometimes fails to extract
  all the required modules from an object library that was specified using
  /INCLUDE=.  To work around the problem CXXLINK provides that library as
  input to the linker in its linker options file without the /INCLUDE=
  syntax, thereby allowing the linker to scan that object library one more
  time for missing symbols.

  This qualifier should be used only if a CXXLINK user requires more
  control over which object files are included from a given object
  library.

8 - /REPOSITORY=(writeable-repository[,readonly-repository,...])

  Name the repository directories. The first item in the list is
  considered the writeable repository, and the remaining items (if any)
  are considered repositories that are read only.

  If you do not specify the /REPOSITORY qualifier, CXXLINK uses the
  default repository, SYS$DISK:[.CXX_REPOSITORY].

9 - /USE_LINK_INPUT[=filename]

      /USE_LINK_INPUT[=filename]
      /NOUSE_LINK_INPUT (D)

  By default, CXXLINK creates a temporary .OPT file in the
  [.cxx_repository] directory.  If the [.cxx_repository]
  directory does not exist, the .OPT file is created in the
  users current directory.  CXXLINK deletes this file.

  If you specify /USE_LINK_INPUT, CXXLINK saves the option file passed
  to LINK in a file named CXX_REPOSITORY.OPT in the user's current
  directory (SYS$DISK:[]CXX_REPOSITORY.OPT).  CXXLINK does not delete
  this file.

  If you specify /USE_LINK_INPUT=filename CXXLINK saves the option
  file passed to LINK in the filename specified.  Because the temporary
  file that CXXLINK uses is renamed to the file name specified,
  "filename" must reside on the same disk as the [.CXX_REPOSITORY]
  directory. CXXLINK does not delete this file.

10 - /VERSION

  Direct CXXLINK to display its version identification and then exit.

  11 - Customer feedback

  Customers with support contracts should seek support for problems through
  local customer support centers.

  Customers who do not have support contracts are encouraged to mail problem
  reports to
         compaq_cxx.bugs@hp.com

  Although these reports will  certainly be used as a source of input
  for fixing problems for new releases, we cannot give the reports
  individual attention. We can take remedial action  only on a best-effort
  basis.

  If you have questions, suggestions, or comments, please send mail to
         compaq_cxx@hp.com

  When reporting problems to HP, please provide the following
  information:

  o Name and version of compiler (from a listing file)
  o Name and version of operating system
  o Smallest possible complete source and commands needed to
    reproduce the problem
  o An example of the incorrect results and the desired results
  Close     Help