Accessing a Remote Development Environment

This document covers the following topics:


Mapping a Natural Environment

To perform development directly on a Natural server on which Natural Development Server (NDV) is installed, you have to activate a Natural server environment. You do this by mapping the appropriate server in the Natural Server view. Each server provides all remote services (such as access or update) for a specific FUSER (Natural system file for user programs).

If you want to connect to a Natural environment for the first time, you have to map it as described below. Once you have mapped an environment, a node for this environment is automatically shown in the Natural Server view. It is possible to map the same environment more than once, for example, if you want to have Natural server sessions with different session parameters.

Note:
When mapping to an environment, especially with Natural security installed, the ETID parameter should be set to ' ' (Mainframe) or $$ (UNIX). Otherwise an error might occur that the user with the same ETID is already active. This error is often raised during a refresh of a NaturalONE Server environment where multiple connections are internally being set up in order to perform the Refresh operation.

Start of instruction setTo map a Natural environment

  1. Go to the Natural Server view.

  2. Invoke the context menu and choose Map.

    Or:
    Choose the following icon in the local toolbar:

    Icon

    Or:
    Press CTRL+ALT+M.

    The following dialog box appears.

    Map environment

  3. Specify the following information:

    Option Description
    Host name The name of the Natural server.
    Port number The TCP/IP port number of the Natural server.
    Environment name The name that is to appear in the Natural Server view. A default name will be created automatically. If you want, you can enter a more specific environment name.
    Session parameters Optional. If dynamic parameters are required for the Natural environment, specify them in this text box.

    Tip:
    For a mainframe environment, it is recommended that you specify TMODEL=2. Otherwise (with the default setting), the output in the Natural I/O window is shown with a very small font.

    Notes:

    1. When connecting to a Natural Development (NDV) server on a Linux, UNIX or Windows platform, you can use the predefined NDVPARM session parameter.
    2. When connecting to a Natural server on a Linux, UNIX or Windows platform, in order to use the Predict Description and Generation optional component of NaturalONE, you can use the predefined PRFPARM session parameter.
    User ID The user ID that is to be used for mapping the Natural environment. This text box is initially blank. When you have previously mapped an environment, the user name that you entered the last time is automatically provided.

    Notes:

    1. When Natural Security is active (see Natural for Mainframe > Natural Security > Logging On), the ID by which the user is defined to Natural Security must be specified in this field. By default, this is the 1-to-8-character uppercase user ID. For non-mainframe environments, Natural Security also provides an option to use 32-digit user names as IDs for the logon to the mapped environment (see Natural for Mainframe > Natural Security > Protecting the Natural Development Environment in Eclipse > Map Environment and Library Selection).
    2. When Natural Security is not active, the ID must conform to the uppercase 8-byte limit. Otherwise, the mapping dialog box displays a warning or error message.
    Password Optional. If Natural Security is active on the Natural server, specify the required password in this text box.
    Use SSL/TLS Optional. Must be enabled when a connection to an SSL/TLS-secured Natural Development (NDV) Server is performed.

    Note:
    If you do not know the host name and port number for your Natural server, ask your administrator.

  4. Choose the Finish button.

    A node for the specified environment is now shown in the Natural Server view.

It is also possible to map a Natural environment from an existing Natural project located in the Project Explorer View or the Natural Navigator View. In this case the runtime properties of the selected Natural project are used as the mapping parameters.

Start of instruction setTo map a Natural environment from an existing Natural project

  1. Go to either the Project Explorer View or the Natural Navigator View.

  2. Select a single or multiple Natural project(s).

  3. Invoke the NaturalONE context menu and choose Map.

    Or:
    Press CTRL+ALT+M.

    A node for each specified environment is now shown in the Natural Server view.

Dynamically Changing the CICS Transaction Name when Starting a Session

The following description applies if you want to switch to a different CICS transaction on a mainframe.

You specify the CICS transaction name in the same text box in which you also specify the dynamic parameters for the Natural environment. So that the CICS transaction name can be evaluated, it is important that you specify it before any Natural parameters, using the following syntax:

<TA_NAME=name>

where name can be 1 to 4 characters long. This must be the name of an existing CICS transaction which applies to a CICS Adapter. It will override the transaction name which is currently defined in the configuration file for the CICS Adapter on the Natural Development Server (NDV). Ask your administrator for further information.

Make sure to put the entire definition in angle brackets. When this definition is followed by a Natural parameter, insert a blank before the Natural parameter. Example:

<TA_NAME=NA82> STACK=(LOGON SYSCP)

If the specified CICS transaction name cannot be found, an error message occurs and the session cannot be started.

Contents of the Natural Server View

The Natural Server view provides the logical representation of one or more Natural environments. The following example shows two Natural server nodes, one for a server on a mainframe and another for a server on UNIX. The names that are shown for the server nodes are the environment names that have been defined when the environments were mapped.

Natural Server view

Specific top-level nodes are provided for user libraries and system libraries (also known as the FUSER and FNAT system files). Other top-level nodes correspond to the Natural architecture in the mapped environment. For example:

  • In a mainframe environment, DDMs are always stored in the system file FDIC. Therefore, a DDMs node is available.

    In a UNIX, OpenVMS or Windows environment, DDMs are normally stored in libraries. However, if the parameter FDDM has been set, the DDMs are stored in the system file FDDM. In this case, a DDMs node is also available.

  • Inactive libraries are only available in UNIX, OpenVMS and Windows environments. Therefore, such a node is not provided for a mainframe environment.

Alias names can be shown for the system files in a UNIX, OpenVMS or Windows environment. They are shown when they have been defined with Natural on the appropriate platform.

When you expand the node for a system file, the nodes for the libraries in this system file are shown. For detailed information on the system files and library types, see the Natural documentation for the corresponding platform.

The objects in a library are grouped into different nodes, according to their Natural object types. For example, all programs are shown in a node called Programs. Thus, if you want to view the available programs in a library, you have to expand the Programs node.

For subroutines, functions, classes and DDMs, the long names (which may exceed 8 characters) are shown. These are the names that have been defined in the program; the names that have been defined when the object has been saved are not shown for these objects.

If Natural Security is active, only the allowed libraries and objects are shown. In addition, the commands which are not allowed to be used are disabled in the context menus.

You can use the Icon button in the local toolbar to collapse all expanded nodes.

Notes:

  1. For an overview of the icons that are used for the different types of objects in the Natural Server view, see Types of Natural Editors.
  2. Further information on the Natural Server view is provided in the following topics: Downloading an Existing Library or Object from a Natural Server and Working with Natural Objects in Natural Server Mode.
  3. When optional components of NaturalONE have been installed, additional top-level nodes may be shown for a mapped environment in the Natural Server view. For example, when Service Development has been selected in the installer, a node with the name "Business-Services" is shown. For detailed information on how to use such a node, see the documentation for the corresponding optional component.
  4. When a huge number of objects are contained in a library on the mainframe, expanding an object node can take a long time. Natural for Mainframes on z/OS provides a hyperdescriptor that can significantly improve the database access required for this purpose. For further information, see Performance Aspects in NaturalONE in a Nutshell.

Filtering Libraries and Objects

Using a filter, you can reduce the number of items that are shown in the Natural Server view. Filtering involves several steps: First you define a filter and then you apply the filter to a system file node or to a library node. Detailed information is provided in the following topics:

Defining a Filter

When you define a filter, you specify a pattern (for example, that only items are to be shown which start with the letter "L"). Each filter can hold an unlimited number of patterns.

The filters that you define can be applied to all mapped Natural environments.

Start of instruction setTo define a filter

  1. Choose the following icon in the local toolbar of the Natural Server view:

    Icon

    The Define Filters dialog box appears.

    Define filters

    When filters are already defined, they are shown in the upper part of the dialog box. The lower part of the dialog box shows the patterns, if defined, for the selected filter.

    Note:
    This dialog box can also be invoked from the Set Filters dialog box (see Setting a Filter).

  2. To define a new filter, choose the Add button in the upper part of the dialog box.

  3. Enter the name for the filter in the resulting dialog box.

    You can use any name for the filter (for example, "My Libraries").

  4. Choose the OK button to close the dialog box in which you have defined the name of the filter.

    Now, you have to define one or more patterns for the new filter.

  5. Make sure that the filter is selected in upper part of the dialog box.

  6. Choose the Add button in the lower part of the dialog box.

  7. Enter the filter pattern in the resulting dialog box. A pattern is defined as follows:

    • You can enter the names of all libraries or objects that are to be shown. All names must be separated by a semicolon.

      Note:
      Instead of entering all filter criteria in one pattern, you can also enter them by adding several patterns.

    • You can use wildcards (? or *) within the names if you do not want to enter each name individually. The question mark (?) may be specified at any position inside the name. The asterisk (*) is only allowed at the end of a name.

    • You can also enter a range of names. Ranges must be entered as follows:

      name1 - name2

      When defining a range, it is important that you enter a space before and after the hyphen. The spaces are necessary since names may contain hyphens. Without the spaces, name1-name2 would be interpreted as the name of a single library or object. Each name in a range definition may contain wildcards (see above). Example:

      AL* - AM?TEST
  8. Choose the OK button to close the dialog box in which you have defined the pattern.

  9. In the Define Filters dialog box, choose the OK button to save your changes and to close the dialog box.

Setting a Filter

Each defined filter can be applied to a system file node or to a library node of a mapped Natural environment:

  • When you select a system file node (for example, User Libraries), you can reduce the number of libraries that are shown for this system file.

  • When you select a library node, you can reduce the number of objects that are shown in this library.

When a filter has been applied, the icons that are shown for the nodes contain an additional plus sign:

Icon System file with an active filter.
Icon Library with an active filter.

Note:
The label decorations for the filters are controlled by the preferences under General > Appearance > Label Decorations. If you do not want to have label decorations for the filters, just go to the above mentioned preference page and deselect Natural Server View Filter.

All filters that you set for a mapped Natural environment are stored with the environment name that is shown in the Natural Server view. For example, when you have defined "MyMainframe" as the environment name and you unmap this environment, the filters will be set again when you map the same environment once more with the same environment name (that is, with the name "MyMainframe"). If you map the same environment with a different environment name (for example, with the name "MyServer"), the filters that you have set for "MyMainframe" are not considered.

Start of instruction setTo set a filter

  1. In the Natural Server view, select the node(s) for which you want to set a filter (either a system file node or a library node).

  2. Invoke the context menu and choose Set Filter.

    The Set Filters dialog box appears. It lists all filters that are currently defined.

    Set filters

  3. Activate the check box for each filter that you want to set.

    You can also use the following command buttons:

    Command Button Description
    Select All Activates all filters in the dialog box.
    Deselect All Deactivates all filters in the dialog box.
    Filters Invokes the Define Filters dialog box in which you can define additional filters or change the existing filters. See Defining a Filter.

    Note:
    When you select a filter (not the check box), the pattern for this filter is shown at the bottom of the dialog box.

  4. Choose the OK button.

    When an automatic refresh has been defined in the Natural preferences (see Runtime Execution in Setting the Preferences), the content of the Natural Server view changes automatically so that just the items that match your filter pattern are shown (depending on your selection).

    When an automatic refresh has not been defined in the Natural preferences, you have to refresh the display manually. See Refreshing the Display.

    Notes:

    1. If a filter is changed in the Define Filters dialog box and if this filter is already used, an automatic refresh does not occur.
    2. The group nodes for a library (for example, Programs) are always shown, even if all objects of the corresponding type are filtered out.

Removing a Filter or Pattern

You can either deactivate a filter for a node or you can remove a filter completely so that it is no longer available.

You can also remove a single pattern if you no longer need it.

Start of instruction setTo deactivate a filter

  1. In the Natural Server view, select the node(s) for which you want to deactivate a filter.

  2. Invoke the Set Filters dialog box as described above (see Setting a Filter).

  3. Deselect the check box for each filter that you want to deactivate.

  4. Choose the OK button.

Start of instruction setTo remove a filter

  1. Invoke the Define Filters dialog box as described above (see Defining a Filter).

  2. Select the filter that you want to delete.

  3. Choose the Remove button in the upper part of the dialog box.

    Note:
    When the selected filter is currently active, you are asked whether you really want to delete the filter.

Start of instruction setTo remove a pattern

  1. Invoke the Define Filters dialog box as described above (see Defining a Filter).

  2. Select the filter which contains the pattern that you want to delete.

  3. Select the pattern that you want to delete.

  4. Choose the Remove button in the lower part of the dialog box.

Properties for the Different Nodes

When you select a node in the Natural Server view, the corresponding properties are automatically shown in the Properties view. The information that is shown in the Properties view depends on the type of node that is currently selected:

  • Natural Environment
    Information on the selected Natural environment is shown. This includes the mapping information.

    Note:
    More detailed information on a Natural environment is provided in the Properties dialog box. See System Information for a Natural Environment.

  • System File, Library or Object Type
    Information on the selected system file, library or object type is shown, for example, database ID, file number, the number of different objects (such as sources and cataloged objects) and their sizes.

  • Object
    Information on the selected object is shown, for example, short name and long name, programming mode, encoding, and date and time when the source was last modified or cataloged.

Brief information on the selected node is also shown in the status line of the Eclipse window. For example, when a Natural object is selected, the following information is shown: environment name (with host name and port number), system file name (with database ID and file number), library name, object type (for example, "P" for program), and object name.

Note:
You can also invoke a Properties dialog box for a node, using the Properties command from the context menu.

System Information for a Natural Environment

In the Natural Server view, you can display detailed system information for each mapped Natural environment.

Start of instruction setTo display system information for a Natural environment

  1. In the Natural Server view, select the top-level node for a mapped Natural environment.

  2. Invoke the context menu and choose Properties.

    The Properties dialog box appears, showing the system information for this environment.

  3. In the tree on the left side of the dialog box, choose the type of system information that you want to display.

    Information on the resulting page is provided in the topics below.

Note:
The information provided in the Properties dialog box corresponds to the output of the Natural system commands SYSPROD, SYSPROF and SYSFILE.

General Information

When you choose General in the tree, general information about the current environment is shown.

General

This information includes, for example, the Natural Development Server (NDV) version and the name of the default code page.

If you want to change the mapping (for example, in order to specify different session parameters or a different user ID and password), you can do this here. See Mapping a Natural Environment for information on the options that can be specified.

Note:
General information is also shown in the Properties view when the node for a mapped Natural environment is selected. However, it is not possible to modify information in this view. See also Properties for the Different Nodes.

Product Information (SYSPROD)

When you choose Product Information (SYSPROD) in the tree, a list of all products that are installed in the Natural environment is shown.

SYSPROD

Two different areas are available, a tree and a table. The information that is shown depends on the selected Natural environment.

  • The tree at the top lists all installed products in the Natural environment.

    When you move the mouse pointer over a product name in the tree, a tool tip appears, providing information about this product. The same information is shown in the table at the bottom when you select the product in the tree.

    For some products, it is possible to expand the product node in the tree:

    • Mainframe environments
      You can display information on history records and/or subcomponents.

    • Windows, UNIX and OpenVMS environments
      You can display information on hotfixes.

  • The table at the bottom shows information about the entry which is currently selected in the tree. For example:

    • When you select the top-level entry Products in the tree, a list of all installed products is shown in the table. In this case, you can see the details for all products (such as INPL version number, INPL date and product ID) at a glance.

    • When you select a product in the tree, only the details for the selected product are shown in the table.

    • When you select, for example, a history record in the tree, the corresponding information is shown in the table.

System Files (SYSPROF)

When you choose System Files (SYSPROF) in the tree, the current assignments for all Natural system files in the Natural environment are shown.

SYSPROF

For each system file, detailed information such as database ID and file number is provided. The information that is shown depends on the selected Natural environment. The above example shows the system files in a mainframe environment. For Windows, UNIX and OpenVMS environments, additional entries for inactive system files can also be shown.

Work and Print Files (SYSFILE)

When you choose Work and Print Files (SYSFILE) in the tree, information about work files and printer settings is shown.

SYSFILE

Several tabs are provided. The information that is shown depends on the selected Natural environment. The above example shows the tabs for a mainframe environment (work files and print files). In a Windows, UNIX and OpenVMS environment, tabs are provided for work files, reports and logical devices.

Unmapping a Natural Environment

When you unmap a Natural environment, its node is removed from the Natural Server view.

Note:
Any editor windows that have been opened for an environment are not closed when unmapping this environment. Even though the environment has been unmapped, it is still possible to save to this environment any modifications that you make in the editor windows.

Start of instruction setTo unmap a Natural environment

  1. In the Natural Server view, select the node for the Natural environment that you want to unmap.

  2. Invoke the context menu and choose Unmap.

    Or:
    Choose the following icon in the local toolbar:

    Icon