SirPro procedure-list selection

From m204wiki
Revision as of 20:15, 13 October 2023 by RPuszewski (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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

Note: You can also access this screen from any screen in RKTools by using a fast-path command-line command.

Controls comparable to those in this screen are available in RKWeb once you select Build > Edit and click the Open Procedure List button to display a procedure list.

Using the procedure file selection screen

You supply values in the screen fields described in the table below. 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.

In case of an error in field specification, for example an invalid Context field, the field is highlighted in red, and an error message is displayed above the function keys.

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.

REGEX Strings Regular expressions may be used as search criteria. 'REG' must be entered within the 3-character condition field (just left of the first search string) and the desired regular expression placed within the first search field.
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

These are the function keys for this screen:

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.

See also