| EMM 1997 | INDIETRO |
What Is ISPF?
Invoking
ISPF
Getting Out Of ISPF
Allocating An ISPF
Profile
Allocating
A Partitioned Data Set
Panels
Panel
Format
Types Of Panels
Specifying
The Data Set Or PDS Member To Edit
Edit
A Member Of A Partitioned Data Set
Edit
An Existing Sequential Data Set
The
Edit Panel
Moving
Around The Edit Screen
Primary
Edit Commands
Line Commands
Insert/Delete/Repeat
Commands
Move/Copy/Overlay
Commands
Text
Preparation Commands
Finding,
Changing And Excluding Data
Edit
Profile
Creating
A Universal Edit Profile
Nulls
Merging
And Segmenting Data
Merging
Data - Copy/Move Commands
Segmenting
Data - Create/Replace Commands
Default PF Key Settings
Display PF Key Definitions
Redefining PF Keys
Splitting Your Screen
Swapping Between Screens
Exiting Split Screen Mode
The ISPF/Program Development Facility (ISPF/PDF or just ISPF) is a programming environment that makes it easy to develop, manage, and organize your data.
ISPF offers capabilities such as:
multilevel programming library support,
full-screen editing,
scrolling of source data in any direction,
split screen capability that allows you to partition your screen into two logical areas,
utilities to maintain libraries and data sets, and
an on-line tutorial.
To invoke ISPF, you must first logon to TSO and be at the READY prompt. If you are not logged on to TSO, you can do so by:
Enter your TSO user ID and password at the Super Session Entry Validation Screen (use the TAB key to move from the USERID line to the PASSWORD line) and press <ENTER>.
Select TSO from the Super Session Application Selection Menu by typing an S to the left of the TSO/GOPHER/EDDIE line and press <ENTER>.
Note: If you have forgotten either your computer ID or password, go to the Help Desk in M4 Martin Hall for assistance. Please bring a picture ID with you.
Once the system displays any broadcast messages, it will present you with a READY prompt. At the READY prompt, you can invoke ISPF by entering
GI
You will then see the Clemson ISPF/PDF Primary Options Panel:
+----------------------------------------------------------------------+ | | | ----------- Clemson ISPF/PDF Primary Options Pane| -------- 15:39 | | OPTION ===> _ 94/01/24 | | | | Data Set Management Miscellaneous | | B Browse a Data Set C TSO|CProcessor | | E Edit a Data Set CAL Calendar | | FTP File Transfer Protocol IOF Interactive Output Facility | | MAKEDS Make a Data Set IP ISPF Parameters | | SPRINT Print Services PRINTDOC Print DCIT Documentation | | RACF RACF Security Services TUP TSO User Profile | | U Utilities CRS Computer Resource Services | | | | | | General Information Electronic Mail | | A Announcements Mail Electronic Mail System | | GOPHER Gopher Server Access MBOX Access Mail Box | | HELP ISPF Help MSEND Send Mail | | T ISPF Tutorial EDDIE E-Mail Library Info & Delivery | | TH Help for TSO Commands | | User ID: JOE | | Printer Dest: LOCAL | | X Exit ISPF to READY Prompt Printout Box: 45 | | LOGOFF LOGOFF System Terminal ID: PPAS200F | | | | | +----------------------------------------------------------------------+
Now that you are in ISPF, the first thing you should learn is how to get out. There are two ways to get of out ISPF:
If you enter X from the Clemson ISPF/PDF Primary Options Panel, ISPF will return you to the READY prompt.
If you enter \q from the Clemson ISPF/PDF Primary Options Panel, you will be taken out of ISPF and logged off the system.
If you have selected an option from the Clemson ISPF/PDF Primary Options Panel and would like to leave ISPF from there, you can:
Enter =X from anywhere within ISPF to exit ISPF and return to the READY prompt;
enter \q from anywhere within ISPF to exit ISPF and be logged off the system; or
press the PF15 key (END) repeatedly unitl you return to the Clemson ISPF/PDF Primary Options Panel. (PF15 will get you out of any ISPF function and back to the previous panel.) Once you have returned to the Clemson ISPF/PDF Primary Options Panel, enter \q to be logged off the system.
ISPF assumes that your data is organized in a partitioned data set. Use a partitioned data set when you want to keep several sequential data sets together. It consists of several members stored in the same data set, along with a directory that contains a list of all the members and their locations in the partitioned data set.
If you would like to see a list of the members of a partitioned data set, you specify the data set name:
'JOEUSER.MISC.SOURCE'
If you would like to access a member of a partitioned data set, you specify the data set name, followed by the member's name enclosed in parenthesis. For example, to access member PROG1 in 'JOEUSER.MISC.SOURCE', you can specify
'JOEUSER.MISC.SOURCE(PROG1)'
To use ISPF, you need to have a permanent profile data set allocated and called
'userid.ISPF.PROFILE'
ISPF uses this data set to store your preferences and allows you to customize various characteristics of your ISPF session. You must create this data set before you begin using ISPF by using MAKEDS.
To allocate a permanent profile data set:
enter MAKEDS from the Clemson ISPF/PDF Primary Options Panel, which will display the following menu:
+----------------------------------------------------------------------+ | | | ---------- MAKEDS Data Set Authorization System V1.0 ---------- | | OPTION ===> _ | | | | | | 1 Source Data Set | | | | 2 Load Library | | | | 3 SAS Data Library | | | | 4 ISPF Profile | | | | 5 ISPF Mail Log | | | | 6 Mail Nickname Data Set | | | | 7 Gopher Bookmark Data Set | | | | 8 Other | | | | I Information about MAKEDS | | | | 0 QUIT | | | | Enter your selection above | | | +----------------------------------------------------------------------+
Select the number associated with the ISPF PROFILE option (3 for students and 4 for employees).
ISPF will display the following menu:
+----------------------------------------------------------------------+ | | | ----------------- Allocate ISPF Dataset --------------------- | | COMMAND ===> _ | | | | | | You have requested the creation and permanent allocation of an ISPF | | Profile data set. The name of this data set is hardcoded. | | Press <ENTER> to complete the allocation process or type "cancel" | | on the command line to abort allocation. | | | | | | | | Data Set Name ==> 'userid . ISPF . PROFILE | | | | | | | | | | | | | | | | | | | | | | | | | | | +----------------------------------------------------------------------+
Press <ENTER> to request that an ISPF profile data set be allocated for you. MAKEDS will notify you via electronic mail that your profile data set allocation was successful.
After you've made your request for your profile data set, select Option 0 from the MAKEDS menu to exit.
Once allocated, ISPF will automatically store in your profile data set any preferences or customizations you make while in ISPF. And since it is a permanent data set, you need not ever allocate it again.
You will need to allocate a permanent partitioned data set in which to store your data sets. A partitioned data set contains space for multiple members. Each member normally contains different data, text, programs, etc. so you will not need to create a data set every time you want to enter something new -- just edit a new member.
To allocate a partitioned data set, from ISPF's Primary Options Menu enter:
MAKEDS
Select Option 1 (Source Data Set) and press <ENTER>.
Enter a 1-8 character name for the middle qualifier of your data set and press <ENTER>. The middle qualifier completes the name, giving you a data set named
'userid.name.SOURCE'
where userid is your computer ID and name is the name you specified for the middle qualifier. When the allocation is complete, MAKEDS will notify you via e-mail.
Note: If you are a student, you can allocate only one partitioned data set and the middle qualifier defaults to MISC (which stands for miscellaneous). So the name of your partitioned data set will be 'userid.MISC.SOURCE', where userid is your computer ID.
Press PF15 to return to the MAKEDS Data Set Authorization System panel. From there, enter 0 to exit MAKEDS.
ISPF communicates with you through a series of predefined panels. Panels may require a response, and that response determines the next panel to be displayed or the function to be performed. Responses are case-insensitive, so upper, lower, or a mixture of the two is valid.
All panels are formatted to fit on a 24-line x 80-character screen, with the first three lines of each formatted as follows:
+-----------------------------+---------------+
Line 1 | Title |Short Message |
+-----------------------------+---------------+
Line 2 | Command/Option | Scroll |
+-----------------------------+---------------+
Line 3 | Long Message |
+---------------------------------------------+The TITLE area identifies the function being performed and, where applicable, the library or data set name, member name, version number, and modification level.
The Short Message area indicates:
Current line (for Browse) and column position (for browse and edit)
Successful completion of a processing function
Error conditions
The Command/Option is where you enter a command or an option selection.
The Scroll area contains the current scroll amount whenever scrolling is applicable. You may overtype this area to change the default amount.
The Long Message area is used to display an explanation of error conditions upon request. Normally, this line is blank on selection panels and data entry panels, contains column headings on member lists, and is treated as part of the data area on data displays.
When using PDF, you will use four types of panels:
SELECTION PANEL - You select from a list of options by typing in its letter(s) on the command/option line and pressing <ENTER>. Selection panels are also called menus. The Clemson ISPF/PDF Primary Options Panel is an example of a selection panel.
ENTRY PANEL - You supply parameters by filling in labeled fields. In many cases, the fields are pre-entered with what you last entered. The EDIT - ENTRY PANEL is an example of an entry panel.
MEMBER LIST - Displays a list of members in a partitioned data set. You may select a member by entering a one-character code in front of the appropriate member name (for example, an "S" in the Browse and Edit Member List panels).
SCROLLABLE DATA DISPLAY - Displays source code that can be manipulated with the scroll commands on the COMMAND line, or with PF Keys. The edit panel is an example of a scrollable data display panel.
From ISPF's Primary Options Menu:
Select E (Edit a Data Set) and press <ENTER>. The SuperEdit - Entry Panel will appear.
Note: To get out of Edit, (and most ISPF panels), press PF15. This will return you to the previous panel.
+----------------------------------------------------------------------+ | | | ------------------ SuperEdit - Entry Panel --------------------- | | COMMAND ===> | | Valid Commands: | | ISPF LIBRARY: PARMS, CLEAR | | Project ==> UP, DOWN | | Group ==> | | Type ==> | | Member ==> (Blank or pattern for member selection list) | | | | OTHER PARTITIONED OR SEQUENTIAL DATA SET: | | Data Set Name ==> | | Volume Serial ==> Initial Macro ==> Profile ==> | | ---------------------- Dynamic Data Set List ------------------- | | | | | | | | | | | | | | | | | | | | ----------------------- Static Data Set List ------------------- | | _ | _ | | _ | _ | | _ | _ | | | +----------------------------------------------------------------------+
If you allocated a partitioned data set using MAKEDS, then you have what ISPF calls an ISPF LIBRARY, which is simply a partitioned data set consisting of 3-level name. If you want to edit a member of your or another partitioned data set whose name is 3 levels, then ISPF has a special place for you to specify the data set name and member. On the SuperEdit - Entry Panel, the fields labeled Project, Group, and Type allow you to specify a 3-level partitioned data set name.
To specify a data set, from the SuperEdit - Entry Panel,
Enter the name of the data set you want to edit in the three fields provided. If these fields are blank, or if you do not want to use the defaults already listed, enter the name of the data set you want to edit. The data set must already exist (i.e. you previously allocated it using MAKEDS).
ISPF LIBRARY:
Project ==> JOEUSER (Your computer ID)
Group ==> MISC
Type ==> SOURCE
Member ==>Note: When you use these fields to specify a data set, you do not need to specify a period to separate the levels.
You can either specify the name of a partitioned data set member or leave the Member field blank:
Name If you enter an existing member name in this
field, ISPF will will display this member for
editing.
If you enter a member name that does not
exist, a new member will be created with this
name and ISPF will display a blank screen for
editing.
Blank If you leave this field blank, and press
<ENTER>, a Member List panel will appear
listing all the existing members in that
partitioned data set. You can then select
one of these members by tabbing down to that
member name, putting an S (select) to
the left of it and pressing <ENTER>, or by
entering S member on the Command
line, where member is the member you
want to edit. If the partitioned data set has
more members than ISPF can display on one
screen, press PF20 to scroll down to see more of
the members. Press PF20 as often as you need to
see all members. You can press PF19 to
scroll back up in the member list.
Below the ISPF LIBRARY section, under the heading
OTHER PARTITIONED OR SEQUENTIAL DATA SET:
Data Set Name ==>you can specify the name of an existing sequential data or the name of a partitioned data set. (You can use this field to specify any partitioned data set, but you must use it to specify a partitioned data set whose name is not 3 levels.) You can enter the data set name fully qualified (i.e., in single quotes) or, if the data set begins with your computer ID, without the userid qualifier and without single quotes.
After specifying the data set and member to edit, a secondary edit screen will appear displaying the data set or a screen with no data (if the member is new).
+----------------------------------------------------------------------+ | | | EDIT ---- JOEUSER.MISC.SOURCE(TEST) - 1.00 -------- COLUMNS 001 072 | | COMMAND ===> SCROLL ===> PAGE | | ****** ****************** TOP OF DATA****************************** | | '''''' | | '''''' | | '''''' | | '''''' | | '''''' | | '''''' | | '''''' | | '''''' | | '''''' | | '''''' | | '''''' | | '''''' | | '''''' | | '''''' | | '''''' | | '''''' | | '''''' | | '''''' | | '''''' | | ****** **************** BOTTOM OF DATA *************************** | +----------------------------------------------------------------------+
The Title area on this panel indicates that you are in EDIT mode and shows the name of the data set and member you are editing. The data set and member names are followed by a version and modification number indicating what version of the data set you are working with, as well as the number of times you have modified the data set. A new data set will have 1.00. Once you make your first change, the modification number increases and the data set will have 1.01, and so on.
The Short Message area shows which columns are being displayed.
The cursor positions itself in the Command area after the COMMAND ==> prompt. Located to the right of the command/option area, the scroll area shows the amount that the data will move when you press PF19 (UP) or PF20 (DOWN). The default is PAGE. Other valid values include MAX, CSR, HALF, and DATA.
The third line shows TOP OF DATA.
The area with either 6-digit line numbers or a string of six single quotes is called the line command area. You can enter line commands (commands which apply to individual lines or blocks of lines) here. Do not enter data in this area.
You enter your data to the right of the line command area.
When you invoke edit on an empty data set, ISPF will position the cursor on the Command line. To enter data, press <RETURN> until the cursor moves into the line command area of the first line. Once here, press the <TAB> key to move the cursor to the data area of the first line. When you finish entering your data on this line, press <RETURN> and the <TAB> key to position the cursor at the beginning of the data area of the second line.
Conversely, when you invoke edit on an empty data set and press <ENTER> while the cursor sits on the Command line, the lines with the strings of single quotes will disappear and the TOP OF DATA and BOTTOM OF DATA lines will come together at the top of the screen.
+----------------------------------------------------------------------+ | | | EDIT ---- JOEUSER.MISC.SOURCE(TEST) - 01.00 ------ COLUMNS 001 072 | | COMMAND ===> _ SCROLL ===> CSR | | ****** ****************** TOP OF DATA **************************** | | ****** ***************** BOTTOM OF DATA ************************** | | | +----------------------------------------------------------------------+
You can enter your data by pressing <RETURN> once and entering an I in the line command area on the TOP OF DATA line. This will open up a single input line, on which you can enter your data. When you finish entering your data on this line, press <ENTER> to open up another input line.
You can use the cursor to move up and down lines and left and right across a character at a time. To scroll to the next screen of your data, you can use the following Primary Commands (entered on the Command line) or the indicated program function key:
These are Primary edit commands entered on the Command line.
You can use line commands to edit your data by entering them in the line command area (by entering the commands over the 6-digit numbers to the left of each data line). These commands permit you to insert, delete, repeat, move, or copy a line or block of lines.
Block commands, a type of line command, operate on more than one line of data. To use block commands, you place the command (MM for example) in the line command areas of both the first and last lines of the block of data. The block can span several screens, so if the last line does not appear on your screen, place the block command on the first line, then press PF20 until the last line of data appears on your screen. You can then place the last block command on the last line of the block, at which time ISPF executes the command. A message indicating that a block function is pending appears in the Short Message area of your screen if the block is not closed with its matching end of block. You will also get this message if the block command requires a BEFORE or AFTER command (Move and Copy functions require this) and this command is missing.
The move and copy commands change the location of lines and duplicate lines respectively. The overlay command allows you to rearrange a single-column list into multicolumn format. These must be used in conjunction with the after (A) or before (B) command, which indicates where to place the moved, copied, or overlayed data.
The text entry command is intended for power typing. When you enter TE in the line command area (to the left of your data), blank lines are inserted starting with the line following the TE. You can type information on the blank line without regard to line end. When you press <ENTER>, ISPF formats the data, with words broken across the line rejoined.
The text split command allows you to add new material to existing text. To split a line, enter TS in the line command area, move the cursor to the desired split point on the same line, and press <ENTER>. A new line is inserted after the line with the TS, text to the right of the cursor is moved to the next line after the inserted line and positioned at the left boundary column.
The text flow command restructures paragraphs following deletions, insertions, splittings, etc. When you enter TF in the line command area, your text is reflowed from the beginning of that line to the end of the paragraph. The end of a paragraph is denoted by a blank line, a change in indentation, or a period (.), colon (:), or ampersand (&) in column 1.
The uppercase command translates a single line or multiple lines of text to uppercase.
The lowercase command translates a single line or multiple lines of text to lowercase.
The find, change and exclude commands find a specified character string, change one character or character string to another, or exclude lines on which a specified character string has been found, respectively. These commands operate on a complete file rather than on a single data or text line and must be entered on the Command line. In the list below, text surrounded with [ ] means that it is optional.
FIND string [ALL]
For example,
FIND 'J. Smith'
will find the first occurrence of the string 'J. Smith' starting at that point in your data set, not the first line. If you would like to see the next occurrence of the string, press PF17 (RFIND). Each time you press PF17, ISPF will show you the next occurrence of the string. Once ISPF finds the last occurrence, ISPF will display BOTTOM OF DATA REACHED in the Short Message area. If you press PF17 again, ISPF will find the first occurrence of the string, starting at the first line of your data set.
If you use the ALL parameters, ISPF places the cursor at the first occurrence of the string, and displays in the Short Message area the number of times the string occurs in the data set. You can then use the PF17 key (RFIND) to see subsequent occurrences of the string.
You can abbreviate FIND as F.
------------------------------------------------------------------------
CHANGE string1 string2 [ALL]
If you enter on the Command line
CHANGE 'J. Smith' 'J.R. Smith' ALL
ISPF will change all occurrences of 'J. Smith' to 'J.R. Smith'. If you omit the ALL parameter, only the first occurrence of the string beginning at that point in your data set is changed. If you would like to change subsequent occurrences of the string, you can press the PF18 key (RCHANGE). Each time you press PF18, ISPF changes the next occurrence of the string.
You can abbreviate CHANGE as CHG, CHA, or C.
------------------------------------------------------------------------
EXCLUDE string [ALL]
If you enter on the Command line
EXCLUDE 'J. Smith'
ISPF will exclude from view (but not delete) the first occurrence of the line that contains 'J. Smith'. Press PF17 (RFIND) to exclude subsequent occurrences of the string.
If you include the ALL option, ISPF excludes from view all lines that contain the specified string.
You can abbreviate EXCLUDE as EX or X.
Each data set has a default profile, which is a set of permanently stored parameters that determine what your edit session is going to look like, such as, will the data set be all caps or can you enter and keep lower case letters, how the data set is numbered, will it automatically be saved when you end the edit session, etc. To view the profile in effect on the data set you are editing, enter PROFILE on the Command line. ISPF will display the profile at the top of your screen.
+----------------------------------------------------------------------+ | | | =PROF> ....SOURCE (FIXED 80)....RECOVERY OFF....NUMBER ON...........| | =PROF> ....CAPS ON....HEX OFF....NULLS OFF....TABS OFF..............| | =PROF> ....AUTOSAVE ON....AUTONUM ON....AUTOLIST OFF...STATS ON.....| | =PROF> ....PROFILE UNLOCK....IMACRO NONE....PACK OFF...NOTE ON......| | | +----------------------------------------------------------------------+
The values of the parameters for the default edit profile are the same for both sequential and partitioned data sets, with one exception. By default, the ISPF editor writes statistics for each member of a partitioned data set. These statistics are not kept for sequential data sets. As a result, the STATS is set to ON for partitioned data sets and OFF for sequential data sets. The values listed above are the default values for the edit parameters.
The PROFILE command only displays the parameters and their values. You can change the parameter values by entering on the Command line the parameter name followed by the value (usually ON or OFF).
When you change the value of a parameter, the change to the profile will remain in effect only during that edit session. If you would like to make a permanent change to your profile, you must first unlock the profile by entering PROFILE UNLOCK, the parameter name and its new value, then PROFILE LOCK.
To remove the profile lines from your data set, enter RES (reset) on the Command line, or use the DD block command to delete the lines.
Note: AUTOSAVE defaults to ON. When you end your edit session by pressing PF15, ISPF automatically saves all the changes you have made. If you do not want this automatic saving, enter AUTOSAVE OFF from the Command line.
For more information on the specific profile parameters, enter HELP from the Command line (or press PF13) and select item 11 (Edit Profiles).
For every data set you edit that has a different last level name, ISPF creates a new profile, in which you can set profile parameter values specific to that data set. For example, the profile for the data set 'JOEUSER.MISC.SOURCE' will be different from the profile for the data set 'JOEUSER.COBOL.CODE'. Note that the default values are the same, and that changes to the profile for 'JOEUSER.MISC.SOURCE' will not effect the members in 'JOEUSER.COBOL.SOURCE'.
If you want to create a default profile that ISPF uses for all your data sets, regardless of the last level name, you must make a new profile and tell ISPF to use it each time you invoke the editor. To do so,
On the SuperEdit - Entry Panel, put a name for the new profile in the place labeled PROFILE.
Enter PARMS on the command line and ISPF will display the Edit Parameters Panel.
+----------------------------------------------------------------------+ | ------------------------- Edit Parameters --------------------- | | COMMAND ===> | | | | | | Retain DYNAMIC data set names between sessions: YES | | | | Retain Initial Macro between edit operations: YES | | | | Retain Edit Profile between edit sessions: YES | | | | Overwrite ISPF Library Fields for 3 level name on recall: YES | | | | Use wildcards to drive data set list processor: YES | | | | Use MEMBER field with any dataset selected for editing: YES | | | | Retain only base dataset name in dynamic zone (no member names):YES | | | | | | Press <ENTER> when all changes are complete. | | | | | | | | | +----------------------------------------------------------------------+
Enter YES at the end of the line that says Retain edit profile between edit sessions. (The other lines will also require a yes or no. You will probably want to say YES for them all.)
Press <ENTER> to return you to the SuperEdit - Entry Panel.
Specify a data set to edit. Once you are in edit, enter PROFILE to list your default profile.
If the profile is locked, enter PROFILE UNLOCK, and then use the various commands to change the profile defaults to whatever you want them to be.
Then type PROFILE LOCK, and get out of EDIT.
ISPF saves this new profile, and its name will always appear on your SuperEdit - Entry Panel in the Profile field. ISPF will use this profile on all data sets you edit as long as the profile name appears on the SuperEdit - Entry Panel. If for some reason, you do not want to use this profile, blank out its name on the SuperEdit - Entry Panel. ISPF will then use a profile based on the last level name of the data set you are editing.
The nulls mode parameter determines whether trailing blanks on each data line are blanks or nulls. If the lines are filled with blanks, you must first delete them using the Erase EOF key before you can insert any text on the line. However, if the line is filled with nulls, you can insert text on the line by first pressing the insert key. If you will need to do insert text in your data, you may want to set the NULLS parameter to ON.
To turn nulls mode on, enter NULLS ON on the Command line. If you want this change to be permanent, remember to first UNLOCK your profile before issuing the command. If you do not unlock your profile, then nulls will be turned on only during that particular edit session.
You can merge or segment data by moving or copying lines into or out of the data set you are editing.
Use the copy or move primary commands to specify a partitioned data set member or sequential data set to be copied into the data set you are editing.
Note: If you use the move command, ISPF deletes the partitioned data set member or sequential data set after a successful move.
The copy and move commands are primary commands so you must enter them on the Command line. After you enter either the move or copy command, enter either the after (A) or before (B) line command in the line command area to specify the destination of the copied/moved lines of data. You may also use line labels instead to indicate the before or after line.
COPY [member name] [AFTER label]
[BEFORE label]For example, if you enter on the Command line
COPY M1 AFTER .ZF
copies all lines from the member M1, which is a member of the current data set, into the member you are editing. The source lines are copied after the line labeled .ZF. The labels .ZF and .ZL refer to the first and last lines of a data set.
You can create your own line labels on any line by overtyping the line number (6-digit number to the left of the data) with a label. Labels always start with a period followed by one to five alphabetic characters, not starting with a Z. (For example, .first, .aaa, .q) You can always use the labels .zf and .zl to refer to the first and last lines of a data set.
If you enter from the Command line
COPY M1
along with either an A or B line area command to specify a destination, ISPF will copy the member M1 from the current partitioned data set to the specified destination.
------------------------------------------------------------------------
MOVE [member name] [AFTER label
[BEFORE label]For example, entering from the Command line
MOVE
plus an A or B line area command brings up another menu which allows you to specify a member of a partitioned data set or sequential data set from which to move.
If you specify a member name, it must be a member of the partitioned data set you are editing. If you want to copy or move a member of another partitioned data set or a sequential data set, omit the member name parameter. You can issue the copy or move commands without any parameters. ISPF will display another panel on which you can specify the source data set you are copying or moving, as well as a range of lines from the source, if you don't want to copy/move the entire source. If you specify a range of lines, you must also specify the line search criteria (Standard, COBOL, Relative). Relative is recommended. It ignores line numbers in the source and interprets the specified line numbers (i.e. 1, 25) as relative to the start of the data.
Use the create or replace primary commands from the Command line to specify a data set to be written to from the data set you are editing. The create command adds a member to the partitioned data set you are editing, provided that the member name specified does not already exist. The replace command adds a member to or replaces a member in the partitioned data set you are editing. You must specify the data you want moved or copied from the data set being edited by using either a pair of line labels or by using the (MM, M#) or copy (CC, C#) line area commands. If the member name is omitted, ISPF will display a panel on which you can specify a partitioned data set member or sequential data set as the destination.
CREATE [unique member name] [line-range labels]
For example, entering from the Command line
CREATE NEWMEM .ZF .ZL
creates a new member, NEWMEM, which contains a copy of the contents of the data set you are currently editing.
CREATE NEWMEM
Creates a new member, NEWMEM, in the current data set. NEWMEM contains lines from the current member marked by a move or copy command (M#, MM .. MM, C#, CC .. CC) or by a block of lines you have defined using line labels.
REPLACE [member name] [line-range labels]
To display additional information about an ISPF error message or to provide tutorial information about commands and options, press:
PF13
To go through a self-paced tutorial of ISPF enter the following from the Clemson ISPF/PDF Primary Options Panel:
T
The jump function allows you to move from one ISPF option to another without first going back to the Clemson ISPF/PDF Primary Options Panel. On the Command line of any panel enter an equal sign (=) immediately followed by any option that is found on the Clemson ISPF/PDF Primary Options Panel.
For example, from any Command line:
Program function keys allow you to equate PF keys located on your terminal keyboard to ISPF commands. For example, the default command equated with PF15 is END, so to end an ISPF application and return to the previous panel, all you need to do is press PF15.
Note: By default, ISPF defines PF keys 1 through 12 the same as PF keys 13 through 24. That is, PF1 is the same as PF13, PF2 is the same as PF14, and so on.
You may be connecting to the mainframe via modem and your emulation software may only define 12 PF keys. The functions listed below can be accessed using either PF keys 1 through 12 or 13 through 24. For example, PF1/13 means the HELP function can be executed using either PF1 or PF13. The default functions for the PF keys are:
+----------------------------------------------------------------------+ | | | | | +----------+----------+----------+ | | | PF1/13 | PF2/14 | PF3/15 | | | | HELP | SPLIT | END | | | | | | | | | |----------+----------+----------| | | | PF4/16 | PF5/17 | PF6/18 | | | | RETURN | RFIND | RCHANGE | | | | | | | | | |----------+----------+----------| | | | PF7/19 | PF8/20 | PF9/21 | | | | UP | DOWN | SWAP | | | | | | | | | |----------+----------+----------| | | | PF10/22 | PF11/23 | PF12/24 | | | | LEFT | RIGHT | RETRIEVE | | | | | | | | | +----------+----------+----------+ | | | +----------------------------------------------------------------------+
You can enter PFSHOW from the Command line to display across the bottom of your screen the PF keys you have defined..
To remove the PF key definition display, enter from the Command line PFSHOW OFF.
You can redefine your program function keys from the defaults to any ISPF command that you would like. To do so from anywhere within ISPF, enter KEYS on the Command line, which displays the following panel:
+----------------------------------------------------------------------+ | | | ---------- PF KEY DEFINITIONS AND LABELS - PRIMARY KEYS ----------- | | COMMAND ===> | | | | NUMBER OF PF KEYS ===> 24 TERMINAL TYPE ===> 3278 | | | | PF13 ===> HELP | | PF14 ===> SPLIT | | PF15 ===> END | | PF16 ===> RETURN | | PF17 ===> RFIND | | PF18 ===> RCHANGE | | PF19 ===> UP | | PF20 ===> DOWN | | PF21 ===> SWAP | | PF22 ===> LEFT | | PF23 ===> RIGHT | | PF24 ===> RETRIEVE | | | | PF13 LABEL ===> PF14 LABEL ===> PF15 LABEL ===> | | PF16 LABEL ===> PF17 LABEL ===> PF18 LABEL ===> | | PF19 LABEL ===> PF20 LABEL ===> PF21 LABEL ===> | | PF22 LABEL ===> PF23 LABEL ===> PF24 LABEL ===> | | | | Press ENTER key to display alternate keys. Enter END command to exit| +----------------------------------------------------------------------+
These are the default PF key definitions for 13 through 24. If you would like to change a key's definition, press <RETURN> to move your cursor to the key field you would like to change and enter the new ISPF command. Press PF15 (END) to return to the previous panel. If you have a permanent ISPF profile allocated, your changes will be permanent.
If you would like to change PF keys 1 through 12, press <ENTER> while the cursor is on the Command line. This displays the default values for 1 through 12. If you press <ENTER> again, you will see 13 through 24.
If you would like to have more than one command equated to a PF key, separate the commands with semicolons (;). For example if you would like to redefine PF12 to save the data set you are editing, submit it, and then invoke IOF, you can enter
PF12 ===> SAVED;SUBMIT;IOF
In addition to the KEYS command, you can also enter IP from the Clemson ISPF/PDF Primary Options Panel. Select option 3 and use the same procedure to redefine your PF keys.
Note: IOF has it's own PF key definitions, so they can be different from the PF keys you use with all other ISPF applications. For example, your PF14 can be SPLIT by default, or NEXT in IOF. Use the KEYS command to change a key's definition within one of these three applications.
The split screen mode "splits" your display screen into two logical screens that operate independently of one another without ending the current function. This can be done anywhere within ISPF. Once your screen is split, you can swap back and forth between screens. When your cursor is located in one logical screen, the other is inactive and unaffected by anything you do in the active screen.
To split the screen:
Position your cursor at the spot on your screen below which you want the second screen to appear.
Enter SPLIT on the Command line, (or press PF14). This will divide your screen at that position, at which point you have a second ISPF session available and can select any ISPF function.
Depending on where you position your cursor before you execute the SPLIT command, ISPF may display all of or a portion of a second Clemson ISPF/PDF Primary Options Panel. ISPF marks the division between your two logical screens with a highlighted dotted line. If you divide your screen at the top or bottom line on your terminal, all you will see is the highlighted dotted line.
If you do not like where the second screen appears, just move the cursor to the preferred line and press PF14 again. This will reposition the division of your screen.
To swap between screens, enter SWAP on the Command line of the screen you want to leave, or press PF21.
To exit split screen mode and remove one of your two ISPF sessions, exit from the desired screen the same way you exit ISPF:
Enter X from the Clemson ISPF/PDF Primary Options Panel;
enter =X from any ISPF panel;
repeatedly press PF15 (END) until the second ISPF session is no longer on your screen.
Although this exits you from one of your ISPF sessions, it does not affect your other ISPF session.
The ISPF utilities provide many data set and member functions, such as
compress, rename, delete, or browse the members of a partitioned data set;
allocate, rename, delete or display the information on an entire data set;
move or copy entire data sets or members of a partitioned data set;
print or display a list of data set names for processing;
compare the contents of two data sets; and
search data sets for strings of data.
To enter the Utilities function, enter U from the Clemson ISPF/PDF Primary Options Panel, and select the desired utility.