Rockwell Automation FactoryTalk Historian SE 3.0 UniInt Interface User Guide User Manual
Page 15

UniInt Interface User Manual
9
Parameter
Description
/host=host:port
Optional
Default = default
Historian Server from
the pilogin.ini file.
The
/host
parameter is used to specify the Historian Home
node.
host
is the IP address of the Historian Sever node or
the domain name of the Historian Server node.
port is
the
port number for TCP/IP communication. It is recommended to
explicitly define the host and port on the command-line with
the
/host
parameter. Nevertheless, if either the host or port
is not specified, the interface will attempt to use defaults.
Defaults:
The default port name and server name is specified in the
pilogin.ini
or
piclient.ini
file. The piclient.ini file
is ignored if a
pilogin.ini
file is found. Refer to the PI
API Installation Instructions manual for more information on
the piclient.ini and
pilogin.ini
files.
If the interface is configured to use the PI SDK, localhost
should not be used, rather the name of the IF node computer
should be used.
Examples:
The interface is running on a Historian Interface node, the
domain name of the Historian 3 home node is Marvin, and the
IP address of Marvin is 206.79.198.30. Valid
/host
parameters would be:
/host=marvin
/host=marvin:5450
/host=206.79.198.30
/host=206.79.198.30:5450
/id=x
Optional
Default = none
The
/id
parameter is used to specify the interface identifier.
For example,
/id=int1
The interface identifier is a string that is no longer than 9
characters in length. UniInt concatenates this string to the
header that is used to identify error messages as belonging to
a particular interface. See the section called “Error and
Informational Messages” for more information, page 99.
UniInt always uses the
/id
parameter in the fashion
described above. Many interfaces also use the /id parameter
to identify a particular interface copy number that corresponds
to an integer value that is assigned to one of the Location
code point attributes, most frequently Location1. For these
interfaces, one should use only numeric characters in the
identifier. For example,
/id=1
When an interface uses the
/id
parameter to specify an
interface copy number, the point source character should be
the same for all copies of the interface. For example, all
Historian Points for the Modbus interface are typically
configured with a point source of M. Modbus points are
distinguished as belonging to a particular copy of the Modbus
interface by assigning a copy number to the Location1
attribute of the point, which, in turn, corresponds to the copy
number designated by the
/id
parameter.
If the interface does not have a parameter such as the
/id
parameter to identify a particular copy of the interface, a
different point source must be used for each copy of the
interface. Interfaces sometimes use other parameters besides