[an error occurred while processing this directive]
HP OpenVMS SystemsC Programming Language |
Compaq C
|
Previous | Contents |
If errors occur during the installation itself or when the Installation Verification Procedure (IVP) is running, VMSINSTAL displays failure messages. If the installation fails, you see the following message:
%VMSINSTAL-E-INSFAIL, The installation of Compaq C V6.n has failed. |
If the IVP fails, you see these messages:
The Compaq C V6.n Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for Compaq C V6.n has failed. |
Errors can occur during the installation if any of the following conditions exist:
For descriptions of the error messages generated by these conditions, see the OpenVMS documentation on system messages, recovery procedures, and OpenVMS software installation. If you are notified that any of these conditions exist, you should take the appropriate action as described in the message. For information on installation requirements, see Section 1.5.
If the installation fails, you must restart the installation procedure from step 2 in Section 2.1. For an explanation of any system messages, see the OpenVMS System Messages and Recovery Procedures Reference Manual or the online HELP/MESSAGE facility. If the installation fails due to an IVP failure, contact a Compaq field service representative.
Compaq C is now installed and can be invoked by all users with the CC command.
The installation procedure modifies the DCL command table so that the CC command is recognized and processed. However, the previous command table is still in effect for those users who are currently logged in. All logged-in users who want to use the CC command must log out and log in again, or use the following DCL command:
$ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES |
You can perform the following system management tasks after Compaq C is installed:
You usually run the IVP during installation. If you want to run the Compaq C IVP separately to ensure the integrity of installed files should system problems occur, execute the following command procedure:
$ @SYS$SYSROOT:[SYSTEST]DECC$IVP |
If the IVP fails for any reason, the following message is displayed:
Compaq C VERSION 6.n TEST FAILED |
To provide for automatic startup of Compaq C when your system is rebooted, add the command line that starts Compaq C to the system startup file, SYS$MANAGER:SYSTARTUP_VMS.COM (V5.0 and later) or SYS$MANAGER:SYSTARTUP_V5.COM (V5.x systems):
$ @SYS$STARTUP:CCXX$STARTUP.COM |
You must invoke this command procedure to define the logical names that the compiler needs to find the Compaq C header source files and any Compaq C++ class library header files.
SYS$STARTUP:CCXX$STARTUP.COM initializes the Compaq C and Compaq C++ compile-time environment only. To initialize the DEC C/C++ Run-Time Components environment on applicable OpenVMS VAX systems, execute SYS$STARTUP:CRT$STARTUP.COM according to the instructions in the installation guide for that kit. |
If your system has DEC C++ for OpenVMS VAX Version 1.1 installed, be sure to note the following changes and required actions:
In summary, unless you want to reuse the obsolete default directories for DECC$LIBRARY_INCLUDE, you should remove the following files from the old areas (dev is selected during DEC C++ Version 1.1 installation; it defaults to SYS$SYSDEVICE):
dev:[DECC$LIBRARY...]*.*;* dev:[000000]DECC$LIBRARY.dir;* SYS$STARTUP:CXX$STARTUP.COM SYS$STARTUP:CC$STARTUP.COM SYS$COMMON[SYSTEST.DECC...]*.*;* SYS$COMMON[SYSTEST]DECC.dir;* SYS$HELP:CC013.RELEASE_NOTES;* |
If you are installing the DEC C Version 4.0 (or higher) files into the same areas as you chose for the C header files when installing DEC C++ Version 1.1, you can either delete the entire directory tree dev:[DECC$LIBRARY...] before installing the new version, or delete only the following files after installing Compaq C:
SYS$STARTUP:CXX$STARTUP.COM;* SYS$STARTUP:CC$STARTUP.COM;* dev:[DECC$LIBRARY.SYSTEM]*.*;* dev:[DECC$LIBRARY]SYSTEM.dir;* dev:[DECC$LIBRARY.CRTL]*.*;* dev:[DECC$LIBRARY]CRTL.dir;* dev:[DECC$LIBRARY.INCLUDE]DECC$RTLDEF.TLB_OLD;* SYS$COMMON[SYSTEST.DECC...]*.*;* SYS$COMMON[SYSTEST]DECC.dir;* |
If you have a system logical or one or more options files that point to
the old linker and the old run-time libraries (RTLs) that resided in
dev:[CXX$LIBRARY.SYSTEM]LINK.EXE and dev:[DECC$LIBRARY.CRTL]*.*, you
should remove them. That linker is obsolete and the RTLs are made
obsolete by the DEC C/C++ Run-Time Components Version 6.0 for
OpenVMS VAX kit (or by your Version 6.0 or later OpenVMS
VAX system).
3.3 VAXcluster Considerations
If you want to run Compaq C on multiple nodes of a VAXcluster, first check to see that you have the appropriate software license (see Section 1.4). Then perform the following steps after you install Compaq C:
$ INSTALL INSTALL> LIST SYS$SYSTEM:DECC$COMPILER.EXE |
SYSMAN>SET ENV/CLUSTER SYSMAN>DO - IF F$GETSYI("CONTIG_GBLPAGES").GT.F$FILE("SYS$SHARE:DCLTABLES.EXE","EOF") - THEN INSTALL REPLACE SYS$SHARE:DCLTABLES |
$INSTALL INSTALL> REPLACE SYS$SYSTEM:DECC$COMPILER.EXE |
To work with Compaq C, user accounts on your system must have
certain privileges and quotas. The following sections contain
information on these requirements.
3.4.1 Privileges
To use Compaq C, each account must have at least the TMPMBX and
NETMBX privileges. Use the OpenVMS Authorize Utility to
determine whether users have the privileges they require.
3.4.2 User Account Quotas
To use Compaq C, a user account does not need to meet any special quota requirements. However, for users who will be compiling very large programs (many program units compiled together), consider adjusting working set (WSDEF, WSQUOTA, WSEXTENT) and pagefile (PGFLQUOTA) account quotas to improve performance.
See Section 1.5.2 for a description of how to verify and change account
quotas.
3.5 Enhancing Compaq C Performance
The following sections include information on system tuning and explain
how to install Compaq C as a shared image.
3.5.1 Tuning Your System
After you install Compaq C, you might want to adjust your system
to enhance performance or lower the use of some system resources.
Information about tuning your system is included in the Guide to OpenVMS Performance Management.
3.5.2 Installing Compaq C as a Shared Image
If you expect Compaq C to be used extensively on your system, you can reduce the system overhead and memory requirements by installing it as a shared image.
To install Compaq C as a shared image on a system that is currently running, use the OpenVMS INSTALL utility. We recommend that you install Compaq C as shared on a system that has been rebooted recently, because the available space in the global page table is less likely to be fragmented.
To install Compaq C as a shared image:
$ INSTALL INSTALL> ADD SYS$SYSTEM:DECC$COMPILER.EXE/OPEN/SHARED/HEADER_RESIDENT INSTALL> ADD SYS$MESSAGE:DECC$MSG_SHR.EXE/OPEN/SHARED/HEADER_RESIDENT INSTALL> EXIT |
$ INSTALL ADD SYS$SYSTEM:DECC$COMPILER.EXE/OPEN/SHARED/HEADER_RESIDENT ADD SYS$MESSAGE:DECC$MSG_SHR.EXE/OPEN/SHARED/HEADER_RESIDENT EXIT |
When you install Compaq C as a shared image you need to increase
the global pages and global sections parameters as described in
Section 1.5.3.1.
3.6 Getting Help and Reporting Problems
If an error occurs while Compaq C is in use and you believe the error is caused by a problem with the product, please report it to Compaq.
If you have a Software Product Services Support Agreement, contact your Customer Support Center (CSC) by telephone or by using the electronic means provided with your support agreement (such as DSNlink). The CSC provides telephone support for high-level advisory and remedial assistance. When you initially contact the CSC, indicate the following:
Whether you submit information electronically or contact the appropriate support specialist by telephone, please take the following steps:
If the problem is related to Compaq C documentation, you can report the problem to the CSC (if you have a Software Product Services Support Agreement and the problem is severe); otherwise, send your comments about Compaq C documentation to the following Internet address:
c_docs-at-hp.com
To obtain information about purchasing a Compaq Software Product Services Support Agreement or other support services, please contact your local Compaq sales representative.
This appendix contains sample installations of the components on the Compaq C kit. Be aware that this is only a sample. Sometimes the installation procedure is modified in maintenance updates of this product.
Because this installation guide is not always revised for maintenance updates, be sure to read the OpenVMS VAX Systems, Version 6.n letter before you install this product. This letter notes any significant changes to the installation samples shown here.
Depending on which layered products you have on your system, you might see additional messages and questions when you perform your installation.
The sample installations assume that DECnet has been shut down, and
that no users are logged on to your system. The Installation
Verification Procedure (IVP) runs at the end of the installations.
A.1 New Installation
This sample was run on a system that had no previous version of Compaq C installed.
$ @sys$update:vmsinstal CC064 DKA400:[CC064.KIT] options n OpenVMS VAX Software Product Installation Procedure X7.2-72B It is 22-JAN-2001 at 09:48. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? [Return] The following products will be processed: CC V6.4 Beginning installation of CC V6.4 at 09:48 %VMSINSTAL-I-RESTORE, Restoring product save set A ... Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: [Return] * Queue name [SYS$PRINT]: [Return] Job CC064 (queue LP29_B, entry 166) started on LP29_B * Do you want to continue the installation [NO]? yes [Return] %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. Compaq C Version 6.4 for OpenVMS VAX Systems Copyright 2001 Compaq Computer Corporation Compaq and the Compaq logo Registered in U.S. Patent and Trademark Office. Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Product: C Producer: DEC Version: 6.4 Release Date: 05-JAN-2001 * Does this product have an authorization key registered and loaded? yes [Return] HTML, postscript and text versions of the Compaq C Users Guide, Language Reference Manual and RTL Reference Manual may be optionally installed into SYS$COMMON:[SYSHLP.CC$VAX_HELP_064]. These documents consume approximately 40000 blocks. * Should these manuals be provided [NO]: yes [Return] This kit contains a file summarizing the new features, changes, restrictions, and compatibility issues in this release of Compaq C. This file is named CC064.RELEASE_NOTES and has been placed in sys$common:[syshlp.cc$vax_help064] This file contains information valuable to Compaq C programmers. Please inform your user community of this file's existence. This kit contains a file summarizing the new features, changes, restrictions, and compatibility issues in this release of Compaq C. This file is named CC064.RELEASE_NOTES and has been placed in sys$common:[syshlp.cc$vax_help064] This file contains information valuable to Compaq C programmers. Please inform your user community of this file's existence. * The default compiler when only CC is specified, VAXC or DECC [DECC]: [Return] This kit contains an Installation Verification Procedure (IVP) to verify the correct installation of Compaq C. The IVP will be left in: SYS$COMMON:[SYSTEST]DECC$IVP.COM After the installation is complete, you can invoke the command file at any time to verify that Compaq C is installed and working correctly. * Do you want to run the IVP after the installation [YES]? no [Return] * Do you want to purge files replaced by this installation [YES]? [Return] All questions have been answered. The installation will take a few minutes. The C Runtime Library headers and Starlet headers are installed as a Text Library (.TLB). The traditional text form of the headers (.H files) is also provided (for reference purposes only) in the directories: SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] and SYS$COMMON:[DECC$LIB.REFERENCE.SYS$STARLET_C]. Please note that the compiler does not search the reference areas SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] and SYS$COMMON:[DECC$LIB.REFERENCE.SYS$STARLET_C] during compilation. Instead headers are taken from the text library. Please add SYS$STARTUP:CCXX$STARTUP.COM to the system startup procedure called SYS$STARTUP:SYSTARTUP_xxx. To use Compaq C for OpenVMS VAX on other VAX nodes of a VMScluster enter the command "$ @SYS$STARTUP:CCXX$STARTUP.COM" from a privileged account on each such node. This will install Compaq C images and define "DECC$*" system-wide logical names. %VMSINSTAL-I-RESTORE, Restoring product save set B ... The CXXDEMANGLE utility appears on this system. Installation of the kit version will not be performed. Your OpenVMS system will now be modified to include the following new and modified files: [SYSEXE]DECC$COMPILER.EXE [new] [SYSMSG]DECC$MSG_SHR.EXE [new] [SYSHLP]HELPLIB.HLP [modified] [SYSHLP.CC$VAX_HELP_064]*.* [new] [SYSHLP]CC064.RELEASE_NOTES [new] [SYSLIB]DCLTABLES.EXE [modified] [SYSLIB]DECC$RTLDEF.TLB [new] [DECC$LIB.REFERENCE.SYS$STARLET_C]*.H [new] [DECC$LIB.REFERENCE.DECC$RTLDEF]*.H [new] [SYSLIB]DECC$OLB.EXE [new] [SYSLIB]DECC$OLB.README [new] [SYSLIB]DECC$OLB.OLB [new] [SYS$STARTUP]CCXX$STARTUP.COM [modified] [SYSEXE]DECC$SET_VERSIONS.COM [new] [SYSEXE]DECC$SHOW_VERSIONS.COM [new] [SYSTEST]DECC$IVP.COM [modified] The file SYS$STARTUP:CCXX$STARTUP.COM contains commands to be executed at system startup to allow for the best compilation performance. You may want to invoke this command file from your system's site specific start up file. This command file does not have to be invoked for correct operation of Compaq C. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Installation of CC V6.4 completed at 10:02 VMSINSTAL procedure done at 10:02 |
This sample was run on a system that had a previous version of Compaq C installed. The system is upgraded to the new version of the compiler, which becomes the default compiler. The old compiler is retained as an alternative compiler.
$ @sys$update:vmsinstal CC064 DKA400:[CC064.KIT] OpenVMS VAX Software Product Installation Procedure X7.2-72B It is 17-JAN-2001 at 14:50. Enter a question mark (?) at any time for help. %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account. %VMSINSTAL-W-ACTIVE, The following processes are still active: UCX$NTPD * Do you want to continue anyway [NO]? yes * Are you satisfied with the backup of your system disk [YES]? [Return] The following products will be processed: CC V6.4 Beginning installation of CC V6.4 at 14:50 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. Compaq C Version 6.4 for OpenVMS VAX Systems Copyright 2001 Compaq Computer Corporation Compaq and the Compaq logo Registered in U.S. Patent and Trademark Office. Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. A C V6.0-001 compiler was found on your system. Type YES to keep this compiler on your system either as the default system compiler, or as an alternate compiler. Type NO to supersede C V6.0-001. Should the existing V6.0-001 system compiler be preserved [NO]: yes [Return] Type NO to have the compiler on this kit become the default system compiler and to have the currently installed compiler saved as an alternate compiler. Type YES to keep the current system compiler as the default compiler, and to have the compiler on this kit available as an alternate compiler. Alternate compilers can be invoked with the cc command after invoking sys$common:[sysexe]decc$set_version.com passing a version_number. * Should this V6.0-001 system compiler remain the default when cc is typed [NO]: no [Return] Product: C Producer: DEC Version: 6.4 Release Date: 05-JAN-2001 * Does this product have an authorization key registered and loaded? yes [Return] HTML, postscript and text versions of the Compaq C Users Guide, Language Reference Manual and RTL Reference Manual may be optionally installed into SYS$COMMON:[SYSHLP.CC$VAX_HELP_064]. These documents consume approximately 40000 blocks. * Should these manuals be provided [NO]: yes [Return] This kit contains a file summarizing the new features, changes, restrictions, and compatibility issues in this release of Compaq C. This file is named CC064.RELEASE_NOTES and has been placed in sys$common:[syshlp.cc$vax_help064] This file contains information valuable to Compaq C programmers. Please inform your user community of this file's existence. * The default compiler when only CC is specified, VAXC or DECC [DECC]: [Return] This kit contains an Installation Verification Procedure (IVP) to verify the correct installation of Compaq C. The IVP will be left in: SYS$COMMON:[SYSTEST]DECC$IVP.COM After the installation is complete, you can invoke the command file at any time to verify that Compaq C is installed and working correctly. * Do you want to run the IVP after the installation [YES]? [Return] * Do you want to purge files replaced by this installation [YES]? [Return] All questions have been answered. The installation will take a few minutes. The C Runtime Library headers and Starlet headers are installed as a Text Library (.TLB). The traditional text form of the headers (.H files) is also provided (for reference purposes only) in the directories: SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] and SYS$COMMON:[DECC$LIB.REFERENCE.SYS$STARLET_C]. Please note that the compiler does not search the reference areas SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] and SYS$COMMON:[DECC$LIB.REFERENCE.SYS$STARLET_C] during compilation. Instead headers are taken from the text library. Please add SYS$STARTUP:CCXX$STARTUP.COM to the system startup procedure called SYS$STARTUP:SYSTARTUP_xxx. To use Compaq C for OpenVMS VAX on other VAX nodes of a VMScluster enter the command "$ @SYS$STARTUP:CCXX$STARTUP.COM" from a privileged account on each such node. This will install Compaq C images and define "DECC$*" system-wide logical names. %VMSINSTAL-I-RESTORE, Restoring product save set B ... The CXXDEMANGLE utility appears on this system. Installation of the kit version will not be performed. Your OpenVMS system will now be modified to include the following new and modified files: [SYSEXE]DECC$COMPILER_V06_00-001.EXE [renamed] [SYSMSG]DECC$MSG_SHR_V06_00-001.EXE [renamed] [SYSEXE]DECC$COMPILER.EXE [new] [SYSMSG]DECC$MSG_SHR.EXE [new] [SYSHLP]HELPLIB.HLP [modified] [SYSHLP.CC$VAX_HELP_064]*.* [new] [SYSHLP]CC064.RELEASE_NOTES [new] [SYSLIB]DCLTABLES.EXE [modified] [SYSLIB]DECC$RTLDEF.TLB [new] [DECC$LIB.REFERENCE.SYS$STARLET_C]*.H [new] [DECC$LIB.REFERENCE.DECC$RTLDEF]*.H [new] [SYSLIB]DECC$OLB.EXE [new] [SYSLIB]DECC$OLB.README [new] [SYSLIB]DECC$OLB.OLB [new] [SYS$STARTUP]CCXX$STARTUP.COM [modified] [SYSEXE]DECC$SET_VERSIONS.COM [new] [SYSEXE]DECC$SHOW_VERSIONS.COM [new] [SYSTEST]DECC$IVP.COM [modified] The file SYS$STARTUP:CCXX$STARTUP.COM contains commands to be executed at system startup to allow for the best compilation performance. You may want to invoke this command file from your system's site specific start up file. This command file does not have to be invoked for correct operation of Compaq C. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Beginning COMPAQ C V6.4 Installation Verification Procedure Copyright 2001 Compaq Computer Corporation Compaq and the Compaq logo Registered in U.S. Patent and Trademark Office. Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Image Check Complete License Check Complete Version Check Complete Message Check Complete Header Check Complete Run Time Library Check Complete COMPAQ C V6.4 Installation Verification Procedure Successful Installation of CC V6.4 completed at 15:04 VMSINSTAL procedure done at 15:04 |
Previous | Next | Contents |