Starting the adapter configuration tool

Start the agentCfg tool to access the configuration menu, where you can modify the different adapter parameters.

Procedure

  1. Log on to the TSO on the z/OS® operating system that hosts the adapter.
  2. Run the following command. Press Enter to enter the UNIX System Services environment.
    omvs
    Note: You can also use a telnet session to enter the UNIX System Services environment.
  3. In the command prompt, change to the read/write /bin subdirectory of the adapter.If the adapter is installed in the default location for the read/write directory, run the following command.
    # cd /var/ibm/adapter_readwritedir/bin
    Note: There is a /bin subdirectory in the adapter read-only directory too. The read/write /bin subdirectory contains scripts that set up environment variables, then call the actual executables that reside in the read-only /bin directory. You must start the adapter tools by running the scripts in the read/write directory, otherwise errors might occur.
  4. Run the following command
    agentCfg -agent IGIAGNT
    The adapter name is specified when you install the adapter. You can find the names of the active adapters by running the agentCfg utility as:
    agentCfg -list
  5. At Enter configuration key for Agent adapter_name, type the configuration key for the adapter.
    The default configuration key is agent.
    Note: To prevent unauthorized access to the configuration of the adapter, you must modify the configuration key after the adapter installation completes. See Changing protocol configuration settings.
    The Agent Main Configuration Menu is displayed.
    Agent Main Configuration Menu
    -------------------------------------------
    A. Configuration Settings.
    B. Protocol Configuration.
    C. Event Notification.
    D. Change Configuration Key.
    E. Activity Logging.
    F. Registry Settings.
    G. Advanced Settings.
    H. Statistics.
    I. Codepage Support.
    
    X. Done
    
    Select menu option:
    
    The following table lists the different options available in the Agent Main Configuration Menu.
    Table 1. Options for the main configuration menu
    Option Configuration task
    A Viewing configuration settings
    B Changing protocol configuration settings
    C Configuring event notification
    D Changing the configuration key
    E Changing activity logging settings
    F Changing registry settings
    G Changing advanced settings
    H Viewing statistics
    I Changing code page settings