This session provides methods for searching among Instruction objects. The search query is constructed using the InstructionQuery.

getInstructionsByQuery() is the basic search method and returns a list of Instructions. A more advanced search may be performed with getInstructionsBySearch(). It accepts an InstructionSearch in addition to the query for the purpose of specifying additional options affecting the entire search, such as ordering. getInstructionsBySearch() returns an InstructionSearchResults that can be used to access the resulting InstructionList or be used to perform a search within the result set through InstructionSearch.

This session defines views that offer differing behaviors for searching.

• federated engine view: searches include instructions in engines of which this engine is an ancestor in the engine hierarchy
• isolated engine view: searches are restricted to instructions in this engine

Instructions may have a query record indicated by their respective record types. The query record is accessed via the InstructionQuery.