This documentation supports the 9.1 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.



You can continue to use C APIs to customize your application, but C APIs are not enhanced to support new capabilities provided by Java APIs and REST APIs.


Specifies the port that your program uses to communicate with the BMC Remedy AR System server and whether to use a private queue.

If you perform a set operation on an overlay and you provide values for an inherited grain, the values are ignored. Only values for extended or overwritten grains of the overlay are set.


All users.


#include "ar.h"
#include "arerrno.h"
#include "arextern.h"

int ARSetServerPort(
   ARControlStruct *control,
   ARNameType server,
   int port,
   int rpcProgramNum,
   ARStatusList *status)

Input arguments


The control record for the operation. It contains information about the user requesting the operation, where that operation is to be performed, and which session is used to perform it. The user and server fields are required.


The name of the server to update.


The port number that your program uses to communicate with the BMC Remedy AR System server. If you do not specify this parameter or provide 0 for the port number, your program uses the port number supplied by the portmapper. This parameter is overridden by the ARTCPPORT environment variable.


The RPC program number of the server. Specify 390600 to use the admin queue, a number from 390621 to 390634 or 390636 to 390669 or 390680 -390694 to use a private queue, or 0 (default) to use the fast or list server queue. This parameter is overridden by the ARRPC environment variable.

To retrieve server statistics information with the ARGetServerStatistics call, you can also set the RPC Program number to 390619, 390620, or 390635.

Return values


A list of zero or more notes, warnings, or errors generated from a call to this function. For a description of all possible values, see Error checking.

Was this page helpful? Yes No Submitting... Thank you