Creating multiple AIX COBOL projects

To create multiple projects for your COBOL files, use the AIX® COBOL Projects wizard.

About this task

To create multiple AIX COBOL projects:

Procedure

  1. Select File > New > AIX COBOL Projects. The AIX COBOL project wizard will open with the Import to Remote Projects page displayed.
  2. Use the Connection field pull-down to select the Remote Systems Explorer connection that you wish to import the projects from. Click New if you wish to create a new connection. Select the folders to import using Ctrl+Click. Click Next.

    Note: Do not create projects pointing to the same project location on the remote host in multiple IDEs. This will cause unexpected behavior to occur.

  3. Choose the project type. Synchronized will create a local copy of your project and keep it synchronized with the remote location -- you will need this type if you wish to use source control, such asRational® Team Concert, or if you want to work offline. Choosing Remote Only means editing files in the project will directly edit the file in the remote location, no local copy is maintained. Network File System should be used if you wish to make use of a remote file system such as NFS or Samba. Click Next. The next page will depend on the project type you choose:
    • For Synchronized projects, the common remote root will be generated. Push on save will push changed files to their remote location every time they are saved. and Push on build will push changed files to their remote location every time a project build is done. These can be changed later. Pull from remote on project creation will download all source files from the remote location on project creation.
      New AIX COBOL Projects - Synchronized
    • For Remote Only projects, the common root will be generated.
      New AIX COBOL Projects - Remote Only
    • For Network File System projects, the common root will be generated. The common local root (on local machine) and Common remote root (on remote machine) must refer to the same location over the remote network file system. The Validate mount location will help ensure this is done correctly.
      New AIX COBOL Projects - Network File System
  4. Click Finish to create the projects, or click Next to change any of the optional settings on the next pages.
  5. Select Build Options for the projects. Build directory is the location the build is run in. The default is ".", meaning the project location. A path can be appended to "." to make it relative to the project location, or starting with "/" will make it an absolute path.
    New AIX COBOL Project - Build Options
    Click Next.
  6. Select Add a template makefile to the project to add a template makefile to build your project, if you don't already have a makefile. There are a list of templates to choose from, and all are well commented to make it easy to edit it for the particular needs of your project. The makefile will be created and added to your project, and will in a file named "makefile".
    New AIX COBOL Project - Makefile Templates
    Click Next.
  7. Specify the list of directories to search copybooks. Copybooks are found automatically from information provided by the build, so this should only be needed if the project cannot be built.
    New AIX COBOL Project - Copybook Locations
    Click Next.
  8. If you use any preprocessors, you can use this page to make the editor aware of where the post-processed files are, so the editor can resolve the actual COBOL code, making the editor behave better with your code that has non-standard COBOL preprocessor statements. Preprocessors are run in order, so if you have a chain of preprocessors you should define them in the correct order from top to bottom.
    New AIX COBOL Project - Preprocessor Configurations
  9. Click Finish.

Results

Alternatively, you can select the desired remote location of the folders in the Remote System Explorer view, right-click, and select Import to AIX COBOL Projects. This will start the wizard, as above, but the remote location will be filled in.

Feedback