Quick Start: Using the Client

Adding and Connecting to a Remote IDE Server
Creating an OpenVMS 3GL Project

Creating a Java Project

Creating a WSIT Project

 

Adding and Connecting to a Remote IDE Server  

Before creating a remote project, there must be a process on the remote OpenVMS machine which will act on our behalf to execute DCL commands, and so on. This process is called the Remote IDE Server. You create this Remote IDE Server from within the IDE.

The Remote IDE Server you create will be a detached process running in your user account on OpenVMS. The Remote IDE Server will make a connection back to the Distributed NetBeans client in the IDE using Java’s RMI (Remote Method Invocation) services.

  To add or connect to the remote IDE server on an OpenVMS system

1. In the NetBeans IDE window, select the Services tab.

2. Right-click on Remote IDE Servers and select Add Remote IDE Server. You will see the Add Remote IDE Server dialog box.

3. Enter the Host Name/IP Address, User Name, and Password information of the OpenVMS system you are adding and click OK to close the dialog box and return to the NetBeans IDE window.

4. The Remote IDE Server is automatically connected.  The connection icon  turns yellow when the connection is in progress, then green to show that your are connected to the remote server.

The following section explains how to create an OpenVMS 3GL application project on the remote OpenVMS system.  

Creating an OpenVMS 3GL Project

In NetBeans 6.5, you must create a project to work with files on the remote OpenVMS system. Your project can be a Java project or an OpenVMS 3GL application project.

The OpenVMS 3GL project type is useful for OpenVMS applications that are written in 3GL languages instead of Java. This project type allows you to map an OpenVMS source directory to a directory on your desktop, and edit and compile files written in the following 3GL languages:

• C/C++

• Cobol

• Fortran

• Basic

• Pascal

  To create an OpenVMS 3GL project from the Distributed NetBeans client

1. In the NetBeans IDE window, select the Projects tab.

2. Select File > New Project.  The New Project wizard is displayed.

3. Select OpenVMS Remote Applications, and click Next.

 

 The New OpenVMS 3GL Application dialog box is displayed. Enter the “Project Name” and click Next.

 

4. Select the name of the Remote IDE Server from the drop-down menu and click Next. The New OpenVMS 3GL Application dialog box is displayed.

 

5. Select the remote file system type as FTP based file system. Click Next to view the New OpenVMS 3GL Application dialog box.

 

6. In the New OpenVMS 3GL Application dialog box enter the following:

Remote FTP Directory Root – Browse to select a remote default directory for the FTP filesystem root on the OpenVMS system. The Remote FTP Directory Root is the root directory that allows you to access and see your source files from the OpenVMS system. Usually, this will be your project directory. For example, USER$:[NBUSER.NBTESTUSER].

Local FTP Directory Root – Browse to select a Local FTP Directory Root to store copies of the files from the OpenVMS system. This directory will contain some or all of the files found in the remote FTP default directory.

 

The following sections explain how to create a new C source file and a new DCL command procedure (.com) file on the remote OpenVMS system.

Creating a New C Source File

  To create a new C source file in the Test project on the remote OpenVMS system

1. From the main menu in NetBeans IDE, select File > New File. The New File dialog box is displayed. Alternately, you can right-click on your project and select New File.

2. Click the plus sign (+) next to OpenVMS C/C++ listed under Categories and select C source files.

3. In the File Types, select the required template file and click Next.

 

The New empty C implementation file dialog box is displayed. Enter the “File Name” and click Browse button and create a C file in a different folder and click Finish.

 

A C source file with .c extension is created in the NetBeans IDE. Your C file will appear in your Projects tab as remote filesystem.  

4. In the source editor window, edit test.c source file and save it.

5. In the Projects tab, right-click on the test.c file and select Remote Compile.

After compilation is done, an OBJ file is created and the following message is displayed in the NetBeans IDE Output Window. Then, follow the procedure outlined in Section 2.2.2, Creating a DCL Command Procedure File.

 

Creating a New DCL Command Procedure File

  To create a new DCL command procedure (.com) file in the Test project on the remote OpenVMS system

1. From the main menu in NetBeans IDE, select File > New File. The New File dialog box is displayed.

2. Select the OpenVMS DCL option listed under Categories.

3. In the File Types, select the required template file and click Next. The New Empty DCL File dialog box is displayed.

4. Enter the “File Name” and click Browse button and create a com file in a different folder and click Finish.

 

A DCL command procedure file with .com extension is created in the NetBeans IDE. Your DCL command procedure file will appear in the Projects tab.  

5. In the source editor window, edit test.com file to create required image (EXE) and save it.

6. In the Projects tab, right-click on the test.com file and select Remote Execute.  

After DCL execution, executable image (EXE) is created and the following message is displayed in the NetBeans IDE Output window.

7. Right-click the EXE file and select Remote Execute.

The NetBeans IDE Output window is displayed.

 

 Creating a Java Project

For creating a Java project, you first create a standard Java or web-based project and then convert it to a remote project.  The conversion to remote project can occur immediately after you create the project or sometime later.

When you convert a project to a remote project, your project files and source files will be copied to the OpenVMS system and modifications will be made to the NetBeans-generated Build.xml to support remote operations.

  To create a Java project using Distributed NetBeans

1. From the main menu in NetBeans IDE, select File > New Project. The New Project dialog box is displayed.

2. Select General listed under Categories.

3. In the Projects tab, select the required Java Application template file and click Next.

 

 The New Java Application dialog box is displayed. Enter the “Project Name”, “Project Location” and “Project Folder” and click Finish to close the dialog box and return to the NetBeans IDE window.

  

4. Right-click on your Java project and select Properties.

 

 The Project Properties – JavaApplication dialog box is displayed.

 

The Java source level should be less than or equal to the version of Java with which you are running the IDE Server on OpenVMS. To change the source level for your project, set the proper source level from the Source Level drop-down menu.

5. In the source editor window, make the required edits to your program in the JavaApplication.main file and save it.

6. In the Projects tab, right-click on your project and select Clean and Build Project.

7. Run your Java Application by right-clicking on your project and select Run Project.

       The NetBeans IDE Output window is displayed.

 

8. Convert to remote project by right-clicking on your project and select Convert to Remote Project. The Remote Project Conversion Wizard dialog box is displayed. Then, follow the steps in the wizard and click Finish.

 

9. After the project has been converted to remote project, right-click and select Remote Project Operations and then select Run Project. The NetBeans IDE Output window is displayed.

     

 

 

 Creating a WSIT Project

  To create an OpenVMS WSIT project from the Distributed NetBeans client

The Web Service Integration Toolkit for OpenVMS (WSIT) contains a collection of integration tools. These tools are easy to use, highly extensible, based on standards and built on open source technology. The toolkit can be used to call OpenVMS applications written in 3GL languages, such as C, BASIC, COBOL, FORTRAN, and ACMS from newer technologies and languages such as Java, Microsoft .NET, Java -RMI, JMS, and web services.

1. In the NetBeans IDE window, select the Projects tab.

2. Select File > New Project.  The New Project wizard is displayed.

3. Select OpenVMS Remote Applications, then select OpenVMS WSIT Application and click Next.

 

 The New OpenVMS WSIT Application dialog box is displayed. Enter the “Project Name” and click Next.

 

4. Select the name of the Remote IDE Server from the drop-down menu and click Next. The New OpenVMS WSIT Application dialog box is displayed.

 

5. Select the remote file system type as FTP based file system. Click Next to view the New OpenVMS WSIT Application dialog box.

 

6. In the New OpenVMS WSIT Application dialog box enter the following:

Remote FTP Directory Root – Browse to select a remote default directory for the FTP filesystem root on the OpenVMS system. The Remote FTP Directory Root is the root directory that allows you to access and see your source files from the OpenVMS system. Usually, this will be your project directory. For example, USER$:[NBUSER.NBTESTUSER].

Local FTP Directory Root – Browse to select a Local FTP Directory Root to store copies of the files from the OpenVMS system. This directory will contain some or all of the files found in the remote FTP default directory.

 

7. The WSIT project is opened. Then Create a New C file (test.c)

8. In the Projects tab, right-click on the test.c file and select Remote Compile. After compilation is done, an OBJ file is created. .

9. Specify the path of the .obj file in the wsit-ant-user.properties file template created along with the WSIT project.

10. Select the options in the Remote run target according to the specification in the wsit-ant-user.properties file.

 

11.The Output of the TEST WSIT (wsit-build.xml) is as follows:

 

 

12. The generated files are listed in the directory as below: