Cicode Programming Reference > Cicode Function Categories > Alarm Functions Introduction > AlmSummaryGetField

AlmSummaryGetField

The AlmSummaryGetField function retrieves the value of the specified field from the record the data browse cursor is currently referencing.

This function is a non-blocking function. It does not block the calling Cicode task.

Syntax

AlmSummaryGetField(iSession, sFieldName)

iSession:

The handle to a browse session previously returned by a AlmSummaryOpen call.

sFieldName:

The name of the field that references the value to be returned. Supported fields are:

ACQERROR, CUSTOM1, CUSTOM2, CUSTOM3, CUSTOM4, CUSTOM5, CUSTOM6, CUSTOM7, CUSTOM8, DATEEXT, ERRDESC, ERRPAGE, FORMAT, GROUP, LOCALTIMEDATE, LOGSTATE, NATIVE_DESC, NATIVE_NAME, NODE, OFFTIMEDATE, ONTIMEDATE, ORATODATE, ORATOOFFDATE, ORATOONDATE, PRIV, SUMTYPE, TAGEX, TIMEDATE, TYPE, TYPENUM.

See Browse Function Field Reference for information about fields.

Return Value

The value of the specified field as a string. An empty string may or may not be an indication that an error has been detected. The last error should be checked in this instance to determine if an error has actually occurred.

Related Functions

AlmSummaryAck, AlmSummaryClear, AlmSummaryClose, AlmSummaryCommit, AlmSummaryDelete, AlmSummaryDeleteAll, AlmSummaryDisable, AlmSummaryEnable, AlmSummaryFirst, AlmSummaryLast, AlmSummaryNext, AlmSummaryOpen, AlmSummaryPrev, AlmSummarySetFieldValue

Example

STRING fieldValue = "";
STRING fieldName = "TYPE";
INT errorCode = 0;
...
fieldValue = AlmSummaryGetField(iSession, sFieldName);
IF fieldValue <> "" THEN
// Successful case
ELSE
// Function returned an error
END
...

See Also

Alarm Functions