Release notes for SirPro V7.5

This document lists the changes that have been made for SirPro version S7.5. It requires Model 204 release 7.5 or higher.

Procedure Search screen (SEARCH)

Field changes

The searching capabilities have been enhanced to provide better impact analysis. The following fields has been changed or added.

Procedure name

Enter a procedure name or search mask. If a procedure name is entered and any matching procedures are found, a procedure list is presented.

Wildcard strings are valid in this field, using "*" as a substitution character for any number of characters in the procedure name. For example: *XYZ will find all procedure names ending in the string XYZ, and XYZ* will find all procedure names beginning with XYZ.

A space indicates "AND", so entering "PU END" would return only those procedures whose names contain both the character sets "PU" and "ND", so, PUNP-END or PUMPKIN.SPENDER.

The "or" bar indicates "OR", so "PU|ND" would find any procedures containing the strings "PU" or "ND". This might include "PUMP", "COLORPURPLE" and "NINTENDO".

Wildcards can be used in conjuntion with the AND/OR selections, so "PUPR*|SCPR*|MOPR*" would find all procedures starting with any of the above strings.

The routine currently has a bias in favor of "OR" selections, so a selection like "PUPR*|SCPR AND" won't work. It will return all procedures beginning with PUPR, then will attempt to add to the list any procedure with the characters "SCPR AND", which will find nothing, because of the embedded space. So do not combine AND and OR selections.

Search strings

The maximum length has bene increased to nn.

# of context lines

Numeric indicator (0 through 9) of number of lines of code to display before and after the line containing the search string.

# occurrences to find

The number (from 1 to 999) that specifies the number of occurrences within a procedure that will be displayed.

Hide SEQa/BASEs

SirLib users will see a prompt and entry area that allows the display or hiding of SEQ. and BASE. procedures, which are used in code management functions but are not intended to be edited directly. Enter "Y" to prevent this procedures from being displayed, and "N" to display them.

Ignore Comment Lines

If set to Y it will ignore any Soul formatted comment lines. If set to N all found lines will be included.

New Function Keys

PF5 - Toggle between case sensitive/insensitive

In Case Sensitive mode, a search for "html" would only find the lower-case version of that string. In Case-Insensitive mode the same search would find procedures containing either "html" or "HTML".

Procedure List screen (PL)

Field changes

Command Line

Most of the functions able to be performed on the Search screen may now be done as commands in the Command Line field. In addition commands can be strung together using the semicolon as a delimiter. For example to switch to a new field and display those procedures that have HELP in their name can be done as: FL SIRIUS;A HELP

Most commands have a full name and an abbreviation.

 BYTES/PAGES  Switch between showing the number of bytes a procedure
              contains or the number of table D pages the procedure holds.
              Defaults to BYTES.

 DISPLAY [x]  Changes the value of '# of context lines'.
 CODE [x]     With these commands you can alter the number of lines of
 SHOW [x]     code to be displayed beginning with the first of any found
 CL [x]       search string.  Obviously, if no search string was
              specified on the previous screen, this command has no
              effect.  Valid values for 'x' are 0 through 9. If there  
              is no 'x' specified,it will give a default value of 0 to  
              the '# of context lines'. 

 HAS/HA/H xxx Changes the selection to procedures containing the specified
              string 'xxx'. 'HAS $GETG' restricts procedures to those
              containing $GETG. HAS does not support wildcards, so a
              search for 'locate*' will look for the string 'locate*'.

 PROCS xxx    Changes the procedure name filter to 'xxx'.  Wildcarding
 A xxxx       is assumed and fully supported, so for instance, the
              command 'PROCS CADDIE' will find all procedures with
              the string 'CADDIE' in its name.  If specific wildcard
              characters are used, the search is done for the
              specified pattern, so 'PROCS I.*' restricts the display
              to procedures beginning with 'I.'
              
 AND xxx      Changes the procedure name filter bying combining 'xxx' with 
              the existing value with AND logic, applying 'distributive  
              law' if necessary. For instance, if the current value of the 
              procedure name filter is 'A|B', an 'AND C' command will 
              change it to 'A C|B C' by applying 'distributive law':  
              (A|B) C -> A C|B C.
              
 +AND xxx     Changes the procedure name filter bying combining 'xxx' with 
              the existing value with AND logic, but WITHOUT applying 
              'distributive law'. It just simply appends 'xxx' to the 
              existing procedure name filter. For instance, if the current
              value of the procedure name filter is 'A|B', an 'AND C' 
              command will change it to 'A|B C'.   
              
 OR xxx       Changes the procedure name filter bying combining 'xxx' with 
              the existing value with OR logic. For instance, if the 
              current value of the procedure name filter is 'A|B', an  
              'OR C' command will change it to 'A|B|C'.               
              
 FILE/FL xxx  Changes the file context using the existing privileges to 
              the file.
              
 FLP          Changes the file context with prompt for password.
 
 GROUP/GP xxx Changes the group context using the existing privileges to 
              the group.   
              
 GPP          Changes the group context with prompt for password.
 
 PASSWORD/PWD Reopens the current file or group with prompt for password.  
              It implies a switch of privileges associated with the 
              password to the current file or group.
              
 OCC [xxx]    Changes the value of '# of occurrences to find'. The valid  
              value for the optional 'xxx' is either a number between 1  
              and 999 or 'ALL'. If there is no 'xxx' specified, it will 
              give a default value of 1 to the '# of occurrences to find'.
              
 HS [x]       Changes the value of 'Hide SEQs/BASEs'. The valid value for   
              the optional 'x' is 'Y' or 'N'. If there is no 'x' 
              specified, it will give a default value of 'Y' to the 
              'Hide SEQs/BASEs'. 
              
 IC [x]       Changes the value of 'Ignore Comment lines'. The valid value    
              for the optional 'x' is 'Y' or 'N'. If there is no 'x' 
              specified, it will give a default value of 'Y' to the 
              'Igonre Comment lines'.
              
 CREATEPROC/  Creates a new procedure named 'xxx' in the current file/group    
 CREATE/      context. If there is no 'xxx' specified, an unnamed     
 CP [xxx]     procedure will be created.  

 LASTID/      Changes the value of 'Last Updater ID'.     
 LID [xxx]    The valid value for 'xxx' is a string not longer than 10, or      
              blank.               
              
 EXIT/QUIT/   Return to previous screen without processing any prefix
 END          commands.