Show TOC

Object documentationRegistering the Pending Transaction Interface

 

Before using the Pending Transaction object for the first time, you must properly configure it for use. To do this, you must register the component with a command line formatted as follows: TRVEXTPT /regserver /r<R> / s<S>/ a<A>

where <R> is the register number,<S> is the store number, and <A> is the IP address of the server.

If you later want to reconfigure the Pending Transaction object, you must first unregister it, using the following command line: TRVEXTPT /unregserver. You can then make any desired changes and re-register the object as described above.

Note Note

The <R> register number and<S> store number registration parameters are optional.

End of the note.
Command Line Options

/Unregserver

Unregisters the COM object and clears all configuration settings (the server unregisters and then exits). All other configuration options are ignored when this option is included.

/Regserver

Registers the COM object. Any existing configuration settings that are not overridden remain unchanged (the server registers and then exits).

/A

Sets the address of the Xpress Server to which the Pending Transaction object should connect (for database updates). This value is optional and, if not provided and no value is stored in the registry, the Pending Transaction object will attempt to connect to the local machine (that is, the Pending Transaction object and the Xpress Server must be running on the same machine).

If used in conjunction with /Regserver, this setting is persisted to the registry and used as the subsequent default when the server is run without this option. If used without / Regserver, it sets the address to be used for this single invocation of the server only.

/L

Locks the Pending Transaction object in memory (for the current execution only). You must manually close the server by right-clicking the tray icon and clicking 'Exit'. Without this option, the Pending Transaction object will exit automatically when no clients are referencing it. This option is ignored when used in conjunction with /Regserver or /Unregserver.

/R

Sets the register number that the Pending Transaction object will use to identify itself to the Xpress Server. If used in conjunction with /Regserver, this setting is persisted to the registry and used as the subsequent default when the server is run without this option. If used without /Regserver, it sets the register number to be used for this single invocation of the server only.

/S

Sets the store number that the pending Transaction object will use to identify itself to the Xpress Server.

If used in conjunction with /Regserver, this setting is persisted to the registry and used as the subsequent default when the server is run without this option. If used without /Regserver, it sets the store number to be used for this single invocation of the server only.

/T

Sets the timeout (in seconds) for responses to datagrams. If this option is not provided, the default value of 5 seconds is used.