Setting general preferences

You can use the z/OS UNIX Subprojects preference page to specify general preferences for z/OS® UNIX subprojects, including the message prefix and the client IP address.

Procedure

To set these options:

  1. In the Preferences window, navigate to z/OS Solutions > z/OS UNIX Subprojects.
  2. Optional: In the Message Prefix field, type the information that you want to automatically prefix to all generated messages that are displayed in the Remote Console view.
    Tip: You can specify substitution variables in the Message Prefix field to insert certain types of information into the message prefix, such as the current date and time (&DATE &TIME). The following substitution variables are supported in the message prefix:
    • &DATE - the date that the message is issued.
    • &TIME - the time that the message is issued.
    • &SYS - the system that generated the message. For remote actions, the name of the remote system is displayed; in all other instances the name of the workstation is displayed.
    • &USER - the user session that generated the message. For remote actions, the user name of the remote system session is displayed; in all other instances, the name of the current workstation is displayed.

    These substitution variables must include a preceding ampersand and be in uppercase.

    For example, &DATE &TIME System: &SYS User: &USER generates the following string: 07/24/2003 14:01:17 System: some_system User: JDoe. This string is prefixed to a message that is generated by a remote action that is run on a remote system named some_system.
  3. In the Dynamic IP Address Options group, do the following steps:
    1. From the Client IP Address list, select the IP address of the system on whichIBM® Developer for z/OS is running.
      This list stores a history of up to 10 unique addresses. This history is composed of IP addresses that were previously typed into this field or are detected by the operating system.
    2. If the Client IP Address list does not contain the IP address of the system on which the product is running, type the correct IP address in the Client IP Address field.
    3. Optional: To prompt this preference page to open the first time that an action is run that requires the local IP address, select the Always ask for IP Address check box.
      If you specified the IP address in this preference page at startup, then the preference page does not open the first time that you run an action that requires the local IP address. After the IP address is specified, it is used for subsequent actions (without a prompt) for the rest of the session, or until you modify the IP address by using this preference page.
    You must set the dynamic IP address options only in the following scenarios:
    • Your network connection is through a VPN connection that does not expose its tunneled IP address to the local operating system.
    • You have multiple network adapters, and therefore, multiple IP addresses. If you do not specify which IP address to use at startup, Developer for z/OS does not know which of these addresses to use.
    If your network connection is not through VPN and only one network adapter is defined, you do not have to set the dynamic IP address options. The default settings identify the correct IP address and use this address when actions (such as JCL submit) are run.
  4. To save your selections in the preference page, click Apply.
    Since the client IP address can change between sessions, the dynamic IP address options are saved for the current session only. When you start a new session of Developer for z/OS, you must specify the dynamic IP address options for that session.