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:

• Running the Installation Verification Procedure (IVP) separately
• Editing the system startup and shutdown files
• Modifying system parameter settings
• Making the product usable on a VAXcluster
• Setting user account quotas
• Tailoring your system
• Enhancing performance
• Reporting problems

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

3.2 Editing and Organizing System Files

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.

If your system has DEC C++ for OpenVMS VAX Version 1.1 installed, be sure to note the following changes and required actions:

• DEC C++ for OpenVMS VAX Version 1.2 has succeeded Version 1.1. Compaq recommends that you upgrade to Version 1.2, which has many problem fixes and a new installation and startup procedure that cooperates with the procedures used by this Compaq C installation.
• Beginning with DEC C++ for OpenVMS VAX Version 1.2 and and DEC C for OpenVMS VAX Version 4.0, the default locations for the top-level directories dev:[DECC$LIBRARY] and dev:[CXX$LIBRARY] have changed to SYS$COMMON:[DECC$LIB] and SYS$COMMON:[CXX$LIB], respectively.
  After installing DEC C for OpenVMS VAX Version 4.0 or higher, the system logical DECC$LIBRARY_INCLUDE points to a new header area. Therefore, if your system has DEC C++ for OpenVMS VAX Version 1.1 installed, be sure to take note of the old location before installing Compaq C.
• With DEC C Version 4.0 and higher, the location for the library form of the DEC C headers has changed from that used in previous DEC C and DEC C++ versions. The old location was dev:[DECC$LIBRARY.INCLUDE]. The new location is SYS$LIBRARY.
• The DEC C Version 4.0 and higher startup is called CCXX$STARTUP.COM and is shared by Compaq C and Compaq C++. This startup file obsoletes both CC$STARTUP.COM (used in previous test versions of DEC C) and CXX$STARTUP.COM (if DEC C++ for OpenVMS VAX Version 1.1 is installed on your system).
  Delete CC$STARTUP.COM and CXX$STARTUP.COM and remove them from SYS$STARTUP:SYSTARTUP_xxx.COM.
  As a reminder to do this, the Compaq C installation creates stub copies of both CC$STARTUP.COM and CXX$STARTUP.COM that do nothing but announce that the old versions of these files are obsolete and should be deleted.

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:

1. Enter the LICENSE LOAD command, as described in the OpenVMS License Management Utility Manual, to activate the license on each node in the VAXcluster on which Compaq C is to be executed.
2. Log in to the installation node and use the OpenVMS INSTALL Utility to determine whether DECC$COMPILER.EXE is a known image:

   $ INSTALL INSTALL> LIST SYS$SYSTEM:DECC$COMPILER.EXE

   
   If the output of the preceding LIST command shows DECC$COMPILER.EXE to be a known image, perform all of the following steps. Otherwise, perform all of the following steps except step 5.

3. Log in to a node on the cluster.
4. Update the DCL tables on all nodes, if enough global pages are available:

   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

5. If DECC$COMPILER.EXE was established as a known image using the INSTALL utility, enter the following commands:

   $INSTALL INSTALL> REPLACE SYS$SYSTEM:DECC$COMPILER.EXE

   
   This command replaces the INSTALL entry for DECC$COMPILER.EXE.
   Repeat this step only for those nodes of the cluster on which you activated the Compaq C license in step 1. (In most cases, all the nodes will be licensed.)

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:

1. Make sure your system has the required number of available global pages and global sections. See Section 1.5.3.1.
2. After you have reset the system parameter values, invoke the OpenVMS INSTALL utility from a privileged account and install Compaq C as a shared image by entering the following commands:

   $ 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

3. Add the following lines to the appropriate system startup command file so that Compaq C is available as a shared image each time the system is started. (If your site has modularized its startup procedures, be sure you add the lines to the correct file.) The default startup command file for OpenVMS Version 5.5-2, for example, is SYS$STARTUP:SYSTARTUP_V5.COM.

   $ 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:

• The name and version number of the operating system you are using
• The version number of Compaq C you are using
• The hardware system you are using (such as a model number)
• A brief description of the problem (one sentence if possible)
• How critical the problem is

Whether you submit information electronically or contact the appropriate support specialist by telephone, please take the following steps:

1. Describe as accurately as possible the circumstances and state of the system when the problem occurred. Include the description and version number of the Compaq C compiler being used. Demonstrate the problem with specific examples.
2. Reduce the problem to as small a size as possible.
3. Remember to include listings of any command files, INCLUDE files, or relevant data files, and so forth.
4. Provide a listing of the program.
5. If the program is longer than 50 lines, submit a copy of it on machine-readable media (diskette or magnetic tape).
6. Report only one problem per report. This will facilitate a faster response.
7. Mail the problem report to Compaq.

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@zko.dec.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 a sample installation 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 sample shown here.

This sample was run on a system that had no previous version of Compaq C installed. Depending on which layered products you have on your system, you might see additional messages and questions when you perform your installation.

The sample installation assumes that DECnet has been shut down, that no users are logged on to your system, and that OPTIONS N is specified to print the release notes. The Installation Verification Procedure (IVP) runs at the end of the installation.

$ @sys$update:vmsinstal CC062 DKA400:[CC062.KIT] options n OpenVMS VAX Software Product Installation Procedure V6.1 It is 23-October-1999 at 11:39. 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.2 Beginning installation of CC V6.2 at 11:39 %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]: 4 [Return] * 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 V6.2-000 for OpenVMS VAX Copyright Digital Equipment Corporation 1993, 1999. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from DIGITAL or an authorized sublicensor. * Do you want to purge files replaced by this installation [YES]? [Return] Compaq C requires a Product Authorization Key (PAK) be registered and loaded. Answer the following question with YES if at least one PAK with the specified product name and a date equal to or later than the date shown is registered and loaded, otherwise answer NO. Product: C Producer: DEC Version: 6.2 Release Date: dd-mmm-yyyy * 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_062]. These documents consume approximately 40000 blocks. * Do you wish to install these documents? [NO]? yes [Return] %VMSINSTAL-I-RESTORE, Restoring product saveset B... This kit contains an Installation Verification Procedure (IVP) to verify the correct installation of the Compaq C compiler. The IVP will be placed in: SYS$TEST:DECC$IVP.COM After the installation is complete, you can invoke the command file at any time to reverify that Compaq C is installed and working correctly. * Do you want to run the IVP after the installation [YES]? [Return] A VAX C compiler was found on your system. The CC command will have the capability to invoke the Compaq C compiler via the command CC/DECC. The CC command will also have the capability to invoke the VAX C compiler via the command CC/VAXC. You have the choice of the CC command defaulting to execute either: - the Compaq C compiler [DECC] - the VAX C compiler [VAXC] If you choose DECC as the default, existing command files using CC to invoke VAX C may not work. Other layered products expecting CC to invoke VAX C during their installation procedure may not install. * The default compiler when only CC is specified should be [DECC]: [Return] Choose a location to place the primary header files used for interfacing with the Compaq C Run Time Library and with OpenVMS system services. Answer To place files in ------- --------------------------------------------------------- D SYS$COMMON:[DECC$LIB.INCLUDE] E In the existing DECC$LIBRARY_INCLUDE: SYS$COMMON:[DECC$LIB.INCLUDE] A An alternative location you specify in the next question. You may want to use an alternative location to save space on the system device and to reduce disk I/O traffic during compilations. * DECC$LIBRARY_INCLUDE location, [D]efault, [A]lternative, or [E]xisting [E]: [Return] DECC$LIBRARY_INCLUDE will be SYS$COMMON:[DECC$LIB.INCLUDE]. All questions regarding the installation of Compaq C have been asked. The installation will now continue for between 10 minutes and one hour, depending on your CPU type and the installation options you have chosen. Compaq C V6.2-000 : providing help and the command line. Compaq C V6.2-000 : providing images and libraries. %VMSINSTAL-I-SYSDIR, This product creates system directory [SYSTEST.DECC]. Please add the SYS$STARTUP:CCXX$STARTUP.COM to the system startup procedure called SYS$STARTUP:SYSSTARTUP_xxx. To use Compaq C for OpenVMS VAX on other nodes of a VAXcluster: from a privileged account on each such node enter the command "$ @SYS$STARTUP:CCXX$STARTUP.COM". This will install images and define system-wide logical names. Your OpenVMS system will now be updated to include the following new and modified files: [SYSEXE]DECC$COMPILER.EXE [new] [SYSHLP]HELPLIB.HLB [modified] [SYSHLP]CC$HELP*.HTML [new] [SYSHLP]CC062.RELEASE_NOTES [new] [SYSHLP]CC062_RELEASE_NOTES.PS [new] [SYSLIB]DCLTABLES.EXE [modified] [SYSLIB]DECC$RTLDEF.TLB [new] [SYSLIB]DECC$COMPILED_PRINTF.OLB [new] [DECC$LIB.REFERENCE.SYS$STARLET_C]*.H [new] [DECC$LIB.REFERENCE.DECC$RTLDEF]*.H [new] [SYSMSG]DECC$MSG_SHR.EXE [new] [SYS$STARTUP]DECC$STARTUP.COM [new] [SYSTEST]DECC$IVP.COM [new] [SYSTEST.DECC]DECC$IVP*.* [new] %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Beginning Compaq C Installation Verification Procedure ... Copyright Digital Equipment Corporation 1993, 1999. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from DIGITAL or an authorized sublicensor. Image Check Complete License Check Complete Version Check Complete Message Check Complete Header Check Complete Run Time Library Check Complete COMPAQ C T6.2-000 Installation Verification Procedure Successful Installation of CC V6.2 completed at 12:15 VMSINSTAL procedure done at 12:16

Previous

Contents

Contents

privacy and legal statement