Download LK12340 CLM Platform Implementation Manual

Transcript
8.4.1
CLM$GET_FIELD
Purpose
CL Interface to Non-Honeywell Device,
CALL CLM$GET_FIELD ( RETSTS
DA—STATUS
CHAR_POINTER
BUFFER_NUM
VALUE_REF
FORMAT
STRING_WIDTH
:
:
:
:
:
:
:
Continued
OUT NUMBER;
OUT NUMBER;
IN OUT NUMBER;
IN OUT NUMBER;
IN REFERENCE_N;
IN STRING;
IN NUMBER)
This function extracts an external value from a field in the buffer, optionally
converts it to internal form and then stores it into VALUE_REF (output value).
Characters must point to the beginning of the field. Anticipated field delimiters
are: Space, Comma, Left parenthesis, Right parenthesis, Colon, Semicolon, and
Carriage Return. The char_pointer is incremented to the next available position.
Parameters
Parameter
RETSTS
DA_STATUS
CHAR_POINTER
BUFFER_NUM
VALUE_REF
FORMAT
STRING_WIDTH
Explanation
The return status of the put field function
Data access error status
Character offset from the beginning of buffer
Buffer ID number
Output value to be converted (This value cannot be a
self-defining enumeration.
The specified format of the field:
byte
“B”
1 byte
integer
“I”
2 byte
IEEE
“E”
4 byte
number
“R-ZZZZ9.99”
logical
“TEXTL1:5”
string
“TEXTL1:10”
time
“DATEMM-DD-YYENDATE”
enumeration
“TEXTL1:10”
entity (point ID)
“TEXTL1:10”
Number of characters in string, if format is of
type string.
Continued on next page
03/2013
CLM Platform Implementation Manual
305