Running the Approval Join Fix utility

The Approval Join Fix (joinfix) utility modifies the join qualifications to make sure that your application communicates correctly with the approval server. The joinfix utility is installed in the same directory as the approval server.

After the join forms are created, run the Approval Join Fix (joinfix) utility once for each approval request form that you connect to the approval server. 

The syntax for joinfix is as follows:

joinfix
-x Server
-u User
[-p Password] [-t TCP Port]
[-a Authentication String] [-r RPC Port]
[-f Form]
[-m Mode]

The following table describes the parameters that administrators need to supply when running the joinfix utility:

Parameter

Description

-x

(Mandatory) Name or IP address of the AR System server to log on to (or localhost, if applicable).

-u

(Mandatory) Specify the AR System user name. This user must belong to an administrator group, otherwise the utility cannot be run successfully, and the following error is displayed at the command prompt and written to approval-utils.log:

Admin verification failed: <userName>

-p

(Optional) Specify the password for the aforementioned user. Omit this parameter if the user account does not have a password.

-t

(Optional) TCP port number of the server being logged into. This parameter is required if the AR System server is configured to listen on a particular TCP port.

If the AR System server is configured to use a portmapper, do not use the -t parameter. If the AR System server does not use a portmapper, use the -t parameter and replace portNumber with the appropriate TCP port.

Tip

The joinfix utility might return authentication errors on an AR System server that is configured to run with a specific TCP port. If such errors occur, set the ARTCPPORT environment variable to the appropriate port number and try again.

-a

(Optional) Specify the authentication string.

-r

(Optional) RPC port number of the server being logged on to. This parameter is required if the AR System server is configured to listen on a particular RPC port.

-f

(Mandatory) Specify the name of the form.

-m

(Mandatory) Specify one of the following modes:

Mode 1—Update join criteria.
Mode 2—Add new fields in the three-way join form. Use this mode when you upgrade your AR System server and approval server to release 7.x.xx or later from an earlier release.
Mode 3—Update password fields on the three-way join form.