SirPro procedure-list selection: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (add info about search strings)
m (update searching info)
Line 3: Line 3:
procedure file and criteria for specifying the procedure(s) to be displayed.
procedure file and criteria for specifying the procedure(s) to be displayed.


<p class="caption" style="width:500px">Procedure file selection screen</p>
<p class="caption" style="width:516px">Procedure file selection screen</p>
<p class="figure">[[File:SProProcSelectS.png|500px]]</p>
<p class="figure">[[File:SProProcSelectS.png|516px]]</p>


==Using the procedure file selection screen==
==Using the procedure file selection screen==
Line 37: Line 37:
<td>As many as five optional search strings may be entered in these fields. The first four of these fields accommodate as many as 32 characters; the fifth accommodates 65. The first field is preceded by three underscores, which are only for the string "not," which retrieves procedures that do not match any of the subsequent search criteria.
<td>As many as five optional search strings may be entered in these fields. The first four of these fields accommodate as many as 32 characters; the fifth accommodates 65. The first field is preceded by three underscores, which are only for the string "not," which retrieves procedures that do not match any of the subsequent search criteria.
<p>
<p>
The procedures that match the other selection criteria (file, procedure wild card, and account) are scanned, and only those that contain any of the requested string(s) appear on the resulting list of procedure names. If there are more than 100 procedures to be scanned, you are warned about the possibility of a long search. To override this warning, press the PF12 key when prompted by the warning message. </p>
The procedures that match the other selection criteria (file, procedure wild card, and account) are scanned, and only those that contain any of the requested string(s) appear on the resulting list of procedure names. If there are more than 100 procedures to be scanned, you are warned about the possibility of a long search. To override this warning, press the F12 key when prompted by the warning message. </p>
<p>
<p>
The string search is done in mixed case if you are currently in <code>*LOWER</code> mode, and it is done in uppercase if you are currently in <code>*UPPER</code> mode. Case mode can be determined by the setting of the "Switch" PF key at the bottom of the screen. (If you are  in <code>*LOWER</code> mode, <b>Switch to *UPPER</b> is shown as the PF key prompt).</p>  
The string search returns only instances that match the case of the indicated search string if the F5 function key label is "Case Sensitive search: On." Otherwise, the search returns all instances of the string without regard for case. </p>
<p>  
<p>  
The <b>Search Strings</b> fields <b><i>do not</i></b> strip blanks before searching. <var class="product">SirPro</var> distinguishes three different searches in the following:</p>  
The <b>Search Strings</b> fields <b><i>do not</i></b> strip blanks before searching. <var class="product">SirPro</var> distinguishes three different searches in the following:</p>  
Line 77: Line 77:


<tr><th>F5</th>
<tr><th>F5</th>
<td>Toggles case-sensitivity of search. In Case-Sensitive mode, a search for "html" finds only the lowercase version of that string. In Case-Insensitive mode, the same search finds procedures containing either  
<td>Toggles case-sensitivity of search. If Case-Sensitive mode is "On," a search for "html" finds only the lowercase version of that string. If Case-Sensitive mode is "Off,", the same search finds procedures containing either "html" or "HTML." </td></tr>
"html" or "HTML". </td></tr>


<tr><th>F6</th>
<tr><th>F6</th>
Line 84: Line 83:


<tr><th>F11</th>
<tr><th>F11</th>
<td>Toggles between <code>*LOWER</code> (mixed case edit) and <code>*UPPER</code> case mode.</td></tr>
<td>Toggles between <code>*LOWER</code> (mixed-case editing) and <code>*UPPER</code> case mode.</td></tr>
</table>
</table>
<p>
<p>

Revision as of 22:57, 26 January 2016

Procedure-level commands are accessed through Option 1 on the SirPro main menu. SirPro displays a screen that allows selection of a procedure file and criteria for specifying the procedure(s) to be displayed.

Procedure file selection screen

Using the procedure file selection screen

Supply values in the fields shown, as described below:

Procedure Name The name of the procedure to be edited. To display a list of all procedures for a given file, enter a question mark (?) in this field, or leave it blank. To display a partial list of procedures, use the asterisk (*) wild card character, for example: *XYZ, XYZ*, or *XYZ*.

If a single procedure name is specified, a Model 204 edit session is immediately invoked on the procedure. If the procedure name field is left blank, or if a wild card selection was entered, a list of procedures is presented (described in SirPro procedure-list operations).

File/Group Name The name of a procedure file or file group. If a file, the file must be allocated to the Online Model 204 region.

To display a list of all available files, enter a question mark (?), or leave this field blank. When you press the Enter key, RKTools shows a list of all available files. You select a file from this list by typing S in the selection column to the left of the desired file. The Password field, below, lets you open a file from this screen.

If your site's METADATA is not populated, this screen is not displayed.

Context Valid input values are File, GROUP, TEMP GROUP, PERM GROUP, and blank. SirPro attempts to open only in the specified context.

If you input a blank, SirPro searches for an entity (using the value specified in File/Group Name) in the default Model 204 search order, that is, it looks for a temporary group, then a permanent group, and then a file.

Password The password for the file or group, if needed.
Last Updater ID Optional entry that will narrow the set of procedures from a selected file to only those that were last updated by the specified account (user ID). The asterisk (*) wild card character is also supported in this field.
Search Strings As many as five optional search strings may be entered in these fields. The first four of these fields accommodate as many as 32 characters; the fifth accommodates 65. The first field is preceded by three underscores, which are only for the string "not," which retrieves procedures that do not match any of the subsequent search criteria.

The procedures that match the other selection criteria (file, procedure wild card, and account) are scanned, and only those that contain any of the requested string(s) appear on the resulting list of procedure names. If there are more than 100 procedures to be scanned, you are warned about the possibility of a long search. To override this warning, press the F12 key when prompted by the warning message.

The string search returns only instances that match the case of the indicated search string if the F5 function key label is "Case Sensitive search: On." Otherwise, the search returns all instances of the string without regard for case.

The Search Strings fields do not strip blanks before searching. SirPro distinguishes three different searches in the following:

'%X=$GETG('SNOPES')' '%X = $GETG('SNOPES')' '%X=$GETG('SNOPES') '

Judicious use of the Delete key should prevent confusion when trailing blanks might be present.

Display
# of context lines The number (0 through 9) of lines of code to display before and after the line containing the search string.
# of occurrences to find The number (from 0 to 999) of occurrences within a procedure that will be displayed.
Hide SEQs/BASEs SEQ. and BASE. procedures are used in code management functions but are not intended to be edited directly. Entering Y prevents their display, while N displays them.
Ignore Comment lines Enter Y to ignore any SOUL-formatted comment lines. Enter N to display all found lines.

Function keys for this panel are:

F1 Invokes Help.
F3 Quits the SirPro main menu.
F5 Toggles case-sensitivity of search. If Case-Sensitive mode is "On," a search for "html" finds only the lowercase version of that string. If Case-Sensitive mode is "Off,", the same search finds procedures containing either "html" or "HTML."
F6 Invokes an empty procedure skeleton for you to populate.
F11 Toggles between *LOWER (mixed-case editing) and *UPPER case mode.

When you press the Enter key, SirPro invokes an Edit session on the selected procedure, or it passes you to a list of procedures for further selection.

The command line at the top of the screen allows fastpath transfer to other RKTools options, and it allows CLOSE xxxx commands to close the specified file or group.

See also