Invoking an admin command in batch mode


Use this commands to invoke an admin command in batch mode.

To invoke an admin command in interactive mode, see Invoking an admin command in interactive mode.

 

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

  2. Issue one of the following commands:

    • If an admin command does not have a target object and an argument, use the following command:

      Jacl...

      $AdminTask commandName

      Jython...

      AdminTask.commandName()


      Table 1. AdminTask description

      $ Jacl operator for substituting a variable name with its value
      AdminTask object allowing admin command management
      commandName is the name of the admin command to invoke

    • If an admin command includes a target object but does not include any arguments or steps, use the following command:

      Jacl...

      $AdminTask commandName targetObject

      Jython...

      AdminTask.commandName(targetObject)


      Table 2. AdminTask targetObject description

      $ Jacl operator for substituting a variable name with its value
      AdminTask object that supports administrative command management
      commandName is the name of the admin command to invoke
      targetObject is the target object string for the invoked administrative command. The expect target object varies with each admin command. View the online help for the invoked admin command to learn more about what you should specify as the target object.

    • If an admin command includes an argument or a step but does not include a target object, use the following command:

      Jacl...

      $AdminTask commandName options

      Jython...

      AdminTask.commandName(options)


      Table 3. AdminTask options description

      $ Jacl operator for substituting a variable name with its value
      AdminTask object that supports administrative command management
      commandName is the name of the admin command to invoke
      options is the option string for the invoked administrative command. Depending on which admin command we are invoking, the administrative command can have required or optional option values. The options string is different for each admin command. View the online help for the invoked admin command to obtain more information about which options are available. Arguments and steps listed on the online administrative command help are specified as options in the option string.

      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. If the invoked administrative command includes target objects, arguments, or steps, then the –interactive option is available to enter interactive mode. For example, using the output of the following online help for the listDataSource command:

      WASX8006I: Detailed help for command: exportServer

      Description: export the configuration of a server to a config archive.

      Target object: None

      Arguments: *serverName - the name of a server *nodeName - the name of a node. This parameter becomes optional if the specified server name is unique across the cell. *archive - the fully qualified file path of a config archive.

      Steps: None

      Option names are specified with a dash before the names. Three options are required for this admin command. The required options are -serverName, -nodename, and -archive. In addition, the -interactive option is available. Options are specified in the option string, which is enclosed by a pair of braces ({}) in Jacl and a pair of brackets ([]) in Jython.

    • If an admin command includes a target object, and arguments or steps:

      Jacl...

      $AdminTask commandName targetObject options

      Jython...

      AdminTask.commandName(targetObject, options)


      Table 4. AdminTask targetObject with options description

      $ Jacl operator for substituting a variable name with its value
      AdminTask object that supports administrative command management
      commandName is the name of the admin command to invoke
      targetObject is the target object string for the invoked administrative command. The expected target object varies with each admin command. View the online help for the invoked admin command to obtain information about what to specify as a target object. 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

      The target object is a configuration object name of a J2C resource adapter.
      options is the option string for the invoked administrative command. Depending on which admin command we are invoking, the administrative command can have required or optional option values. The options string is different for each admin command. View the online help for the invoked admin command to obtain more information about which options are available. Arguments and steps that are listed on the online administrative command help are specified as options in the option string. 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. If the invoked administrative command includes target objects, arguments, or steps, then the –interactive option is available to enter interactive mode. For example, using the output of the following online help for listDataSource:

      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

      Option names are specified with a dash before the names. The required options for this admin command include: -connectionFactoryInterface, -name, and -jndiName. The optional options include: -description and -authDataAlias. In addition, we can also use the -interactive option. Options are specified in the option string, which is enclosed by a pair of braces ({}) in Jacl and a pair of brackets ([]) in Jython.

 

Example