Release notes for SirPro V7.5: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (minor cleanup)
m (add pointers to PL feature)
 
(10 intermediate revisions by the same user not shown)
Line 12: Line 12:


====Search Strings====
====Search Strings====
The maximum length has been increased to ??.
The maximum length has been increased to 66 for each of the five search string fields.


====# of context lines====
====# of context lines====
Line 35: Line 35:
===Other features===
===Other features===


====Logical And/Or for Procedure Name search====
====Logical And/Or for Procedure Name search====    
If a procedure name is entered and any matching procedures are found, 
As in previous SirPro versions, an asterisk (<tt>*</tt>) wildcard is valid in the <b>Procedure Name</b> field as a substitution character for any number of characters in the procedure name.   
a procedure list is presented.                         
                                                       
As in previous SirPro versions, wildcard strings are valid in this field, using an asterisk (<tt>*</tt>) as a substitution character for any number of characters in the procedure name.  For example: <code>*XYZ</code> finds all procedure names ending in the string "XYZ", and <code>XYZ*</code> finds all procedure names beginning with "XYZ".


New in version 7.5:
These are added in version 7.5:
<ul>
<ul>
<li>A space indicates a logical And operation. Entering <code>PU END</code> returns only those procedures whose names contain both the character sets "PU" and "ND", for example, <code>PUNP-</code> or <code>PUMPKIN.SPENDER</code>. </li>
<li>A space 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 procedures 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 procedures 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/Or    
<li>Wildcards can be used in conjunction with the And/Or selections.  
selections. <code>PUPR*|SCPR*|MOPR*</code> finds all       
<p>
procedures starting with any of the above strings. </li>
<code>PUPR*|SCPR*|MOPR*</code> finds all       
procedures starting with any of these strings. </p></li>
</ul>
</ul>


<blockquote class="note">
For further details, see [[SirPro_procedure-list selection#procname|Procedure Name]].
<p><b>Note:</b> You must use caution when combining And and Or selections, because the routine currently has a bias in favor of Or selections.
Specifying <code>PUPR*|SCPR AND</code> 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. </p>
</blockquote > 


====Field error tagging====
====Field error tagging====
In case of an error in field specification, for example an invalid <b>Context</b> field, the field is tagged red and an error message is displayed above the PF keys.
In case of an error in field specification, for example an invalid <b>Context</b> field, the field is tagged red and an error message is displayed above the PF keys.


====Longer procedure names====
====Better subsystem transfer====
Users can now move from any screen in SirPro, for example, to a screen in SirMon by specifying <code>MON 3.2</code>, for example, in the command line. The <code>3</code> refers to option 3 from the SirMon main menu, which opens the <b>USER Monitor Options</b> screen. The <code>2</code> refers to option 2 on the <b>USER Monitor Options</b> screen, which invokes the display of system users and measures of their level of activity.


====Better subsystem transfer====
Similarly, <code>SCAN <i>n.n</i></code> takes you to SirScan screens, <code>FILE <i>n.n</i></code> to SirFile screens, and <code>PRO <i>n.n</i></code> to SirPro screens.


====Save profile for each change====
====Save profile for each change====
Most changes you make to SirPro screens are saved, including entries like last item searched for and any procedure selection restrictions,  and they are restored if you exit and then return to SirPro.


==Procedure List screen (ProcList/PL)==
==Procedure List screen (ProcList/PL)==
Line 108: Line 105:
</td></tr>
</td></tr>
      
      
<tr><th>OR <i>xxxx,/i></th>
<tr><th>OR <i>xxxx</i></th>
<td>Changes the procedure name filter by combining <var class="term">xxxx</var> with the existing value with Or logic. For instance, if the current value of the procedure name filter is <code>A|B</code>, an <code>OR C</code> command changes it to <code>A|B|C</code>. Hence this adds additional procedures to the display listing.
<td>Changes the procedure name filter by combining <var class="term">xxxx</var> with the existing value with Or logic. For instance, if the current value of the procedure name filter is <code>A|B</code>, an <code>OR C</code> command changes it to <code>A|B|C</code>. Hence this adds additional procedures to the display listing.
</td></tr>
</td></tr>
Line 164: Line 161:
</table>
</table>


====Selection field====
====Sel (selection) field====
The following procedure selection option has been added:
The following procedure-selection prefix commands are added:


  E (Edit)Invokes the [[soulEdit|SoulEditor]].  
<ul>
<li><b>E (Edit)</b>
<p>
Invokes [[SoulEdit]], the SOUL editor.
</p>


The following new selection options a part of the
<li><b>U (Undo)</b>
Sirius Configuration and Change Control System (SirLib).  If SirLib is
<p>
not installed then these commands are not valid.  Further information
This <i>[[SirLib]]-required</i> command performs the same operation as <var>Q</var>, resulting in the creation of a "working"
on managed updates and the Configuration Management system is in the
procedure and a sequenced copy of that procedure. However, the <var>U</var> command may only be executed against a change deck. It includes the change deck against which it is executed in the code for the working procedure but <b>not</b> in the code from the sequenced copy. In other words, it recreates
SirLib User's Guide.
 
<table class="thJustBold">
<tr class="head"><th>Command</th><th>Description</th></tr>
 
<tr><th>U (Undo)</th>
<td>
May only be executed against a change deck.  This command
performes the same operation as a Q, resulting in a "working"
procedure and a sequenced copy of that procedure being created
in the user's selected development procfile. However, the U
command specifically includes the change deck against which it is
executed in the code for the working procedure, but NOT in the
code from the sequenced copy. In other words, it recreates
the state of the development procedures that created the change
the state of the development procedures that created the change
deck against which the U command is executed.
deck. </p>
<p>
For further details, see [[SirPro change management tools and functions#undoCmd|U (Undo)]]. </p></li>


Typically, the U command is used to recreate the state of development
<li><b>Y (Refresh)</b>
when the programmer has accidentally deleted the procedures she
<p>
was working on, either manually, or via the "Clean-up" switch on
This <i>[[SirLib]]-required</i> command lets you "refresh" your local working copy
the Xcompare screen.
 
The U command is a special-use feature, and there are a number
of ways in which it will fail to work -- most notably, if the
selected change deck is somewhere in the middle of a series of
changes and, by excluding it from procedure creation, some code
dependency is missing.  However, for its primary function --
recovering from a mistake that was made very recently, typically
as the most recent change to a procedure, it should always work.
</td></tr>
 
<tr><th>Y</th>
<td>
This change-control prefix command provides a special check-out
ability in which the user can "refresh" their local working copy
of a procedure with changes that have been checked in by other
of a procedure with changes that have been checked in by other
programmers since the working copy was originally taken from
programmers since you checked out the working copy from
the source procedure file. "Y" is applied against the working
the source procedure file. </p>
procedure, a screen is presented, and the result is a new
<p>
working procedure with all updates applied AND the user's current
For further details, see [[SirPro change management tools and functions#refresh|Y (Refresh)]]. </p>
changes still in place, and a sequenced copy that has all updates
</li>
applied, but the user's current changes not in place.
</ul>


In other words, the "Y" command is very much like a "Q" command,
==New PL subsystem==
but it is done while changes are in progress, and it slips
The new <var>PL</var> subsystem and fast-path command allows direct entry to the [[SirPro procedure-list operations#Overview|Procedure List screen]] in SirPro. The command format is:
into place other changes that have occurred since the original
<p class="syntax">PL [<span class="term">procedurePattern</span>] [FILE <span class="term">filename</span> | GROUP <span class="term">groupname</span>]
procedure check-out.
</td></tr>
</table>
 
== New PL subsystem==
(Adrian to complete)
 
A new command PL allows direct entry to the Procedure List screen in SirPro. The format is:
<p class="code">PL [<procedurePattern>] [FILE <fileName>|GROUP <groupName>]
</p>
</p>
If FILE or GROUP is not supplied then the current open context will be used. The context is obtained using $view('APDFCNTX') (see [[APDFCNTX_parameter]]).
<p>
 
For further details, see [[RKTools#PL command|PL command]]. </p>
Note - If a procedure search is required for the words 'FILE' or 'GROUP', then it must be entered as:
<p class="code">PL file FILE <filename></p>
where the first 'file' is for procedures containing the word 'file'.  The second 'FILE' is required as the context is not automatically added if searching for the words 'FILE' or 'GROUP'.


==Enhanced Help==
==Enhanced Help==
(in progress)
(in progress)

Latest revision as of 19:19, 4 May 2016

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

SirPro is a member of the RKTools product family; see also the release notes for RKTools version 7.5.

The previous version of SirPro was 707, available in March, 2010.

Procedure Search screen (ProcSearch/PS)

Option 1, Procedure List, from the SirPro main menu brings you to this screen.

Field changes

The searching capabilities are enhanced to provide better impact analysis. The following fields are changed or added.

Search Strings

The maximum length has been increased to 66 for each of the five search string fields.

# of context lines

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

# occurrences to display

This number (from 1 to 999) specifies how many occurrences of a search string within a procedure to display.

Hide SEQs/BASEs

SirPro users who are also SirLib users can display or hide SEQ. and BASE. procedures, which are used in code management functions but are not intended to be edited directly.

Ignore Comment Lines

You can ignore any SOUL-formatted comment lines or include all found lines.

New function keys

PF5 - Toggle between case sensitive/insensitive

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 "html" or "HTML".

PF6 - Create Proc

Enter the SoulEdit editor within a skeleton procedure-creation template.

Other features

Logical And/Or for Procedure Name search

As in previous SirPro versions, an asterisk (*) wildcard is valid in the Procedure Name field as a substitution character for any number of characters in the procedure name.

These are added in version 7.5:

  • A space 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 procedures containing the strings "PU" or "ND", for example, PUMP, COLORPURPLE, and NINTENDO.

  • Wildcards can be used in conjunction with the And/Or selections.

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

For further details, see Procedure Name.

Field error tagging

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

Better subsystem transfer

Users can now move from any screen in SirPro, for example, to a screen in SirMon by specifying MON 3.2, for example, in the command line. The 3 refers to option 3 from the SirMon main menu, which opens the USER Monitor Options screen. The 2 refers to option 2 on the USER Monitor Options screen, which invokes the display of system users and measures of their level of activity.

Similarly, SCAN n.n takes you to SirScan screens, FILE n.n to SirFile screens, and PRO n.n to SirPro screens.

Save profile for each change

Most changes you make to SirPro screens are saved, including entries like last item searched for and any procedure selection restrictions, and they are restored if you exit and then return to SirPro.

Procedure List screen (ProcList/PL)

This screen displays a list of the procedures that satisfy the specifications made on the Procedure Search screen described above.

Field changes

Command line

Most of the functions you can perform on the Procedure Search screen may now be done as commands in the command line field. In addition, You can string commands together using a semicolon as a delimiter.

For example, to switch to a new file, SIRIUS, and display those procedures that have "HELP" in their name, specify:

FL SIRIUS;A HELP

An erroneous command remains on the screen so it can be amended.

Most commands have a full name and an abbreviation.

Procedure List commands
CommandDescription
{PROCS | A} [xxxx] Changes the procedure name filter to 'xxxx'. Wildcarding is assumed and fully supported, so for instance, the command PROCS CADDIE finds all procedures with the string "CADDIE" in its name.

If you use specific wildcard characters, the search is done for the specified pattern, so PROCS I.* restricts the display to procedures beginning with "I".

If the filter name xxxx is omitted, all procedures are displayed.

AND xxxx Changes the procedure name filter by combining xxxx with the existing value with And logic, applying the "distributive law" if necessary. For instance, if the current value of the procedure name filter is A|B, an AND C command changes it to A C|B C by applying the distributive law:

(A|B) C -> A C|B C

Hence this filters the current display listing to show only those that also meet the new criteria.

+AND xxxx Changes the procedure name filter by combining xxxx with the existing value with And logic, but without applying the "distributive law." It just simply appends xxxx to the existing procedure name filter. For instance, if the current value of the procedure name filter is A|B, an AND C command changes it to A|B C.
OR xxxx Changes the procedure name filter by combining xxxx 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 changes it to A|B|C. Hence this adds additional procedures to the display listing.
{CREATEPROC | CREATE | CP} [xxxx] Creates a new procedure named xxxx in the current file/group context. If there is no xxxx specified, an unnamed procedure is created.
{FILE | FL} xxx Changes the file context to xxx using the existing privileges to the file.
FLP xxx Changes the file context to xxx with a prompt for password.
{GROUP | GP} xxx Changes the group context to xxx using the existing privileges to the group.
GPP xxx Changes the group context to xxx with a prompt for password.
PASSWORD | PWD Reopens the current file or group with a prompt for password. It implies a switch of privileges associated with the password to the current file or group.
{LASTID | LID} [xxx] Changes the value of the Last Updater ID field. The valid value for xxx is a string not longer than 10, or is a blank.
{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* looks for the string "locate*".

If the string xxx is omitted, the search string is cleared.

{DISPLAY | CODE | SHOW | CL} [n] With these commands you can alter the number of lines of code to be displayed, beginning with the first of any found search string. If no search string was specified on the previous screen, this command has no effect.

Valid values for n are 0 through 9. If there is no n specified, it gives a default value of 0 to the # of context lines field.

OCC [nnn] Changes the value of the # of occurrences to find field. The valid value for the optional nnn is a number between 1 and 999 or it is ALL. If there is no nnn specified, it gives a default value of 1 to the # of occurrences to find field.
IC [x] Changes the value of the Ignore Comment lines field. The valid values for the optional x are Y and N. If there is no x specified, it gives a default value of Y to Ignore Comment lines.
HS [x] Changes the value of the Hide SEQs/BASEs field. The valid value for the optional x is Y or N. If there is no x specified, it gives a default value of Y to Hide SEQs/BASEs.

Sel (selection) field

The following procedure-selection prefix commands are added:

  • E (Edit)

    Invokes SoulEdit, the SOUL editor.

  • U (Undo)

    This SirLib-required command performs the same operation as Q, resulting in the creation of a "working" procedure and a sequenced copy of that procedure. However, the U command may only be executed against a change deck. It includes the change deck against which it is executed in the code for the working procedure but not in the code from the sequenced copy. In other words, it recreates the state of the development procedures that created the change deck.

    For further details, see U (Undo).

  • Y (Refresh)

    This SirLib-required command lets you "refresh" your local working copy of a procedure with changes that have been checked in by other programmers since you checked out the working copy from the source procedure file.

    For further details, see Y (Refresh).

New PL subsystem

The new PL subsystem and fast-path command allows direct entry to the Procedure List screen in SirPro. The command format is:

PL [procedurePattern] [FILE filename | GROUP groupname]

For further details, see PL command.

Enhanced Help

(in progress)