Professional Documents
Culture Documents
ISPF Training by EDS
ISPF Training by EDS
ISPF
Template Control: GSMS Portrait Styling Template Template Version 2.0 -- Approval Date 28, October, 2002
Saved 27 December, 2003 Page 1 of 63
C:\fileaid\ISPF_Training_EDS.doc
ISPF Training Material
Amendment History - Document Status (e.g. Draft, Final, Release #): Initial Release
WHAT IS ISPF?
Consider the Interactive System Productivity Facility (ISPF) program product an extension of the MVS
Time Sharing Option (TSO) host system on which it runs. ISPF services complement those of the host
system to provide interactive processing. ISPF is similar to a control program or access method in that it
provides services to dialogs (applications) during their execution. The types of services provided by ISPF
are:
Display services
File-tailoring services
Variable services
Table services
Miscellaneous services
o Setting breakpoints
A dialog receives requests and data from a user at a terminal. The dialog responds by using ISPF
services to obtain information from, or enter information into, a computer system.
WHAT IS A DIALOG?
To understand the dialog interface, you must first understand what a dialog is. A dialog is the interaction
between a person and a computer. It helps a person who is using an interactive display terminal to
exchange information with a computer.
The user starts an interactive application through an interface that the system provides. The dialog with
the user begins with the computer displaying a panel and asking for user interaction. It ends when the task
for which the interactions were initiated is completed.
A dialog developer creates the parts of a dialog, called dialog elements. Each dialog application is made
up of a command procedure or program, together with dialog elements that allow an orderly interaction
between the computer and the application user.
Functions
Variables
Command tables
Panel definitions
Message definitions
File-tailoring skeletons
Tables.
A dialog does not necessarily include all types of elements, particularly tables and skeletons, which certain
kinds of applications do not use.
You can use ISPF to simplify the programming that provides interactive application operations. Operations
performed during dialog execution include:
o Prompting the user to enter new data and verifying that data
o Processing or storing the user's data, then advising the user of its disposition
Providing online messages, help, and tutorial displays to help users understand application
processing.
DEVELOPING A DIALOG
A developer, using an editor such as the PDF editor in Option 2 of ISPF, develops a dialog by creating its
various elements at a terminal and storing them in libraries. You can use any available editor when
creating dialog elements.
However, in addition to an editor, ISPF provides special facilities to aid dialog development. Examples of
these facilities are:
Edit models for messages, file-tailoring skeletons, panels, and DTL source
Library access services for accessing both ISPF libraries and other data sets.
Panel definitions, message definitions, and file-tailoring skeletons are created prior to running the dialog.
These dialog elements are saved in libraries. The developer stores the program (after compilation) or
command procedure in an appropriate system program library. During dialog testing, tables of data, log
entries, and file-tailoring output data sets can be created by dialog processing. ISPF creates the log data
set the first time the user performs some action that results in a log message, such as saving edited data
or submitting a job to the batch machine. ISPF creates the list data set the first time a user requests a
print function or executes a dialog that issues a LIST service request.
When the developer completes the functions, panel definitions, and any other dialog
elements required by the application being developed, the dialog is ready to be
processed under ISPF.
o How to use ISPF PFSHOW and FKA (function key area) commands
And More…
To begin your ISPF session, after the TSO Ready prompt, type:
ISPF
or type:
Then press Enter. ISPF and PDF are the default command names.
Figure 1 shows the standard ISPF Primary Option Menu. Type FKA ON to view all of the function keys for
the panel.
Notes:
1. The placement of the Command Line and the appearance of both the messages and function keys
can be specified in Option 0, "ISPF Settings."
The CUA (Common User Access) guidelines define the appearance of panels and the interaction
style for the SAA user interface. Besides moving the Command line, the CUA interaction style
supports the use of both the Dialog Tag Language (DTL) and ISPF panel definition language
when creating panel and message definitions.
If you prefer to see the Command line at the top of the screen, do not select the Command line at
bottom field.
2. ISPF product panels display short messages in the upper-right corner of the panel, or in association
to a field in error. Long messages are displayed directly below the Command or Option line if it is at
the top of the panel, directly above the Command or Option line if it is at the bottom of the panel, or
in association to a field in error.
GETTING HELP
You might have questions about a menu, action bar, or pull-down choice after you have looked at the
short and long messages. On most panels, panel-specific help is available on the action bar.
Figure 2 shows the help topics that appear when you select Help on the
ISPF Primary Option Menu action bar.
Figure 2. Help Topics Pull-down Menu on Primary Option Menu Action Bar
(ISR@PRIM)
Within help, select the option you need from the pull-down or menu. When you have finished reading the
information, use F12 to back up a panel, or F3 to exit to the panel from which you first entered Help.
Before you start working with ISPF, you should know the operation of your function keys. Use the
PFSHOW and FKA (function key area) commands to display function key values on your terminal screen
for easy reference.
The function keys on your terminal have default settings provided by ISPF. You do not have to use the
function keys at all while you use the products, but they do make it easier to perform certain tasks.
To show all function keys, type PFSHOW or FKA on either a Command line or an Option line and press
Enter.
The first time you type either of these commands, you see all of the function keys displayed on the panel.
The partial screen in Figure 3 illustrates a typical display of function keys where Panel display CUA
mode is selected in Option 0, and Keylists are on.
If you type either of the commands again, you change the function keys displayed to only those that you
defined as being on a short list of keys. If you type the command a third time, the keys do not display at
all. As you can see, the commands work like a toggle. However, at any time, you can turn off the displayed
keys by typing either pfshow off or fka off on either a Command line or an Option line and pressing Enter.
Pressing a function key has the same effect as typing the command on the Command line and pressing
Enter. For instance, if a panel gives directions like this:
Enter the END command to terminate. you get the same result (termination) whether you type the word
END and press Enter, or press F3.
ISPF uses a library structure to name and organize data sets. This naming structure is similar to that used
for TSO partitioned data sets: a three-part name, with member names following in parentheses. The parts
of the ISPF library name are:
project.group.type
Before you can create a member of an ISPF library, you must allocate the library. This is a different
allocation from that which pairs a data set with a DDNAME that the operating system can recognize.
This allocation defines storage space for data sets or ISPF libraries so you can then use Edit (option 2) to
create and update them.
1. Select Utilities (option 3) from the ISPF Primary Option Menu or from
the action bar. The panel shown in Figure 4 appears.
3. On the Data Set Utility panel, select option A, Allocate new data set, and fill in the name of an ISPF
library, as follows, using your user ID as the project name. See Figure 5
Note: If your project has certain naming conventions that you are required to follow, enter an acceptable
name on this panel and continue with the exercise.
Note: Option M - Enhanced data set allocation, only appears on the panel if your system supports
managed data sets.
4. Press Enter.
5. On the Allocate New Data Set panel shown in Figure 6 are characteristics that you can specify for the
new data set. Make sure that the number of directory blocks is not zero; you must allocate an ISPF library
as a partitioned data set. For this exercise, make sure that the values you specify are the same as those
shown on the following panel.
6. Press Enter.
7. Check to see if the message Data set allocated appears in the upper-right corner of the Data Set Utility
panel, as shown in Figure 7. If these values on the Allocate New Data Set panel are not changed, they are
in effect any time you create a library or data set,
Figure 7. Data Set Utility with Data Set Allocated Message (ISRUDA2S)
Are you surprised to find yourself at the Edit Entry panel? This is another way to get around ISPF panels--
it is called the jump function.
You can use the jump function to move from one option to another under the same primary option menu.
Type an equal sign followed by a ISPF option number in any input field that is preceded by ===> or leader
dots (...), press Enter, and you can go directly to that option without going back to the ISPF Primary Option
Menu. You can disable the jump function from fields preceded by leader dots within Option 0 Settings by
deselecting the Jump from leader dots option.
You can also access options by selecting them from the action bar.
1. To create and edit member MEM1 of the ISPF library that you just allocated, enter the following name
as shown in Figure 9
You do not need to fill in or change any of the other information on this panel. Press Enter.
Note: You can remove any warnings in the member by typing reset on the command line and pressing
Enter.
2. On the panel shown in Figure 10, press the Tab key to move to the text area and enter the following
paragraph (or some text of your own choice):
3. When you finish typing the text, press Enter. The cursor moves below the last line of input, and ...
all the text you just typed is now in capital letters! To understand what caused that to happen, we have to
look at the edit profile for this data set.
An edit profile is a set of characteristics that defines the way you can edit a data set. For example, a
profile can be set up to edit data that is all in capital letters, or to edit data that is in mixed-case letters.
ISPF generates a default edit profile based on the library type of the data set you are editing. Usually, the
default profile is suitable for the kind of data you want to put in the data set. Sometimes, however, it is
not.
on the Command line and press Enter. The default edit profile appears on five lines above the data set
member, as shown in Figure 12.
First, we will explain why everything you entered in mixed case letters suddenly changed to uppercase.
The CAPS ON mode means that you can enter input any way you want (all lowercase, mixed case, all
uppercase), but, when you press Enter, or save the data by pressing F3, everything you entered is
changed to uppercase. This is useful when you are working with data that must be all uppercase, such as
a COBOL program, but for some data sets, it can be inconvenient.
You might prefer to have the text in this member appear in mixed case letters. You can change the profile
to make that happen.
and press Enter. You see that the line in the profile changes, but the text stays the same.
2. Now, type over two or three lines of the upper case text, the way you originally typed it, and press
Enter. See Figure 13.
Figure 13. Text Display with Caps off in the Edit Profile (ISREDDE2)
Another way to change letters from uppercase to lowercase is to use the LC line command. Conversely,
the UC line command can change letters from lowercase to uppercase. To change the case of all the lines
use the block command Lcc and Ucc.
Sequence numbers keep track of the number and sequence of the lines of data in a data set.
Look at the edit profile again. In this edit profile, sequence numbering is on (NUMBER ON STD). This is
all right for certain kinds of data; PL/I programs are a good example. However, when you are creating
panels, messages, CLISTs or REXX EXECs, or skeletons for your ISPF dialogs, you must be sure to set
sequence numbering to off before you begin entering data (if the edit profile you are using is not already
set up that way).
Here is why. When you try to run the dialog, or try to use Dialog Test (option 7) to test the panel and
message definitions, they do not format correctly because the processing reads the sequence numbers as
part of the definitions. You receive a message about invalid characters in the panel or message definition,
and no matter how thoroughly you review your input for mistakes, you will forget that on the far right side
of the data set, where they are not visible, lie the sequence numbers.
Therefore, to save yourself some time, always check the edit profile before you enter data in a new data
set, and make sure the defaults are appropriate for the kind of data you want to put there. To eliminate the
sequence numbers, type:
on the Command line and press Enter. Notice that NUMBER ON STD changes to NUMBER OFF in the
edit profile. The numbers have disappeared! See Figure 15.
Figure 15. Right Side of Edit Panel without Sequence Numbers (ISREDDE2)
on the Command line and press Enter. The RESET or RES command does not take you out of the
member; it simply removes the profile display. While you are still in this member, practice using some of
the function keys. For example, try:
o Scrolling down to the bottom of the data, and then scrolling back to
the top using F7 and F8
o Requesting help using F1 (To exit from the help panel, press F3.)
o Splitting the screen using F2 and swapping the cursor between the
screens using F9. (To end split-screen mode, enter the =X command.)
See what happens if you try to edit the same member on both screens.
o Primary commands
o Line commands
Primary commands are the ones you type in on the edit Command line at the top of your data. For
example: PROFILE, CAPS OFF, UNNUM, and RESET.
Line commands are commands that you enter on the edit line numbers, which are located on the left side
of the data. Suppose you want to add a line or a group of lines to this member. You can use the
I (INSERT) line command, like this:
001400
001500
Figure 16. Member Saved Message on the Edit Entry Panel (ISREDM01)
You should use the Data Set Utility (option 3.2) to allocate your private libraries before continuing.
You can use the same defaults for your private libraries that you used for the userid.PURPLE.PROSE
library. Make sure the number of directory blocks is not zero; all of your PRIVATE libraries should be
partitioned data sets.
BROWSE [member]
BRO
COLUMNS
COLS
COL
DISPLAY [char]
DISPL [NOCC | CC]
DISP
DIS
EDIT [member]
RESET
SUBMIT
VIEW [member]
You can use the following format to enter label definitions on the command line:
.ccccc
Defines a label (PDF component internal symbol), which is equated to the top line on the screen. Can be
used with LOCATE to scroll directly to that line.
CONFIRM
LOCATE string
LOC
L
MLC
MLS
REFRESH
RESET
SAVE [list-id]
SORT [field1[field2]]
LINE COMMANDS
On all member list displays except those for option 3.1 and 3.4, you can enter the following one-character
command at the beginning of a line.
S
Selects the member.
On option 3.1 and 3.4 member list displays, you can enter the following one-character commands at the
beginning of a line.
B
Browses the member.
C
Copies the member.
D
Deletes the member.
E
Edits the member.
G
Resets the member.
J
Submits the member.
M
Moves the member.
P
Prints the member.
R
Renames the member. When using this command, you must also enter the new name to the right of the
member name.
T
TSO command.
V
Views the member.
W
WS command.
TSO commands, CLISTs, and REXX EXECs can be entered in member lists that have an expanded line
command field. These are member lists displayed by using option M of the Data Set List utility. Here, any
command other than B, D, E, P, R, or V is considered to be a TSO command, CLIST, or REXX EXEC.
APPEND
DSLIST
EXCLUDE
LC
LOCATE lparm
LOC
L
REFRESH
RESET
RFIND
SAVE [list-id]
SORT [field1[field2]]
VA
VS
VT
VW
LINE COMMANDS
On option 3.4 data set list displays, you can enter the following one-character commands at the beginning
of a line. Any other command entered at the beginning of a line is considered to be a TSO command,
CLIST, or REXX EXEC.
B
For a library or partitioned data set, displays a member list. You can then use the S command to
select a member to browse. For a sequential data set, displays the data set in browse mode.
C
Catalogs the data set.
CO
Copies a data set.
D
Deletes an entire data set. Displays a Confirm Delete panel if you request confirmation.
E
For a library or partitioned data set, displays a member list. You can then use the S command to
select a member to edit. For a sequential data set, displays the data set in edit mode.
F
Frees unused space in a data set.
I
Displays library or data set information.
M
For a library or partitioned data set, displays a member list.
MO
Moves a data set.
NX
Unexclude a line from display.
NXF
Unexclude the first of a set of excluded data sets.
NXL
Unexclude the last of a set of excluded data sets.
P
Prints the library or data set.
PX
Prints an index listing.
R
Displays a panel, on which you can rename the library or data set.
RA
Adds a data set to a reference list.
RS
Resets statistical data.
S
Displays library or data set information in short format.
U
Uncatalogs the data set.
V
For a library or partitioned data set, displays a member list. You can then use the S command to
select a member to view. For a sequential data set, displays the data set in view mode.
X
Excludes a data set from the list.
Z
Compresses a library or data set.
=
Repeats the last line command entered.
AUTOLIST [ON ]
[OFF]
AUTONUM [ON ]
[OFF]
AUTOSAVE [ON ]
[OFF PROMPT ]
[OFF NOPROMPT]
BROWSE [member]
BUILTIN cmdname
CANCEL
CAN
CAPS [ON ]
[OFF]
EDIT [member]
END
IMACRO [name|NONE]
LEVEL num
LEV
LOCATE {label }
LOC {line-number}
L
NONUMBER
NOTES [ON ]
NOTE [OFF]
PACK [ON ]
[OFF]
PRESERVE
PROFILE [name] [number]
PROF
PRO
PR
PROFILE RESET
PROF
PRO
PR
PROFILE [LOCK | UNLOCK]
PROF
PRO
PR
RCHANGE
REN
RFIND
RMACRO [name|NONE]
SAVE
STATS [mode]
SUBMIT [range]
SUB
UNDO
UNNUMBER
UNNUM
UNN
VERSION num
VERS
VER
VIEW [member]
LINE COMMANDS
Under Edit or View, you can enter the following line commands at the beginning of a line by typing over the
line number. If you do not enter a number for the value of n, the default is 1 except for:
The TE command, which defaults to the number of lines remaining on the screen
_______________________________________________________________________________
| <[n | 2] | Shifts data left two positions or the specified number |
| <<[n | 2] | of positions. |
|_____________|__________________________________________________________|
| >[n | 2] | Shifts data right two positions or the specified number |
| >>[n | 2] | of positions. |
|_____________|__________________________________________________________|
| ([n | 2] | Shifts columns left two positions or the specified |
| (([n | 2] | number of positions. |
|_____________|__________________________________________________________|
| )[n | 2] | Shifts columns right two positions or the specified |
| ))[n | 2] | number of positions. |
|_____________|__________________________________________________________|
| A[n] | Identifies the line after which copied, moved, or model |
| | lines are to be inserted. |
|_____________|__________________________________________________________|
| B[n] | Identifies the line before which copied, moved, or model |
| | lines are to be inserted. |
|_____________|__________________________________________________________|
| BOUNDS | Displays the column boundary definition line. |
| BOUND | |
| BNDS | |
| BND | |
|_____________|__________________________________________________________|
| C[n] | Copies one or more lines from one location to another. |
| CC | |
|_____________|__________________________________________________________|
| COLS | Displays a position identification line. |
| COL | |
|_____________|__________________________________________________________|
| D[n] | Deletes one or more lines. |
| DD | |
|_____________|__________________________________________________________|
| F[n] | Redisplays one or more lines at the beginning of a block |
| | of excluded lines. |
|_____________|__________________________________________________________|
| I[n] | Inserts a blank data entry line. |
|_____________|__________________________________________________________|
SEARCH STRINGS
Picture Strings - Special Characters for String-1:
P'='
Any character
P'¬'
Any character that is not a blank
P'.'
Any character that cannot be displayed
P'#'
Any numeric character, 0-9
P'-'
Any non-numeric character
P'@'
Any alphabetic character, uppercase or lowercase
P'<'
Any lowercase alphabetic character
P'>'
Any uppercase alphabetic character
P'$'
Any special character, neither alphabetic nor numeric.
If you are using an APL or TEXT keyboard, you can use the following additional characters in a picture
string:
P'
' Any APL-specific or TEXT-specific character
P'_'
Any underscored non-blank character.
P'='
Equal to the corresponding character in string-1
P'>'
Converts the corresponding character in string-1 to uppercase
P'<'
Converts corresponding character in string-1 to lowercase.
Simple string:
cccccc (no embedded blanks or commas)
Delimited
string: 'ccccc' or "ccccc"
Hex string:
X'hhhh' or 'hhhh'X
Text string:
T'cccc' or 'cccc'T
Picture string:
P'ssss' or 'ssss'P
Character
string: C'cccc' or 'cccc'C
Previous string:
* (single asterisk)
______________________________________________________________________________
| ISPF System Commands |
|______________________________________________________________________________|
| Command | Description |
|___________________________________|__________________________________________|
| ACTIONS | Moves the cursor between the action bar |
| | and the panel body. |
|___________________________________|__________________________________________|
| AUTOTYPE | Allows you to type a partial data set or |
| | member name, press a program function |
| | key, and ISPF completes the name for |
| | you. |
| | |
| | Note: AUTOTYPE is not a true ISPF |
| | system command because it is not |
| | built into the base code of ISPF |
| | and it works only on panels that |
| | are written to understand it. |
|___________________________________|__________________________________________|
| BACKWARD | Alias for the UP command. Scrolls toward |
| | the top of the data. |
|___________________________________|__________________________________________|
| BOTTOM | Alias for the DOWN MAX command. Scrolls |
| | to the bottom of the data. |
|___________________________________|__________________________________________|
| CANCEL | If CANCEL is requested from an action |
| | bar pull-down, the action taken depends |
| | on whether you are running in host or |
| | GUI mode: |
| | |
| | o In host mode, the pull-down is |
| | removed and the cursor is positioned |
| | on the first action bar choice. |
| | |
| | o In GUI mode, the CANCEL command is |
| | returned to the dialog. |
| | |
| | If CANCEL is requested from a panel |
| | displayed using the DISPLAY, TBDISPL, or |
| | SELECT service calls, the DM component |
| | places the command in ZCMD and sets a |
| | return code of 0 from the display |
| | screen. |
| | |
| | If CANCEL is requested from a panel |
| | displayed using the DISPLAY or TBDISPL |
| | service calls and the panel was defined |
| | with a PANEL tag (DTL) or a )PANEL |
| | statement, the DM component returns the |
| | command in ZVERB and sets a return code |
| | of 8 from the display screen. |
|___________________________________|__________________________________________|
| CMDE | If CMDE is entered on any command line, |
| | a pop-up panel (ISPCMDE) with a |
| | 234-character command input field is |
| | displayed. |
| | |
| | |
| | By issuing the command with no |
| | parameters, you cause a list of |
| | available personal data set lists to be |
| | displayed. |
|___________________________________|__________________________________________|
| DTEST parameter number | Enables you to start, or change the |
| | conditions of, a dialog test. |
| | Specifying a parameter number is |
| | required, and different conditions of |
| | dialog test result. For example, if you |
| | enter DTEST 8 while running an |
| | application under Dialog Test, the 7.8 |
| | Breakpoints panel is displayed. After |
| | setting the breakpoints, you return to |
| | your application with the new |
| | breakpoints activated. The panels that |
| | you can call up with DTEST are: |
| | |
| | 1 Invoke Functions panel |
| | |
| | 2 Invoke Display Panel panel |
| | |
| | 3 Invoke Variables panel |
| | |
| | 4 Invoke Tables panel |
| | |
| | 5 Display Browse log panel |
| | |
| | 6 Invoke Dialog Services panel |
| | |
| | 7 Invoke Traces selection panel |
| | |
| | 8 Invoke Breakpoint panel |
|___________________________________|__________________________________________|
| END | Stops the current operation and returns |
| | to the previous menu. If the ISPF |
| | Primary Option Menu is displayed, this |
| | command ends ISPF. |
| | When entered on a selection panel |
| | displayed by the SELECT service, the END |
| | command causes a redisplay of the next |
| | higher menu in the hierarchy. When |
| | entered on a panel displayed by the |
| | tutorial program, it stops the tutorial |
| | and causes a redisplay of the menu from |
| | which the tutorial was started or the |
| | panel from which HELP was requested. |
| | |
| | When the END command is entered on a |
| | panel displayed by a dialog function |
| | through the DISPLAY or TBDISPL service, |
| | the dialog function must take whatever |
| | action is appropriate to terminate and |
| | return control. Entry of the END command |
| | is signalled by a return code of 8 from |
| | the DISPLAY or TBDISPL service. |
|___________________________________|__________________________________________|
| ENVIRON [ENBLDUMP[ON|OFF]] | Allows you to reduce service time by |
| [TERMTRAC[ON|ERROR|DUMP|OFF]] | gathering data that can be helpful in |
| [TERMSTAT [QUERY]] | diagnosing problems. Functions provided |
| | include: |
| | |
| | o Enabling Abend dumps when ISPF is |
| | not in TEST mode |
| | o Tracing and dumping ISPF terminal |
| | input and output data and errors |
|___________________________________|__________________________________________|
| ISPFWORK | Starts the ISPF Workplace. |
|___________________________________|__________________________________________|
| ISPLIBD [libtype] | Invokes the LIBDEF Display Utility. The |
| | optional parameter, libtype, identifies |
| | a specific LIBDEF library definition to |
| | be displayed. All LIBDEF definitions for |
| | the current logical screen are displayed |
| | if the parameter is omitted, if the |
| | parameter is longer than eight |
| | characters, or if the parameter |
| | specifies ISPPROF as the library name. |
| | See ISPF Dialog Developer's Guide and |
| | Reference for more information about the |
| | ISPLIBD command. |
|___________________________________|__________________________________________|
| ISPPREP | Allows you to create preprocessed |
| | panels, those for which ISPF has |
| | partially processed the panel definition |
| | before it is stored in the panel data |
| | set, either interactively or in batch |
| | mode. |
|___________________________________|__________________________________________|
| ISRRLIST | The action bar interface into referral |
| | lists. |
|___________________________________|__________________________________________|
| ISRROUTE | The action bar interface into the ISPF |
| | command stacking routing. ISRROUTE also |
| | provides an interface to the SELECT |
| | service from the ACTION/RUN statement |
| | within a pull-down choice. The |
| | parameters are the same as the ISPEXEC |
| | interface to the SELECT service. |
|___________________________________|__________________________________________|
| KEYLIST [PRIVATE|SHARED|OFF|ON] | The parameters on this command determine |
| | where, or if, ISPF looks for keylists. |
| | The default setting for KEYLIST is |
| | equivalent to issuing the KEYLIST |
| | PRIVATE command, which means that the |
| | program looks in the user's profile |
| | table for the keylist specified on a |
| | panel before looking in the xxxxKEYS |
| | table allocated in ISPTLIB. |
| | |
| | The KEYLIST SHARED command means that |
| | ISPF looks only in the xxxxKEYS table |
| | allocated in ISPTLIB for the keylist. |
| | |
| | Using either the PRIVATE or SHARED |
| | parameter performs an implicit KEYLIST |
| | ON command. Both of the parameters are |
| | local to each application, so setting |
| | PRIVATE for application X does not |
| | affect application Y, which might be |
| | using SHARED. |
| | |
| | By specifying KEYLIST OFF, you cause |
| | ISPF to ignore the keylist on all |
| | logical screens and use the ZPF |
| | variables for controlling function keys. |
| | This is in effect only for the |
| | application for which you enter the |
| | command. |
| | |
| | The KEYLIST ON command causes ISPF to |
| | recognize keylists again, with the |
| | parameter (SHARED or PRIVATE) that was |
| | |
| | The MSGID ON/OFF command affects only |
| | the current logical screen, so when you |
| | are running in split screen, one screen |
| | can have MSGID ON and the other MSGID |
| | OFF. The MSGID command will return only |
| | the MSGID of a message for its own |
| | logical screen. |
| | |
| | An option on the Log Data Set Defaults |
| | and List Data Set Defaults panels, which |
| | are choices on the Log/List pull-down on |
| | the ISPF Settings panel, |
| | |
| | Log Message ID . . . _ (/ = Yes) |
| | |
| | allows you to select whether the message |
| | ID is written to the log data set as |
| | part of the long message text. The |
| | initial default is unselected. Note that |
| | not all lines in the log data set |
| | originate from a message member. |
| | Therefore, not every line in the log |
| | data set will have a message number |
| | associated with it. |
| | |
| | Note: This facility does not affect |
| | long message text returned by the |
| | GETMSG service, messages |
| | displayed in the Error Box, or |
| | messages displayed by TRACEX. |
|___________________________________|__________________________________________|
| NOP | The classic no operation command. |
|___________________________________|__________________________________________|
| NRETRIEV | Data set and library name retrieved. |
|___________________________________|__________________________________________|
| PANELID [ON|OFF] | Indicates whether or not the panel |
| | identifier (ID) is to be displayed. If |
| | you enter PANELID without any |
| | parameters, the command toggles the |
| | display of the panel ID. If an action |
| | bar is present, the ID is displayed |
| | immediately below the action bar, |
| | indented one space. If an action bar is |
| | not present, the DM component displays |
| | the ID indented one space in the left |
| | corner of line 1 on the panel. |
| | |
| | Note: In GUI mode, the panel identifier |
| | is placed on the title bar rather |
| | than on the first line of the |
| | panel. |
| | |
| | During initial entry to ISPF, the |
| | PANELID is set to OFF. The ID is |
| | displayed only if the panel contains a |
| | protected-field attribute byte in row 1 |
| | column 1 (relative to the action bar) |
| | and is padded with one blank. |
|___________________________________|__________________________________________|
| PFSHOW [ON |OFF|TAILOR] | Toggles through the different forms of |
| | the function key area. The first time |
| | you enter the PFSHOW command (without |
| | parameters), the long form of the |
| | function key area is displayed. If you |
| | enter the command again, the short form |
| | is displayed. If you enter the command |
|___________________________________|__________________________________________|
| PRINT-HI | Same as PRINT, except that |
| | high-intensity characters on the screen |
| | are printed with overstrikes to simulate |
| | the dual-intensity display. |
| | |
| | See Using Print Commands with DBCS under |
| | the PRINT command. |
| | |
| | Note: The PRINT-HI command is disabled |
| | if you are running in GUI mode. |
|___________________________________|__________________________________________|
| PRINTL | Causes a snapshot of the logical screen |
| | image to be recorded in the ISPF list |
| | file for subsequent printing. In |
| | split-screen mode, the PRINTL command |
| | prints what would be seen if |
| | split-screen were not in effect. |
| | |
| | See Using Print Commands with DBCS under |
| | the PRINT command. |
| | |
| | Note: The PRINTL command is disabled if |
| | you are running in GUI mode. |
|___________________________________|__________________________________________|
| PRINTLHI | Same as PRINTL, except that |
| | high-intensity characters on the logical |
| | screen are printed with overstrikes to |
| | simulate the dual-intensity display. |
| | |
| | See Using Print Commands with DBCS under |
| | the PRINT command. |
| | |
| | Note: The PRINTLHI command is disabled |
| | if you are running in GUI mode. |
|___________________________________|__________________________________________|
| PSCOLOR | Globally alters the color, intensity, |
| | and highlighting of point-and-shoot |
| | fields through a pop-up dialog. Valid |
| | choices include the following: |
| | |
| | Color Intensity Highli|ht
| | |
| | RED HIGH NONE |
| | PINK LOW BLINK|
| | GREEN REVER|E
| | YELLOW USCOR|
| | BLUE |
| | TURQ (Turquoise) |
| | WHITE |
| | |
| | To restore the ISPF default values, |
| | delete any new values you have entered |
| | (leaving the entry fields blank) and |
| | press Enter, or select the Defaults |
| | field. |
|___________________________________|__________________________________________|
| RCHANGE | Repeats the action of the previous |
| | CHANGE command (change one character |
| | string to another) (Edit and View only). |
|___________________________________|__________________________________________|
| REFACTD nnnnnnnn xx | Calls the personal data set list named |
| | nnnnnnnn and retrieves the data set in |
| | position xx |
|___________________________________|__________________________________________|
| REFACTL nnnnnnnn xx | Calls the personal data set list named |
| | nnnnnnnn and retrieves the data set in |
| | position xx. |
|___________________________________|__________________________________________|
| REFADDD nnnnnnnn | Updates the personal data set list named |
| | nnnnnnnn with the most recently |
| | referenced data set. |
|___________________________________|__________________________________________|
| REFADDL nnnnnnnn | Updates the personal library list named |
| | nnnnnnnn with the most recently |
| | referenced library. |
|___________________________________|__________________________________________|
| REFLISTD xx | Calls the reference data set list dialog |
| | and retrieves the data set in position |
| | xx. |
|___________________________________|__________________________________________|
| REFLISTL xx | Calls the reference library list dialog |
| | and retrieves the library in position |
| | xx. |
|___________________________________|__________________________________________|
| REFOPEND | Calls the personal data set open dialog. |
|___________________________________|__________________________________________|
| REFOPENL | Calls the personal library list open |
| | dialog. |
|___________________________________|__________________________________________|
| RESIZE | Increases the size of a pop-up window to |
| | fill the entire 3270 physical display |
| | area. The initial RESIZE command |
| | increases the pop-up window to its |
| | maximum size, and the following RESIZE |
| | reduces the window to its original size. |
|___________________________________|__________________________________________|
| RETF | Retrieves commands from the command |
| | stack moving in the direction from the |
| | oldest command in the command stack |
| | toward the most recent commands in the |
| | command stack. Forward retrieve (RETF) |
| | retrieves the oldest command on the |
| | command stack, if RETF is entered |
| | immediately after a command is executed, |
| | before performing a RETRIEVE. |
|___________________________________|__________________________________________|
| RETP | Causes a pop-up panel to be displayed |
| | with a list of the last 20 commands in |
| | the retrieve stack. Retrieve pop-up |
| | (RETP) enables you to select by number |
| | the command to be retrieved. The command |
| | selected is retrieved to the command |
| | line, as it is when using other retrieve |
| | commands. You will not be able to change |
| | the commands in the retrieve pop-up |
| | until the command is selected and |
| | retrieved to the command line. |
| | |
| | The RETP pop-up panel has an OPTIONS |
| | action bar choice that allows you to set |
| | the minimum number of characters |
| | required to save a command in the |
| | retrieve stack and to choose whether to |
| | position the cursor at the beginning or |
| | end of the retrieved command when the |
| | command is retrieved to the command |
| | line. RETP displays the pop-up panel if |
| | the retrieve stack is empty, which |
| | allows the user to change the retrieve |
| | options. |
|___________________________________|__________________________________________|
| RETRIEVE | Repeatedly entering RETRIEVE causes the |
| | commands most recently entered from the |
| | |
| | o Application ID |
| | |
| | o Session type (GUI or 3270) |
| | |
| | You can select from this list the screen |
| | you want to display or start a new |
| | screen or application. The screen you |
| | select replaces the screen from which |
| | you issued the command. |
| | |
| | Using a listed parameter changes the |
| | focus (in GUI mode) or display (in 3270 |
| | mode) to the PREVious, NEXT, or |
| | specified logical screen. |
| | |
| | PREV changes the focus or display to the |
| | next lower screen number until reaching |
| | 1, then wraps back to 32 or the last |
| | number used. |
| | |
| | NEXT displays the next highest screen |
| | number until the last number used is |
| | reached (ISPF maximum 32, your |
| | installation might vary), then will wrap |
| | back to number 1. |
| | |
| | SWAP screen name changes the display or |
| | focus to the screen called screen name, |
| | if it is active. See the SCRNAME command |
| | for more information about screen names. |
| | |
| | SWAP n, where n is a number, changes the |
| | display or focus to the specified screen |
| | number, if it is active. |
|___________________________________|__________________________________________|
| SWITCH (3270 | GUI) | Switches the mode of screen display |
| | between GUI and 3270. |
|___________________________________|__________________________________________|
| TOP | Alias for the UP MAX command. Scrolls to |
| | the top of the data. |
|___________________________________|__________________________________________|
| TSO | Allows the user to enter a TSO command, |
| | CLIST, or REXX command procedure. |
| | |
| | |
| | Do not enter the following commands |
| | after the TSO command: |
| | |
| | o LOGON, LOGOFF |
| | o ISPF, PDF, ISPSTART, and SPF |
| | o TEST |
| | o Commands that are restricted by TSO |
| | or PCF |
| | |
| | You can enter a CLIST or REXX name after |
| | the TSO command, but the following |
| | restrictions apply: |
| | |
| | o The CLIST or REXX command procedure |
| | cannot invoke the restricted |
| | commands shown in the preceding |
| | list. |
| | |
| | o Restrictions that apply to CLIST |
| | attention exits are described in |
| | ISPF Dialog Developer's Guide and |
| | Reference |
| | |
| | o TERMIN command procedure statements |
| | cause unpredictable results. |
|___________________________________|__________________________________________|
| TSOCMD | Displays the ISPF Command Shell panel. |
|___________________________________|__________________________________________|
| TSOGUI [ ON | OFF ] | ON specifies that the ISPF/TSO window is |
| | resumed and all TSO line mode output and |
| | input is directed to the ISPF/TSO |
| | window. |
| | |
| | OFF specifies that the ISPF/TSO window |
| | is suspended and all fullscreen and line |
| | mode data appears in the 3270 window |
| | until TSOGUI ON command is issued. |
|___________________________________|__________________________________________|
| TUTOR [panelid] | Calls the ISPTUTOR program to display |
| | specified tutorial panels. |
| | |
| | To display a particular tutorial panel, |
| | enter the TUTOR command along with the |
| | panel identifier of the desired tutorial |
| | panel as a parameter. |
| | |
| | If you issue the TUTOR command without a |
| | parameter, the general tutorial help |
| | panel (ISP00000) is displayed. |
|___________________________________|__________________________________________|
| UP | Scrolls toward the top of the data. |
|___________________________________|__________________________________________|
| WINDOW | Moves a pop-up that is currently |
| | displayed. |
| | |
| | If more than one pop-up is displayed on |
| | your logical screen, only the active (or |
| | most recent) pop-up will move. |
| | |
| | A pop-up can only be moved within the |
| | logical screen from which it originated. |
| | |
| | Note: The WINDOW command is disabled if |
| | you are running in GUI mode. |
|___________________________________|__________________________________________|
| WS | Modelessly starts the command you |
| | specify, providing a seamless interface |
| | between host and workstation |
| | applications. For example, when running |
| | in GUI mode, you can enter the following |
| | command to invoke a workstation editor |
| | on file test.fil: |
| | |
| | WS e.exe test.fil |
|___________________________________|__________________________________________|
| WSCON | Displays the Initiate Workstation |
| | Connection panel. Using this panel, you |
| | can start a workstation connection. |
| | There are some restrictions to consider |
| | if you choose to start a workstation |
| | connection with this command: |
| | |
| | o At the completion of ISPF command |
| | processing, or program, clist, or |
| | REXX exec execution, ISPF does not |
| | reprocess the panel from which the |
| | command was invoked. The panel is |
| | simply relaunched to the screen |
| | |
| | o If popup windows are displayed in |
| | GUI mode when the WSDISCON command |
| | is issued, those popup windows are |
| | suspended on the 3270 session and |
| | the panels display as fullscreen |
| | panels. If new addpops are then |
| | invoked, these new panels display as |
| | popups. |
| | |
| | o You cannot disconnect using the |
| | WSDISCON command when running in |
| | batch GUI mode. |
| | |
| | o If the CODEPAGE and CHARSET |
| | parameters were specified (on the |
| | WSCON service, or on the Initiate |
| | Workstation Connection panel, or on |
| | the ISPSTART GUI statement) when |
| | your workstation connection was |
| | made, these values might no longer |
| | be the host codepage and character |
| | set in 3270 mode following a |
| | WSDISCON command. The values |
| | returned from the terminal query are |
| | restored as the active codepage and |
| | character set. If your emulator does |
| | not support codepages, the CODEPAGE |
| | and CHARSET parameter values |
| | originally specified on your |
| | ISPSTART statement are used. If |
| | these ISPSTART parameters were not |
| | specified, ENGLISH is the default |
| | specification. |
|___________________________________|__________________________________________|
| ZKEYS | Displays a panel that lets you view and |
| | change the current function key |
| | variables. This command is equivalent to |
| | selecting the Global PF Key settings |
| | choice from the Function keys pull-down |
| | on the ISPF Settings panel. |
|___________________________________|__________________________________________|
UP (F7/19)
Same as the UP command
DOWN (F8/20)
Same as the SKIP command
LEFT (F10/22)
Same as the BACK command
RIGHT (F11/23)
Same as the Enter key (display the next page).
When scrollable data is displayed, scrolling enables you to move the screen window up, down, left, or right
across the information. Only up and down scrolling is allowed for table displays and scrollable areas.
When scrolling is allowed, a scroll amount is commonly displayed at the top of the screen (line 2). This
amount determines the number of lines, or columns, scrolled with each use of a scroll command. To
change the scroll amount, move the cursor to the scroll field and type over the displayed amount. Valid
scroll amounts are:
0-9999
Specifies the number of lines (up or down) or columns (left or
right) to be scrolled.
PAGE
Specifies scrolling by one page.
For scrolling purposes, a page is defined as the amount of information currently visible on the logical
screen. Function key definition lines are not a part of the page. In split-screen mode, for example, a
Browse display might have 12 lines by 80 columns of scrollable data. In this case, a scroll amount of
PAGE moves the text up or down by 12 lines, or right or left by 80 columns.
DATA
For up and down scrolling, specifies scrolling by one line less than a page. For left and right scrolling, it is
one column less than a page.
HALF
Specifies scrolling by half a page.
MAX
Specifies scrolling to the top, bottom, left margin, or right margin, depending upon which scrolling
command is used.
CSR
Specifies scrolling based on the current position of the cursor. The line or column indicated by the cursor
is moved to the top, bottom, left margin, or right margin of the screen, depending upon which scrolling
command is used. If the cursor is not in the body of the data or if it is already positioned at the top, bottom,
left margin, or right margin, a full-page scroll occurs.
Command ===> UP 3
Command ===> 3
and press the UP function key. Either form results in a temporary, one-time override of the scroll amount.
If ISPF does not recognize the value specified on the command line as a valid scroll amount, such as
PAGE, DATA, HALF, MAX, CSR, or a positive integer, the value is interpreted as a command and passed
to the function in control.
General
KEYS Displays the PF Keys for that panel
PFSHOW Shows all PF Keys at the bottom of the panel
PFSHOW OFF Removes the PF Keys from the bottom of the panel
Scroll Options
PAGE Scroll by entire screen (length or width) – no matter where the cursor is located
CSR Scroll based on where the cursor is located on the screen
HALF Scroll by ½ a screen (length or width) – no matter where the cursor is located
Browsing
How:
Main Menu Option 1
= 1 on Command Line
File-Aid Option 1 (9.19;1)
Line Command B with 3.4 file list
Panvalet Option 1 (L.1)
Function Keys:
PF1 = Help
PF2 = Split screen at the cursor’s location
PF3 = Exit
PF4 = Exit or Return
PF5 = Find next occurrence of last F command
PF6 = Change next occurrence of last C command
PF7 = Move up
PF8 = Move down
PF9 = Swap between split screens
PF10 = Move left
PF11 = Move right
PF12 = Cancel or Repeat (redisplays the previous Command Line command)
PF13 – 24 are usually repeats of the above
RES = ditto
SWAP = Switch between split screens
HOLD = Put the current session of TSO on hold and start a new one
=x = Exit the current TSO session
HEX = Display the data in Hexadecimal mode
HEX OFF = Turns the Hexadecimal mode off
CUT = With C or CC line command will copy the line(s) to temporary storage
Line Commands:
COL = Display a ruler
COLS = ditto
D = Remove the ruler
C = Copy the current line
CC = Block copy of lines (requires a set of 2 CC)
Function Keys:
PF1 = Help
PF2 = Split screen at the cursor’s location
PF3 = Exit
PF4 = Exit or Return
PF5 = Find next occurrence of last F command
PF6 = Change next occurrence of last C command
PF7 = Move up
PF8 = Move down
PF9 = Swap between split screens
PF10 = Move left
PF11 = Move right
PF12 = Cancel or Repeat (redisplays the previous Command Line command)
PF13 – 24 are usually repeats of the above
How:
Screen: Example
1 IMSVS.IMP1.CTLBLK.PSBSRC 13 BSG.CLIST
2 IMSVS.IMP1.CTLBLK.DBDSRC 14 PAN.ISPF.CLIST
3 15 KZZVGF.HP.JCL
4 16
5 17
6 18
7 XCC1.CNTLLIB 19
8 XCC1.APOLLO.READER 20
9 RDC1.PROCLIB 21
10 XCC1.DTDLIB 22
11 IMSVS.IMP1.CTLBLK.PSBSRC 23 IMSVS.IMP1.DBDLIB
12 IMSTEST.IMT3.CTLBLK.PSBSRC 24
The QB and QE screen first comes up without any of the 24 filenames filled in. I’ve entered filenames 1, 2,
7-15, and 23. The filenames you enter can be in any order.
Tab to the Filename List and type in the main part of the filename.
The example above will bring up a list of files that is in KZZVGF.HP.JCL that begins with CJ023, in this
case CJ02300, CJ02310, and CJ02320, you can select the specific one which you want to browse from
the list by using the S line command. If you don’t want to use one of the filenames in the library list, blank
out the library number and tab to Data Set Name and type in the full filename. Press the ENTER key to
execute the request.
You are now in browse or view mode and can use the appropriate Command Line and line commands and
function keys.
Editing
How:
Main Menu Option 2
= 2 on Command Line
File-Aid Option 2 (9.19;2)
Line Command E with 3.4 file list
Panvalet Option 2 (L.2)
Line Commands:
Function Keys:
PF1 = Help
PF2 = Split screen at the cursor’s location
PF3 = Exit and Save
PF4 = Exit or Return without Saving
PF5 = Find next occurrence of last F command
PF6 = Change next occurrence of last C command
PF7 = Move up
PF8 = Move down
PF9 = Swap between split screens
PF10 = Move left
PF11 = Move right
PF12 = Cancel or Repeat (redisplays the previous Command Line command)
PF13 – 24 are usually repeats of the above
Enter QE on the Command Line. (Warning if you are in any of the Option 9 utilities, it has its’ own listing
of QE files).
Screen: Example
1 USGREV.CE.RECORDS 13 KZZVGF.CLIST
2 UDEM.BB.EB17CNTL 14 KZZVGF.JOB
3 PROCH.FD.PSDB.PDS 15 KZZVGF.PDS.JCL
4 16 KZZVGF.MMRSC.REXX
5 17
6 BSG.STAGELIB 18 KZZVGF.PROCLIB
7 BSG.PROCLIB 19 KZZVGF.CNTLLIB
8 XCC1.APOLLO.READER 20 KZZVGF.CNTLLIB.SAS
9 RDC1.PROCLIB 21 KZZVGF.PSBLIB
10 XCC1.CNTLLIB 22 KZZVGF.CNTL
11 XCC1.CNTLLIB.SAS 23 KZZVGF.PDS.SOURCE
12 XCC1.AFILE 24 KZZVGF.ABEND.CODES
QE works just like QB, except you will be in Edit mode after pressing ENTER.
Blank If the option code is left blank and an ISPF Library or Other Partitioned,
Sequential, or VSAM data set name is filled in, the characteristics for that
member will be displayed and retained for use in allocating similar files.
A Allocates a Partitioned or Sequential data set
R Renames the entire Partitioned, Sequential, or VSAM data set
D Deletes the entire Partitioned, Sequential or VSAM data set
C Catalogs a data set
U Uncatalogs a data set
S Same as Blank
M
V VSAM utilities
Enter the entire partitioned, sequential or VSAM file name as possible. If you
only remember parts of the file name, you can use the * (asterick) symbol for
wildcarding or leave off the last nodes of the name and a file list will be
displayed. Warning if you use the * symbol as the first node it can take a long
time for the results to come back.
XMIT ipc.id dsn(‘xxx.xxx.xxx(xxx)’) Transmits a file to another user on another IPC system.
Additional Information
1. When you see *** on the screen press the ENTER key.
2. In most cases you can enter =# on the Command Line and automatically transfer to that utility (# can
be 1 for browse, 2 for edit, 9.12 for SDSF, etc.).
3. The semicolon character (;) can be used to represent the ENTER key when stringing utility options, for
instance 9;37;1;1;3 will put you into the Endevor Develop Batch option.
FIND Command
WORD - locates the string as an entire word (must have a space before and after).
PREV - locates the previous occurrence of the string
Special String Characters
P’=’ displays any character
P’.’ displays any non-displayable character
P’#’ displays any numeric
P’-‘ displays any non-numeric
P’@’ displays any alphabetic
P’<’ displays any lower case alphabetic
P’>’ displays any upper case alphabetic
P’$’ displays any special character
X’hex value’ finds the hex value
Multiple Screens
You can open multiple swap screens the normal default is only 2. This new method will allow you to have
up to 8.
1. Move your cursor to the command line and type in NEW then press the F2 button.
2. F9 will only work with 2 screens, to toggle between the other swapped screen you can:
a. Type in LIST and press F9 on the command line then move your cursor to the appropriate
screen number (the 2 screens the F9 will automatically toggle between are marked with *
and – by their assigned number).
b. Type in =n and press F9 also on the command line (=n is the number associated with the
screen).
c. Type in NEXT and press F9 on the command line to bring up the next screen.
d. Type in PREV and press F9 on the command line to bring up the previous screen.
3. To exit the swap session type in =X on the command line.
With Chameleon you can define Button Pads that will have the above commands already coded to them.
*************************************End Of Document*****************************************