|
HP OpenVMS SystemsC Programming Language |
|
HP C
|
| Previous | Contents |
This chapter explains how to install HP C:
HP C I64 Version 7.3 and higher provides support for installing and using multiple versions of the compiler on the same node.
During installation of Version 7.3, if a previous version of the compiler is already installed, you have the opportunity to preserve that compiler rather than overwrite it. If you do choose to preserve the currently installed compiler, the new compiler version will become the system default, and the previous version will remain as an alternate.
Users can make the choice to use an alternate compiler instead of the installed default system compiler by running a command procedure that changes the behavior of the cc command for the process that invokes it.
This kit provides two command procedures to display and control which HP C compiler is used by a process:
$ @SYS$SYSTEM:DECC$SHOW_VERSIONS The following HP C compiler(s) are available in SYS$COMMON:[SYSEXE]: Filename Version Defaults --------------------------------------------------------- DECC$COMPILER.EXE T7.3-018 System Default DECC$COMPILER_S07_01-013.EXE S7.1-013 DECC$COMPILER_T07_03-017.EXE T7.3-018 DECC$COMPILER_V07_01-011.EXE V7.1-011 DECC$COMPILER_V07_02-001.EXE V7.2-001 DECC$COMPILER_V07_02-022.EXE V7.2-022 Process Default |
$ @SYS$SYSTEM:DECC$SHOW_VERSIONS.COM V7.2 The following HP C compiler(s) are available in SYS$COMMON:[SYSEXE]: Filename Version --------------------------------------- DECC$COMPILER_V07_02-001.EXE V7.2-001 DECC$COMPILER_V07_02-022.EXE V7.2-022 Process Default |
When you install HP C I64 Version 7.3 or higher on a system that already has a previous version of the compiler installed, you are given the chance to preserve that currently installed system compiler. To do this, during installation, your system administrator needs to answer NO to the question about default options:
Do you want the defaults for all options? [YES] NO <RET> |
And then answer YES to the question about making alternate compilers available:
Would you like to set up your system for running alternate versions of C? [NO] YES <RET> |
If you answer YES to the first question above (about the default options), you will not receive the second prompt (to set up your system for running alternate versions of C), and the installation proceeds in the traditional manner, overwriting the currently installed system compiler.
If you answer YES to the second prompt, the new compiler is installed as the system default compiler, and the previously installed compiler is set up as an alternate compiler with a name based on its ident.
The installation procedure loads HP C product distribution files onto the system disk on the system where you perform the installation.
Follow these steps to install HP C from the OpenVMS I64 Software Products Library CD-ROM set:
$ SET PROCESS/PRIVILEGE=(BYPASS,CMKRNL,SYSLCK,SYSPRV) |
$ SHOW PROCESS/PRIVILEGES |
$ SHOW DEVICE DKA400 |
DKA400 is the device name used in examples in this document to show where the appropriate media CD-ROM has been mounted. |
$ MOUNT DKA400 label |
$ DIRECTORY *.PCSI Directory DKA400:[dir.subdir] HP-I64VMS-C-V0701-nnnn-1.PCSI Total of 2 files. |
$ PRODUCT EXTRACT RELEASE_NOTES C /SOURCE=disk:[dir] |
$ TYPE/PAGE CC.RELEASE_NOTES |
$ PRODUCT INSTALL C /SOURCE=node::disk:[kit_dir] |
1 - HP I64VMS C V7.1-002 Layered Product
2 - All products listed above
? - Help
E - Exit
Choose one or more items from the menu: 1
The following product has been selected:
HP I64VMS C V7.1-002 Layered Product
Do you want to continue? [YES] [Return]
Configuration phase starting ...
You will be asked to choose options, if any, for each selected product and for
any products that may be installed to satisfy software dependency requirements.
HP I64VMS C V7.1-002: HP C for OpenVMS Industry Standard
Copyright 2004 Hewlett-Packard Development Company, L.P.
This software product is sold by Hewlett-Packard Company
PAKs used: C-USER
Do you want the defaults for all options? [YES]
Copyright 2004 Hewlett-Packard Development Company, L.P.
HP, the HP logo, Alpha and OpenVMS are trademarks of
Hewlett-Packard Development Company, L.P. in the U.S. and/or
other countries.
Confidential computer software. Valid License from HP
required for possession, use or copying. Consistent with
FAR 12.211 and 12.212, Commercial Computer Software, Computer
Software Documentation, and Technical Date for Commercial
Items are licensed to the U.S. Government under vendor's
standard commercial license.
Do you want to review the options? [NO] [Return]
Execution phase starting . . .
The following product will be installed to destination:
HP I64VMS C V7.1-002 DISK$ICCSYS:[VMS$COMMON.]
Portion done: 0%...90%...100%
The following product has been installed:
HP I64VMS C V7.1-002 Layered Product
%PCSI-I-IVPEXECUTE, executing test procedure for HP I64VMS C V7.1-002 ...
%PCSI-I-IVPSUCCESS, test procedure completed successfully
HP I64VMS C V7.1-002: HP C for OpenVMS Industry Standard 64 for
Integrity Servers
The compiler is now available from the command line of newly created processes.
To enable access to the compiler from the command line of a currently
running process (such as this one), execute:
SET COMMAND/TABLE=SYS$COMMON:[SYSLIB]DCLTABLES
The release notes are located in the file SYS$HELP:CC.RELEASE_NOTES
for the text form and SYS$HELP:CC_RELEASE_NOTES.PS for the postscript form.
$
|
$ PRODUCT SHOW OBJECT /PRODUCT=C |
To use other features of the PCSI utility, see the POLYCENTER Software Installation Utility User's Guide.
The following is a sample installation run on a system that had a previous version of HP C installed. In this sample, the new version of the compiler is installed as the default compiler, but a previous version of the compiler is kept as an alternate compiler. See Section 2.1 for more information on installing and using multiple compiler versions.
$ product install c /source=C$:[disk1.cpri.bvbv.bl50.saveset]
The following product has been selected:
HP I64VMS C V7.3-18 Layered Product [Installed]
Do you want to continue? [YES]
Configuration phase starting ...
You will be asked to choose options, if any, for each selected product and for
any products that may be installed to satisfy software dependency requirements.
HP I64VMS C V7.3-18: HP C for OpenVMS Industry Standard
Copyright 2003, 2004-2007 Hewlett-Packard Development Company, L.P.
This software is sold by Hewlett-Packard Company
PAKs used: C or C-USER
Do you want the defaults for all options? [YES] no
HP I64VMS VMS V8.3 [Installed]
* Configuration options for this referenced product cannot
* be changed now because the product is already installed.
* (You can use PRODUCT RECONFIGURE later to change options.)
Copyright 2003, 2004-2007 Hewlett-Packard Development Company, L.P.
HP, the HP logo, Alpha and OpenVMS are trademarks of
Hewlett-Packard Development Company, L.P. in the U.S. and/or
other countries.
Confidential computer software. Valid license from HP
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.
Multi_Version Support:
If you would like to set up your system to be able to run different
versions of the compiler then answer yes. The installation procedure will
then copy the previously installed C compiler and associated files along
side the new compiler in this kit with a suffix appended to the name that
corresponds to the version number. Users may then execute
DECC$SET_VERSION.COM to run an alternate version of the compiler
and DECC$SHOW_VERSIONS.COM to show available versions at anytime
after this installation.
Would you like to set up your system for running alternate versions of C? [NO] yes
Do you want to review the options? [NO]
Execution phase starting ...
The following product will be installed to destination:
HP I64VMS C V7.3-18 DISK$ICXXSYS:[VMS$COMMON.]
Portion done: 0%...40%...50%...60%...70%...80%...90%...100%
The following product has been installed:
HP I64VMS C V7.3-18 Layered Product
%PCSI-I-IVPEXECUTE, executing test procedure for HP I64VMS C V7.3-18 ...
%PCSI-I-IVPSUCCESS, test procedure completed successfully
HP I64VMS C V7.3-18: HP C for OpenVMS Industry Standard
The release notes are located in the file SYS$HELP:CC.RELEASE_NOTES
for the text form and SYS$HELP:CC_RELEASE_NOTES.PS for the postscript form.
A startup file SYS$STARTUP:DECC$STARTUP.COM has been provided.
It contains commands which can be executed after the product install
procedure has been run and at 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 HP C.
|
Errors can occur during the installation if any of the following conditions exist:
For descriptions of error messages generated by these and related conditions, see the OpenVMS I64 documentation on system messages and software installation or the online HELP/MESSAGE command. Take the appropriate action described in the message.
For information on system requirements for installing HP C, see Section 1.4.
To report a problem to HP, see Section 3.7.
You can perform the following tasks after HP C is installed:
The HP C Installation Verification Procedure (IVP) runs automatically during HP C installation.
If system problems occur, you should run the HP C IVP separately to ensure the integrity of the installed files. To run the IVP, enter the following command:
$ @SYS$TEST:DECC$IVP.COM |
If any problems are encountered, a message like one of the following appears:
HP C VERSION 7.n Installation Verification FAILED HP C VERSION 7.n Installation Verification did not run HP C VERSION 7.n Installation Verification ABORTED |
You must edit the system-wide startup file to provide for automatic startup of HP C when your system is rebooted.
Add the command line that starts HP C to the system startup file, SYS$MANAGER:SYSTARTUP_VMS.COM. HP C cannot start until after the network has started, so you must position this new command line after the line that invokes the network startup command procedure. The following example shows the network startup command line:
$ @SYS$MANAGER:STARTNET.COM |
If you want to run HP C on multiple nodes of an OpenVMS cluster, first check to see that you have the appropriate software license (see Section 1.6). Then perform the following steps after you install HP C:
$ INSTALL INSTALL> LIST SYS$SYSTEM:DECC$COMPILER.EXE |
INSTALL> REPLACE SYS$LIBRARY:DCLTABLES.EXE |
INSTALL> REPLACE SYS$SYSTEM:DECC$COMPILER.EXE |
HP 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 |
Some products cannot be used unless certain privilege and quota requirements are met by user accounts. The following sections describe the privilege and quota requirements needed to work with HP C.
To use HP C, each account must have TMPMBX and NETMBX privileges. Use the OpenVMS AUTHORIZE utility to determine whether users have the privileges they require.
To use HP 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.
Use the OpenVMS Authorize Utility from a suitably privileged account to change the process quotas in the user authorization file (UAF). Some sites may restrict the use of the Authorize Utility to certain accounts or people.
After the quotas for the account have been changed, the user should log out of the account and log in again for the new quotas to take effect.
For information on using the Authorize Utility, see the OpenVMS System Manager's Manual: Essentials.
The following sections include information on system tuning and explain how to install HP C as a shared image.
After you install HP C, you might want to adjust your system to enhance performance or lower the use of some system resources. General information about tuning an OpenVMS system is included in the Guide to OpenVMS Performance Management.
| Previous | Next | Contents |