web server - Borland Technical Publications

web server - Borland Technical Publications web server - Borland Technical Publications

techpubs.borland.com
from techpubs.borland.com More from this publisher
12.11.2014 Views

Using the iastool command-line tools pservice Use this tool to enable, disable, or get the state of a partition service. Syntax -pservice -cfg -partition -moagent -service [-force_restart] [-mgmtport ] [-realm ] [-user ] [-pwd ] [-file ] Default Output The default output returns nothing to standard output (stdout). Options The following table describes the options available when using the pservice tool. Option -hub -host : -partition -moagent -service -enable | -disable | -status -force_restart -mgmtport -realm -user -pwd -file Description Specifies the hub where the partition service you are interested in is located. There is no default. Specifies the host name and the listener port of the machine on which the partition service you are interested in is running. The option is enables the iastool utility to locate a partition service on a different subnet than the machine on which iastool is running. Specifies the name of the partition. Specifies the managed object agent name. Use this option if the specified hub has more than one agent. Specifies the name of the service. Specifies the operation you would like to perform on the partition service. Restarts the specified Partition after completing the enable, disable, or status operation. If this option is not specified, you will need to restart the Partition manually to initialize the module. Specifies the management port number used by the specified hub. The default is 42424. Specifies the realm used to authenticate a user when the user and password options are specified. Specifies the user to authenticate against the specified realm. Specifies the user's password to authenticate against the specified realm. Specifies a login script file containing the realm, user name, and password used to authenticate a user. The full or relative path to this file must be specified. See “Executing iastool command-line tools from a script file” on page 321 for more information. Example The following example shows how to enable the partition naming service on the standard partition. iastool -pservice -hub BES1 -cfg j2ee -partition standard -service standard_visinaming -enable -force_restart -mgmtport 24431 Chapter 29: iastool command-line utility 313

Using the iastool command-line tools removestubs Use this tool to remove all stub files from a JAR file. Syntax -removestubs -jars [-targetdir ] Default Output The default output returns nothing to standard output (stdout). Options The following table describes the options available when using the removestubs tool. Option -jars -targetdir Description Specifies the JAR file(s) from which you want to remove one or more stub files. To specify more than one JAR file, enter a comma(,) between each JAR file (no spaces). The full or relative path to the JAR file(s) must be specified. There is no default. Specifies the directory in which the stub files that were removed will be stored. A full or relative path must be specified, if this option is specified. There is no default. If no target directory is specified, the stub files will be removed, but not saved. Example The following example shows how to remove stub files located from the EJB JAR files proj1.jar, proj2.jar, and proj3.jar located in the current directory and copy them to c:\examples\proto: iastool -removestubs -jars proj1.jar,proj2.jar,proj3.jar -targetdir c:\examples\proto restart Use this tool to restart a hub or managed object. The hub must already be running in order for the restart tool to work with a hub. Syntax -restart [-mgmtport ] [-realm ] [-user ] [-pwd ] [-file ] or -restart [-cfg ] -mo -moagent [-mgmtport ] [-realm ] [-user ] [-pwd ] [-file ] Default Output The default output displays the hub or managed object that has been restarted. If the restart tool fails (for example, when a managed object cannot be shutdown or restarted), an error is displayed with a status code which is returned to standard error output (stderr). 314 BES Developer’s Guide

Using the iastool command-line tools<br />

removestubs<br />

Use this tool to remove all stub files from a JAR file.<br />

Syntax<br />

-removestubs -jars [-targetdir ]<br />

Default Output<br />

The default output returns nothing to standard output (stdout).<br />

Options<br />

The following table describes the options available when using the removestubs tool.<br />

Option<br />

-jars <br />

-targetdir <br />

Description<br />

Specifies the JAR file(s) from which you want to remove one or more<br />

stub files. To specify more than one JAR file, enter a comma(,)<br />

between each JAR file (no spaces). The full or relative path to the JAR<br />

file(s) must be specified. There is no default.<br />

Specifies the directory in which the stub files that were removed will be<br />

stored. A full or relative path must be specified, if this option is<br />

specified. There is no default. If no target directory is specified, the<br />

stub files will be removed, but not saved.<br />

Example<br />

The following example shows how to remove stub files located from the EJB JAR files<br />

proj1.jar, proj2.jar, and proj3.jar located in the current directory and copy them to<br />

c:\examples\proto:<br />

iastool -removestubs -jars proj1.jar,proj2.jar,proj3.jar<br />

-targetdir c:\examples\proto<br />

restart<br />

Use this tool to restart a hub or managed object. The hub must already be running in<br />

order for the restart tool to work with a hub.<br />

Syntax<br />

-restart [-mgmtport ]<br />

[-realm ] [-user ] [-pwd ] [-file ]<br />

or<br />

-restart [-cfg ]<br />

-mo -moagent [-mgmtport ]<br />

[-realm ] [-user ] [-pwd ] [-file ]<br />

Default Output<br />

The default output displays the hub or managed object that has been restarted.<br />

If the restart tool fails (for example, when a managed object cannot be shutdown or<br />

restarted), an error is displayed with a status code which is returned to standard error<br />

output (stderr).<br />

314 BES Developer’s Guide

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!