Reconfigure External Persistent Class Utility (EPCReconfigure.exe)

The Reconfigure External Persistent Class utility (EPCReconfigure.exe) can be used at runtime to view, delete, or change the configuration properties of an external class with persistent members. This utility stores the configuration details in the _Config table of the runtime database. The _Config table is created when you first deploy an AB Suite system only if the system contains external classes with persistent members.

The configuration details stored in the _Config table take precedence over those set in the model. Therefore, after deploying the runtime application, you can use the Reconfigure utility to modify the configuration details with which the system was originally generated. This allows a system to be deployed using the Runtime Transfer and any external persistent classes within the system to be reconfigured and connected to different external data.

You can modify configuration details, such as the external host, the TCIP port number, the external EAE system, the external table, the user id, and the password required to access the host server.

This utility is available in the CD Runtime\Windows Runtime\Runtime Utilities\EPCReconfigure folder of the Agile Business Suite 7.0 Installation CD. You can invoke the utility from a command line.

Note: You must have local administrator privileges to use EPCReconfigure.exe.

The EPCReconfigure utility requires a set of command line arguments for each of the following options:

GETCONFIG - To view the configuration properties

EPCReconfigure.exe GETCONFIG <system name> <model class name>

DELETECONFIG - To delete the configuration properties

EPCReconfigure.exe DELETECONFIG <system name> <model class name>

SETCONFIG - To modify the configuration properties

EPCReconfigure.exe SETCONFIG <system name> <model class name> <ExternalHost> 
<PortNumber> <ExternalSystem> <ExternalTable> <UserId> <Password>

Note: An error message appears if you do not specify the required command line arguments for an option. All error messages are available in the system.log file.

where,

Configuration Property	Description
<system name>	Specifies the deployed AB Suite system. *Note:* An error message appears if the system does not exist.
<model class name>	Specifies the external class with persistent members used to read the OS 2200 database.
<ExternalHost>	Specifies the IP address or the name of the external host server. For example: \\USTR-TIS2.UNISYS.COM
<PortNumber>	Specifies the TCIP port number to connect to the external host server. The port number must be between 1 and 65535 inclusive.
<ExternalSystem>	Specifies the name of the deployed EAE system.
<ExternalTable>	Specifies the OS 2200 table being accessed or the Source Name of the external data source. *Note:* An error message appears if the Source Name is invalid and you should verify the external table in the OS 2200 RDMS database. You can access the system.log file for more information on this.
<UserId>	Specifies the registered user-id that can access the host server. The user-id can be Alphanumeric character Period (.) Hyphen (-) Of length less than or equal to 12 The user-id must not begin with an underscore or a numeral. *Note:* The user-id is encrypted and stored in the _Config table.
<Password>	Specifies the password required for the authorized user id on the host server. The password can be Alphanumeric character Of length less than or equal to 18 A password must not contain a comma (,) or a slash (/). *Note:* The password is encrypted and stored in the _Config table.