HP 3000 Manuals HP 3000 Manuals
Using Symbolic Access Symbolic access references data through the use of symbolic names declared at the source code level, rather than through addresses and offsets to specific memory locations. This facility allows users to access stored information in a more natural way, leaving the drudgery of translating symbolic names to storage locations up to System Debug. The chart below summarizes the symbolic functions currently available. These functions allow programmatic access to the information provided by the FT and FV commands. Each function takes a path specification as one of its parameters. The form of this parameter is the same as that used by the FT and FV commands presented on the previous pages. Each of these functions are presented in detail (including examples) in chapter 8. ------------------------------------------------------------------------------------------ | | | SYMVAL ( address, pathspec ) returns the value of the data structure specified | | by pathspec. | | | | | | SYMLEN ( pathspec, [units] ) returns the length of a data structure in bits or | | bytes. | | | | | | SYMADDR ( pathspec, [units] ) returns the bit or byte offset of an element | | specified by pathspec, relative to the start of the | | path. | | | | | | SYMINSET ( address, pathspec, returns a boolean value of TRUE if the set member | | element ) element is in the set specified by address and | | pathspec. | | | | | | SYMTYPE ( pathspec ) Returns the type of a component described by | | pathspec. | | | | | | SYMCONST ( pathspec ) returns the value of the constant specified by | | pathspec. | | | | | | Parameters: | | | | address the address of the actual data. (Required) | | | | pathspec a path specification. (Required) | | | | units specifies whether the return value for SYMLEN and | | SYMADDR is in bits or bytes. (Optional) | | | | element a set element. (Required) | | | ------------------------------------------------------------------------------------------