Search

Scope: Core (OPC-10000-*) All specs

41 result(s) for EstablishConnections

OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

5.4 ConfigurationData

required. This configuration is separate from the configuration required for the actual communication. The EstablishConnections Method allows any of the FunctionalEntity's ConfigurationData to be set. ConfigurationData can contain Variables
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.2 AutomationComponentType definition

HasProperty Variable 3:ConformanceName 0:UriString 0:PropertyType O 0:HasComponent Method 3:EstablishConnections Defined in 6.2.4 M 0:HasComponent Method 3:CloseConnections Defined in 6.2.5 M 0:HasComponent Object ... LogObject is supported, the AutomationComponent shall produce LogRecords for all calls of the EstablishConnections and CloseConnections Methods . The LogObject configuration would determine if the LogRecords are stored. The LogRecords shall
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.4.2 EstablishConnections signature

EstablishConnections signature The signature of this Method is specified below; the arguments are defined in Table 8 . Signature EstablishConnections ( [in] 2:FxCommandMask CommandMask, [in] 2:AssetVerificationDataType[] AssetVerifications, [in] 2:ConnectionEndpointConfigurationDataType ... ConnectionEndpointConfigurationResultDataType[] ConnectionEndpointConfigurationResults, [out] 2:ReserveCommunicationIdsResultDataType[] ReserveCommunicationIdsResults, [out] 2:CommunicationConfigurationResultDataType[] CommunicationConfigurationResults ); Table 8 - EstablishConnections Method arguments Argument Description CommandMask CommandMask provides the commands to be processed by the implementation of this
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.4.3.1 Overview

Overview A Client calling the EstablishConnections Method may provide multiple commands and the required Arguments for each command. If multiple commands are provided in a single call, the individual commands ... illustrated in Figure 20 . A Client may issue the same command in consecutive EstablishConnections Calls , e.g., to apply large configuration data in multiple Calls with SetConfigurationDataCmd . If the processing
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.4.3.2 Command VerifyAssetCmd

Command VerifyAssetCmd If CommandMask VerifyAssetCmd is set, the EstablishConnections implementation shall execute the IAssetRevisionType VerifyAsset Method for each element in the AssetVerifications array. The VerifyAsset Method shall be called ... ExpectedVerificationResult requires Match , at least one VerifyAsset Method execution returned an error, then the EstablishConnections implementation shall abort processing of additional commands as described in 6.2.4.3.11 . The possible StatusCodes related
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.4.3.3 Command VerifyFunctionalEntityCmd

Command VerifyFunctionalEntityCmd If CommandMask VerifyFunctionalEntityCmd is set, the EstablishConnections implementation shall execute the FunctionalEntityType Verify Method for each element in ConnectionEndpointConfigurations with a non-empty ExpectedVerificationVariables array. For elements with ... VerificationVariablesErrors is populated; at least one Verify Method execution returned an error; the EstablishConnections implementation shall abort the processing of subsequent commands as described in 6.2.4.3.11 . The possible StatusCodes
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.4.3.4.1 General

General If CommandMask ReserveCommunicationIdsCmd is set, the EstablishConnections implementation shall reserve communication model identifiers for each element in ReserveCommunicationIds
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.4.3.4.2 PubSub

PubSub communication model, a structure of type PubSubReserveCommunicationIds2DataType (see 10.43.4 ) shall be used. The EstablishConnections implementation shall reserve the requested number of IDs for both WriterGroups and DataSetWriters for each ... ReserveIds Method, including error definitions. If any error occurs, the EstablishConnections implementation shall abort processing as described in 6.2.4.3.11 . The EstablishConnections implementation shall return the default value for each requested
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.4.3.5 Command CreateConnectionEndpointCmd

Command CreateConnectionEndpointCmd If CommandMask CreateConnectionEndpointCmd is set, the EstablishConnections Method shall create a ConnectionEndpoint or shall verify and update a preconfigured ConnectionEndpoint for each element in ConnectionEndpointConfigurations (see 10.14 ) with ... Parameter defined in ConnectionEndpoint (see 10.16 ). The EstablishConnections implementation shall set ConnectionEndpointConfigurationResults ConnectionEndpointResult on errors as specified in Table 12 . If IsPreconfigured is set to FALSE, the EstablishConnections implementation shall
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.4.3.6 Command EstablishControlCmd

Command EstablishControlCmd If CommandMask EstablishControlCmd is set, the EstablishConnections implementation shall call the EstablishControl Method on each element in ControlGroups for each element in ConnectionEndpointConfigurations . If ControlGroups is null ... This command shall pass the ApplicationUri of the Session associated with the EstablishConnections Method Call as LockContext Argument to EstablishControl (see 6.5.3 ). The EstablishConnections implementation shall stop processing this command
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.4.3.7 Command SetConfigurationDataCmd

Command SetConfigurationDataCmd If CommandMask SetConfigurationDataCmd is set, the EstablishConnections implementation shall apply the Value to the Key for each element in ConnectionEndpointConfigurations and each element in ConfigurationData . If the ConnectionEndpoint ... ConfigurationData is empty, ConfigurationDataResult shall be set to null or empty (see 10.15 ). The EstablishConnections implementation shall stop processing this command on the first error and abort processing as described
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.4.3.8 Command ReassignControlCmd

Command ReassignControlCmd If CommandMask ReassignControlCmd is set, the EstablishConnections implementation shall call the ReassignControl Method on each element in ControlGroups for each element in ConnectionEndpointConfigurations . If ControlGroups is null ... string representation of the NodeId of the ConnectionEndpoint as LockContext Argument to ReassignControl . The EstablishConnections implementation shall stop processing this command on the first error and shall abort processing
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.4.3.9.1 General

General If CommandMask SetCommunicationConfigurationCmd is set, the EstablishConnections implementation shall apply the communication model configuration supplied in CommunicationConfigurations in an atomic operation
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.4.3.9.2 PubSub

PubSub communication model is a structure of the type PubSubCommunicationConfigurationResultDataType (see 10.11.3 ). The EstablishConnections implementation shall process the supplied PubSubConfiguration with RequireCompleteUpdate and ConfigurationReferences in an atomic operation according ... ConfigurationObjects in other corresponding fields of that structure. If an error is returned, the EstablishConnections implementation shall abort processing as described in 6.2.4.3.11 . The SetCommunicationConfigurationCmd will apply the PubSubConfiguration , including
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.4.3.10.1 General

General If CommandMask EnableCommunicationCmd is set, the EstablishConnections implementation shall enable all communication model-specific Objects related to the ConnectionEndpoints in an atomic operation
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.4.3.10.2 PubSub

PubSub The EstablishConnections implementation shall enable the DataSetReader and DataSetWriter referenced by ToDataSetReader and/or ToDataSetWriter References for each element in ConnectionEndpointConfigurations . It shall also ensure that the parent Objects ( WriterGroup ... PubSubConnection , and PublishSubscribe ) are enabled. If enabling any communication model-specific Objects fails, the EstablishConnections implementation shall abort processing as described in 6.2.4.3.11 . If enabling a ConnectionEndpoint would lead
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.4.3.11 Abort

Abort The EstablishConnections implementation shall abort processing if one of the issued commands fails; see the individual command behaviour descriptions in Clauses 6.2.4.3.2 to 6.2.4.3.10 . No further commands requested
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.5.2 CloseConnections behaviour

TRUE, the Method implementation shall remove what has been dynamically created by the EstablishConnections Method Call(s) related to the ConnectionEndpoints . This includes any configuration specific to the utilised communication
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.2.6 AutomationComponentCapabilitiesType

MaxConnectionsPerCall indicates the maximum number of Connections that can be established in a single EstablishConnections Call (see 6.2.4 ). MaxConnectionsPerCall shall be less than or equal to MaxConnections (if both exist ... CommandBundleRequired indicates whether this AutomationComponent requires a single Method Call for bundled commands when EstablishConnections is called (see 6.2.4.3.1 ). If the capability is not present or set to FALSE
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.5.2 ControlGroupType definition

another ControlGroup that references the same Variables or Methods in ListToBlock or ListToRestrict . The EstablishConnections Method supports commands to establish control ( EstablishControlCmd ) and reassign control ( ReassignControlCmd ). The CloseConnections Method will ... that may have been acquired as part of connection establishment. The functionality provided by EstablishConnections ( ReassignControlCmd ) and CloseConnections is the same as that provided by the individual Methods
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.7.2 ConnectionManagerType definition

Event . If the LogObject is supported, the ConnectionManager shall generate records for all EstablishConnections calls, CloseConnections calls, and any related calls (see 13 ), including reporting of all errors. The reporting ... EstablishCallCount diagnostics counter provides a count of the number of EstablishConnections calls issued by the ConnectionManager. This applies to local and remote calls. EstablishCallFailedCount diagnostics counter provides a count
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.7.3.2 Establishing Connections

ConnectionManager shall use the sequence of Calls illustrated in Figure 36 to the EstablishConnections Method on the involved AutomationComponents . See Figure 35 for an illustration of the configuration information contained ... Connection . For further examples, please refer to Annex E . Figure 35 - ConnectionConfigurationSet example The EstablishConnections Method (see 6.2.4 ) is used to establish ConnectionEndpoints on an AutomationComponent . The Method allows
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

6.16.3.2 PubSubCommunicationModelConfigurationType definition

ConfigurationValues Variable contains the names and identifiers that were assigned by EstablishConnections . They correspond to null names or 0 identifiers in the PubSubConfiguration . OPC UA FX allows multiple ConnectionManagers ... unique name is generated by the addressed AutomationComponent when passing the PubSubConfiguration using the EstablishConnections SetCommunicationConfigurationCmd . If it has a specific value, that value will be used. For certain elements
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

10.5 AssetVerificationDataType

required for Asset verification to be used as arguments in a Method Call (e.g., EstablishConnections ). It is semantically equivalent to the AssetVerificationType as defined in 6.15.2 . The structure is formally
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

10.6 AssetVerificationResultDataType

This structure contains the result of Asset verification returned by the Method Call (e.g., EstablishConnections ). The structure is formally defined in Table 131 . Table 131 - AssetVerificationResultDataType structure Name Type Description
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

10.14 ConnectionEndpointConfigurationDataType

ConnectionManager , see 6.7.5.3 . For a definition of how this DataType is interpreted by the EstablishConnections Method
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

10.15 ConnectionEndpointConfigurationResultDataType

ConnectionEndpointConfigurationResultDataType This structure contains the results returned from the ConnectionEndpoint configuration by the EstablishConnections Method . For a definition of how this DataType is used by the EstablishConnections Method
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

10.16 ConnectionEndpointDefinitionDataType

preconfigured ConnectionEndpoint . This element is used when calling EstablishConnections with the CreateConnectionEndpointCmd . True Node 0:NodeId The NodeId of the ConnectionEndpoint to use. This element is used when calling EstablishConnections
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

10.30 LastActivityMask

activities include resolving parameters related to a Connection , communicating with an SKS, calling the EstablishConnections Method, or any other activity related to establishing the Connection . The LastActivityMask representation
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

13.2.1 Locating Server

Server . If the Server is the same Server that the ConnectionManager resides on, the EstablishConnections Method may be invoked by vendor-specific means, and all portable node identifiers
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

13.3.4 AliasName provided

AliasName Server provides the information required to connect to the Server . Once connected, the EstablishConnections Call may be issued without any additional resolution step, assuming all nodes were defined using
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

D.3.6.2 Using preconfigured DataSets

including DSW_A (referencing the preconfigured PDS_AI4), are in this example created during EstablishConnections . For simplicity, PubSubConnection and WriterGroup are not shown. Figure D.22 - Fixed layout used by ConnectionEndpoint
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

D.3.6.3 Using preconfigured and customised DataSets

created in this example during EstablishConnections . ControllerA, connected through Conn_A, will receive all channels using the preconfigured PublishedDataSet PDS_AI4. ControllerB, connected through Conn_B, will receive Channel2
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

E.2.1 Overview

ConnectionConfigurationSet to establish all contained Connections . The configuration information required as input to call EstablishConnections on a particular AutomationComponent can be retrieved by following the References starting at each ... Figure E.6 - PubSubConfiguration illustration The ConnectionManager establishes all Connections by calling EstablishConnections on each AutomationComponent (see 6.7.5.3 ). This includes the communication model information targeted for the AutomationComponent (i.e., SecurityGroups
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

E.2.2.1 For logical connections between two AutomationComponents

AutomationComponents) The ConnectionManager executes the following steps for establishing the Connections: The ConnectionManager calls EstablishConnections on AC1 using the ReserveCommunicationIdsCmd to reserve WriterGroupIds and DataSetWriterIds for the publishing side ... publishing side of the communication configuration for AC2 to null IDs. The ConnectionManager calls EstablishConnections on AC2 using the SetCommunicationConfigurationCmd to add the updated communication configuration. AC2 assigns
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

E.2.2.2 For logical connections between multiple AutomationComponents

scenario, the ConnectionManager could set up the logical connections as follows: The ConnectionManager calls EstablishConnections on AC1, AC2, and AC3 using the ReserveCommunicationIdsCmd to reserve WriterGroupIds and DataSetWriterId ... subscribing side ( DataSetReaders ) using the IDs reserved in step (1). The ConnectionManager then calls EstablishConnections on AC1, AC2, and AC3 using the SetCommunicationConfigurationCmd to add the complete communication configuration
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

E.6.1 Overview

DataType that is a large structure. This structure is passed to the EstablishConnections Method to provide the required information to the AutomationComponent to configure PubSub communication on that AutomationComponent
OPC-10000-81 – OPC Unified Architecture - Part 81: UAFX Connecting Devices and Information Model

E.6.6 Loading / Saving ConnectionConfigurationSets

NamespaceIndex on the target Server before the structure is transmitted as part of an EstablishConnections (see 6.16.3.2 ). No issues exist in using the structure to set up a Connection
OPC-10000-82 – OPC Unified Architecture - Part 82: UAFX Networking

5.3.2 HostName resolution using DNS

already resolved as part of UA session establishment, before issuing the EstablishConnections Method . Figure 3 illustrates the use of DNS in conjunction with PubSub for controller-to-controller communications. Figure ... PubSub with DNS resolution In this case, via the EstablishConnections Method , each Controller has been given a PubSub configuration containing the other Controller's HostName . In order to send
OPC-10000-82 – OPC Unified Architecture - Part 82: UAFX Networking

5.6.4.5 Connection establishment and operation

Address as contained in the PubSubCommunicationFlowConfiguration. To this end, the ConnectionManager invokes the EstablishConnections Method on the AutomationComponents that reference the FunctionalEntities being connected, as depicted in Figure 12 label
OPC-10000-84 – OPC Unified Architecture - Part 84: UAFX Profiles

5.2.3 UAFX AutomationComponent

Connections per call. Server UAFX AutomationComponent ConnectionEstablishment Bundled This AutomationComponent requires that the EstablishConnections Method restricts the commands defined in the set of bundled commands to only be issued ... AutomationComponentType include the ConformanceName Variable . Server UAFX AutomationComponent ConnectionEstablishment VerifyAsset Supports the EstablishConnections Method VerifyAssetCmd command. Server UAFX AutomationComponent ConnectionEstablishment VerifyFunctionalEntity Supports the EstablishConnections Method VerifyFunctionalEntityCmd command. Server UAFX AutomationComponent