Running the Approval Join Fix utility
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. To run the joinfix utility manually, see Running the approval utilities.
This 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.
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:
Parameters for the joinfix utility
(Mandatory) Name or IP address of the BMC Remedy AR System server to log on to (or localhost, if applicable).
(Mandatory) Specify the BMC Remedy 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:
(Optional) Specify the password for the aforementioned user. Omit this parameter if the user account does not have a password.
(Optional) TCP port number of the server being logged into. This parameter is required if the BMC Remedy AR System server is configured to listen on a particular TCP port.
The joinfix utility might return authentication errors on a BMC Remedy 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.
(Optional) Specify the authentication string.
(Optional) RPC port number of the server being logged on to. This parameter is required if the BMC Remedy AR System server is configured to listen on a particular RPC port.
(Mandatory) Specify the name of the form.
(Mandatory) Specify one of the following modes:
Use mode 1 to update the join criteria.