Managing Stacks › Change Configuration Using Obeyfile Data Sets

Change Configuration Using Obeyfile Data Sets

Note: This section applies to IBM TCP/IP servers only.

To make changes to the configuration, use an Obeyfile data set. Changes made using an Obeyfile data set are dynamic and only affect the running system—they are lost when the IBM TCP/IP system is stopped and restarted.

You can use an Obeyfile data set to control tracing, start or stop devices, or to add new or temporarily authorized users without stopping and restarting the system.

Execute an Obeyfile Data Set

To execute an Obeyfile data set

1. Enter O (Execute Obeyfile) next to an IBM STACK entry on the IP Resource Monitor.

   The TCP/IP : STACK Execute Obeyfile panel appears.

2. Complete the following field:
   • Obeyfile Dataset

     Specifies the name of the data set. This can be:

   • The name of a partitioned data set (PDS), with no member name
   • The name of a PDS, with a member name included
   • The name of a sequential data set

     Press F6 (Action).

     The Obeyfile PDS List appears.

3. Enter O next to the Obeyfile member that you want to execute.

   The Obeyfile Confirm panel appears.

4. Press F6 (Action).

   The Obeyfile is executed.

Check Your Obeyfile Results

The contents and results of the Obeyfile are recorded in the activity log, which you can access by entering /LOG at the prompt.

For information about creating Obeyfile data sets or modifying configuration data sets to change your system's configuration, see IBM's Communications Server IP books.

Note:  You do not need to create obeyfiles for starting and stopping packet traces or devices. TCP/IP commands are automatically generated for these purposes when the appropriate actions are selected on connection and device link displays.

Create a New Member of an Obeyfile Data Set

You can create a new member of an Obeyfile data set, or you can edit an existing one.

To create a new member of an Obeyfile data set

1. Enter E membername or EDIT membername at the prompt on the Obeyfile PDS List panel.

   The Edit Obeyfile panel appears.

2. Press F4 (Edit) from the Obeyfile Confirm panel.

   The Edit Obeyfile panel appears.

   Note: If you are at the Obeyfile PDS List panel, you can edit an Obeyfile member by entering E (Edit) next to a data set name to display the Edit Obeyfile panel.

3. Edit the data set, as required.
4. Press F4 (Save).

   The data set is saved.

Note: Obeyfile processing can be used to start and stop traces and to alter the state of the interface devices as well as altering some configuration parameters. The OBEYFILE command is used to execute the IBM TCP/IP configuration commands.