Step 1.2.2.3. Ptopc_config.xml File: Global Specifications

Lines in the ptopc_config.xml file that define specifications for all projects are as follows.

The number of lines in the list depends on your system requirements.

Note: If optional lines are not added and there is a default value, the default value will be used.

Code Snippet from Sample File

...

24

 

<client_name>CimView</client_name>

25

 

<default_update_rate>1000</default_update_rate>

26

 

<update_rates>

27

 

 

<_MY2SECGROUP>2000< _MY2SECGROUP>

28

 

 

<_MY3SECGROUP>3000<_MY3SECGROUP>

29

 

</update_rates>

30

 

<max_string_length>80</max_string_length>

31

 

<max_array_string_length>80</max_array_string_length>

32

 

<property_id_display_format>5003</property_id_display_format>

33

 

<trace_flags>0</trace_flags>

34

</config>

 

 

Other optional lines

Snippet Line Description

24

client_name>CimView</client_name>

 

(Optional)

 

Included in the distribution file.

This line allows the Advanced Viewer to identify itself to the OPC Server via the IOPCCommon::SetClientName function.

Because the Advanced Viewer is designed to work with external OPC servers (not the OPC Server that comes with CIMPLICITY) you might have to make use of IOPCCommon::SetClientName so the OPC Server can perform special logic based on what type of client is connecting to it.

You enter the Advanced Viewer name as a string between the XML tags.

Example

 In the following string:

 <client_name>AdvancedViewer</client_name>

AdvancedViewer  will get passed as a parameter to the SetClientName function.

This allows the Advanced Viewer (which is an OPC client) to identify itself as a particular type of client to the external OPC Server.

Note: The OPC Foundation Web site provides more information about the IOPCCommon::SetClientName  function in its OPC DA 3.0 Specification.

25

<default_update_rate>1000</default_update_rate>

 

(Optional)

 

How often the OPC server updates the items in this group with fresh device data. It also determines how often to send

Default: 1000 (milliseconds)

Caution: CPU usage increases when updates are set to occur more frequently.

26

<update_rates>

 

(Optional)

 

Starts a list of update rates for selected groups that are different from the default update rate.

27/28

<MY2SECGROUP>2000<_MY2SECGROUP>/<MY2SECGROUP>2000<_MY2SECGROUP>

 

(Optional)

 

List of groups with assigned update rates that are different from the default rate.

29

</update_rates>

 

(Optional)

 

Ends the list of groups with their own assigned update rates.

30

<max_string_length>80</max_string_length>

 

(Optional)

 

Sets the maximum string length that will be accepted from the OPC Server.

If the actual string length is higher than the entered value, it will be truncated/

Default: 80

31

<max_array_string_length>80</max_array_string_length>

 

(Optional)

 

Sets the maximum array string length that will be accepted from the OPC Server.

If the actual string length is higher than the entered value, it will be truncated/.

Default: 80

32

<property_id_display_format>5003</property_id_display_format>

 

(Optional)

 

If your OPC server supports a Property ID Display Format attribute and uses a different attribute number from 5003, you can enter the number your OPC server uses with the above line in the ptopc_config.xml file.

Default: 5003

33

<trace_flags>0</trace_flags>

 

A Trace flags utility is required for the <trace_flags> setting.

If you experience problems contact your support representative.

34

</config>

 

(Required)

 

Ends the ptopc_config.xml file.

Other Optional Lines

The Advanced Viewer used the following two standard OPC property ID values assigned by the OPC Foundation.

If your OPC Server uses different values, include these lines in the global section of the ptopc_config.xml file..

<property_id_display_limit_high>102</property_id_display_limit_high>

 

(Optional)

 

Assigned OPC property ID value for the Property ID Display Limit High attribute.

Default: 102

<property_id_display_limit_low>102</property_id_display_limit_low>

 

(Optional)

 

Assigned OPC property ID value for the Property ID Display Limit Low attribute.

Default: 103

More information

Step 1.2.2. Enter Advanced Viewer specifications in the ptopc_config.xml file.