Type Code S

Previous  Top  Next

Description

This will call a File Search routine that has been defined using the OSMOSi File Search Definition routine. The Search routine must be stored in the file "_SEARCH, fff" where fff is the file name stored in attribute 5 and the search id is the same as the search id of the process record stored in "_PROCS".

Syntax

The format of the "_PROCS" record is:

Attribute Description 1 "S" 2 Description of the process 3 Internal use 4 Internal use 5 Multi-value position 1 = Dictionary file name for the Query to use Multi-value position 2 = Data file name (if different to the dictionary name) 6 Selection Criteria for the records in the file in 5 above 7 Sort fields 8 Items to be displayed in the search list to choose from 9 Search Options - see below 10 Multi-value position 2 is a subroutine name to perform the select 14 Release Information (release, date created and date last amended) 19 System Id (optional)

After the selection is made, if one item is detected the key to that item will become the returned VALUE (unless option F is used, when it will

also be shown as a single line in a selection window).

The Options available are:

Opt Description Specs A Returns selected keys separated with Attribute Marks (CHAR (254)) * C Returns selected keys separated with commas * D Use DATA MVC statement with each key found, for automatic processing F Forces the selection window to show even if one selected key found ** J Returns selected keys without separators (as one string) * M Allows selection of more than one item from the list ** N Suppresses the redisplay of the calling screen P Returns "1" in the COMMON variable Rtnflg and show error "NO ITEMS PRESENT" if no items found in the list Q Returns all display fields wrapped in quotes and separated by a space R Returns all display fields, each in "presentation" format * S Returns the selected list of id's in the COMMON variable Ukeys U Use the subroutine to perform the select V Returns selected keys separated with Value Marks (CHAR (253)) * W Returns the first word in the selection line * X Forces BY-EXP to prefix all multi-value sort fields

Remarks

All items marked * will return data in the COMMON variable VALUE.

All items marked ** will return the selected record's id in the COMMON variable VALUE.