Editing application configurations using the wsadmin scripting tool

Use the wsadmin tool to configure application settings.

About this task

You can use the AdminApp edit or editInteractive command to change an entire application or a single application module.

You can set or update a configuration value using options in batch mode. To identify which configuration object is to be set or updated, the values of read only fields are used to find the corresponding configuration object. All the values of read only fields have to match with an existing configuration object, otherwise the command fails.

You can use pattern matching to simplify the task of supplying required values for certain complex options. Pattern matching only applies to fields that are required or read only.

Attention: If an application is running, changing an application setting causes the application to restart. On stand-alone servers, the application restarts after you save the change. On multiple-server products, the application restarts after you save the change and files synchronize on the node where the application is installed. To control when synchronization occurs on multiple-server products, deselect Synchronize changes with nodes on the Console preferences page.

Procedure

  1. Start the wsadmin scripting tool.
  2. Edit the entire application or a single application module. Use one of the following commands:
    • The following command uses the installed application and the command option information to edit the application:

      • Using Jacl:
        $AdminApp edit appname {options}
      • Using Jython list:
        AdminApp.edit('appname', ['options'])
      • Using Jython string:
        AdminApp.edit('appname', '[options]')
      Table 1. AdminApp edit command description. Run the edit command with the name of the application or module.
      $ is a Jacl operator for substituting a variable name with its value
      AdminApp is an object that supports application object management
      edit is an AdminApp command
      appname is the name of application or application module to edit. For the application module name, use the module name returned from listModules command as the value.
      {options} is a list of edit options and tasks similar to the ones for the install command
    • The following command changes the application information by prompting you through a series of editing tasks:

      • Using Jacl:
        $AdminApp editInteractive appname
      • Using Jython:
        AdminApp.editInteractive('appname')
      Table 2. AdminApp editInteractive command description. Run the editInteractive command with the name of the application or module.
      $ is a Jacl operator for substituting a variable name with its value
      AdminApp is an object that supports application object management
      editInteractive is an AdminApp command
      appname is the name of application or application module to edit. For the application module name, use the module name returned from listModules command as the value.
  3. Save the configuration changes.
    Use the following command example to save your configuration changes:
    AdminConfig.save()
  4. In a network deployment environment only, synchronize the node.
    Use the syncActiveNode or syncNode scripts in the AdminNodeManagement script library to propagate the configuration changes to node or nodes.
    • Use the syncActiveNodes script to propagate the changes to each node in the cell, as the following example demonstrates:
      AdminNodeManagement.syncActiveNodes()
    • Use the syncNode script to propagate the changes to a specific node, as the following example demonstrates:
      AdminNodeManagement.syncNode("myNode")



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms of Use | Feedback

Last updatedLast updated: Sep 19, 2011 3:08:41 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-nd-zos&topic=txml_editapp
File name: txml_editapp.html