Emerson ROC EIE – UIS Command Component Parameters

Devices > Remote Devices > Emerson ROC EIE > UIS Command Component Parameters

UIS Command Component Parameters

The following tables list and describe the parameters specific to the UIS command component types for this remote device:

CLRHSTXA
CONFIG
CYUPDTPT
CYWAITPT
DG_F_DEV
DG_T_DEV
GETTIME
SETTIME
STATUS

For more general information about UIS command component parameters, see UIS Command Components. The DG_F_DEV (Get data group from device) and DG_T_DEV (Send data group to device) command component types are configured in the template file. The other command component types are considered ‘special’ and are defined in the EIE editor code. See Special UIS Command Component Types for more information.

CLRHSTXA

Clear All History Tx Info clears all historical data group caches. CLRHSTXA has no command parameters.

Note: If you clear all caches using a UIS command, the cache values in each transaction of historical data groups are not reset; past transactions continue to display actual values. This is done for performance reasons so that each DDS transaction does not have to be updated. The driver ignores these cached values after the command has been issued.

CONFIG

Get RTU Configuration retrieves configuration information from the field device. CONFIG has no parameters.

CYUPDTPT

Update CygNet Point updates the record for a CygNet point. CYUPDTPT has the following command parameters:

Parameter	Required	Description
FOnErr	No	Fail cmd on update error indicates to abort the UIS command if any update errors are encountered. The errors that might come up include: if the point specified in the Fac, Serv, Site, or UDC parameters does not exist, or if the point exists in a different UIS and any messaging errors or communication failure to that service comes up.
Fac	Yes	Facility for pt identifies the facility of the point to update.
Serv	No	Service for pt identifies the SERVICE of the point to update.
Site	No	Site for pt identifies the SITE of the point to update.
UDC	Yes	UDC for pt identifies the UDC of the point to update.
UType	No	Update type indicates the type of update. Value options are 0 - 3, where 0=Completion, 1=Success, 2=Failure, 3=Creation.
UsrMsk	No	User bit mask specifies the user bit mask of the point to update.
UsrVal	No	User bit value to match specifies the user bit value to match when updating the point record.
Value	No	Value indicates the point value to update.

CYWAITPT

Wait for CygNet Point signals the UIS to wait to perform a command until the value of the specified CygNet point changes to a specified value.

CYWAITPT must be the first command component added to a UIS command. You cannot add other instances of CYWAITPT to a UIS command.

CYWAITPT has the following command parameters:

Parameter	Required	Description
Dur	Yes	Duration is the amount of time (in HH:MM:SS or HH:MM or HH) for the UIS command to wait for the point value to change before timing out.
FOnErr	No	Fail on point error indicates to abort the UIS command if any error conditions are encountered. The point errors that might come up include: if the point specified in the Fac, Serv, Site, or UDC parameters does not exist, or if the point exists in a different UIS and any messaging errors or communication failure to that service comes up.
Fac	Yes	Facility for pt identifies the facility of the point on which to wait for the point value to change before performing the UIS command.
Int	Yes	Interval indicates the frequency (in HH:MM:SS or HH:MM or HH) with which the UIS will check the point’s value to see if it has changed.
Serv	No	Service for pt identifies the SERVICE of the point on which to wait for the point value to change before performing the UIS command.
Site	No	Site for pt identifies the SITE of the point on which to wait for the point value to change before performing the UIS command.
UDC	Yes	UDC for pt identifies the UDC of the point on which to wait for the point value to change before performing the UIS command.
UsrMsk	No	User bit mask specifies the user bit mask on which to wait for the status bit change before issuing the UIS command. Note: The user status bit parameters (UsrMsk and UsrVal) only apply to the extended status field of the point record, so they will not match anything in the base status.
UsrVal	No	User bit value to match specifies the user bit value to match before issuing the UIS command.
Value	No	Value to match specifies the value on which to wait for the point to change to before issuing the UIS command. Note: You can set parameters for both the point user status AND point value. So you can match either one by itself, or you can specify that both must match your parameter values.

DG_F_DEV

Get data group from device retrieves a data group from a field device. The Parent XML Element is uccRecvParms. The following parameters are available for each specified data group type.

Data Group Type	Parameter	Required	Description
AlarmsLog	EDate	No	Ending Contract Date defines the ending contract time and date for a date-range request. Value options are strings in formats described in Selecting Date and Time.
AlarmsLog	SDate	No	Starting Contract Date defines the starting contract time and date for a date-range request. Value options are strings in formats described in Selecting Date and Time.
ArchDay	Date	Yes	History Date defines the date and time of a daily (24-hour) archive request. Value options are strings in formats described in Selecting Date and Time.
AuditLog	ClearLog		Clear Audit Log defines whether or not to clear events after retrieving them. Clearing an event causes it to be marked as cleared in the device, but does not delete the event. Value options are Boolean. Note: This parameter is not available for 107IC devices.
	EDate		Ending Contract Date defines the ending contract time and date for a date-range request. Value options are strings in formats described in Selecting Date and Time.
	GetUC		Get Uncleared Audit Records defines whether or not to retrieve all audit records not previously cleared. Value options are Boolean. Note: This parameter is not available for 107IC devices.
	SDate		Starting Contract Date defines the starting contract time and date for a date-range request. Value options are strings in formats described in Selecting Date and Time.
ConOpCode	Cnt	Yes	Number of Locations defines the number of table entries to include in the "Configurable Opcode Data" data group. Value options are integers from 1 to 44.
ConOpCode	Val1	Yes	Starting Location defines which table entry to begin with when generating table entries for the "Configurable Opcode Data" data group. Value options are integers from 1 to 44.
EventsLog	EDate	No	Ending Contract Date defines the ending contract time and date for a date-range request. Value options are strings in formats described in Selecting Date and Time.
EventsLog	SDate	No	Starting Contract Date defines the starting contract time and date for a date-range request. Value options are strings in formats described in Selecting Date and Time.
ExHst	EDate	Yes	Ending Date and Time defines the ending date and time of a date-range request for extended history. Value options are strings in formats described in Selecting Date and Time.
	GetLatest	No	Get Latest? defines whether or not to retrieve history from the latest successfully read history record (the cache). Value options are Boolean. For more information, see History Retrieval Optimization.
	SDate	Yes	Starting Date and Time defines the starting date and time of a date-range request for extended history. Value options are strings in formats described in Selecting Date and Time.
FmsAlarm	EDate	Yes	End Device Date/Time defines the ending device date and time of a date-range request. Value options are strings in formats described in Selecting Date and Time.
FmsAlarm	SDate	Yes	Start Device Date/Time defines the starting device date and time of a date-range request. Value options are strings in formats described in Selecting Date and Time.
FmsEvent	ClearLog	No	Clear Audit Log defines whether or not to clear events after retrieving them. Clearing an event causes it to be marked as cleared in the device, but does not delete the event. Value options are Boolean. Note: This parameter is only available for 300IC and 400IC devices.
	EDate	Yes	End Device Date/Time defines the ending device date and time of a date-range request. Value options are strings in formats described in Selecting Date and Time.
	GetUC	No	Get Uncleared Audit Records defines whether or not to retrieve all audit records not previously cleared. Value options are Boolean. Note: This parameter is only available for 300IC and 400IC devices.
	SDate	Yes	Start Device Date/Time defines the starting device date and time of a date-range request. Value options are strings in formats described in Selecting Date and Time.
FmsHistDGm	EDate	Yes	End Device Date/Time defines the ending device date and time of a date-range request. Value options are strings in formats described in Selecting Date and Time. Note: This parameter is only available for 107 and 107IC devices.
FmsHistDGm	SDate	Yes	Start Device Date/Time defines the starting device date and time of a date-range request. Value options are strings in formats described in Selecting Date and Time. Note: This parameter is only available for 107 and 107IC devices.
FmsHistDGq	EDate	Yes	End Device Date/Time defines the ending device date and time of a date-range request. Value options are strings in formats described in Selecting Date and Time. Note: This parameter is only available for 107 and 107IC devices.
FmsHistDGq	SDate	Yes	Start Device Date/Time defines the starting device date and time of a date-range request. Value options are strings in formats described in Selecting Date and Time. Note: This parameter is only available for 107 and 107IC devices.
FmsHistHGm	EDate	Yes	End Device Date/Time defines the ending device date and time of a date-range request. Value options are strings in formats described in Selecting Date and Time. A maximum of 16 characters may be used.
FmsHistHGm	SDate	Yes	Start Device Date/Time defines the starting device date and time of a date-range request. Value options are strings in formats described in Selecting Date and Time. A maximum of 16 characters may be used.
FmsHistHGq	EDate	Yes	End Device Date/Time defines the ending device date and time of a date-range request. Value options are strings in formats described in Selecting Date and Time. Value options are strings in formats described in Selecting Date and Time.
FmsHistHGq	SDate	Yes	Start Device Date/Time defines the starting device date and time of a date-range request. Value options are strings in formats described in Selecting Date and Time. Value options are strings in formats described in Selecting Date and Time.
HistMultiD	EDate	Yes	Ending Date defines the ending date and time of a date-range request for row-based daily history for multiple points. Value options are strings in formats described in Selecting Date and Time.
	GetLatest	No	Get Latest? defines whether or not to retrieve history from the latest successfully read history record (the cache). Value options are Boolean. For more information, see History Retrieval Optimization.
	NumHistPt	Yes	Number of Hist Pts defines the number of history points to be retrieved. Value options are integers from 1 to 100, which is the maximum number of history points in the segment. The combination of Starting Hist Pt and Number of Hist Pts should not exceed 100.
	SDate	Yes	Starting Date defines the starting date and time of a date-range request for row-based daily history for multiple points. Value options are strings in formats described in Selecting Date and Time.
	StHistPt	Yes	Starting Hist Pt defines the beginning of the range of history points to be retrieved. Value options are integers from 1 to 100, which is the maximum number of history points in the segment.
HistMultiE	EDate	Yes	Ending Date defines the ending date and time of a date-range request for row-based extended history for multiple points. Value options are strings in formats described in Selecting Date and Time.
	GetLatest	No	Get Latest? defines whether or not to retrieve history from the latest successfully read history record (the cache). Value options are Boolean. For more information, see History Retrieval Optimization.
	NumHistPt	Yes	Number of Hist Pts defines the number of extended history points to be retrieved. Value options are integers from 1 to 50, which is the maximum number of extended history points. The combination of Starting Hist Pt and Number of Hist Pts should not exceed 50.
	SDate	Yes	Starting Date defines the starting date and time of a date-range request for row-based extended history for multiple points. Value options are strings in formats described in Selecting Date and Time.
	StHistPt	Yes	Starting Hist Pt defines the beginning of the range of extended history points to be retrieved. Value options are integers from 1 to 50, which is the maximum number of extended history points.
HistMultiP	EDate	Yes	Ending Date defines the ending date and time of a date-range request for row-based periodic history for multiple points. Value options are strings in formats described in Selecting Date and Time.
	GetLatest	No	Get Latest? defines whether or not to retrieve history from the latest successfully read history record (the cache). Value options are Boolean. For more information, see History Retrieval Optimization.
	NumHistPt	Yes	Number of Hist Pts defines the number of history points to be retrieved. Value options are integers from 1 to 100, which is the maximum number of history points in the segment. The combination of Starting Hist Pt and Number of Hist Pts should not exceed 100.
	SDate	Yes	Starting Date defines the starting date and time of a date-range request for row-based periodic history for multiple points. Value options are strings in formats described in Selecting Date and Time.
	StHistPt	Yes	Starting Hist Pt defines the beginning of the range of history points to be retrieved. Value options are integers from 1 to 100, which is the maximum number of history points in the segment.
PerHst	EDate	Yes	Ending Date defines the ending date and time of a date-range request for periodic history. Value options are strings in formats described in Selecting Date and Time.
	GetLatest	No	Get Latest? defines whether or not to retrieve history from the latest successfully read history record (the cache). Value options are Boolean. For more information, see History Retrieval Optimization.
	SDate	Yes	Starting Date defines the starting date and time of a date-range request for periodic history. Value options are strings in formats described in Selecting Date and Time.
SingleTlp	DataType	Yes	Data Type defines the type of data stored at the specified register number. Value options appear in the Data Type drop-down menu in the Single Register data group dialog box.
	FacUdc	No	Facility.UDC for Point Processing provides a means to specify a UDC to which to map the specified data point; it requires a corresponding point in the Point Service (PNT). Value options are strings that specify a Facility.UDC combination.
	TLP	Yes	T,L,P (one-based) defines the Point Type, Logical, Parameter combination to be retrieved from the device. Value options are integers, separated by commas, in the form T,L,P. The Point Type (T) portion of the value can be any valid point type on the device. The Logical (L) portion of the value is one-based and can be any valid logical for the specified point type. The Parameter (P) portion of the value can be any valid parameter of the specified point type.
	TLPDesc	No	TLP Description provides for a user-defined description of the TLP in the event that the user does not want to use the default description. Value options are alphanumeric characters.
SoftPoints	Cnt	No	Number of Data Items defines the total number of data items retrieved for a soft point request. Total number does not include soft point tag or integer flag. Value options are integers 1 - 20.
SoftPoints	Item	No	Starting Data Item # defines the soft point data item number from which to begin retrieving soft points. This does not include soft point tag or integer flag. Value options are integers 1 - 20.

DG_T_DEV

Send data group to device sends a data group to a field device. The parent XML Element is uccSendParms. The following parameters are available for each specified data group type.

Data Group Type	Parameter	Required	Description
AO	Val1	Yes	Output Value in EUs enables you to set the analog output engineering unit value. Value options are floating-point numbers.
CmdWrCfgM	WrtCfgMem	Yes	Write to config memory flag indicates whether to write to config memory.
ConOpCode	Item	Yes	Table Item # defines which table entry a value is sent to in a "Configurable Opcode Data" data group. Value options are integers 1 - 44.
ConOpCode	Value	No	Value defines a value to be sent to a "Configurable Opcode Data" data group. Value options are determined by the table entry type and may be integer, string, or others.
DO	Val1	No	Status defines the actual value that is written to the digital output. Value options are Boolean. The value determines whether the device sets the output line high or low.
DO	Val2	No	TDO EU Value enables you to set the timed discrete output engineering unit value. Value options are floating-point numbers.
Login	AccLevel	No	Access Level defines the security access level assigned to the corresponding operator ID. Value options are char values 0 - 5.
	OpID	Yes	Operator ID defines the identifier of an operator. Value option is a user-defined string.
	Password	No	Password defines the password assigned to the corresponding operator ID. Value options are integers from 0 - 9999.
SingleTlp	DataLen	No	String Length specifies the string length of data stored at the specified register number.
	DataType	Yes	Data Type defines the type of data stored at the specified register number. Value options appear in the Data Type drop-down menu in the Single Register data group dialog box.
	FacUdc	No	Facility.UDC for Point Processing provides a means to specify a UDC to which to map the specified data point; it requires a corresponding point in the Point Service (PNT). Value options are strings that specify a Facility.UDC combination.
	TLP	Yes	T,L,P (one-based) defines the Point Type, Logical, Parameter combination to be retrieved from the device. Value options are integers, separated by commas, in the form T,L,P. The Point Type (T) portion of the value can be any valid point type on the device. The Logical (L) portion of the value is one-based and can be any valid logical for the specified point type. The Parameter (P) portion of the value can be any valid parameter of the specified point type.
	TLPDesc	No	TLP Description provides for a user-defined description of the TLP in the event that the user does not want to use the default description. Value options are alphanumeric characters.
	Value	Yes	Value defines the value of the TLP.
SoftPoints	Item	Yes	Data Item # defines the number of the soft point data item to be sent to the field device. Value options are integers 1 - 20.
SoftPoints	Value	Yes	Value defines the value for the corresponding soft point data item to be sent to the field device. Value options are floats.
SysVars	ContHr	Yes	Contract Hour defines the contract hour to be sent to a field device for system variables. Value options are integers 0 - 23.

GETTIME

Get RTU Time retrieves time from the field device. GETTIME has no command parameters.

SETTIME

Set RTU Time sets time for the field device. SETTIME has no command parameters.

STATUS

Get Current Status retrieves current status from the field device. STATUS has no command parameters.

Note: The Get Current Status UIS command is not available for Emerson FBx devices.