SirPro procedure-list selection: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (→‎Using the procedure file selection screen: add proc name And/Or info from 7.5 rel notes)
m (minor formatting)
Line 9: Line 9:
Supply values in the fields shown, as described below:
Supply values in the fields shown, as described below:
<table class="thJustBold">
<table class="thJustBold">
<tr><th nowrap>Procedure Name</th>
<tr><th nowrap><b id="procname"></b>Procedure Name</th>
<td>The name of the procedure to be edited. If a single procedure name is specified, a <var class="product">Model&nbsp;204</var> edit session is immediately invoked on the procedure. If the procedure name field is left blank, or if a wild card selection is specified, a list of procedures is presented (described in [[SirPro procedure-list operations]]).
<td>The name of the procedure to be edited. If a single procedure name is specified, a <var class="product">Model&nbsp;204</var> edit session is immediately invoked on the procedure. If the procedure name field is left blank, or if a wildcard selection is specified, a list of procedures is presented (described in [[SirPro procedure-list operations]]).
<p>
<p>
To display a list of all procedures for a given file, enter a question mark (<tt>?</tt>) in this field, or leave it blank. To display a partial list of procedures, use the asterisk (<tt>*</tt>) wild card character as a substitution for any number of characters in the procedure name, for example: <code>*XYZ</code>, <code>XYZ*</code>, or <code>*XYZ*</code> finds respectively all procedure names ending in, beginning with, or including the string "XYZ". </p>
To display a list of all procedures for a given file, enter a question mark (<tt>?</tt>) in this field, or leave it blank. To display a partial list of procedures, use the asterisk (<tt>*</tt>) wildcard character as a substitution for any number of characters in the procedure name, for example: <code>*XYZ</code>, <code>XYZ*</code>, or <code>*XYZ*</code> finds respectively all procedure names ending in, beginning with, or containing the string "XYZ". </p>
<p>
<p>
In addition, as of version 7.5: </p>
In addition, as of version 7.5: </p>
<ul>
<ul>
<li>A blank indicates a logical And operation. Entering <code>PU ND</code> returns only those procedures whose names contain both the character sets "PU" and "ND", for example, <code>PUND-</code> or <code>PUMPKIN.SPENDER</code>. </li>
<li>A blank indicates a logical And operation.  
<p>
Entering <code>PU ND</code> returns only those procedures whose names contain both the character sets "PU" and "ND", for example, <code>PUND-</code> or <code>PUMPKIN.SPENDER</code>. </p></li>
                                                          
                                                          
<li>A vertical bar (<tt>|</tt>) indicates a logical Or operation. <code>PU|ND</code> finds procedure names containing the strings "PU" or "ND", for example, <code>PUMP</code>, <code>COLORPURPLE</code>, and <code>NINTENDO</code>. </li>
<li>A vertical bar (<tt>|</tt>) indicates a logical Or operation. <p>
<code>PU|ND</code> finds procedure names containing the strings "PU" or "ND", for example, <code>PUMP</code>, <code>COLORPURPLE</code>, and <code>NINTENDO</code>. </p></li>
                                                          
                                                          
<li>Wildcards can be used in conjunction with the And and Or    
<li>Wildcards can be used with the And and Or specifications.  
specifications. <code>PUPR*|SCPR*|MOPR*</code> finds all       
<p>
procedures starting with any of these strings. </li>
<code>PUPR*|SCPR*|MOPR*</code> finds all       
procedures starting with any of these strings. </p></li>
</ul>
</ul>


Line 49: Line 53:


<tr><th>Last Updater ID</th>
<tr><th>Last Updater ID</th>
<td>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 (<tt>*</tt>) wild card character is also supported in this field.</td></tr>
<td>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 (<tt>*</tt>) wildcard character is also supported in this field.</td></tr>


<tr><th>Search Strings</th>
<tr><th>Search Strings</th>
<td>As many as five optional search strings may be entered in these fields. Each field accommodates as many as 66 characters as of version 7.5. The first field is preceded by three underscores, which are only for the string <code>not</code>, 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. Each field accommodates as many as 66 characters as of version 7.5. The first field is preceded by three underscores, which are only for the string <code>not</code>, 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 F12 key when prompted by the warning message. </p>
The procedures that match the other selection criteria (file, procedure wildcard, 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 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>
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>

Revision as of 17:43, 28 April 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. 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 wildcard selection is specified, a list of procedures is presented (described in SirPro procedure-list operations).

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 (*) wildcard character as a substitution for any number of characters in the procedure name, for example: *XYZ, XYZ*, or *XYZ* finds respectively all procedure names ending in, beginning with, or containing the string "XYZ".

In addition, as of version 7.5:

  • A blank indicates a logical And operation.

    Entering PU ND returns only those procedures whose names contain both the character sets "PU" and "ND", for example, PUND- or PUMPKIN.SPENDER.

  • A vertical bar (|) indicates a logical Or operation.

    PU|ND finds procedure names containing the strings "PU" or "ND", for example, PUMP, COLORPURPLE, and NINTENDO.

  • Wildcards can be used with the And and Or specifications.

    PUPR*|SCPR*|MOPR* finds all procedures starting with any of these strings.

Note: You must use caution when combining And and Or selections, because the routine currently has a bias in favor of Or selections. Specifying PUPR*|SCPR AND for example, does not work. It returns all procedures beginning with "PUPR", then attempts to add to the list any procedure with the characters "SCPR AND", which finds nothing because of the embedded space.

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 (*) wildcard character is also supported in this field.
Search Strings As many as five optional search strings may be entered in these fields. Each field accommodates as many as 66 characters as of version 7.5. 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 wildcard, 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 display The number (from 0 to 999) of occurrences of the search string within a procedure to display with the procedure.
Hide SEQs/BASEs SEQ. and BASE. procedures are used in SirLib code management functions and 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.

If F1 is pressed when the cursor is located on a field, the invoked Help is positioned at the Help text for that field. Otherwise, it is positioned at the start of the Help for the screen.

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