Configuration Object - Object Definition

The class of OS to which this extended object applies

If you want to create an extended object that is associated with an object that does not have a BMC Server Automation RSCD agent installed, select None. If you select None, the Application Server must centrally execute the script or program associated with this extended object

An icon to associate with this extended object.

To populate this list with choices, you must create an icon library (see Defining custom icons). If you select Default from this list, the standard icon for extended objects is associated with the extended object you are defining.

A command that the extended object should run. Enter your command or enter (or specify by browsing) a path to the program or script that contains this information for the extended object.

When entering a path, you can include one or more parameters. You can enter a parameter manually, or you can click Select Property . Using parameters, you can enter a path such as /??TARGET.WINDIR??/system32/$$TARGET.SCRIPT_DIR??/script.bat. When the script runs, the system replaces the parameters with the value of the server properties WINDIR and SCRIPT_DIR. If you are defining a local extended object for a component template, use the local properties of the component template to make the path applicable to multiple instances of the same component on a server.

For execution of the script or program, select one of the following options:

• Central Execution — Executes the script or program on the Application Server. The script or program must be available in the path or explicitly qualified with the path so that the Application Server can successfully invoke it.
• Remote Execution — Executes the script or program on a remote server using a Network Shell nexec (or equivalent) command. The script or program must be available in the path or explicitly qualified with the path so that the agent on the remote server can successfully invoke it.

The mode of character encoding to use with the extended object, one of the following:

• Select Output uses default encoding on executing system to use the default character encoding for the system where the extended object is generating output.
• Select Output uses encoding and then select the type of character encoding that is used when displaying the output of the extended object. For example, you might select UTF8 or UTF16.

To specify the file path for the configuration file, do one of the following:

• If you are adding a single file, enter the path to the file or use Browse to navigate to the file.
• If you are using the wild card approach, enter the path to a directory or use Browse to navigate to the directory containing configuration files. Then use a wild card to identify multiple files in that directory. When entering a path, you can include one or more parameters. For example, you can enter $$TARGET.PATH??/??TARGET.CONFIG_DIR??/.xml* to add all the XML files at a location identified by the combination of the TARGET.PATH and the TARGET.CONFIG_DIR properties. You can enter a parameter manually, or you can click Select Property .
  
  If you are defining a local configuration object for a component template, use the local properties of the component template to make the path applicable to multiple instances of the same component on a server.

The mode of character encoding to use with the configuration file, one of the following:

• Select Uses default character encoding to use your system's default character encoding when displaying the configuration file.
• Select Uses encoding and then select the type of character encoding that is used when displaying the configuration file. For example, you might select UTF8 or UTF16.