# 1. {Graphical User Interface}
SPF/Pro differs from previous versions in a number of ways. One of the
more obvious is the Graphical User Interface (GUI). The use of modern
graphical user interface techniques enhances the SPF/Pro experience and
contributes to increased user productivity.
The basic display mechanism of the GUI is the Window. All functions of
SPF/Pro are rendered in native mode windows of the operating system
platform in use.
The basic method of interaction with windows is the mouse. Keyboard
equivalents are provided for all mouse operations. See page for
further details on mouse operations.
SPF/Pro is a Multiple Document Interface application. In this
architecture, you have a parent window and one or more child windows. The
child windows are displayed within the parent client space.
Child windows within the parent client space may be maximized, normal, or
minimized:
* In maximized state, the child window fully occupies the parent client
space and the child title bar overlays the parent title bar.
When using low resolution display monitors (e.g. VGA on notebook PC),
this mode provides the greatest number of display lines and columns.
* In normal state, the child window may reside anywhere within the parent
client space and be of any size equal or less than the parent. In this
case, the child window has its own title bar.
* In minimized state, the child window is reduced to an icon and
positioned in the lower left corner of the parent client space.
The default display mode for child windows is NORMAL.
All windows are comprised of the following components:
Window Frame
The Window Frame is the outer border of the window. The functional
value of the frame is that it can be "grabbed" with the mouse and
"stretched" or "shrunk" to alter the window size. To resize the
window:
- position the mouse cursor over any part of the window frame
- press and hold down the left mouse button
- move the mouse to achieve the desired size
- let the left mouse button up to finalize the new window size
- "pulling" or "pushing" on the left or right frame alters the width
- "pulling" or "pushing" on the top or bottom frame alters the depth
- "pulling" or "pushing" on any corner alters the width and depth
simultaneously
Task Control Button
In the upper left corner of the window, there is a button which
controls the SPF task. You can use this button to:
- Close the task and exit.
Note: If you close from the main window, all SPF tasks are
terminated.
- Restore, Move, Size, Minimize, and Maximize. These functions are
accessible through alternate methods so we won't discuss them here.
Title Bar
At the top of the window is the Title Bar. It provides information
about the task context. For example, if you are in Edit, the title bar
displays the Task ID (an integer number starting with one) and the name
of the file being edited.
In addition to providing information, the Title Bar is used to:
- Move the window:
-- Position the mouse cursor over any portion of the Title Bar.
-- Press and hold down the left mouse button while moving the mouse
to move the window.
-- Let the left mouse button up to finalize the new window position.
- Maximize the window
-- double click on the title bar with the left mouse button.
Min/Max Buttons
On the upper right corner of the window:
- The MINIMIZE Button "shrinks" the window to the size of the SPF/Pro
icon. You can use this button to keep SPF/Pro on the desktop for
instant recall. To recall SPF/Pro click on the "shrunken" icon.
- The MAXIMIZE Button increases the size of the window to occupy the
full available space. Use this button when you want to display the
maximum number of rows and columns of text possible.
After maximizing, the MAXIMIZE button takes on a new form; this form
is called NORMAL. To return to normal window size from maximized
size, click on the NORMAL (formerly MAX) button.
Client Space
The client space is where SPF panels are displayed. These panels
contain text and graphical elements.
- Text fields defined in your panel definition are rendered as text.
- Input fields defined in your panel definition are rendered as
concave three dimensional areas.
- Attention fields defined in your panel definition are rendered as
three dimensional buttons. Text content of attention fields is
rendered as the button legend.
Scroll Bars
To view data outside the viewable frame, scroll bars are provided:
- In tables and select lists, vertical scroll bars are provided.
- In Edit and Browse, both vertical and horizontal scroll bars are
provided.
- In all other panel types, no scroll bars are provided.
Note: Scroll bars may be enabled/disabled via Option 0.1.
PFSHOW Bar
PF keys are displayed at the bottom or top of the parent frame. The
number, display position, and starting key may be set via Option 0.1 or
the PFSHOW primary command.
Status Bar
The status bar provides current information about the operating
environment:
- Whether the system is busy.
- Whether you are in "macro recording" mode.
- The day of week, date, and time.
- The state of the SHIFT key.
- The state of the CAPS LOCK key.
- The state of the INSERT key.
- In tables, the current table row and column.
- In edit, the current file line and data column.
Popup Menus
Popup menus are available via right mouse button in various contexts
during normal SPF/Pro operation. These menus provide a point and shoot
activation scheme for frequently used commands.
- In file select lists, verbs that apply to the current selection
- In edit line command field, line commands that apply to the current
selection
- In edit text area, primary commands that apply to the current
selection
- In any other panel type, useful general commands
Note: You can add or modify popup menus on a per panel basis or
reconfigure dynamically within a panel.
# 1.1 {Menu Bar}
The menu bar provides native GUI operational mode. You can perform many
mainline SPF tasks directly off the menu without using SPF dialogs. The
following menu commands are supported:
FILE
Perform file operations:
New
Open a new file in Edit. The default name for new file is "*.*".
Supply the desired name for your new file in the "File name" field
of the dialog. If you want a different directory, use the "Look in"
navigator of the dialog to set the desired directory.
Open for Edit
Open an existing file in Edit. The open file dialog is initialized
with the name of the last file edited. If you want to edit a
different file, supply the name in the "File name" field of the
dialog. If you want a different directory, use the "Look in"
navigator of the dialog to set the desired directory.
Open for Browse
Open an existing file in Browse. The open file dialog is
initialized with the name of the last file Browsed or Edited. If
you want to edit a different file, supply the name in the "File
name" field of the dialog. If you want a different directory, use
the "Look in" navigator of the dialog to set the desired directory.
Save
Saves the current edit file and continues in edit. Same as primary
command SAVE.
Save as
Brings up the Windows common open dialog. Specify the new "File
name" and press "SAVE". This creates the new file and a new edit
session to edit it.
End
End the edit session and return to the previous panel. If the file
was modified, it is automatically saved. Same as END primary
command.
End without Save
Exit the edit session without saving the file. Same as CANCEL
primary command.
Print Setup
This item invokes the Windows common printer setup dialog. This
dialog allows you to set a wide variety of printer properties. When
you commit the settings via OK, the setup values are bound to the
current SPF logical printer.
Print Selection
Prints the current selection. Same as SPRINT primary command.
Print All
Prints the entire file. Same as PRINT ALL primary command.
MRU Edit List
This is a list of the last 5 files Edited. You can click on any one
of them with the left mouse button to launch an Edit on the file.
Exit
Completely terminate SPF. Same as "=x" primary command.
EDIT
Perform edit operations:
Undo
Undo the last edit operation. Same as UNDO primary command.
Redo
Redo the last Undo operation. Same as REDO primary command.
Cut
Copy the current selection to the clipboard, then delete it from the
edit file. Same as SCUT primary command.
Copy
Copy the current selection to the clipboard. Same as SCOPY primary
command.
Paste
Paste the current clipboard contents into the current edit file at
the cursor. Same as SPASTE primary command.
Delete
Delete the current selection from the edit file. Same as SDELETE
primary command.
Find
Find a string in the current edit file. Same as FIND primary
command.
Find next
Repeat the last Find command. Same as RFIND primary command.
Change
Change one string to another in the current edit file. Same as
CHANGE primary command.
Change next
Repeat the last change command. Same as RCHANGE primary command.
WINDOW
Organize windows and tasks:
FSplit
Start a new SPF task.
-- In maximized state, the new task replaces the current task
display.
-- In normal state, the new task is created using the size of the
current task and is displayed in cascaded stair-step fashion.
Swap
If more than one SPF task is active, swap to the next SPF task in
the task ring. If only one SPF task is active, process the command
as an FSplit.
Tile
If more than one SPF task is active, arrange the SPF task windows
side by side in a non-overlapped manner sharing the parent display
space equally.
Cascade
If more than one SPF task is active, arrange the SPF task windows in
an overlapped stair-step fashion in the parent display space.
MRU Task List
This is a list of all active SPF tasks. You can click on any one of
them with the left mouse button to activate it.
HELP
Access SPF/Pro online HELP:
Help...
Invoke the SPF Help dialog. This dialog lets you select help by
topic and also allows dynamic searches.
About
Display information about SPF/Pro.
# 2. {Quickstart}
While it is helpful, you do not need prior knowledge of IBM's mainframe
based ISPF to use SPF/Pro. Reading this manual from front to back will
give you an in depth understanding of all the facilities available to you
but will also consume a lot of your valuable time. A more effective
approach for the uninitiated is to acquire a minimum working knowledge in
a short time that will enable you to perform simple file editing tasks.
This chapter will get you up and running in under one hour. As you use
SPF/Pro in this minimal way you can explore the full range of functional
capabilities described in the remainder of this manual at your leisure.
# 2.1 {Edit a New Empty File}
You can now execute SPF/Pro to edit a file. For this exercise let's edit
file TEST.TXT:
* Click on the SPF program group icon and/or the SPF program item icon to
launch SPF/Pro.
You are now in the Primary Option Panel.
* Type 2 in the "Option" field.
* Press [SPF-Enter] (the right [CTRL] key).
You are now in the Edit Entry Panel.
* Use the mouse or the [TAB] key to position to the "System File
Specification" field.
* Type TEST.TXT in the "System File Specification" field.
* Press [SPF-Enter].
The top line of the client space displays the SPF Title Line. The Title
Line is the first line of the body of each SPF Dialog. In the Edit Dialog,
the name of the file you are editing is displayed on the left. On the
right are the starting and ending columns of the displayed portion of the
file's records (usually 1 and 72). If you have records longer than 72
characters, the characters from column 73 to the end of each record are
not presently visible; we will talk about how to reveal them in another
section.
The second line is the Command Line. The first input field on the Command
Line is the Primary Command Field where edit primary commands are entered.
The second input field is the Scroll Field where scroll amounts are
entered. We will not modify the scroll field.
The third and subsequent lines to the bottom of the client space are data
lines. The first six columns of each data line are the Line Command Field
where edit line commands are entered. The Line Command Field normally
displays a six digit line number. Column 7 is a boundary between the Line
Command Field and the data area and is always blank. Columns 8 through 79
display columns 1 through 72 of each data record.
The first and last data lines are not part of your file. They are created
by the editor to indicate that you are at the top or bottom of the file
and are called the Top of Data and Bottom of Data lines respectively.
You are currently editing new empty file TEST.TXT. The cursor is setting
in the Primary Command Field. The top display line shows "TOP OF DATA".
The bottom display line shows "BOTTOM OF DATA". The intermediate display
lines are empty. Empty lines in SPF/Pro are called Null Lines and are
indicated by six apostrophes in the Line Command Field.
* Press the [ENTER] key to get to the top line (TOP OF DATA).
* Press the [ENTER] key a second time to get to the first data line.
* Press the [TAB] key to get to the first data column (8).
* Type "This is a line of text."
* Press the [SPF-Enter] key to commit the text to the file.
All the empty data lines were "closed up" when you pressed [SPF-Enter].
* Press [SHIFT][TAB] twice to position to the start of the display line
(the Line Command Field of line 000001).
* Type "r99" in the Line Command Field.
* Press the [SPF-Enter] key to "replicate the current line 99 times".
The file now contains 100 lines of "This is a line of text.". We will
use this sample file for the remaining exercises.
# 2.2 {Moving Around the Screen}
The MOUSE can be used to position the cursor anywhere on the screen.
Simply move the mouse pointer to the desired location and click the left
mouse button one time. More advanced mouse capabilities and techniques are
described elsewhere.
You can also use the cursor keys to move left, right, up and down by one
position. When you reach the edge of the display in any direction, the
cursor leaves that edge and reappears at the opposite edge.
The [ENTER] key moves you down one line and to the left edge of the screen
in a single step.
The [TAB] key moves you from screen column 1 (line command area) to screen
column 8 (data area) in a single step.
# 2.3 {Executing Primary Commands}
This section explains how to enter and execute primary commands which will
be discussed in later sections.
Move the mouse pointer on the Primary Command Field and click the left
mouse button one time, or press the [HOME] key. Your are now in the
Primary Command Field.
* Enter the primary command in the Primary Command Field.
* To execute:
- If you have an enhanced keyboard (101 keys), press the right [CTRL]
key. Hereafter this key is represented as [SPF-Enter].
- If you have a standard keyboard, press the ENTER key on the numeric
keypad. Hereafter this key is represented as [SPF-Enter].
- On any other keyboard type press [CTRL][ENTER]. Hereafter this key
sequence is represented as [SPF-Enter].
# 2.4 {Executing Line Commands}
This section explains how to enter and execute line commands which will be
discussed in later sections.
* Use the mouse or the [ENTER] key and/or cursor keys to move the cursor
to the Line Command Field of the line you want to operate on.
* Enter the line command in the Line Command Field.
* To execute press [SPF-Enter].
# 2.5 {Scrolling}
To move up or down one full frame in the file use the [PG-UP] and [PG-DN]
keys respectively.
Function keys [F7] and [F8] are pre-programmed with the UP and DOWN
primary commands respectively.
To go to the top of the file in a single step enter and execute primary
command:
top
To go to the bottom of the file in a single step enter and execute primary
command:
bot
To reveal text not visible on the right enter and execute primary command:
right
To reveal text not visible on the left enter and execute primary command:
left
Function keys [F10] and [F11] are pre-programmed with the LEFT and RIGHT
primary commands respectively.
# 2.6 {Summary 1}
You now know how to:
* Edit a file.
* Travel around the screen using the mouse or cursor keys.
* Enter and execute primary and line commands.
* Scroll the file vertically using the [PG-UP] and [PG-DN] keys.
* Go to the top or bottom of the file in a single step using the "top"
and "bot" primary commands.
* Go to the left or right edge of the data using the "left" and "right"
primary commands.
# 2.7 {Overtyping Text in Existing Line}
The default text entry mode is overtype. In overtype mode the cursor is
shaped like a box. Simply move the cursor to the data portion of the
record you want to change and type over the text you want replaced.
# 2.8 {Inserting Text in Existing Line}
To insert text you must first put the editor into insert mode by pressing
the [INS] key. In insert mode the cursor is a thin vertical line. Now
move the cursor to the data portion of the record you want to change and
type the text you want inserted.
# 2.9 {Insert New Lines in Existing File}
To insert a new line:
* Type "i" line command in the line above where you want a new line
inserted.
* Press [SPF-Enter].
* A new line is inserted immediately below the "i" line. The cursor is
placed in the first data column.
* Type the desired data in the new line.
If you would like more new lines immediately following the first:
* After entering text on the first new line and without any other
intervening keystrokes, press [SPF-Enter].
* Another new line is inserted and the cursor is positioned at the first
data column.
* Continue entering text. Repeat this process as required.
After all data is entered, press [SPF-Enter] one more time to eliminate
unused empty lines.
# 2.10 {Deleting Lines in Existing File}
To delete a single line:
* Type "d" line command in the line you want deleted.
* Press [SPF-Enter].
* The line is deleted.
To delete multiple lines:
* Type "dd" line command in the first line of the block of lines you want
deleted.
* Type "dd" line command in the last line of the block of lines you want
deleted.
* Press [SPF-Enter].
* The block of lines between the first "dd" and last "dd" inclusive is
deleted.
# 2.11 {Summary 2}
In the last information set you learned how to:
* Overtype existing lines.
* Insert text in existing lines.
* Insert new lines.
* Enter text in an empty file.
* Delete existing lines.
# 2.12 {Finding Text}
If you don't want to manually search an entire file looking for a
particular record, you can use the FIND primary command to get there in a
single step. For example,
find line
finds the first occurrence of the string "line" in upper, lower, or mixed
case.
If you want to find the next occurence of the same string press [F5].
# 2.13 {Changing Text}
You can change the first occurrence of a string to another value with the
CHANGE primary command. For example,
change line bit
changes the first occurrence of string "line" to "bit".
To change the next occurence of the same string press [F6].
change this bit all
changes all occurrences of string "this" to "bit".
# 2.14 {Summary 3}
In the last information set you learned how to:
* Find the first occurence of a string of text.
* Find the next occurence of the same string.
* Change the first occurrence of a string to another value.
* Change the next occurence of the same string.
* Change all occurrences of a string to another value.
# 2.15 {Copy Lines}
To copy a single line:
* Type "c" line command in line to be copied.
* Type "a" line command in line preceding desired destination.
* Press [SPF-Enter]. Line with "c" is copied after line with "a".
To copy multiple lines:
* Type "cc" line command in first line of block of lines to be copied.
* Type "cc" line command in last line of block of lines to be copied.
* Type "a" line command in line preceding desired destination.
* Press [SPF-Enter]. Block of lines between first line with "cc" and last
line with "cc" inclusive is copied after line with "a".
# 2.16 {Move Lines}
To move a single line:
* Type "m" line command in line to be moved.
* Type "a" line command in line preceding desired destination.
* Press [SPF-Enter]. Line with "m" is moved after line with "a".
To move multiple lines:
* Type "mm" line command in first line of block of lines to be moved.
* Type "mm" line command in last line of block of lines to be moved.
* Type "a" line command in line preceding desired destination.
* Press [SPF-Enter]. Block of lines between first line with "mm" and last
line with "mm" inclusive is moved after line with "a".
# 2.17 {Summary 4}
In the last information set you learned how to:
* Copy a single line from one location in the file to any other location.
* Copy a block of lines from one location in the file to any other
location.
* Move a single line from one location in the file to any other location.
* Move a block of lines from one location in the file to any other
location.
# 2.18 {Saving Modified File}
To save the file in its modified form, enter and execute primary command:
save
After the file is saved, editing can resume.
# 2.19 {Exit With Save}
To save the file in its modified form and exit SPF/Pro, enter and execute
primary command:
=x
# 2.20 {Exit Without Save}
To exit SPF/Pro without saving the file, enter and execute primary
command:
cancel
At this point a panel is presented with a number of options; enter and
execute primary command:
=x
# 2.21 {Summary 5}
In the last information set you learned how to:
* Save a modified file and continue editing.
* Exit a modified file saving all changes.
* Exit a modified file without saving changes.
# 2.22 {Epilogue}
This chapter illustrates a minute portion of the functional capability of
the Edit component of SPF/Pro. After you become familiar with what you
have learned here, examine the remainder of the book at your leisure.
This chapter describes only the most orthodox methods. Frequently there
are shortcuts to doing many of the operations discussed which you will
learn over time.
# 3. {Introduction}
# 3.1 {Feature Summary}
SPF/Pro is a complete integrated applications development environment for
MVS legacy applications programs. It is typically used for editing source
code, invoking compilers, linkers, and debuggers, in a variety of
programming languages, such as COBOL, FORTRAN, and C++. Of course SPF/Pro
can be used with other programming languages and source files.
SPF/Pro has many features designed to make managing and authoring source
code easier, such as:
* Custom Dialogs interfacing to:
- Micro Focus
- XDB
* Fully graphical user interface
* PC based Partitioned Dataset support
* FIND/CHANGE in select lists
* FIND/CHANGE string highlighting
* MODEL support
* SUPERC file compare
* Undo/Redo
* Program source colorization
* Horizontal or Vertical screen SPLIT
* Multiple full screen SPLITs
* Multi-way select list file management
* Multiple-file search and replace
* Run Time Macro support via REXX
* Unlimited file size
* Programmable keyboard and keyboard macros
* Multiple character set and file format support
* Several tabbing modes, several line numbering modes
* Full integration with popular COBOL workbenches
* Extended, expanded, and virtual memory support
* CUT/PASTE via clipboard
# 3.2 {SPF/Pro Files}
SPF/Pro uses several files during its processing:
SPFPRO.EXE (in SPFPRO)
This is the main executable file for Windows-95, and Windows-NT.
SPFPC50.GBL (in SPFPRO\PROFILES)
If not already present, this file is created at installation time. It
is updated whenever you change global profile variables. SPFPC50.GBL
can load from:
- the default location
- the location specified in environment variable SPF5PATH
- the location specified in command option /G
Note: If SPF/Pro can't find SPFPC50.GBL, it creates it with default
parameters.
*.PRF (in SPFPRO\PROFILES)
These files are not installation files. They are created as you edit
files, to record information about file formats. Each .PRF file
contains file format information which applies to all files with a
particular type. For example, the file profile for program source file
EDITCMD.CPP would be CPP.PRF.
The *.PRF files are found and loaded in the same manner as SPFPC50.GBL.
*.SPF (in SPFPRO\REXX and SPFPRO\REXX\USER)
These files are SPF/Pro edit macros which use ISREDIT macro commands.
Edit macros included on the installation diskette are documented in
README.MAC. Edit macros you create must be located in in one of the
following:
- SPFPRO\REXX
- SPFPRO\REXX\USER
- The directory specified in the MACRO SEARCH PATH field of the 0.8
OPTIONS Menu. If multiple directories are specified, they must be
separated by semicolons.
- The current directory.
For more information on sample macros, see README.MAC in directory
SPFPRO.
Note: Edit macros that have been precompiled, have the file type
".SP2" and reside in the same directories.
*.ISP (in SPFPRO\REXX and SPFPRO\REXX\USER)
Dialog procedures are developed using ISPEXEC dialog services. They
follow the same rules for directory residence as the edit macro files.
Note: Dialog procedures that have been precompiled, have the file type
".IS2" and reside in the same directories.
*.CLR (in SPFPRO\PROFILES)
These are program source colorization definition files.
SPFCOLR.TBF (in SPFPRO\PROFILES)
When you create a named color setup using Option 0.4 it is stored in
this file.
SPFMRU.TBF (in SPFPRO\PROFILES)
When you edit files, the Most Recent Edits list is stored in this file
and accessed via Panel 3.H.
SPFUSER.TBF (in SPFPRO\PROFILES)
When you create a named user program using Option 4 it is stored in
this file.
SPFLIST.TBF (in SPFPRO\PROFILES)
When you save a select list via primary command SAVELIST, the name of
the list is saved in this file.
list-name.TBF (in SPFPRO\PROFILES)
When you save a select list via primary command SAVELIST, the list is
saved in a file with the specified name. For example, if you "SAVELIST
PROJECT1", the list is saved in file PROJECT1.TBF.
*.TBF (in SPFPRO\PROFILES)
Tables created dynamicly with dialog services are kept in files of this
type.
*.KEY (in SPFPRO\PROFILES)
All named keyboard mappings created via 0.K are kept in files of this
type.
*.MAC (in SPFPRO\PROFILES)
When you create a named keyboard macro within a named keyboard via 0.M,
the macro is saved in files of this type.
*.PDS (in SPFPRO\PAN)
Panel definitions are normally stored in Partitioned Datasets. Access
to PDS files is through the special REXX API which we provide.
*.PAN (in SPFPRO\PAN and SPFPRO\PAN\USER)
Panel definitions that are in development or frequently modified, are
stored as individual PC files of this type.
SPFPRO.MSG (in SPFPRO\PAN)
Base message definition file.
SPFUSER.MSG (in SPFPRO\PAN)
User message definition file.
README.DOC (in SPFPRO)
A text file on the distribution diskette which contains documentation
developed after this document went to print.
README.WIN (in SPFPRO)
Information specific to running SPF/Pro in the Windows environment.
README.MAC (in SPFPRO)
Information specific to *.SPF macros supplied with SPF/Pro.
# 3.3 {Starting an SPF/Pro Session}
Click on the SPF program group icon and/or the SPF program item. This
action loads SPF/Pro and puts you into the Primary Option Panel.
# 3.3.1 {Start-up Parameters}
You can invoke SPF/Pro via "FILE" menu "RUN" or Command Window, with
parameters which allow you to bypass the Primary Option Panel and go
directly to a specific option:
SPFPRO [filename]
[/Bfilename]
[/E]
[/Gglobal-profile-path]
[/Iimacro-name]
[/Kkeyboard-macro-name]
[/L(line-number,col-number)]
[/Pedit-profile-name]
[/Rfile-name]
[/Sdialog-function]
[/T]
[/n.n]
The startup parameters are defined below:
filename
The name of a file to edit. If wild-card characters are specified, a
select list is presented for file selection.
Note: filename may not be specified if "/B" or "n.n" is specified.
/B
The name of a file to browse. If wild-card characters are specified, a
select list is presented for file selection.
Note: /B may not be specified if "filename" or "n.n" is specified.
/E
Exit directly to command prompt after edit.
/G
Specifies the path where the global profile will be found. This
overrides the value set in environment variable SPF5PATH.
/I
The name of an initial macro. Can only be used with a specific
filename.
/K
Specifies the keyboard macro name to execute on entry to SPF/Pro:
/Kkeyboard-macro-name.
/L
Specifies line and column numbers in the following form:
/L(line-number,col-number).
/P
The name of an edit profile. Can only be used with a specific
filename.
/R
The name of a compiler error message file. This file is merged as
NOTES into the edit file. The compiler messages must be in what is
generally known as "The Microsoft Format". Among the compilers that
support this format are the following:
Micro Focus COBOL
CA-Realia-II COBOL
Borland C++
Zortech C++
Microsoft (all languages)
/S
The name of a dialog function to be used in place of the primary option
panel. The dialog function can take one of the following forms:
/SPANEL(panel-id)[PARM(parameter-values)]
/SCMD(REXX-procedure-name)[PARM(parameter-values)]
/SCTC(internal-function-name)[PARM(parameter-values)]
/SPGM(external-program-name)[PARM(parameter-values)]
As an alternative to the /S startup command option you can set
environment variable SPFSTART with a value identical to that which you
would specify for /S and you would get the same result. For example,
issuing command
SPFPRO /SPANEL(MYPRIME)
and setting
SET SPFSTART=PANEL(MYPRIME)
would have the same effect. If /S is specified on the command line, it
overrides the SPFSTART environment variable.
/T
Activates the profile trace for diagnostic purposes.
/n[.n]
The specific id of a panel you want to enter directly.
Note: n.n may not be specified if "filename" or "/B" is specified.
Note: The older form =n.n is still supported but its use is
discouraged because if you use it in a command file (.BAT or .CMD) the
equal sign is stripped off by the batch command processor yielding a
syntax error.
A few examples of the startup command follow:
SPFPRO CONFIG.SYS [ENTER]
SPFPRO C:\SRC\MAIN.C [ENTER]
SPFPRO NEXNAME.COB /PDAT [ENTER]
SPFPRO CKDATE.COB /ICOBINIT [ENTER]
SPFPRO /BAUTOEXEC.BAT [ENTER]
SPFPRO /3.4 [ENTER]
# 3.4 {Ending an SPF/Pro Session}
When you have finished using SPF/Pro and are ready to end your session,
you can:
* Press [F3] (END command) repeatedly, backing up through previous panels
to the system prompt.
* Press [HOME], then type in the exit command, as follows:
COMMAND ===> =X [SPF-Enter]
* Double click with the left mouse button on the close box for the SPF
task you want to end.
* Select the FILE menu EXIT item with the mouse.
# 4. {Using the Mouse}
This chapter describes how to use the mouse to:
* select a menu item
* select a PF key
* select a list entry
* operate on multiple list entries
* activate a popup menu
* scroll select list
* position the cursor
* select a group of lines
* select a stream of characters
* select a block (rectangular area)
* extend the selection
* perform [SPF-Enter] processing
* cancel selection
* delete the selection from the file
* cut the selection from the file to the clipboard
* copy the selection from the file to the clipboard
* paste the selection from the clipboard to the file
* create/replace an external file from the selection
* convert the selection to all uppercase letters
* convert the selection to all lowercase letters
* print the selection
* exclude the selection (applies to lines only)
* move the split separator
* sort file select list
Using the mouse is most efficient when the primary commands that relate to
the mouse are mapped to function keys or control keys. In the following
discussion, we use function keys to describe how to do various operations
in conjunction with the mouse. For our examples, the following mapping is
used:
[SHIFT][F1] = SCUT
[SHIFT][F2] = SCOPY
[SHIFT][F3] = SPASTE
[SHIFT][F4] = SCREATE
[SHIFT][F5] = SREPLACE
[SHIFT][F6] = STOUPPER
[SHIFT][F7] = STOLOWER
[SHIFT][F8] = SXCLUDE
[SHIFT][F9] = SDELETE
See Keys Option 0.K for a description of how to map the keyboard. You can
map the mouse related primary commands in a manner which best suits your
style.
# 4.1 {Select a Menu Item}
Any time you are in an SPF/Pro menu, you can select a menu item by
clicking on it with the left mouse button.
# 4.2 {Select a PF Key}
Any time the PF keys are visible, you can select a PF key by clicking on
it with the left mouse button. Use the PFSHOW primary command to make PF
keys visible.
# 4.3 {Select a List Entry}
Any time you are in an SPF/Pro select list, you can invoke SELECT on a
single entry by double-clicking on it with the left mouse button.
# 4.4 {Operate on Multiple List Entries}
To operate on multiple list entries (e.g. a group of files):
* click on the line command field of the first entry in the block with
the left mouse button
* enter the desired operation (e.g. S, E, etc.)
* press the shift key then click on the last entry in the block with the
left mouse button
* press [SPF-Enter] to apply the line command you entered on the first
entry to all the entries between and including first and last
# 4.5 {Activate Popup Menus}
Popup menus are available in file select lists and edit to provide a
convenient point and shoot activation scheme for frequently used commands.
Click the right mouse button to activate the popup menu. Use the mouse to
select the desired entry. Click the left or right mouse button to activate
the command.
# 4.6 {Scroll Select List}
Scroll the select list by clicking on the vertical scroll bar when
present.
# 4.7 {Position the Cursor}
You can position the character cursor anywhere on the screen by moving the
mouse cursor to that position and clicking the left mouse button.
# 4.8 {Select a Group of Lines}
A group of lines is one or more complete lines. This is the most common
form of selection when dealing with program source. In EDIT or BROWSE to
select a group of one or more lines:
* Use the mouse to position the cursor to the line command field of the
first line in the block.
Note: If line commands are turned off (see LCMD primary command),
position to the first character in the line.
* Press down the left mouse button.
* With the left button still pressed and staying in the line command
field, drag the mouse to the last line in the block. As you drag the
mouse, the lines which become selected are highlighted.
Note: When you drag to the top or bottom edge of the display, EDIT (or
BROWSE) automatically scrolls to extend the selection in the direction
of travel.
* When you have reached the end of the selection, let the left mouse
button up. The selection is now complete.
# 4.9 {Select a Stream of Characters}
A stream is all the characters between the first character of the
selection, in a continuous stream (including line ends), to the last
character of the selection. This is the most common form of selection
when dealing with textual material. In EDIT or BROWSE to select a stream
of one or more characters:
* Use the mouse to position the cursor to the first character in the
stream.
* Press down the left mouse button.
* With the left button still pressed, drag the mouse to the last
character in the stream. As you drag the mouse, the characters which
become selected are highlighted.
Note: When you drag to the top, bottom, left or right edge of the
display, EDIT (or BROWSE) automatically scrolls to extend the selection
in the direction of travel.
* When you have reached the end of the selection, let the left mouse
button up. The selection is now complete.
Note: Unlike word processors, SPF/Pro preserves line ends within stream
selections.
# 4.10 {Select a Block}
A block is a rectangular area. This form of selection is used for special
cases. In EDIT or BROWSE to select a block:
* Holding the ALT key, click the left mouse button and drag to select the
block.
* Use the mouse to position the cursor to the upper left corner of the
block.
* Press down the right mouse button.
* With the right button still pressed, drag the mouse to the lower right
corner of the block. As you drag the mouse, the area which becomes
selected is highlighted.
Note: You can also select from lower right to upper left.
* When you have reached the end of the selection, let the right mouse
button up. The selection is now complete.
# 4.11 {Extend Selection}
To extend the current selection without dragging, reposition the mouse,
press the [SHIFT] key, then click the left mouse button. The selection is
extended from the end of the current selection to the current mouse
position. This technique also works with a null selection. (To extend a
block selection, click on the right mouse button.)
# 4.12 {Cancel Selection}
To cancel the selection, press any non-function key except [HOME] or click
the left mouse button.
# 4.13 {Delete Selection}
To delete the selection, press the [DEL] key or press the [SHIFT][F9] key
(=SDELETE). The deleted text is removed from the file but is not put into
the clipboard.
# 4.14 {Cut Selection}
To cut the selection, press the [SHIFT][F1] key, or [CTRL][X] (both are
mapped to SCUT). The selected text is copied into the clipboard; it is
then removed from the file.
# 4.15 {Copy Selection}
To copy the selection, press the [SHIFT][F2] key, or [CTRL][C] (both are
mapped to SCOPY). The selected text is copied into the clipboard; it is
not removed from the file.
# 4.16 {Paste Selection}
* For line selections - place the cursor anywhere on the target line,
* For stream selections - place the cursor at the target character within
the target line,
* For block selections - place the cursor at the upper left corner of the
target area
then press the [SHIFT][F3] key, or [CTRL][V] (both are mapped to SPASTE).
After the paste operation, the cursor is positioned at the end of the
pasted selection. The contents of the clipboard are not altered. To get
multiple copies of the selection, repeat the paste operation. This is
essentially the same as the SPF/Pro replicate function.
# 4.17 {Create/Replace File}
To create an external file from the selection press either [SHIFT][F4] key
(=SCREATE) to create an original file or [SHIFT][F5] key (=SREPLACE) to
replace an existing file. A panel is presented in which you specify the
name of the file that is being created.
# 4.18 {Convert to Uppercase}
To convert the entire selection to all uppercase letters press the
[SHIFT][F6] key (=STOUPPER).
# 4.19 {Convert to Lowercase}
To convert the entire selection to all lowercase letters press the
[SHIFT][F7] key (=STOLOWER).
# 4.20 {Print Selection}
To print the selection, press the [SHIFT][F10] key (=SPRINT). SPRINT
prints only the selected characters.
# 4.21 {Exclude Selection}
To exclude the selection, press the [SHIFT][F8] key (=SXCLUDE). Exclude
operates on whole lines regardless of the mode of selection. If the
selection is a stream or block, the exclude is applied to all characters
of each line touched by the selection.
# 4.22 {Extend a Selection}
As noted above, selections are normally extended by dragging the mouse
while holding down the left mouse button. An alternative method of
extending the selection is to:
* establish the origin of the selection by clicking the mouse at the
desired start point.
* position the mouse to the desired end point of a selection (no drag
required), then press [SHIFT] and click the left mouse button. The
complete selection is now highlighted.
* You can append to an existing selection using this same technique.
Position the mouse the the new desired end point. Press [SHIFT] and
click the left mouse button. All text between the origin of the
original selection and the new end point is now selected.
# 4.23 {Perform [SPF-Enter] Processing}
At any time, double-clicking the left mouse button on a text entry panel
(e.g. panel 2) produces the same effect as pressing [SPF-Enter].
# 4.24 {Move SPLIT Separator}
If you have split the screen into multiple SPF/Pro sessions via SPLIT,
SPLITV, or VSPLIT primary commands, you can move the split separator by:
* place the mouse cursor on the separator
* hold down the left mouse button
* drag the separator to the desired position
When dragging the separator, SPF/Pro maintains a five line buffer zone
from the top or bottom in the vertical direction, and a ten character
buffer zone from the left or right in the horizontal direction.
# 4.25 {Sort File Select List}
Above each column in file select lists is a labeled column sort button.
To sort the file select list by that property (Name, Size, Date, etc.)
click on the desired column sort button.
# 5. {Interacting With SPF/Pro}
SPF/Pro functions are available to:
* Have full operation control of all elements of Micro Focus Workbench
via custom SPF dialogs.
* Access XDB via extensive custom dialog.
* Browse or edit files.
* Manipulate files or directories.
* Set profile options.
* Launch foreground and background tasks.
* Issue operating system commands on PC.
All SPF/Pro functions are performed via Graphical User Interface through
SPF dialogs comprised of menus or panels. One aspect of learning SPF/Pro
is learning which menu or panel performs what functions and how to move
among them. This chapter explains how to:
* Use menus and panels. Each panel tells you where you are and what you
can do next. The Menus and Panels section below identifies different
panel types and how they are used.
* Use keyboard features. In addition to typing in text, there are a
number of keyboard features of interest. These include 3270-type
features, PF keys, and special purpose keys.
* Issue commands. The Command section introduces different types of
SPF/Pro commands, where to type them in, using commands together, and
other general information.
# 5.1 {Menus and Panels}
SPF/Pro menus and panels fall into basic categories:
MENUS
Menus display a list of available functions. The functions are listed
by number or letter. You select one by either:
- positioning the mouse pointer on the desired entry, and clicking the
left mouse button, or
- typing in the number or letter in the primary command field and
pressing [SPF-Enter].
When you select a menu item, SPF/Pro displays an entry panel or a lower
level menu.
Note: Once you determine which panels are most frequently used, you
can bypass the menus by using the "jump" feature.
ENTRY PANELS
Entry panels have fields for information which is needed to carry out a
function. Simply fill in the fields and press [SPF-Enter] to execute
the function. To position to fields either:
- position the mouse pointer on the desired field and click the left
mouse button
- use cursor and/or tab keys to position to fields
SELECT LISTS
SPF/Pro displays a select list when you initiate a function that
requires a filename but you only supply a path name or a partial
filename (including wild-card characters).
You would normally specify a partial filename intentionally to get a
select list. For example, if you wanted to edit a group of related
COBOL source files you would specify "*.COB" in the filename field of
the EDIT ENTRY PANEL. This would bring up a select list of all the
COBOL source files in the current (or project) directory.
Once a list is displayed, you can select one or more files to edit,
browse, or perform some other function. File selection can be done by
either:
- positioning the mouse pointer on the desired list entry and double
clicking the left mouse button, or
- cursor positioning to the desired entry, placing an "s" to the left
of the entry, and pressing [SPF-Enter].
- Click the left mouse button once on the desired list entry. Click
the right mouse button to display a popup menu of verbs that can be
applied to the selection.
- To select a block of entries, click once on the first entry of the
block, position the mouse to the last entry in the block, press
[SHIFT] and click the left mouse button. You can now use the popup
menu to apply a verb to all the entries in the block.
FILE DISPLAY PANELS
SPF/Pro brings up a file display panel when you request edit or browse
and give a complete filename. The file display panel includes fields
for primary and line commands.
# 5.2 {General Features}
This section describes features common to all panel types. General
features are discussed below. Features unique to a single panel type are
discussed in following sections.
# 5.2.1 {Display Topology}
SPF/Pro panels are normally pre-defined to display in an 80 by 25 display
space. In Windows the display space is arbitrarily sized.
If the available space is smaller than the panel definition calls for, the
excess columns and/or lines are clipped (not displayed) although they are
still part of the active panel. In any case where a portion of the panel
is not visible, you can MAXIMIZE the window to reveal the remainder of the
panel.
If the available space is larger than the panel definition calls for, the
panel is displayed flush top left in the available space. Excess space is
rendered in the protected-low attribute.
The SCREEN primary command of previous versions, is no longer supported.
# 5.2.2 {Select Lists and File Displays}
Select lists and file displays are often larger than the screen area.
Select lists are arbitrarily long and can be scrolled vertically. File
displays are arbitrarily long and wide and can be scrolled both vertically
and horizontally.
Menus and panels have the following basic features:
PANEL HEADING
The top line of the display contains:
- On the left, the product name followed by an integer number which is
the session id.
- In the center, the panel title.
- On the right, the product version number.
EDIT and BROWSE display a file name in place of the panel name and
column numbers in place of the product version number.
SHORT MESSAGE AREA
The short message area overlays the right edge of the top display line
when necessary to display a message. SPF/Pro uses this area to display
information and diagnostic messages.
COMMAND or OPTION FIELD
The second display line on all menus and panels contains the primary
command field labeled COMMAND or OPTION. In either case you can enter
general primary commands. In the OPTION case you can select an item
from the menu by number or letter.
You can enter any of the general commands listed at the end of this
chapter. On file display panels you can enter additional primary
commands supported by EDIT or BROWSE.
LONG MESSAGE AREA
When SPF/Pro displays a short message, enter HELP (or [F1]) to display
a more detailed message. The long message overlays the third display
line when necessary to display the message.
STATUS LINE
The bottom display line is the Status Line. It contains the following
status indicators from left to right:
- INPUT INHIBITED, a special symbol indicates that the last input
character was not accepted. If the symbol has a small arrow on each
side, you tried to type in a protected area such as a field name.
If the arrow is only on the right side of the symbol, you tried to
insert characters into a line or field that is full.
- SYSTEM BUSY, the text "X SYSTEM" indicates the system is busy.
Keyboard input is queued until the last command completes.
- KEYBOARD MACRO RECORDING, the text "RECORDING" indicates that a
keyboard macro is being recorded.
- DATE/TIME, an optional field displaying todays date and the current
time. Use Terminal Option 0.1 to set date and time options.
- SHIFT STATE INDICATOR is visible when the SHIFT key is down.
- CAPS LOCK INDICATOR is visible when the CAPS LOCK state is TRUE.
- INSERT INDICATOR is on when the INSERT state is TRUE.
# 5.2.3 {PFSHOW}
An alternative mode of display is one in which some or all of the PF keys
are displayed at the top or bottom of the screen along with their labels.
This mode is invoked with the PFSHOW primary command.
Key labels are either the first eight characters of the map value or an
explicitly assigned label from the KEYS panel. See Option 0.3 or Option
0.K for details on defining PF key mappings and labels.
When the PF keys are visible they can be selected by positioning the mouse
cursor to the desired key and clicking the left mouse button.
# 5.2.4 {Menus}
Menus present you with a list of SPF/Pro functions. For example, the
Primary Option Panel. Some options on this menu, like 2, Edit lead
directly to function panels. Others, like 3, Utilities lead to a
secondary menu, where other options are listed.
In addition to common general features, a Selection Menu has an OPTION
LIST which lists options by number or letter with a title and short
functional description. To select an Option:
* click on the Option button with the left mouse button
* type the number (or letter) of the Option in the OPTION field and press
[SPF-Enter].
# 5.2.5 {Entry Panels}
SPF/Pro displays an Entry Panel when a selected function needs information
such as a filename to proceed. Entry Panels have titled fields for all
needed information.
SPF/Pro often displays the fields with the last information you typed.
This data is often preserved from session to session. For example, the
file specification in the Edit Entry Panel is preserved across sessions.
Entry panels for different purposes have different formats. They all have
the items listed below, in addition to general panel features.
In addition to general features, an Entry Panel has the following
features:
INPUT FIELDS
These are blank fields indicating needed information. Input fields are
rendered in 3D giving a visual queue to their function. For example,
in the Option 2, EDIT panel, the PROFILE field is an Entry Field.
Some entry fields are scrollable. When you type past the end of the
field, it scrolls instead of giving you input-inhibited. For example,
the primary command field is scrollable.
The maximum amount of data that can be entered in a scrollable field is
1024 characters.
OUTPUT FIELDS
Output fields derive their content from SPF variables that are
specified in the panel definition. For example, the 0.1 Terminal Option
contains a number of output fields indicating various aspects of the
display technology.
LABELS
Input and output fields normally have labels and in some cases other
explanatory information in the form of comments. Labels clarify field
content and may give additional information or instructions.
Note: On color monitors labels and fields may be displayed in
different colors.
# 5.2.6 {File Specifications}
Some input fields call for a PC file specification. For convenience,
SPF/Pro supports several forms of file specification which augment the
conventional form DRIVE:\PATH\FILENAME. The following additional forms are
supported:
PATH;PATH
You can specify multiple paths separated by semicolon or comma. You
can also include a file name if desired with each path element. For
example, to access all .COB and .CPY files in the \SRC\V1 directory:
\SRC\V1\*.COB;\SRC\V1\*.CPY
If all the files you want are in the current directory you can simply
specify the file names:
*.COB;*.CPY
[PATH;PATH]filename
In cases where you want to operate on a common set of files from single
or multiple directories you can specify a path set enclosed in square
brackets followed by a file name or names. For example,
[\SRC\V1;\SRC\V2]*.COB;*.CPY
In this example we are asking for all .COB and all .CPY files from the
directories specified within the square brackets.
%ENV-VAR%
You can use this form of specification to refer to an environment
variable. For example:
%PATH%
To request all .EXE files in all elements of the PATH environment
variable:
[%PATH%]*.EXE
Or access all .CPY files in the COBCPY library set:
[%COBCPY%]*.CPY
Or access all .H files in the INCLUDE library set:
[%INCLUDE%]*.H
# 5.2.7 {Select Lists}
SPF/Pro displays a Select List when you request an operation on a file
without specifying a file name or when you use wild card characters. Wild
card characters are asterisk (*) and question mark (?). Normally you use
wild card characters when you are not sure of the file name or want to
work with a related group of files.
When all the files in a list reside in the same directory, the common
directory is shown on line three of the display. The common path
component of the file name is not repeated in the list.
PANEL HEADING
The top display line identifies the context for the select list.
SCROLL FIELD
On the right end of the second display line is the scroll field. This
field specifies how far the select list will be scrolled in response to
UP, DOWN, LEFT, or RIGHT commands.
CURRENT DIRECTORY
The third display line identifies the active disk and subdirectory. If
no disk or directory information is displayed with the file
information, this is the location of all files in the list.
FILE INFORMATION
The fourth and subsequent display lines contain file information for
all files that match your specification. Individual files are listed
by fields:
- When all files are in the same directory, the fields are:
NAME
EXTENSION
SIZE
DATE
TIME
ATTRIBUTES
- Attributes are indicated with single characters as follows:
A - archive
R - read-only
S - system
H - hidden
- When files are in different directories, the PATH field is appended
to the basic entry.
LINE COMMAND AREA
Each file information line has a two character input field for entry of
select list line commands. You can enter single or double character
line commands to do a variety of things to an individual file or group
of files. For example, in the edit or browse select list, the S line
command selects the file for editing or browsing.
SCROLL BAR
When select lists and other lists like 0.2 and 0.7 have more entries
than can be displayed, a vertical scroll bar is displayed.
Select lists are dynamic in nature. As the file name length increases the
SIZE, DATE, and TIME fields are moved to the right to accommodate the
longest name.
In the case where the longest name is such that the SIZE, DATE, or TIME
fields will not fit, the non-fitting field is clipped.
At any time you can use the I (information) line command to bring up a
panel containing a full elaboration of the file's name and other
attributes.
# 5.2.8 {File Display Panels}
SPF/Pro uses File Display Panels to display files for editing or browsing.
The edit panel displays line numbers and supports a full range of editing
commands. The browse panel has no line numbers and supports a limited set
of commands. If the file is deeper or wider than the available display
space, it can be scrolled UP, DOWN, LEFT, or RIGHT.
In addition to general panel features, a file display panel has the
following features:
MODE INDICATOR
On the left end of the top display line, a mode indicator BROWSE or
EDIT is displayed to indicate which function you are in.
PATH AND FILENAME
Following the mode indicator, the fully qualified path name of the file
being edited or browsed is displayed.
COLUMNS
At the right end of the top display line the start and end data column
are displayed. The COLUMNS display is updated whenever the screen is
scrolled LEFT or RIGHT. In the EDIT file display panel, columns 1
through 6 display line sequence numbers, columns 8 and beyond display
data commencing with data column one. The COLUMNS display shows 1
through N where N is the rightmost data column displayed.
If some characters do not fit in the display area, you can scroll to
reveal them with a "RIGHT" primary command. The COLUMNS display is
updated each time you scroll left or right.
In browse mode, the current line number is displayed along with the
column numbers.
SCROLL FIELD
At the right end of the second display line the scroll field specifies
how far the file will be scrolled in response to UP, DOWN, LEFT, or
RIGHT commands.
LINE COMMAND AREA
The first six character positions of each text line are available for
entry of Edit Line Commands. This area appears only on the edit panel.
It has two purposes:
1. It displays line sequence numbers (relative or absolute)
2. You enter EDIT Line Commands here.
By default line numbers are relative and incremented by 1. Line
numbers are updated whenever a line is inserted, deleted, or moved.
See primary commands NUMBER, RENUM and UNNUM for details on other
numbering methods.
Line commands are one or more characters that allow you to mark one or
more lines for insert, copy, move, or delete and many other line
related operations.
FILE TEXT AREA
This is the data in your file displayed one record per line. You can
scroll UP, DOWN, LEFT, or RIGHT as desired to reveal other areas of the
file. By default EDIT is in overtype mode so you can simply type
anywhere in the text area to make desired changes. The [DEL] key
deletes characters, and the [INS] key toggles the insert state.
BROWSE does not allow modifications to the file.
ROW/COLUMN INDICATOR
At the right end of the status line the file line number (R) and column
number (C) for the current cursor position is displayed. These
indicators are only displayed when in EDIT or BROWSE.
# 5.2.9 {Scrolling}
Scrolling is moving the viewport into a file or select list UP, DOWN, LEFT
or RIGHT.
There are four ways to issue a scroll command:
1. Use the [PG-UP] or [PG-DN] key.
2. Use one of the pre-assigned PF keys:
[F7] - UP
[F8] - DOWN
[F10] - LEFT
[F11] - RIGHT
3. Type it in the command field and press [SPF-Enter].
4. Click on the desired arrow or move the slider of a scroll bar.
# 5.2.10 {Scrolling Amount}
The amount you move with any scroll command is determined by the scroll
field. You can change the scroll amount any time by typing over it. The
scroll amount may also be typed in directly with any scroll command.
Valid scroll values are listed below:
PAGE (P)
Scroll by the full dimension of the display area. Vertically by the
depth in lines of the display area. Horizontally by the width in
columns of the display area.
HALF (H)
Scroll by one half the amount of PAGE.
CSR (C)
Scroll to move the cursor to the edge of the display area.
- For UP, data is moved to place the cursor at the bottom edge of the
display area.
- For DOWN, data is moved to place the cursor at the top edge of the
display area.
- For LEFT, data is moved to place the cursor at the right edge of the
display area.
- For RIGHT, data is moved to place the cursor at the left edge of the
display area.
DATA (D)
Scroll by the amount of PAGE minus one line in the vertical, or minus
one column in the horizontal.
MAX (M)
Scroll the maximum amount in the direction indicated. MAX is reset to
the original amount after the scroll is completed.
In the vertical direction MAX is used to get to the top or bottom of the
file or select list.
In the horizontal direction MAX is used to get to the leftmost or
rightmost data column.
nnnn
Scroll by nnnn lines or columns in the direction indicated.
To temporarily override the scroll amount:
* Type a command and an amount in the command field. For example, UP 10.
* Easier yet, type an amount in the command field and issue the scroll
command with a function key. For example, type 10 in the command
field, and press [F7] for UP.
Note: In addition to scrolling, you can use:
* LOCATE and SELECT commands to position in select lists
* FIND, LOCATE, SELECT and LABEL commands to position in files
# 5.3 {Moving Between Menus and Panels}
When you first start using SPF/Pro you will move from panel to panel
invoking functions in a serial fashion. This technique is fine but may not
be the most efficient for all cases. After you learn which panels are most
frequently useful to you, you can go to and from panels directly using the
techniques discussed below:
* Use the jump feature to go directly to a panel by typing =n or =n.n in
the command field followed by [SPF-Enter]. You can use this feature in
a random manner from any panel. For example, to go directly to the
UTILITIES, FILE LIST panel type =3.4 in the command area and press
[SPF-Enter].
Note: After using the jump feature, the END command returns to the
Primary Option Panel.
* Use the RETURN command (normally [F4]) any time to return directly to
Primary Option Panel regardless of your current position in the menu
tree.
* There are also startup options that allow you enter directly into EDIT,
BROWSE, or any panel.
# 5.4 {Split Screen}
This feature allows you to launch multiple independent copies of SPF/Pro.
You can launch multiple copies of SPF/Pro in one of three modes:
* HORIZONTAL SPLIT - one session above, one session below. To do a
horizontal split, position the cursor to the desired split point, then
press [F2] or use the SPLIT primary command. Limit: two sessions.
* VERTICAL SPLIT - one session on the left, one session on the right. To
do a vertical split, position the cursor to the desired split point,
then use the VSPLIT primary command. (We also support the mainframe
SPLITV primary command which always splits in the middle regardless of
the cursor position). Limit: two sessions.
* FULL SCREEN SPLIT - multiple copies occupying the full display space,
the active session is visible. To do a full screen split, use the
FSPLIT primary command. Limit: specified in Terminal Option 0.1.
If no split has been done, you can effect a full screen split by simply
pressing [F9] (SWAP).
We refer to all forms of multi-session operation as split screen. Each
session is a complete task that allows you to use all SPF/Pro features and
functions. The session ID, an integer from 1 to N, is displayed after the
product name at the left edge of the title line.
In discussions of split screen, the task where the cursor is located is
called the active task. Any command you issue is applied to the active
task.
Some things you can do with multiple sessions are:
* Edit two files at once, which is useful when you use the editor's
cut-and-paste feature.
* Edit a file in one task and execute a utility program or compiler in
the second task.
* Use an SPF/Pro feature in one task and use the command processing panel
to issue operating system commands from the second.
After you split the screen, use the SWAP command (normally [F9]) to switch
between the tasks.
If you are in horizontal split mode, and one of the sessions is less than
five lines deep, SWAP reallocates the screen so that the active task
always has the greater number of display lines.
If you are in vertical split mode, and one of the sessions is less than
ten columns wide, SWAP reallocates the screen so that the active task
always has the greater number of columns.
After splitting in one mode you can switch to the other mode by simply
issuing the opposite split command.
To change from horizontal split mode to vertical issue the VSPLIT or
SPLITV command.
To change from vertical split mode to horizontal issue the SPLIT command.
To end split screen mode, simply [F3] out, or =X out of either task. The
remaining task will occupy the full screen.
# 5.5 {SPF/Pro Commands}
In previous sections we discussed menus and panels. We will now cover
SPF/Pro commands. This section of the manual introduces three types of
commands, and explains some of the rules for using commands: where to type
them, how to use more than one command, how to stack commands, etc.
# 5.5.1 {Types of Commands}
SPF/Pro commands are classified by where you type them:
* Primary commands are typed in the field labeled COMMAND or OPTION.
These commands affect the panel, the function, the file, or your entire
session.
* Line commands are typed in the input field at the left end of lines in
files or select lists. This input field is called the Line Command
Field. These commands affect a single file or group of files in select
lists, or a single line or block of lines in edit.
You can also execute operating system commands without leaving the SPF/Pro
environment.
# 5.5.2 {Issuing Commands}
General rules for using each type of command are summarized below:
* Primary commands. To issue a primary command, use the mouse or [HOME]
key to move the cursor to the COMMAND or OPTION field. Type in the
command. If the command requires a parameter, or you use an optional
parameter, type it after the command. Press [SPF-Enter].
* Line commands. To issue a line command, use the mouse or cursor keys
to position the cursor to the Line Command Field of the desired line,
type in the command; press [SPF-Enter].
* To operate on a block of lines or group of files, type the desired line
command on the first line in the block; move to the end of the block
(use [F8] or [PG-DN] if necessary); then type the same line command on
the last line in the block; press [SPF-Enter].
* In Edit, ISREDIT macro commands are invoked in the same manner as
primary commands. You can also use the IMACRO feature to execute a
specific macro once at the time the file is opened.
* Operating system commands. These are standard operating system
commands that you normally enter at the operating system command
prompt. To issue an operating system command, use the mouse or [HOME]
key to move the cursor to the command or option line, type in DOS
followed by the command. If the command requires a parameter or you
use an optional parameter, type it after the command. Press
[SPF-Enter].
* PF keys. After you have used SPF/Pro for a while and know which
commands you use regularly, you can assign them to PF keys. Then they
can be executed with a single keystroke.
# 5.5.3 {Command Stacking}
To invoke multiple related commands, enter the commands separated by
semicolon (;), then press [SPF-Enter]. SPF/Pro executes the commands in
the order in which you typed them.
If an error occurs, the command in error remains in the primary command
field.
# 5.6 {Using Your Keyboard With SPF/Pro}
There are a number of single-keystroke functions on your keyboard. Some
of these are standard PC functions, others are unique to SPF/Pro. All are
listed in this section. In all cases the key assignment may be changed
using Option 0.K, Keyboard Mapping.
# 5.6.1 {General Keys}
[SPF-Enter]
This symbol is used throughout SPF/Pro documentation to identify the
equivalent to the 3270 ENTER key. This key activates all SPF/Pro
functions.
This key does not actually exist on any PC keyboard so we use the
following keys to effect [SPF-Enter]:
- For 101 key enhanced keyboard use:
-- Right [CTRL] key, or
-- [ENTER] key on the numeric keypad, or
-- Left [CTRL] + [ENTER] key
- For AT-style keyboard use:
-- key on numeric keypad, or
-- Left or Right [CTRL] + [ENTER] key
To get SPF/PC v. 2.1 style ENTER processing you must select the "SPF/PC
2.1" keyboard scheme in Keyboard Options 0.K. The default setting for
this keyboard differs from the standard 3270 approach in that the
[ENTER] key does newline processing AND 3270-ENTER processing.
[BACKSPACE]
Use this key to move the cursor to the left. The default backspace is
non-destructive. You can assign the destructive form of backspace with
Option 0.K, Keyboard Mapping.
[DEL]
Use this key to delete characters at the cursor; characters to the
right of the cursor are shifted left one position.
Left-[CTRL]
When pressed by itself, the left [CTRL] key performs a 3270 RESET.
[CTRL][DEL]
Use this combination of keys to erase characters from the current
cursor position to the end of the field or line. See 0.1 for an
alternative key configuration for this function.
[INS]
Use this key to toggle insert mode. If insert is on, characters to the
right of the cursor are moved farther to the right as new characters
are typed. Otherwise new characters overlay current characters as they
are typed. If a line or field is full, attempting to insert new
characters causes a beep and an input inhibited indicator in the status
line.
[NUMLOCK]
Use this key to set the shift state of the numeric keypad. The Num
Lock indicator is displayed when numeric lock is on.
[ESC]
Use this key to restore entry fields to their original values. This is
equivalent to an UNDO of the text typed since the last [SPF-Enter].
# 5.6.2 {Traveling Keys}
[ENTER]
Use this key to move from line to line or field to field. If there is
more than one field on a single line, use the [TAB] key to position to
the next field, described below. If the cursor is in the last line or
field, it wraps around to the top of the screen when you press the key.
[HOME]
Use this key to move the cursor to the command/option field. The
CURSOR command also performs this function.
[END]
Use this key to move the cursor to the end of the current field. When
you press the key, the cursor moves to the blank space following the
last character in the field. If the field is blank, the cursor is
positioned at the beginning of the field.
[PG-UP]
Use this key to scroll up toward the top of the file or select list.
The amount of the scroll is determined by the scroll field. [F7] can
also be used to scroll up.
[PG-DN]
Use this key to scroll down toward the bottom of the file or select
list. The amount of the scroll is determined by the scroll field.
[F8] can also be used to scroll down.
[CTRL][PG-UP]
Use this key to scroll to the top of the file.
[CTRL][PG-DN]
Use this key to scroll to the bottom of the file.
[ARROW-UP]
Use this key to move the cursor up. If you set VERTICAL SCROLL W/CURSOR
on Editor Options panel, the screen scrolls in the direction that the
cursor is moving when the cursor reaches the edge of the screen.
[ARROW-DOWN]
Use this key to move the cursor down. If you set VERTICAL SCROLL
W/CURSOR on Editor Options panel, the screen scrolls in the direction
that the cursor is moving when the cursor reaches the edge of the
screen.
[ARROW-LEFT]
Use this key to move the cursor left. If you set HORIZONTAL SCROLL
W/CURSOR on Editor Options panel, the screen scrolls in the direction
that the cursor is moving when the cursor reaches the edge of the
screen.
[ARROW-RIGHT]
Use this key to move the cursor right. If you set HORIZONTAL SCROLL
W/CURSOR on Editor Options panel, the screen scrolls in the direction
that the cursor is moving when the cursor reaches the edge of the
screen.
[ALT][ARROW-LEFT]
Use these keys to move the cursor two characters to the left.
[ALT][ARROW-RIGHT]
Use these keys to move the cursor two characters to the right.
[CTRL][ARROW-LEFT]
Use these keys to move the cursor one word to the left (word jump).
[CTRL][ARROW-RIGHT]
Use these keys to move the cursor one word to the right (word jump).
[TAB]
Use this key to move the cursor to the next tab position in edit or
field in a panel.
[SHIFT][TAB]
This is the backtab key. It works in the opposite direction of the tab
key, moving to the previous tab position or field.
# 5.6.3 {Selection Keys}
[SHIFT]+arrow-key
Use the shift key in conjunction with an arrow key in place of the
mouse to do selections.
Pressing [SHIFT][ARROW-UP] is equivalent to pressing the left mouse
button and dragging the mouse up.
Pressing [SHIFT][ARROW-DOWN] is equivalent to pressing the left mouse
button and dragging the mouse down.
Pressing [SHIFT][ARROW-LEFT] is equivalent to pressing the left mouse
button and dragging the mouse left.
Pressing [SHIFT][ARROW-RIGHT] is equivalent to pressing the left mouse
button and dragging the mouse right.
# 5.6.4 {PF Keys (Enhanced Keyboard)}
[F1]-[F12]
Base PF keys PF1 through PF12.
[SHIFT][F1]-[F12]
The SHIFT form of the base PF keys are used to effect PF13 through
PF24.
[CTRL][F1]-[F12]
The CTRL form of the base PF keys are used to effect PF25 through PF37.
[ALT][F1]-[F12]
The ALT form of the base PF keys are used to effect PF37 through PF48.
# 5.6.5 {PF Keys (AT Keyboard)}
[F1]-[F10]
Base PF keys PF1 through PF10.
[SHIFT][F1]-[F10]
The SHIFT form of the base PF keys are used to effect PF11 through
PF20.
[CTRL][F1]-[F10]
The CTRL form of the base PF keys are used to effect PF21 through PF30.
[ALT][F1]-[F10]
The ALT form of the base PF keys are used to effect PF31 through PF40.
# 5.6.6 {PF Keys, General}
The PF keys can be used to issue an SPF/Pro command in a single keystroke
and without moving to the command field. There is a default set of
SPF/Pro commands assigned to your PF keys. You can change the PF key
mappings any time with the KEYS command.
The default settings of the PF keys are listed below:
3270 Style SPF/PC 2.1
PF1 - HELP HELP
PF2 - SPLIT SPLIT
PF3 - END END
PF4 - RETURN SWAP
PF5 - RFIND RFIND
PF6 - RCHANGE RCHANGE
PF7 - UP UP
PF8 - DOWN DOWN
PF9 - SWAP LEFT
PF10 - LEFT RIGHT
PF11 - RIGHT RETURN
PF12 - RETRIEVE RETRIEVE
PF13 - SCUT n/a
PF14 - SCOPY n/a
PF15 - SPASTE n/a
PF16 - SCREATE n/a
PF17 - SREPLACE n/a
PF18 - STOUPPER n/a
PF19 - STOLOWER n/a
PF20 - SXCLUDE n/a
PF21 - SDELETE n/a
PF22 - n/a n/a
PF23 - n/a n/a
PF24 - n/a n/a
PF25-PF36 Repeat PF1-PF12
PF37-PF48 Repeat PF1-PF12
To execute one of these commands simply press the appropriate PF key (or
combination of [SHIFT], [ALT] or [CTRL] and PF key).
To pass a parameter to a PF key simply type it in the command field, then
press the PF key. For example, if you type 4 in the command field and
then press [F7], it is equivalent to executing the command "UP 4".
# 6. {Directories and Files}
In addition to the familiar services offered by the mainframe based ISPF,
SPF/Pro provides a rich set of enhancements to manipulate files.
You can use SPF/Pro's powerful file management system, to work with
operating system directories and files in ways not available on the
mainframe. File management functions are supported through panels, and
select lists. There is no need to issue operating system commands. Using
select lists you can apply various operations to individual files or
groups of files.
Standard ISPF file list line commands:
* Select
* Browse
* Edit
* Print
* Rename
* Delete
* Move
* Copy
* Information (display properties)
Additional SPF/Pro file list line commands:
* Go (execute program or batch file)
* Tree (create recursive sub-list)
* User (apply user command)
* Convert (one format to another)
* Exclude (prune list)
# 6.1 {Basic BROWSE/EDIT Operation}
* Select Browse or Edit from the Primary Option Panel.
* SPF/Pro displays an entry panel.
* In the PROJECT FILE or SYSTEM FILE SPECIFICATION field enter the fully
qualified path name for the directory containing files that you would
like to operate on. For example,
C:\SOURCE\COBOL\*.COB
* SPF/Pro displays all files that match your specification in a select
list. You can now apply operations to individual files.
* You can use the SORT command to order the list by name, extension,
date, time, size, or attributes.
* You can use the LOCATE command to find specific entries.
* You can use [PG-UP], [PG-DN], [F7], [F8] to scroll the list.
* Select a file to BROWSE or EDIT by placing an "s" in the line command
field of the individual file entry.
To edit a new file, use the SELECT primary command (e.g. "s new-name").
After EDIT, the new file's name is automatically added to the list.
* When you press [SPF-Enter] SPF/Pro invokes BROWSE or EDIT on the
selected file.
* If you issue an S (Select) line command on a subdirectory entry,
SPF/Pro presents a corresponding select list. You can continue to
select subdirectories in this manner as desired all the way down the
subdirectory tree.
* When you complete your operation:
- press [F3] to return to the select list, or
- press [F4] to return to the Primary Option Panel
# 6.2 {Basic UTILITIES Operation}
The UTILITIES function (Primary Option 3) provides additional file
manipulations beyond BROWSE and EDIT.
* Select Utilities (3) from the Primary Option Panel.
* Select File List (4).
* SPF/Pro displays an entry panel.
* You can now perform the same steps as you did for BROWSE and EDIT above
to create a select list of files that you would like to manipulate.
* In the Utilities File List, you place line commands on individual file
entries to perform specific operations.
The Utilities File List duplicates the functions of BROWSE and EDIT.
Operating from the Utilities File List provides a lot of convenience and
we highly recommend it.
# 6.3 {Super Lists}
If you really want to step up in power and flexibility, super lists
provide the most comprehensive set of functions available through a single
interface point.
Super lists extend the Utilities concept in a variety of ways:
* You can create a super list by searching:
- recursively
- across drives
- for a specific text string
- for directories only
- for files only
- for directories + files
in any combination!
* Once you have created a super list, you can:
- add entries via primary command INSERT.
- subtract entries via primary command EXCLUDE.
- preserve entries via primary command INCLUDE (inverse of EXCLUDE).
- create a subset list of files containing a specific text string via
primary command FIND.
- change one string to another in all files in the list via primary
command CHANGE.
- save the list under a symbolic name for later use via primary
command SAVELIST (a micro-project).
* Super lists support the extended line command set.
* Super lists support block operations for all line commands.
* Super Lists maintain the focus after an operation. In ISPF if you P
(print) a file, after the print is complete, the list is scrolled to
place the printed file entry at the top and the cursor is placed in the
primary command field. In Super Lists, the list is not scrolled and
the cursor remains in place.
* To eliminate ISPF style audit trails in select lists go to Option 0.6,
set CLEAR LISTS = Y. Example: if you delete a file, instead of
flagging the entry with "DELETED", the entry is simply deleted from the
list.
* To enable full super list line command set in all select lists go to
Option 0.6, set EXTENDED LINE COMMANDS = Y.
# 6.4 {Popup Menu}
For convenience, a popup menu containing the most frequently used select
list line commands is available with a click of the right mouse button.
For a operation on a single entry in the list, simply move the mouse
cursor to the desired entry, click the right mouse button, and select the
desired operation.
To operate on multiple entries, move the mouse cursor to the first entry,
click the left mouse button once to highlight the entry, move to the last
entry in the block, click the right mouse button to complete the selection
and display the popup menu. Select the desired operation with a single
click of the left mouse button.
# 6.5 {Entry Panel}
The Printer Characteristics panel is a typical example of most entry
panels. Browse, Edit, and Utility entry panels look slightly different,
but all use the same file specification rules.
As previously stated, you can use the file specification fields to select
a single file, a group, or an entire directory.
SPF/Pro entry panels have two places to type a file specification. These
two forms give you maximum flexibility in identifying the file you want to
work with.
The PROJECT FILE field allows you to type a file specification in a
structured format.
Unlike standard operating system file specifications, the PROJECT FILE
begins in the root directory regardless of the operating system current
directory.
On any PATH field you can enter multiple path elements separated by a
backslash. You can also type path elements without an initial backslash.
In all cases SPF/Pro insures that the path specification you enter begins
with backslash and does not end with backslash.
The project file fields can be displayed either vertically (the default)
or horizontally depending on the setting of File List Options 0.6. The
two forms are displayed below:
PROJECT FILE:
DRIVE ===> c:
PATH ===> \a
PATH ===> \b
PATH ===> \c
NAME ===> *.cob
PROJECT FILE:
DRIVE ===> c:
PATH ===> \a PATH ===> \b PATH ===> \c
NAME ===> *.cob
There is an implied backslash preceding the NAME field's contents; it
is never displayed.
The following example shows how you can move back and forth between the
program source of two related versions with a difference of one keystroke
(v1 vs. v2) in the file specifications:
PROJECT FILE: PROJECT FILE:
DRIVE ===> c: DRIVE ===> c:
PATH ===> \v1 PATH ===> \v2
PATH ===> \src PATH ===> \src
PATH ===> PATH ===>
NAME ===> *.cob NAME ===> *.cob
You can also request different subdirectories in a similar way. Changing
the second PATH field from \src to \doc, for example, would give you
access to the project documentation files.
PROJECT FILE: PROJECT FILE:
DRIVE ===> c: DRIVE ===> c:
PATH ===> \v1 PATH ===> \v1
PATH ===> \src PATH ===> \doc
PATH ===> PATH ===>
NAME ===> *.cob NAME ===> *.doc
Within a subdirectory the file subset is also easily changed. For
example, in the NAME field, a "C" program's source is accessed with *.c;
its data structures with *.h.
PROJECT FILE: PROJECT FILE:
DRIVE ===> c: DRIVE ===> c:
PATH ===> \v1 PATH ===> \v1
PATH ===> \src PATH ===> \src
PATH ===> PATH ===>
NAME ===> *.c NAME ===> *.h
You can also specify two or more file types in the NAME field separated by
semicolon or comma. For example:
PROJECT FILE:
DRIVE ===> c:
PATH ===> \v1
PATH ===> \src
PATH ===>
NAME ===> *.c;*.h
See page 31 for details on other advanced forms of file specification.
* If you want to specify the file in operating system command line form,
use the SYSTEM FILE SPECIFICATION field. Unlike the PROJECT FILE, if
you do not begin with an initial backslash, the file name is the
concatenation of the current directory and your specified name.
The SYSTEM FILE SPECIFICATION takes precedence over the PROJECT FILE.
* SPF/Pro displays the current drive and directory in the SYSTEM CUR DIR
field.
* If you leave other fields blank, and press [SPF-Enter], SPF/Pro
displays a select list for the current directory.
* You can create new files from an entry panel by typing the new file
name in either of the two file specification fields.
* You can create a new file from the Select List for Edit by typing s
newname in the COMMAND field and pressing [SPF-Enter].
# 7. {Primary Options}
SPF/Pro is accessed via a series of menus. The menus are organized in a
tree form. The first menu in the tree is the Primary Option Panel.
The Primary Option Panel is a Selection Menu. Selection Menus have
multiple choices indicated by buttons on the left with numbered or
lettered identifiers followed by descriptive text. We call these choices
Options. To activate an Option, either click on the desired button, or
type the Option identifier into the OPTION field and press [SPF-Enter].
Picking an Option presents a lower level panel which in turn may cause an
operation on a file or create a list of files which may be operated upon.
The Primary Options are described below:
0 - SPF PARMS
Allows you to set SPF/Pro start up parameters, program function key
definitions, run time parameters, and file profiles. It is a good idea
to review these items before working extensively with SPF/Pro.
1 - BROWSE
Allows viewing of a file without modifying it.
2 - EDIT
Allows viewing and modification of a file.
3 - UTILITIES
Provides select lists and file functions such as rename, delete, move,
copy, and print.
4 - FOREGROUND
Allows you to set up compilers, utilities or other programs as user
applications and execute them synchronously from within SPF/Pro.
Control returns to the current panel when user program execution is
complete.
5 - BACKGROUND
Allows you to set up compilers, utilities or other programs as user
applications and execute them asynchronously from within SPF/Pro. The
user program is launched as a peer of SPF; control returns immediately
to the current panel.
6 - COMMAND
Allows execution of operating system commands and programs from within
SPF/Pro.
7 - DIALOG TEST
Provides a test harness for Panel Definitions, REXX macros, and a
display facility for variables.
A - APPLICATIONS
This option provides access to the Custom Dialogs for Micro Focus, and
XDB.
C - CHANGES
Provides a summary of changes in the current release.
T - TUTORIAL
Displays information to assist you in using SPF/Pro. You can also
reach this information by pressing [F1] at any time.
X - EXIT
Exits SPF/Pro and returns to the operating system command prompt.
In most cases, selecting an Option takes you to a secondary menu. Each
time you make a selection you move one level deeper in the menu tree until
you reach the desired function.
After you use a specific function, you may:
* return to the next higher level by entering the END command (normally
[F3]).
* return directly to the Primary Option Panel by entering the RETURN
command (normally [F4]).
* return directly to the operating system prompt by entering =x in the
command field and press [SPF-Enter].
# 8. {Parameter Options (Option 0)}
SPF/Pro is a very flexible system. You can alter many of its operating
characteristics through Primary Option 0, SPF/Pro PARMS. The parameters
controlling SPF/Pro are logically divided into major functional areas:
* Display and keyboard (Option 0.1).
* Printer destination and formatting characteristics (Option 0.2).
* PF key definitions (Option 0.3).
* Display characteristics (Option 0.4).
* Editor options (Option 0.5).
* File List options (Option 0.6).
* File Profiles (0.7)
* Paths (0.8)
* Concurrent (Option 0.C)
* Environment (Option 0.E)
* Fonts (Option 0.F)
* Keyboard Mapping (Option 0.K)
* Keyboard Macros (Option 0.M)
There are two basic ways to access the parameter panels:
* When you start SPF/Pro, the first screen it presents is the Primary
Option Panel. If you want to work with the SPF/Pro parameters, select
option 0, SPF/Pro Parameter Options. SPF/Pro responds by displaying the
SPF Parameter Options menu.
* At any time, you can use the "jump" feature to move directly to the
parameter options. Move to the command line, type equal (=) and the
option number (e.g. =0.5), then press [SPF-Enter].
# 8.1 {Terminal Characteristics (Option 0.1)}
Panel 0.1 displays basic characteristics of your keyboard and display and
allows you to alter some of them. This information tells SPF/Pro how you
want to handle the display and keyboard.
SPF/Pro obtains much of the information it needs from the operating
system. Some entry fields on the panel prompt you for additional
information. For example, you identify the character you want to use as a
command delimiter when issuing a string of commands.
Individual fields are explained below:
USER ID
This field allows you to set up the user ID that SPF/Pro displays on
the Primary Option Panel. This is an informational field, it has no
effect on processing.
COMMAND DELIMITER
Type in the character that you want to use to separate stacked
commands. This character separates commands in a command string. The
default is a semicolon (;), which should only be changed with due
consideration.
PERSISTENT INSERT
If YES is specified, the insert state is not reset when [SPF-Enter] is
pressed.
If NO is specified, the insert state is reset when [SPF-Enter] is
pressed.
SCROLL BARS
If YES is specified, scroll bars are displayed for tables, browse, and
edit.
If NO is specified, scroll bars are not displayed for tables, browse,
and edit.
MAX CONCURRENT TASKS
Specifies the maximum number of SPF/Pro sessions that can be active at
any given time. New sessions are created by SPLIT, FSPLIT, SPLITV, and
VSPLIT primary commands.
DISPLAY TIME/DATE
Specifies whether time, date, or both are to be displayed on the status
line at the bottom of the display.
PFSHOW Enable
Specifies whether PFSHOW display should be enabled. Specify "Y" or
"N".
PFSHOW Display Mode
Specifies which PF key set is to be displayed as the first line of the
PFSHOW bar.
- Specify "N" for NORMAL (PF1 - PF12)
- Specify "S" for SHIFT (PF13 - PF24)
- Specify "C" for CTRL (PF25 - PF36)
- Specify "A" for ALT (PF37 - PF48)
PFSHOW Lines
Specifies the number of display lines in the PFSHOW bar. Each line
displays twelve PF keys.
Cursor Insert Size
Specifies the size of the text cursor when SPF/Pro is in insert mode.
The size is expressed as a percentage from 1% to 100% where 100% is the
largest available size. If 0 is specified, the SPF/Pro default is
used.
Cursor Overtype Size
Specifies the size of the text cursor when &PRODUCT is in overtype
mode. The size is expressed as a percentage from 1% to 100% where 100%
is the largest available size. If 0 is specified, the SPF/Pro default
is used.
Cursor Orientation
Specifies how the text cursor is to be oriented. Specify "V" for
vertical orientation. or "H" for horizontal orientation.
Note: Using other than default values for the cursor is only
recommended for notebook computers where cursor visibility may not be
as good as a traditional monitor.
Press [F3] to effect changes and return to the SPF Parameter Options menu.
# 8.2 {Printer Characteristics (Option 0.2)}
Panel 0.2 allows you to create multiple printer configurations which can
be used to perform different printing roles. Printer setups are
symbolically named. DEFAULT, the default, typically performs no formatting
functions and is routed to logical device PRN.
The following line commands are supported. Enter the line command to the
left of the list entry, then press [SPF-Enter].
S - select existing printer setup
E - edit existing printer setup
C - copy existing printer setup
You can also use one of the following primary commands to operate on the
printer setup:
S setup-name (select existing setup)
LPRINT setup-name (select existing setup)
E new-setup-name (edit a new setup)
When you END or [F3], the new definition is saved.
Fields of the printer setup dialog are described below:
PRINTER DESCRIPTION
Optional. A brief description of this printer's characteristics for
your reference. This description is presented to the right of the
logical printer name in the printer setup select list.
SETUP
The SETUP button invokes the Common Printer Connection Dialog of the
operating system. This dialog connects the SPF logical printer to a
specific system printer.
SELECT FONT
The SELECT FONT button invokes the Common Font Selection Dialog of the
operating system. This dialog sets the font which is to be used by this
print setup.
Note: Page depth in lines is automatically adjusted to correspond to
the font selection. The smaller the font, the more lines will fit and
vice versa.
FORM FEED:
Optional. Specifies whether and when form feeds should be produced.
INITIAL
Specifies whether an initial form feed is sent to the printer prior
to page one. This is normally not needed.
FINAL
Specifies whether a final form feed is sent to the printer after the
last page. This is normally not needed.
INTER
In the event that there is more than one page, you may specify that
an intermediate form feed be generated between pages. When pages are
printed to capacity (typically 66 lines), the intermediate form feed
is not required as the page is advanced when the page depth plus one
line prints. Some printers (HP LaserJet series) advance full pages
and treat an intermediate form feed as an ADDITIONAL page eject. In
this case you do not want to generate intermediate form feeds.
MARGINS:
Optional. Specifies page margins. If any margins are specified, the
PAGE parameter must be specified.
TOP
Specifies the number of blank lines to print before the header or
any body text is printed.
Note: SPF reserves a small amount of space at the top of the page
to accomodate the fact that laser printers disallow print access to
that area. The result is that the topmost printed line with TOP=0
prints slightly below the top edge of the physical sheet.
BOTTOM
Specifies the number of blank lines to print after the body text
and/or footer is printed. Normally 3 lines = .5 inch. If you
request intermediate form feeds, there is no need to print the page
to full capacity.
Note: SPF reserves a small amount of space at the bottom of the
page to accomodate the fact that laser printers disallow print
access to that area. The result is that the bottommost printed line
with BOTTOM=0 prints slightly above the bottom edge of the physical
sheet.
LEFT
The number of columns to reserve on the left edge of the page before
each line of text. Normally 10 columns = 1.0 inch.
The left margin is applied to header/footer and body text.
RIGHT
The number of columns to reserve on the right edge of the page after
each header/footer line of text. Normally 10 columns = 1.0 inch.
The right margin is only applied to header and footer text; not to
body text. Body text lines are allowed to print over the right
margin.
HEADER:
Optional. Specifies the elements to be included in the page header.
PARTS
This field lets you specify a variety of text elements that may be
included in the page header. The page header is printed below the
top margin and above the body text.
Header text elements are:
-- NAME, if printing a file, the file name
-- TIME, the current time
-- DATE, the current date
-- PAGE NUMBER, the physical page number
Header text elements are specified as one or more characters. For
example, to get the file name in the header specify "n". Up to four
text elements (all possibilities) may be specified. For example, to
get name, data, time, and page number, specify "ndtp".
ALIGN
Specifies the text alignment for the header text. The header text
alignment choices are:
-- LEFT, all parts of the header text are set flush left.
-- CENTER, all parts of the header text are centered.
-- RIGHT, all parts of the header text are set flush right.
-- SPREAD, the space remaining on the header line is evenly
distributed between the parts in such a way that they fill the
space available between the left and right margins.
SPACE
The number of blank lines to print immediately below the page
header.
FOOTER:
Optional. Specifies the elements to be included in the page footer.
PARTS
Same as the page header but the page footer is printed below the
body text and footer space.
ALIGN
Same as the page header but the alignment is applied only to the
footer text.
SPACE
The number of blank lines to print immediately above the page
footer.
# 8.3 {PF Key Definitions (Option 0.3)}
Panel 0.3 displays the current settings of the PF keys and allows you to
change them. You can also specify labels to be displayed when keys are
displayed with PFSHOW.
You change a PF key definition by typing over the current definition.
Primary commands are typed as-is; line commands are prefixed with a colon
(:); literal data strings are enclosed in single quotes.
PFSHOW labels are typed into the LABPFnn fields at the bottom of the KEYS
panel. If no labels are specified, the PFSHOW label is the first eight
characters of the PF key value. For example, "F1=HELP"
The sample panel above shows the initial settings for your keys, which
give you one-keystroke access to some frequently used general commands.
The initial settings are all primary commands; you can also use line and
macro commands. 1
The initial settings for keys beyond PF12 repeat PF1-PF12 settings. You
can modify these definitions as desired without affecting the definitions
for PF1-PF12.
Some of the ways in which changing key functions or adding new functions
can make your editing faster and more efficient are listed below:
* Set up PF keys to execute frequently used commands in one keystroke.
* Rearrange keys (move functions from one key to another) to help you
remember the functions or reach the keys more easily.
* Set a series of keys to perform related complex operations in different
ways depending on results of a previous operation. An example of this
is RFIND ([F5]), RCHANGE ([F6]).
* Create macro commands to perform arbitrarily complex operations and
assign them to PF keys.
PF keys are applied to the active panel. Not all commands accessed via PF
key may operate in all contexts. For example, editor line commands only
operate in the Edit File Display.
Changes to PF key definitions are applied when you press [SPF-Enter].
When a command is executed via PF key, the primary command field value, if
present, is passed to the command as a parameter. For example, type 5 in
the primary command field, then press [F7]. This is the equivalent of
entering the primary command "up 5".
# 8.3.1 {3270 Style PF Key Definitions}
The initial settings for PF keys [F1] to [F12] are briefly defined below.
The initial assignments are primary commands; you can execute all of them
from the primary command field.
[F1] HELP, present context sensitive help panel or long message.
[F2] SPLIT, split the screen, start another SPF/Pro session.
[F3] END, end the current function, return to the previous panel.
[F4] RETURN, end current function, return to the Primary Option Panel.
1. The appearance of the panel depends on the keyboard.
[F5] RFIND, repeat the last FIND primary command.
[F6] RCHANGE, repeat the last CHANGE primary command.
[F7] UP, scroll up by scroll field amount. Same as [PG-UP].
[F8] DOWN, scroll down by scroll field amount. Same as [PG-DN].
[F9] SWAP, swap to the other split-screen session.
[F10] LEFT, scroll left by scroll field amount.
[F11] RIGHT, scroll right by scroll field amount.
[F12] RETRIEVE, retrieve and display the last primary command.
# 8.3.2 {Mouse Selection Operations}
The shifted PF keys are set up to do operations on the current selection.
This mapping is for your convenience. Feel free to re-assign these keys as
you see fit for your own use.
[SHIFT][F1] SCUT, Copy the current selection to the clipboard, then delete
it from the file.
[SHIFT][F2] SCOPY, Copy the current selection to the clipboard.
[SHIFT][F3] SPASTE, Paste the contents of the clipboard at the current
cursor position. The pasted data is always inserted. The contents of the
clipboard are unchanged.
[SHIFT][F4] SCREATE, Create a new external file from the contents of the
current selection.
[SHIFT][F5] SREPLACE, Replace an existing external file with the contents
of the selection.
[SHIFT][F6] STOUPPER, Convert the alpha characters in the current
selection to uppercase.
[SHIFT][F7] STOLOWER, Convert the alpha characters in the current
selection to lowercase.
[SHIFT][F8] SXCLUDE, Exclude all lines touched by the current selection.
[SHIFT][F9] SDELETE, Delete the current selection from the file.
[SHIFT][F10] SPRINT, Print the current selection.
# 8.3.3 {Changing PF Key Definitions}
You can use a PF key to execute an SPF/Pro general command, edit primary
command, edit line command, or edit macro command. As mentioned above,
you set up a key to execute a command by typing the command on the PF Key
Definitions panel. The rules for typing in each type of command are
covered below:
* To assign a general command, an edit primary command, or a macro
command to a function key, simply type in the command name.
* To assign a line command to a function key, type in a colon (:)
immediately followed by the line command name.
* To assign string type data to the key, enclose the string in single
quotes.
* To reset the assignment to the default value, clear the field then
press [SPF-Enter].
Changes to PF key assignments are immediately reflected in the PFSHOW
display if present.
Press [F3] to return to the SPF Parameter Options menu.
# 8.4 {Color Definitions (Option 0.4)}
Panel 0.4 allows you to create multiple color schemes which can be used
for different purposes. Each color scheme is named. Only one is active at
any given time.
The following line commands are supported. Enter the line command to the
left of the list entry, then press [SPF-Enter].
C - copy an existing color scheme
D - delete an existing color scheme
E - edit an existing color scheme
R - rename an existing color scheme
S - select an existing color scheme
Use the following primary command to create a new color scheme:
S new-name
When a new color scheme is created, it is initialized to the values of the
active color scheme.
Use these panels to set colors for all SPF/Pro menus and panels.
SPF/Pro menus and panels are divided into multiple color zones. Each color
zone has a FOREGROUND and BACKGROUND color. A color zone is determined by
the context of the text in the zone, not by its location on the screen.
All text and symbols with the same context are displayed in the same
color. You can assign any color combination to any zone.
The following points should be considered when setting colors:
* Assigning the same color to FOREGROUND and BACKGROUND makes text
invisible (e.g. black on black); SPF/Pro does not allow this.
* On a monochrome monitor this feature can control the location of normal
and highlighted text. On gray-scale monitors it can control the level
of gray assigned to different types of text.
The GOTHAM color scheme is specifically designed for use on monochrome
displays. It is comprised of varying levels of grey to achieve
attractive results in the limited environment.
The names and functions of color zones are defined below:
PROTECTED NORMAL
Specifies the colors for protected areas which are used to display
characters that identify panel and display information. The "normal,"
or low-intensity protected areas are used for such items as the names
of display and input fields, and system-generated values in display-
only fields.
PROTECTED HIGH
Specifies the colors for the high-intensity protected areas which are
used for items that define the panel format: the panel title, the
command line, SPF/Pro messages, and the arrows that mark input and
display fields.
UNPROTECTED NORMAL
Specifies the colors for unprotected areas which are used to display
characters you type in, including characters you have already typed.
The "normal," or low-intensity unprotected areas are used for your
normal working area, such as text or code and line numbers on an edit
panel.
UNPROTECTED HIGH
Specifies the colors for the high-intensity unprotected areas which are
used where you interact directly with SPF/Pro, such as the filename
fields on entry panels, the scroll at the top of edit, browse, and
select lists, and the command line.
SHORT/LONG MESSAGE
Specifies the colors for the short message which is displayed in the
upper right corner of any panel. The long message is displayed on the
third display line of the panel.
SHORT/LONG MESSAGE WITH ALARM
Specifies the colors for the short message which is displayed in the
upper right corner of any panel. The long message is displayed on the
third display line of the panel.
BROWSE TEXT
Specifies the colors for the text area of the browse function.
EDIT TEXT
Specifies the colors for the text area of the edit function.
TOP/BOTTOM OF DATA TEXT
Specifies the colors for the Top of Data and Bottom of Data lines.
NOTE LINES
Specifies the colors for note lines.
MSG LINES
Specifies the colors for message lines.
INSERT LINES
Specifies the colors for insert lines.
PROF LINES
Specifies the colors for profile lines.
LINE COMMANDS
Specifies the colors for the line command field when any character is
typed in.
LINE LABELS
Specifies the colors for line labels.
LINE NUMBERS
Specifies the colors for line numbers.
LINE TYPE MARKERS
Specifies the colors for line type indicators such as "MSG", "NOTE",
etc.
LINE ACTIVE INDICATOR
Specifies the colors for the active line. The active line is
established by FIND and LOCATE primary commands and by software
tabbing.
SELECTED TEXT
Specifies the colors for text which is selected with the mouse in
BROWSE or EDIT, and text which is highlighted by FIND or CHANGE.
COLORIZATION WORD CLASS 1
Specifies the colors for class 1 programming language elements defined
in the active .CLR file.
COLORIZATION WORD CLASS 2
Specifies the colors for class 2 programming language elements defined
in the active .CLR file.
COLORIZATION WORD CLASS 3
Specifies the colors for class 3 programming language elements defined
in the active .CLR file.
COLORIZATION WORD CLASS 4
Specifies the colors for class 4 programming language elements defined
in the active .CLR file.
COLORIZATION SOURCE STRINGS
Specifies the colors for literal strings in program source.
COLORIZATION SOURCE COMMENTS
Specifies the colors for comments in program source.
COLORIZATION SPECIAL CHARACTERS
Specifies the colors for individual special characters in program
source.
Press [F3] to return to the SPF Parameter Options menu.
# 8.5 {Editor Options (Option 0.5)}
Panel 0.5 lets you specify a number of options that affect the general
operating characteristics of SPF/Pro. The fields on the panel are listed
and explained below:
SOUND ALARM
Indicate whether you want the alarm (beep) to sound when SPF/Pro issues
an error message:
Y
Specifies that SPF/Pro is to beep when it issues an error message.
N
Specifies that SPF/Pro is not to beep when it issues an error
message.
VERTICAL SCROLL WITH CURSOR
Indicate whether you want your cursor to cause vertical scrolling:
Y
Specifies that SPF/Pro is to scroll up or down by one when the
cursor reaches the top or bottom of the screen. This is typical for
PC systems.
N
Specifies that the cursor is to wrap to the opposite edge when it
reaches the top or bottom of the screen. This is typical of
3270-type terminals.
HORIZONTAL SCROLL WITH CURSOR
Indicate whether you want your cursor to cause horizontal scrolling:
Y
Specifies that SPF/Pro is to scroll left or right by one when the
cursor reaches the left or right edge of the screen. This is
typical for PC systems.
N
Specifies that the cursor is to wrap to the opposite edge when it
reaches the left or right edge the screen. This is typical of
3270-type terminals.
MAX RECORD LENGTH
Specifies the nominal maximum record length for any records that may be
handled. Set this value to the longest record you expect to process.
The smaller the default maximum is, the more efficiently SPF/Pro will
run. All internal buffers used to handle records are allocated at the
maximum record length.
When loading data delimited records from normal DOS text files, EDIT
examines the length of each variable length record. If it is the
longest record read, the maximum record length allowed is automatically
increased up to the limit set here by MAX RECORD LENGTH.
RECENT EDIT DEPTH
Specifies the depth of the Recent Edits file list which is accessed via
Utility function 3.H. The minimum depth is 1; the maximum is 99; the
default is 16.
SYNTAX COLORIZATION
Specifies whether program source should be colorized or not. This is a
global setting. In addition to enabling colorization here, it is also
necessary to bind a language colorization file (.CLR) to a particular
file type and set a color scheme which defines which colors apply to
the different classes of language elements.
Y
Program source colorization is globally enabled.
N
Program source colorization is globally disabled.
AUTOMATIC PROFILE CREATE
Indicate whether you want SPF/Pro to create profiles automatically.
Y
Create profiles automatically. If not already present, a profile is
created when a profile variable is altered.
N
Do not create profiles automatically under any circumstance.
VIRTUAL LOAD
Specifies the method of file loading to be used. Virtual loading loads
a small portion of the file and then displays the first frame. This
provides the effect of "instant" loading even on very large files.
A
Specifies that virtual loading is ALWAYS used.
E
Specifies that virtual loading is used with EDIT only.
B
Specifies that virtual loading is used with BROWSE only.
N
Specifies that virtual loading is NEVER used.
FIND/CHANGE SEARCH TYPE
Indicate whether you want case-sensitive or case-insensitive searches
when you issue a FIND, CHANGE, or EXCLUDE primary command.
Whichever you select, you can request the other type explicitly when
you issue the command.
C
Specifies that text searching is to be case-sensitive. Character
search mode matches your string exactly as entered, including
upper/lower case.
T
Specifies that text searching is to be case-insensitive. Text
search mode matches your string with any case character in any
position.
EDIT READ-ONLY FILES
Specifies whether you want to be able to edit read-only files. In this
case edit loads the file and allows all functions of EDIT to operate in
the normal manner but will not allow you to save the file. This is
handy when you want to examine a file which has the read-only attribute
and you want to perform operations which are not available in BROWSE.
Y
Allow edit of read-only files.
N
Don't allow edit of read-only files.
SCROLL NOTELINES
Specify whether NOTE lines are to scroll with the adjacent text or be
static while text scrolls past them.
Y
Specifies that NOTE lines are to scroll.
N
Specifies that NOTE lines are not to scroll.
UNDO ENABLE
Specifies whether UNDO support is to be active. When UNDO support is
active more memory is used to record edit transactions that may later
be undone. In a memory constrained system you may want to disable UNDO.
Y
Activate UNDO support.
N
Deactivate UNDO support.
ABEND RECOVERY ENABLE
Specifies whether abnormal termination recovery procedures should be
activated. Abnormal termination recovery gives you an opportunity to
save work in progress before SPF terminates.
Y
Activate ABEND recovery.
N
Deactivate ABEND recovery.
Press [F3] to return to the SPF Parameter Options menu.
# 8.6 {File List Options (Option 0.6)}
Panel 0.6 lets you specify a number of options that affect the general
operating characteristics of SPF/Pro. The fields on the panel are listed
and explained below:
CLEAR LISTS
Indicate whether you want ISPF style audit trail of file actions in
select lists or not:
Y
Clear standard ISPF file action indicators in select lists. For
example, a deleted file simply drops out of the list.
N
Present standard ISPF file action indicators in select lists. For
example, a deleted file is marked "< DELETED >".
CONFIRM DELETE OF FILES
Indicate whether you want a delete confirmation panel presented any
time you delete a file from a select list:
Y
Present a delete confirmation panel before deleting a file.
N
Do not present a delete confirmation panel before deleting a file.
EXTENDED LINE COMMANDS
Indicate whether you want the extended line command set to be available
in all select lists.
Y
Make all extended line commands available in all select lists.
N
Extended line commands are only available in 3.x select lists.
DEFAULT DIRECTORY SEQUENCE
Specifies the sort sequence for select lists:
*
Files are presented in the same order as they are maintained in the
system directory. Same as operating system DIR command.
N
Sort files by NAME. This option produces ISPF/PDF style select
lists.
E
Sort files by EXT.
S
Sort files by SIZE.
D
Sort files by DATE (TIME field is also sorted). The sort is in
descending time order, most recent first.
Note: All sort sequences except "*" present subdirectories together at
the top of the list.
Note: You can also sort the select list with the SORT primary command.
SHOW HIDDEN/SYSTEM FILES
Specifies whether files with the hidden or system attribute should be
displayed in directory lists.
Y
Show all files regardless of attributes.
N
Show all files except files with hidden or system attribute.
SORT DIRS TO TOP
In select lists you can have both files and sub-directories. This
option specifies that all directory type entries be displayed together
at the top of the list.
Y
Display all directories together at the top of the list.
N
Display directories in the order they naturally occur.
LIST PATHS HORIZONTALLY
Specifies how path fields are to be displayed in panels which contain a
PROJECT FILE section.
Y
Array the three elements of the path field horizontally.
N
Array the three elements of the path field vertically.
EXPAND VARS
Specifies whether to expand Ampersand (&) and Percent (%) type
variables in file name specifications.
Y
Expand the variables.
N
Do not expand the variables.
Press [F3] to return to the SPF Parameter Options menu.
# 8.7 {File Profiles (Option 0.7)}
# 8.7.1 {Profile Select List}
Panel 0.7 lets you access individual file profiles from a select list.
Each file profile is stored in directory SPFPRO\PROFILES. Profiles are
named extension.PRF corresponding to the various file extensions that you
work with. Files without an extension use profile NULL.PRF.
The following line commands are supported. Enter the line command to the
left of the list entry, then press [SPF-Enter].
C - copy an existing entry
D - delete an existing entry
R - rename an existing entry
S - edit an existing entry
To create a new entry, use the following primary command:
S new-name
SPF/Pro allows you to apply special treatment to different classes of
files based on the file type (file extension). For example,
* .COB files might be comprised of fixed length records of 80 characters.
On an IBM mainframe this would be DSORG=F, LRECL=80.
* .C files might be variable length records delimited by a special escape
sequence like CR/LF per the operating system stream file convention.
* Other files downloaded from a mainframe might contain binary data which
requires special input processing.
|