READ

READ is a CAOS command for Catalogue access.

Usage
Syntax: READ tagname (string) offset (int)

Returns, as a string, the relevant field of the tagname tag in the catalogue. The first field has offset 0. tagname is case-sensitive.

Before querying with READ you should check the tag exists with REAQ tagname, and ensure that offset is in the range from 0 to (REAN tagname)-1. Otherwise the command fails with a Catalogue error.

If you are querying Agent Help it is preferable for most cases to use WILD instead of READ. This will provide fallback in case of undocumented agents.