SetPosition Method is used to set a target position.

Signature

SetPosition (

[in] 0:Float Position,

[in] SEMEnum SEM

[in] 0:BooleanShutdownRequest);

Table 64 – SetPosition Method Arguments

Argument

Description

Position

Target position as percent of open. The CIMV will automatically maintain this position

SEM

The selection of which SEM to send the command to

ShutdownRequest

Boolean indicates that this command is part of a shutdown sequence.

Method result codes are defined as part of the Call Service (see OPC 10000-4). They are described in Table 124 for ease of reference.

Comments

The SetPosition Method commands the CIMV to move to and automatically maintain the position. Parameters include the requested position, overriding of any interlocks and the SEM selection to use for the command. The Position Method argument is of datatype float and represents percent of open. The Position Method argument value shall be between 0 and 100. The server shall return Bad_OutOfRange if the Position Method argument value is outside of this range. The Method will complete when the command has been accepted. After receiving the new commanded position, the CIMV will store the value of the input param Position in the TargetPosition and will automatically maintain the position. Refer to Position and TargetPosition component of MDISCIMVObjectType discussed in 6.9.3. The CIMV must be in operation mode Position_1 (refer to 8.1.8) otherwise the Method shall return Bad_InvalidState. The operation may or may not have completed when the Method returns. The Method will return an error if the operation cannot be started.

If a Server does not support the selection of SEM, the SEM parameter is ignored.

ShutdownRequest is a Boolean that indicates that this command is part of a shutdown sequence. It should be noted that the responsibility for the shutdown is on the DCS and operator side. All nondefeatable interlocks of the subsea system will be overridden which can cause damage to the subsea system.

Table 65 specifies the AddressSpace representation for the SetPosition Method.

Table 65 – SetPosition Method AddressSpace Definition

Attribute

Value

BrowseName

SetPosition

References

Node Class

BrowseName

DataType

TypeDefinition

Other

0:HasProperty

Variable

0:InputArguments

0:Argument[]

0:PropertyType

M

ConformanceUnits

MDIS CIMV Base