Invoking an administrative command in interactive mode

Perform the following steps to invoke an administrative command in interactive mode. To invoke an administrative command in batch mode, see Invoking an administrative command in batch mode.

1. Invoke the AdminTask object commands interactively, in a script, or use the wsadmin -c command from an operating system command prompt.

2. Invoke an administrative command in interactive mode by issuing one of the following commands:

   • Use the following command invocation to enter interactive mode without providing another input in the command invocation: Using Jacl:

     $AdminTask commandName {-interactive}

     Using Jython:

     AdminTask.commandName('[-interactive]')

     where:

     $	is a Jacl operator for substituting a variable name with its value
     AdminTask	is an object allowing administrative command management
     commandName	is the name of the administrative command being invoked
     -interactive	is the interactive option

   • Use the following command invocation to enter interactive mode using an administrative command that takes a target object. You do not have to provide a target object to enter interactive mode. Target objects provided in the command invocation will be applied to the command and displayed as the current target object value during interactive prompting. Using Jacl:

     $AdminTask commandName targetObject {-interactive}

     Using Jython:

     AdminTask.commandName(targetObject, '[-interactive]')

     where:

     $	is a Jacl operator for substituting a variable name with its value
     AdminTask	is an object allowing administrative command management
     commandName	is the name of the administrative command being invoked
     targetObject	is the target object string for the invoked administrative command. The target object is different for each administrative command. View the online help for the invoked administrative command to learn more about what to specify as a target object.
     -interactive	is the interactive option

   • Use the following command invocation to enter interactive mode for an administrative command that takes options. You do not have to provide other options to enter interactive mode. Options provided in the command invocation are applied to the command and the option values will be displayed as the current values during interactive prompting. Using Jacl:

     $AdminTask commandName {-interactive commandOptions}

     Using Jython:

     AdminTask.commandName('[-interactive commandOptions]')

     where:

     $	is a Jacl operator for substituting a variable name with its value
     AdminTask	is an object allowing administrative command management
     commandName	is the name of the administrative command being invoked
     -interactive	is the interactive option
     commandOptions	is the command option available for the associated administrative command. Available command options are different for each administrative command. View the online help for the invoked administrative command to obtain more information about which options are available. Arguments and steps listed on the online administrative command help are specified as command options. Each option consists of a dash followed immediately by an option name, and then followed by an option value if the option requires a value. For example, using the output of the following online help for createJ2CConnectionFactory: WASX8006I: Detailed help for command: createJ2CConnectionFactory Description: Create a J2C connection factory *Target object: The parent J2C resource adapter of the created J2C connection factory. Arguments: *connectionFactoryInterface - A connection factory interface that is defined in the deployment description of the parent J2C resource adapter. *name - The name of the J2C connection factory. *jndiName - The JNDI name of the created J2C connection factory. description - The description for the created J2C connection factory. authDataAlias - the authentication data alias of the created J2C connection factory. Steps: None In this example, there are five options available: -connectionFactoryInterface -name -jndiName -description -authDataAlias Each requires an option value. Only three of the options are required and are denoted with a *.

   • Use the following command invocation to enter interactive mode for an administrative command that has a target object and options. You do not have to specify a target object to enter interactive mode. The values specified are applied to the command before the command data is displayed. As a result, the values specified will be displayed as the current values during interactive prompting. Using Jacl:

     $AdminTask commandName targetObject {-interactive commandOptions}

     Using Jython:

     AdminTask.commandName(targetObject, '[-interactive commandOptions]')

     where:

     $	is a Jacl operator for substituting a variable name with its value
     AdminTask	is an object allowing administrative command management
     commandName	is the name of the administrative command being invoked
     targetObject	is the target object string for the invoked admin command. The expect target object varies with each admin command. Consult the on-line help on the invoked admin command to learn more about what to specify as target object.
     -interactive	is the interactive option
     commandOptions	is the command option available for the associated administrative command. Available command options are different for each administrative command. View the online help for the invoked administrative command to obtain more information about which options are available. Arguments and steps listed on the online administrative command help are specified as command options. Each option consists of a dash followed immediately by an option name, and then followed by an option value if the option requires a value. For example, using the output of the following online help for createJ2CConnectionFactory: WASX8006I: Detailed help for command: createJ2CConnectionFactory Description: Create a J2C connection factory *Target object: The parent J2C resource adapter of the created J2C connection factory. Arguments: *connectionFactoryInterface - A connection factory interface that is defined in the deployment description of the parent J2C resource adapter. *name - The name of the J2C connection factory. *jndiName - The JNDI name of the created J2C connection factory. description - The description for the created J2C connection factory. authDataAlias - the authentication data alias of the created J2C connection factory. Steps: None In this example, there are five options available: -connectionFactoryInterface -name -jndiName -description -authDataAlias Each requires an option value. Only three of the options are required and are denoted with a *.

Example

• The following example invokes an administrative command in interactive mode by specifying the -interactive option: Using Jacl:

  $AdminTask createJ2CConnectionFactory {-interactive}

  Using Jython:

  AdminTask.createJ2CConnectionFactory('[-interactive]')

  Example output:

  Create a J2C connection factory 
  *The J2C resource adapter: "WebSphere Relational ResourceAdapter (cells/myCell/nodes/myNode|resources.xml#builtin_rra)"
  
  A connection factory 
  interface (connectionFactoryInterface):javax.resource.cci.ConnectionFactory *Name (name): myJ2CCF
  *The JNDI name (jndiName): j2c/cf Description (description):
  authentication data alias (authDataAlias):
  
  create J2C connection factory 
  F (Finish)
  C (Cancel)
  
  Select [F, C]: [F]
  
  myJ2CCF(cells/myCell/nodes/myNode|resources.xml#J2CConnectionFactory_1069690568269)

• The following example invokes an administrative command using the -interactive option with a target object specified in the command invocation: Using Jacl:

  set ra [$AdminConfig getid /J2CResourceAdapter:myResourceAdapter/]
  $AdminTask createJ2CConnectionFactory $ra {-interactive}

  Using Jython:

  ra = AdminConfig.getid('/J2CResourceAdapter:myResourceAdapter/')
  AdminTask.createJ2CConnectionFactory(ra, '[-interactive]')

  Example output:

  Create a J2C connection factory 
  *The J2C resource adapter: ["WebSphere Relational ResourceAdapter (cells/myCell/nodes/myNode|resources.xml#builtin_rra)"]
  
  A connection factory interface (connectionFactoryInterface):
  javax.resource.cci.ConnectionFactory *Name (name): myJ2CCF
  *The JNDI name (jndiName): j2c/cf Description (description):
  authentication data alias (authDataAlias):
  
  create J2C Connection Factory 
  F (Finish)
  C (Cancel)
  
  Select [F, C]: [F]
  
  myJ2CCF(cells/myCell/nodes/myNode|resources.xml#J2CConnectionFactory_1069690568269)

• The following example invokes an administrative command using the -interactive option where both the target object and the additional command options are specified in the command invocation: Using Jacl:

  set ra [$AdminConfig getid /J2CResourceAdapter:myResourceAdapter/]
  $AdminTask createJ2CConnectionFactory $ra {-name myNewCF -interactive}

  Using Jython:

  ra = AdminConfig.getid('/J2CResourceAdapter:myResourceAdapter/')
  AdminTask.createJ2CConnectionFactory(ra, '[-name myNewCF -interactive]')

  Example output:

  Create a J2C connection factory 
  *The J2C resource adapter: ["WebSphere Relational ResourceAdapter (cells/myCell/nodes/myNode|resources.xml#builtin_rra)"]
  
  A connection factory interface (connectionFactoryInterface):javax.resource.cci.ConnectionFactory *Name (name): [myNewCF]
  *The JNDI name (jndiName): j2c/cf Description (description):
  authentication data alias (authDataAlias):
  
  create J2C Connection Factory 
  F (Finish)
  C (Cancel)
  
  Select [F, C]: [F]
  
  myNewCF(cells/myCell/nodes/myNode|resources.xml#J2CConnectionFactory_3839439380269)