SirPro procedure-list operations: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision: SirPro from Stage)
m (change PF keys)
Line 6: Line 6:
==Overview==
==Overview==


<p class="caption" style="margin-right:15em">The Procedure List screen</p>
<p class="caption" style="width:500px">The Procedure List screen</p>


The procedure list shows the procedures that fit the criteria
The procedure list shows the procedures that fit the criteria
Line 95: Line 95:
</table>
</table>


<p><b>PF keys</b></p>
<p><b>Function keys</b></p>
<p>
<p>
The following PF keys invoke actions as described:</p>
The following function keys invoke actions as described:</p>


<table class="thJustBold">
<table class="thJustBold">
<tr><th>PF1</th>
<tr><th>F1</th>
<td>Full screen help.</td></tr>
<td>Full screen help.</td></tr>


<tr><th>PF2</th>
<tr><th>F2</th>
<td>Sort the displayed list by procedure name.</td></tr>
<td>Sort the displayed list by procedure name.</td></tr>


<tr><th>PF3</th>
<tr><th>F3</th>
<td>Quit (return to previous screen).</td></tr>
<td>Quit (return to previous screen).</td></tr>


<tr><th>PF4</th>
<tr><th>F4</th>
<td>Sort the displayed list by last updating user.</td></tr>
<td>Sort the displayed list by last updating user.</td></tr>


<tr><th>PF5</th>
<tr><th>F5</th>
<td>Sort the displayed list by last date updated.</td></tr>
<td>Sort the displayed list by last date updated.</td></tr>


<tr><th>PF6</th>
<tr><th>F6</th>
<td>Sort the displayed list by size of procedure.</td></tr>
<td>Sort the displayed list by size of procedure.</td></tr>


<tr><th>PF7</th>
<tr><th>F7</th>
<td>Scroll backward (up).</td></tr>
<td>Scroll backward (up).</td></tr>


<tr><th>PF8</th>
<tr><th>F8</th>
<td>Scroll forward (down).</td></tr>
<td>Scroll forward (down).</td></tr>


<tr><th>PF9</th>
<tr><th>F9</th>
<td>Repeat last command-line command.</td></tr>
<td>Repeat last command-line command.</td></tr>


<tr><th>PF10</th>
<tr><th>F10</th>
<td>Refresh the list. Use this PF key to clear any prefix selections and to recheck the file for procedure information that may have changed (for instance, if another user is deleting procedures in the same file, your list may be out-of-date).</td></tr>
<td>Refresh the list. Use this key to clear any prefix selections and to recheck the file for procedure information that may have changed (for instance, if another user is deleting procedures in the same file, your list may be out-of-date).</td></tr>


<tr><th>PF11</th>
<tr><th>F11</th>
<td>Toggles between upper and mixed case <b><i>E</i></b>dit when the editor is invoked. The PF key label indicates the case to which you will switch when the PF key is pressed.</td></tr>
<td>Toggles between upper and mixed case <b><i>E</i></b>dit when the editor is invoked. The key label indicates the case to which you will switch when the key is pressed.</td></tr>


<tr><th>PF12</th>
<tr><th>F12</th>
<td>Toggle the display between a "D LIST" format and a "FULLNAME" format. In DLIST format, the display shows the traditional <var class="product">Model 204</var> procedure list information with long procedure names truncated at 25 characters (for display only). In FULLNAME format, long procedure names overlay their corresponding procedure information.</td></tr>
<td>Toggle the display between a "D LIST" format and a "FULLNAME" format. In DLIST format, the display shows the traditional <var class="product">Model 204</var> procedure list information with long procedure names truncated at 25 characters (for display only). In FULLNAME format, long procedure names overlay their corresponding procedure information.</td></tr>
</table>
</table>
Line 159: Line 159:


<tr><th>M</th>
<tr><th>M</th>
<td>When using PF7 or PF8, scroll up or down to the top or bottom of the list of procedures.</td></tr>
<td>When using F7 or F8, scroll up or down to the top or bottom of the list of procedures.</td></tr>


<tr><th>CLOSE <i>xxxx</i></th>
<tr><th>CLOSE <i>xxxx</i></th>
Line 165: Line 165:


<tr><th>END or QUIT</th>
<tr><th>END or QUIT</th>
<td>Same as PF3, returns the user to previous screen.</td></tr>
<td>Same as F3, returns to previous screen.</td></tr>
</table>
</table>
<p>
<p>
Line 185: Line 185:
The source information is protected.
The source information is protected.


<p class="caption" style="margin-right:15em">Move/Copy procedure screen</p>
<p class="caption" style="width:500px">Move/Copy procedure screen</p>


The copy screen requires input in the following fields:
The copy screen requires input in the following fields:
Line 216: Line 216:
</table>
</table>


<p><b>PF keys</b></p>
<p><b>Function keys</b></p>
The following PF keys invoke actions as described:
The following keys invoke actions as described:
<table class="thJustBold">
<table class="thJustBold">
<tr><th>PF1</th>
<tr><th>F1</th>
<td>Full screen help.</td></tr>
<td>Full screen help.</td></tr>


<tr><th>PF3</th>
<tr><th>F3</th>
<td>Cancel the request to copy or move this procedure (
<td>Cancel the request to copy or move this procedure. If this is one of a list of selected procedures, the next procedure is presented; if this is the only procedure, or if it is the last procedure in a list, you are returned to the procedure list display.</td></tr>
if this is one of a list of selected procedures, the next procedure is presented; if this is the only procedure, or if it is the last procedure in a list, you are returned to the procedure list display).</td></tr>
</table>
</table>


==Deleting procedures==
==Deleting procedures==
Procedures selected for deletion are presented in a single scrollable
Procedures selected for deletion are presented in a single scrollable
list, from which the user presses the PF3 key
list, from which you press the F3 key
to cancel (and return to the list where the selections can be changed),
to cancel (and return to the list where the selections can be changed),
or PF12 to confirm the deletions.
or F12 to confirm the deletions.


<p class="caption" style="margin-right:15em">Confirming procedure deletion</p>
<p class="caption" style="width:500px">Confirming procedure deletion</p>


PF keys are the same as on the procedure selection list, except that PF10
Function keys are the same as on the procedure selection list, except that F10
is not active (the user must return to the previous screen to refresh
is not active (the user must return to the previous screen to refresh
the procedure list), and PF12 is used as a confirmation key for the delete.
the procedure list), and F12 is used as a confirmation key for the delete.


On returning to the original list, procedure information lines are
On returning to the original list, procedure information lines are
Line 253: Line 252:
and various characteristics of the print job:
and various characteristics of the print job:


<p class="caption" style="margin-right:15em">Print destination screen</p>
<p class="caption" style="width:500px">Print destination screen</p>


Enter the following information:
Enter the following information:
Line 298: Line 297:
</table>
</table>


PF keys are the same as on the procedure selection list, except that
Function keys are the same as on the procedure selection list, except that
PF10 is not active (the user must return to the previous screen to refresh
F10 is not active (the user must return to the previous screen to refresh
their selected list), and PF12 is used as a confirmation key for the print.
their selected list), and F12 is used as a confirmation key for the print.


If either Option 1 or Option 2 is selected, <var class="product">SirPro</var> executes a simple <var>USE</var> command.
If either Option 1 or Option 2 is selected, <var class="product">SirPro</var> executes a simple <var>USE</var> command.
Line 315: Line 314:
Procedures selected for <b>R</b>enaming are presented one at a time.
Procedures selected for <b>R</b>enaming are presented one at a time.


<p class="caption" style="margin-right:15em">Renaming procedures screen</p>
<p class="caption" style="width:500px">Renaming procedures screen</p>


On returning to the original list, procedure information lines are
On returning to the original list, procedure information lines are
Line 321: Line 320:
protected from update until the user's procedure list is refreshed.
protected from update until the user's procedure list is refreshed.


<p><b>PF keys</b></p>
<p><b>Function keys</b></p>
The following PF keys invoke actions as described:
The following keys invoke actions as described:
<table class="thJustBold">
<table class="thJustBold">
<tr><th>PF1</th>
<tr><th>F1</th>
<td>Full screen help for this screen.</td></tr>
<td>Full screen help for this screen.</td></tr>


<tr><th>PF3</th>
<tr><th>F3</th>
<td>Cancel the request to rename this procedure.</td></tr>
<td>Cancel the request to rename this procedure.</td></tr>
</table>
</table>
Line 348: Line 347:
</ul>
</ul>


<p class="caption" style="margin-right:15em">SmartBrowse: Browsing a procedure</p>
<p class="caption" style="width:500px">SmartBrowse: Browsing a procedure</p>


<p class="caption" style="margin-right:15em">SmartBrowse: Displaying undeclared variables</p>
<p class="caption" style="width:500px">SmartBrowse: Displaying undeclared variables</p>


All three of these commands invoke the same procedure, so the user may
All three of these commands invoke the same procedure, so the user may
Line 390: Line 389:


<tr><th>M</th>
<tr><th>M</th>
<td>When using PF7 or PF8, scroll up or down to the top or bottom of the list of procedures.</td></tr>
<td>When using F7 or F8, scroll up or down to the top or bottom of the list of procedures.</td></tr>
</table>
</table>


<p><b>PF keys</b></p>
<p><b>Function keys</b></p>
The following PF keys invoke actions as described:
The following keys invoke actions as described:


<table class="thJustBold">
<table class="thJustBold">
<tr><th>PF1</th>
<tr><th>F1</th>
<td>Full screen help for this screen.</td></tr>
<td>Full screen help for this screen.</td></tr>


<tr><th>PF3</th>
<tr><th>F3</th>
<td>Exit from SmartBrowse of this procedure.</td></tr>
<td>Exit from SmartBrowse of this procedure.</td></tr>


<tr><th>PF7</th>
<tr><th>F7</th>
<td>Scroll up.</td></tr>
<td>Scroll up.</td></tr>


<tr><th>PF8</th>
<tr><th>F8</th>
<td>Scroll down.</td></tr>
<td>Scroll down.</td></tr>


<tr><th>PF9</th><td>Repeat last command-line command.</td></tr>
<tr><th>F9</th><td>Repeat last command-line command.</td></tr>
</table>
</table>



Revision as of 18:52, 28 July 2015


Overview

The Procedure List screen

The procedure list shows the procedures that fit the criteria specified on the selection panel. A prefix area to the left of each procedure name allows entry of a variety of single-character procedure commands.

Supply a value in the select field (SEL), as described below:

B Browse
C Copy
D Delete
E or S Edit
I Include
M Move
P Print
R Rename
V Variable analysis
# Expanded Browse

In addition, the following managed update commands are provided for users of the SirLib change management system.

X Xcompare
Q seQuence
N New
K Klobber
Z resequence (or ReSequence or resequenZ)

The managed update commands are described in SirPro change management tools and functions.

Users may enter any number and combination of prefix commands, none of which will execute until the Enter key is pressed. Deletes and Prints are done for all procedures at once. Processing for other commands is performed one procedure at a time, but with all same-type commands processed sequentially (that is, all Edits are performed, then all Browses, then all Prints, etc.) in the order in which commands are encountered from the top of the procedure list.

The display area of the screen, described below, can be toggled between a set of views. The DLIST view, similar to the view of procedures most commonly seen by User Language developers at the command level, contains the following information:

PROCEDURE NAME The name of a procedure available for editing. Procedure names longer than 25 characters are truncated. An asterisk is added as the last character of the truncated procedure name to indicate that the full name is not displayed, and the procedure name is highlighted. These procedures can still be selected from the list, and the full procedure name is used in all functions.
ACCOUNT The account (user id) of the last user to update the procedure.
BYTES Number of bytes stored in Table D for the procedure.
DATE/TIME The date and time the procedure was last updated.

Function keys

The following function keys invoke actions as described:

F1 Full screen help.
F2 Sort the displayed list by procedure name.
F3 Quit (return to previous screen).
F4 Sort the displayed list by last updating user.
F5 Sort the displayed list by last date updated.
F6 Sort the displayed list by size of procedure.
F7 Scroll backward (up).
F8 Scroll forward (down).
F9 Repeat last command-line command.
F10 Refresh the list. Use this key to clear any prefix selections and to recheck the file for procedure information that may have changed (for instance, if another user is deleting procedures in the same file, your list may be out-of-date).
F11 Toggles between upper and mixed case Edit when the editor is invoked. The key label indicates the case to which you will switch when the key is pressed.
F12 Toggle the display between a "D LIST" format and a "FULLNAME" format. In DLIST format, the display shows the traditional Model 204 procedure list information with long procedure names truncated at 25 characters (for display only). In FULLNAME format, long procedure names overlay their corresponding procedure information.

The following commands are valid on the command-line of this screen:

L n Locate line number n.
n or -n Scroll n or -n lines from the top line of the display.
F string or /string Find a specific "string," starting the search from the top line of the display. This string can be any part of the procedure name. That is, it is not a prefix search.
-F string or -/string Find a specific string, searching backward from the top line of the display.
TOP Moves the display to the top of the procedure list.
BOTTOM Moves the display to the bottom of the procedure list.
M When using F7 or F8, scroll up or down to the top or bottom of the list of procedures.
CLOSE xxxx Closes the specified file or group. SirPro subsystem files, and the file(s) from which the current procedure list was taken, cannot be closed.
END or QUIT Same as F3, returns to previous screen.

In addition, any of the prefix commands may be typed on the command line, followed by either a procedure name, or the number of that procedure in the displayed list. If the procedures selected in this manner is the first procedure selected, processing is initiated immediately. If other prefix commands have already been entered, the procedure is added to the selected list.

Include and Edit (E or S) are not documented further, as they merely invoke a Model 204 edit or include. The other prefix commands invoke special screens and processing, which are documented in the sections that follow.

Move/Copy

The destination screen is displayed once for each procedure selected for Copy or Move. The screen requires entry of destination file and procedure name, and allows the procedure to be edited on the way to the new location. The source information is protected.

Move/Copy procedure screen

The copy screen requires input in the following fields:

FROM FILE The name of the file from which you are moving/copying. This field is protected.
FROM PROC The name of the procedure from which you are moving/copying. This field is protected.
DESTINATION FILE The name of the file to which you want to move/copy the file.
DESTINATION FILE PASSWORD The file password, if needed.
DESTINATION PROCEDURE NAME The procedure can be renamed during Copy/Move operation. If the file is being copied or moved to the same file, it must be renamed.
REPLACE Y/N Type Y to replace if the procedure already exists. The default is N.
EDIT Y/N Type Y to edit the new procedure before UL/SPF performs the move/copy. The default is N.

If you type Y, editing takes place before UL/SPF stores the procedures in the "TO" procedure and leaves the source procedure unchanged. The procedure status line (the top line of the editor display screen) shows that you are editing a temporary procedure into the destination procedure name.

When you finish editing the procedure, type END in the command window. UL/SPF stores the new procedure in the destination procedure name. To terminate the edit process and abandon edit changes and the Copy, type QUIT.

Function keys

The following keys invoke actions as described:

F1 Full screen help.
F3 Cancel the request to copy or move this procedure. If this is one of a list of selected procedures, the next procedure is presented; if this is the only procedure, or if it is the last procedure in a list, you are returned to the procedure list display.

Deleting procedures

Procedures selected for deletion are presented in a single scrollable list, from which you press the F3 key to cancel (and return to the list where the selections can be changed), or F12 to confirm the deletions.

Confirming procedure deletion

Function keys are the same as on the procedure selection list, except that F10 is not active (the user must return to the previous screen to refresh the procedure list), and F12 is used as a confirmation key for the delete.

On returning to the original list, procedure information lines are overwritten with a success or failure message for the delete operation.

Printing procedures

A variety of options are provided for printing procedures. Procedures may be routed to an output file, or to a printer via a USE printer.id command or a USE $PRINT command.

No confirmation is performed for print operations. The user is routed directly to the Print Destination screen for routing.

The Print destination screen controls output routing of the procedures, and various characteristics of the print job:

Print destination screen

Enter the following information:

DESTINATION The destination of the procedure. Select 1 to print to a the printer named in the PRINTER field, 2 to output the procedures to the file named in the FILE field, and 3 to invoke a USE $PRINT, to the specified CLASS and PRINTER.
PRINTER A valid predefined printer name. If this field is blank or invalid when a 1 is specified in the OUTPUT DESTINATION field, the print comes to the user's terminal.
OUTFILE A valid preallocated sequential file.
CLASS The job class to use for USE $PRINT requests. This job class should be a valid class at your site. USE $PRINT is an obsolete method of printing, and its use is discouraged. If the PRINTER is blank or invalid when a USE $PRINT is invoked, the print is routed to PRINTER=LOCAL by Model 204
WITH criteria Enter in these two fields any print routing criteria normally placed in the "WITH" clause of a USE statement (such as COPIES=xx, TAG or ID statements).
UDDLPP The number of lines to be printed or displayed per page. The default is 60 lines per page.
UDDCCC The number of characters to be printed or displayed per line. The default is 133 characters per line.
HDRCTL Header control settings allow the user to suppress various levels of automatic print headers.
UDDRFM The number of characters to be printed or displayed per line. The default is 133 characters per line.
Use SirPro Formatting? Specifying N to this prompt prints procedures as they are in the procedure file. Specifying Y forces a page break at the beginning of each procedure, numbers the lines of the procedure and produces a header at the top of each page, indicating the procedure file, procedure name, date, and time of the print.
Format for file reorg? Specifying Y to this prompt prints procedures beginning in column 1 and placing PROCEDURE procname and END PROCEDURE procname statements around each output procedure.

Procedures output to a file using this formatting feature can be input directly to a procedure file reorganization job.

Specifying Y to this prompt overrides a Y to the previous prompt (Use SirPro Formatting?), because file reorganization format precludes the type of headers and line numbers used in SirPro formatting.

Function keys are the same as on the procedure selection list, except that F10 is not active (the user must return to the previous screen to refresh their selected list), and F12 is used as a confirmation key for the print.

If either Option 1 or Option 2 is selected, SirPro executes a simple USE command. If Option 3 is selected, a command of the following format is executed:

USE $PRINT PRINTER=printer.id CLASS=print.class

If the specified printer is invalid, PRINTER=LOCAL is substituted.

All user entries on the print screen are saved in the user profile except the destination.

Rename procedures

Procedures selected for Renaming are presented one at a time.

Renaming procedures screen

On returning to the original list, procedure information lines are overwritten with a success message for renamed procedures, and they are protected from update until the user's procedure list is refreshed.

Function keys

The following keys invoke actions as described:

F1 Full screen help for this screen.
F3 Cancel the request to rename this procedure.

SmartBrowse: Browse, Variable and (#) Expand

Browse, Variable and # (Expand) prefix commands all invoke SmartBrowse sessions.

  • Browse displays the procedure in a scrollable list (which does not invoke an edit session).
  • Expand (#) brings inline all INCLUDEd code, and presents the fully expanded procedure in a scrollable list (INCLUDEs of temporary procedures are ignored).
  • Variable scans the fully expanded procedure and presents a list of undeclared %variables.

SmartBrowse: Browsing a procedure

SmartBrowse: Displaying undeclared variables

All three of these commands invoke the same procedure, so the user may switch their browse session from one view to another with the following commands:

BROWSE Convert the display to a simple browse session.
UNDECL Display undeclared variable names only.
VARIABLE Display undeclared variable names only (same as UNDECL).
EXPAND Expand all include statements.

The following command-line commands are also valid:

L n Locate line number n.
n or -n Scroll n or -n lines from the top line of the display.
F string or /string Find a specific "string," starting the search from the top line of the display. This string can be any part of the procedure name. That is, it is not a prefix search.
-F string or -/string Find a specific string, searching backward from the top line of the display.
TOP Moves the display to the top of the procedure list.
BOTTOM Moves the display to the bottom of the procedure list.
M When using F7 or F8, scroll up or down to the top or bottom of the list of procedures.

Function keys

The following keys invoke actions as described:

F1 Full screen help for this screen.
F3 Exit from SmartBrowse of this procedure.
F7 Scroll up.
F8 Scroll down.
F9Repeat last command-line command.

See also