NetBeans™ Version 3


NetBeans™ Version 3.6 for OpenVMS




January 2005




This document contains instructions for installing NetBeans Version 3.6 on OpenVMS Alpha and OpenVMS I64.








Operating System:

OpenVMS Alpha V7.3-1 or higher, or OpenVMS I64 V8.2 or higher

Software Version:

NetBeans Version 3.6 for OpenVMS








Hewlett-Packard Development Company, L.P.




Purpose of This Document 3

Conventions  3


Operating System   4

Software  4

Hardware  4

Performance Recommendations  4

Using X Window System   5


Authorized Privileges  6

Disk Storage Space  6

Quotas  6

Backing Up Your System Disk  7


1. Installing NetBeans using the PCSI installation utility  8

2. NetBeans post-installation tasks  9

Running NetBeans  10

Installing Plug-in Modules  10




A. Sample Installation  12

Install the PCSI Kit 12

B. Files Installed on Your System   14







This document contains instructions for installing NetBeans™ for OpenVMS on Alpha and I64 systems. It is intended primarily for system administrators. General usage information is contained in:





The following conventions are used in this document:

            UPPERCASE/lowercase            Since Java™ is a case-sensitive language

                                                            and NetBeans requires an ODS-5 disk,

                                                            commands are mixed-case as required.


            $                                              Indicates the DCL prompt. This prompt

                                                            may be different on your system.


            [optional-name]                        Square brackets indicate that the

                                                            enclosed item is optional (unless

                                                            within a file specification).


            <variable-name>                         Angled brackets indicate a placeholder

                                                            for a command-line option, a system-

                                                            specific name, or some other variable.






NetBeans for OpenVMS is available for the Alpha and I64 platforms. It requires the following products to be preinstalled and properly configured.


·         OpenVMS Alpha Version 7.3-1 or higher, or OpenVMS I64 Version 8.2 or higher


·         Software Development Kit (SDK) v 1.4.2-x for the OpenVMS Operating System for the Java™ Platform (Includes Fast VM)


Available free from the

Java Technology Software Download Page


For information about required operating system patches (ECOs)


Important: By default, NetBeans 3.6 uses the Java SDK v 1.4.2-x. (Java 5.0 is not supported.) If you have an earlier version of Java installed on your system, you must set the NETBEANS$JDK_HOME logical to point to that JVM. See the Release Notes for more information.



·         500MHz minimum processor

·         128MB minimum RAM

·         75,000 blocks minimum free disk space on an ODS-5 disk


ODS-5 Disk Required

NetBeans must be installed on an ODS-5 disk.  If NetBeans is installed on an ODS-2 disk, it will not operate properly.

See the OpenVMS System Manager's Manual:
Initializing a New Volume with ODS-5 Format

The NetBeans user directory must be on an ODS-5 disk. This directory is set the first time you start NetBeans. By default, the directory is automatically created by NetBeans as a subdirectory under your
SYS$LOGIN directory. You may specify a different directory on the command line. The default is [.NETBEANS.3_6] under your SYS$LOGIN directory.



Systems that do not meet the minimum memory requirement of 128MB per concurrent NetBeans user will exhibit poor performance.

For best performance
The memory and CPU speed recommendations are:

·         At least 256MB of memory per concurrent user

·         At least a 667MHz processor


Maximum performance is obtained by using NetBeans on an OpenVMS workstation without hosting the display across a local area network to another machine. Hosting an X Window display on a different workstation from the OpenVMS machine running NetBeans may result in performance degradation due to network traffic.

eXcursion Fonts

If you are an eXcursion user, to ensure that the appearance of the NetBeans user interface is optimal, the following font sets should be installed in eXcursion:

Type 1

Check their presence by opening the eXcursion Control Panel and selecting the Fonts tab.

If one or more font sets is not present, you can reinstall eXcursion (and choose the option to install all fonts) or you can do the following:

1.       Locate the directory location of the font sets that come with the eXcursion kit.

2.       Open the eXcursion Control Panel and select the Fonts tab.

3.       Specify the full path of each missing font set in the New Font Path Elements group box and click Add.

4.       Once you have all five sets installed and activated, restart the eXcursion server.

On your OpenVMS system, do the following:

1.       Copy the eXcursion font properties file to your LOGIN directory.

The standard location for this file is SYS$COMMON:[JAVA$142.JRE.LIB]FONT_PROPERTIES.EXCURSION


See the SDK Release Notes for important information about Java, eXcursion, and fonts. (





To install NetBeans for OpenVMS, you must be logged in to an account that has at least the following authorized privileges:








*These privileges must be enabled prior to beginning the installation. If these privileges are authorized but not enabled by your process, you should use the following command to enable them:


$ SET PROCESS/PRIVILEGE=<privilege_name>



NetBeans requirements for free disk storage space are slightly greater during installation than after installation:

     Blocks Needed During Installation      175,000

     Blocks Needed After Installation         161,000


To determine the number of free disk blocks on the ODS-5 disk where you will be installing NetBeans, enter the following command:

$ SHOW DEVICE <dev_name>

where <dev_name> is the actual device name to check.



The recommended minimum quotas for the account installing and using NetBeans are:

ASTLM             300

BIOLM              1024

BYTLM             2000000

DIOLM              1024

ENQLM             2000

FILLM               1000

JTQUOTA          60000

PGFLQUOTA    1500000

PRCLM             10

TQELM             400

WSEXTENT       524288


The recommended SYSGEN values are:

CHANNELCNT   at least 2000

WSMAX            at least the value of WSEXTENT


See NetBeans for OpenVMS Release Notes for information about performance tuning. Also see the SDK Release Notes. (



HP recommends that you do a system disk backup before installing any software.

Use the backup procedures that are established at your site. For details on performing a system disk backup, see the OpenVMS System Management Utilities Reference Manual Chapter 7: Backup Utility.




Before proceeding, review the installation requirements and release notes.


Important NetBeans must be installed on an ODS-5 disk to work properly.

Be sure to specify this disk type as the destination device.

To initialize an ODS-5 disk, select a nonsystem disk, move all data to other disks, and use the following command:

$ INITIALIZE /STRUCTURE_LEVEL=5 <device-name> <volume-label>


Choosing an installation destination
Before you run the PRODUCT INSTALL command, decide on the installation destination. There are two ways you can specify where NetBeans should be installed. The third option (not specifying and permitting the default installation) is valid only if SYS$SYSDEVICE is an ODS-5 disk. If this is not the case, you must choose the first or second option:

§         Use the /DESTINATION=<DIR_SPEC> on the installation command line. This option overrides the use of the PCSI$DESTINATION logical name.

§         If you do not use the /DESTINATION=<DIR_SPEC> and do define the logical name PCSI$DESTINATION, the value of this logical is used as the destination device for the kit.

§         If you do not use the /DESTINATION=<DIR_SPEC> and do not define the PCSI$DESTINATION logical, the kit will be installed to SYS$SYSDEVICE:[VMS$COMMON.]


To install NetBeans to either the location pointed to by PCSI$DESTINATION or the default location, run the command:


To install to a specified destination, run the command:


Respond to the PCSI installation questions.

[See Appendix A for a representative installation procedure.]


Incomplete requirements

If the installation process detects that your system does not fulfill the installation requirements and prerequisites, it will give you the opportunity to cancel the installation. For example, the following message may appear:

Java is either not installed on your system or its version is

below the minimum necessary to run NetBeans. If you choose to

continue the installation, NetBeans cannot be used until the

appropriate version of Java is installed. Terminating is

strongly recommended.  Do you want to terminate? [YES]


License Agreements

You must accept the license agreements, which are displayed during the installation process. If you decline the agreements, the installation will terminate with no files moved to the destination.

The following software products found in the NetBeans Build are governed by the Binary Code License Agreement including its applicable Supplemental Terms and Conditions ("BCL") set out in the scroll window displayed during the installation:

§         XML Parser 1.1 (jaxp and parser)

§         JavaHelp 2.0

§         JavaC Compiler

§         JavaMake

§         J2EE Deployment APIs 1.1

§         J2EE Management 1.0

§         EJB Enterprise JavaBeans 2.0

§         JMX 1.2

§         J2EE Editor

§         XML Resolver 1.0

The Ant, Crimson, Jasper, Regexp, Webserver and Xerces software products included in the NetBeans Build are governed by the terms of the Apache Software License found at

The Ant software product included in the NetBeans Build is governed by the terms of the Apache Software License found at

The Flute 1.1 and SAC 1.1 software products included in the NetBeans Build are governed by the terms of the W3C® SOFTWARE NOTICE AND LICENSE found at

The JUnit v.3.8.x software products included in the NetBeans Build are governed by the terms of the Common Public License Version 1.0 found at

The Xalan-Java v.2.6.x (including SAX and DOM APIs) and Xerces2 Java Parser v.2.x (including SAX and DOM APIs) software products included in the NetBeans Build are governed by the terms of following three licenses:

§         Apache Software License found at

§         DOM License found at

§         SAX License found at


All other code is governed by the terms of the Sun Public License ("SPL"), the full text of which can be found at The source code licensed by the SPL can be found at



If you want to create a symbol so that all users on the system can simply type

NETBEANS to start the IDE, add the following lines to SYS$MANAGER:SYLOGIN.COM:








If the Java 2 SDK for OpenVMS is not installed in its default location, or if you want to use a version of the Java 2 SDK earlier than 1.4.2, define NETBEANS$JDK_HOME so NetBeans can find the Java directory:




$ DEFINE/SYSTEM NETBEANS$JDK_HOME <jdk_installation_dir>


Replace <jdk_installation_dir> with the actual location of the Java product installation. Defining this logical is necessary so that NetBeans can find the Java directory.




Instructions for running NetBeans for OpenVMS are contained in the NETBEANS36_RELEASE_NOTES_OPENVMS.TXT|PS|PDF|HTML.

See Section 3: Importing from Previous Versions for information about importing existing projects and settings.



NetBeans for OpenVMS provides access to both the NetBeans Update Center and the NetBeans for OpenVMS Update Center. The OpenVMS Update Center contains modules that are designed to enhance the usability and productivity of NetBeans for OpenVMS customers.

For installation information, see NetBeans for OpenVMS Release Notes: Downloading and Installing NetBeans Plug-in Modules.

NetBeans for OpenVMS Modules Page




Support for NetBeans for OpenVMS is provided under existing OpenVMS service agreements through standard support channels.


As an open-source application, NetBeans is also supported through peer-support channels. is home to the NetBeans Open Source project and is the best resource for general support information and links to peer-support groups.


To ask questions or give feedback
Send your technical questions and feedback about NetBeans for OpenVMS directly to the engineering team at:


To participate in peer groups provides a variety of mailing lists and newsgroups that can answer most user questions.


To report bugs provides a bug-entering system called IssueZilla, which you can use to enter and track issues. The submission form includes an operating system selection field that lists OpenVMS.


General Comments and Feedback
If you would like to provide comments or general feedback about the e-business offerings for OpenVMS, please send mail to:
















A.         Sample Installation


The following is a representative installation of NetBeans for OpenVMS:

Install the PCSI Kit




The following product has been selected:

    NETBEANS AXPVMS NETBEANS36 V3.6        Layered Product


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.




.  .  . .   .   .   .   [LICENSE AGREEMENTS]   . .   .   . .   .   .


I have read and accept the above licenses, including the Binary Code License

and Supplemental Terms and Conditions.


[Y = I Accept, N = I Reject]: y


* This product does not have any configuration options.


    ODS-5 device


    NetBeans must be installed on an ODS-5 device to work properly. If

    you have specified a non-ODS-5 device as the destination, you should

    terminate the installation now. Then, restart the installation and

    specify an ODS-5 device as the destination using the /DESTINATION

    qualifier with the PRODUCT INSTALL command.




    Do you want to continue? [YES]  

    The installation will now continue without requesting further user input.


Execution phase starting ...


The following product will be installed to destination:

    NETBEANS AXPVMS NETBEANS36 V3.6        ODS5$DISK:[000000.]



Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%


The following product has been installed:

    NETBEANS AXPVMS NETBEANS36 V3.6        Layered Product






    For NetBeans to work properly, the following system and user process

    parameters must be set:


      System parameter CHANNELCNT greater than or equal to 2000

      Process parameter ASTLM greater than or equal to 300

      Process parameter BIOLM greater than or equal to 1024

      Process parameter BYTLM greater than or equal to 2000000

      Process parameter DIOLM greater than or equal to 1024

      Process parameter ENQLM greater than or equal to 2000

      Process parameter FILLM greater than or equal to 1000

      Process parameter JTQUOTA greater than or equal to 60000

      Process parameter PGFLQUOTA greater than or equal to 1500000

      Process parameter PRCLM greater than or equal to 10

      Process parameter TQELM greater than or equal to 400

      Process parameter WSEXTENT greater than or equal to 524288



    Defining a NetBeans symbol


    If desired, a symbol may be defined in the system-wide login command

    file to start NetBeans. To do this, insert the following line in



      $ NetBeans :== @<dev>:[<dir>.BIN]RUNIDEOPENVMS.COM


    Where <dev> and <dir> comprise the location where NetBeans was installed.






    Please refer to the release notes for additional information.


    Even if you have already installed and used a previous version of NetBeans

    for OpenVMS, please review the release notes included with this release

    for important new information.


B.         Files Installed on Your System

The following command shows the files installed by the NetBeans for OpenVMS installation:






© 2005 Hewlett-Packard Development Company, L.P.

NetBeans, Java, and all Java-based marks are trademarks of Sun Microsystems, Inc. in the U.S. and/or other countries.

All other product names mentioned herein may be trademarks of their respective companies.

Confidential computer software. Valid license from Hewlett-Packard 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.

Hewlett-Packard shall not be liable for technical or editorial errors or omissions contained herein. The information is provided “as is” without warranty of any kind and is subject to change without notice. The warranties for Hewlett-Packard products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.