In an earlier section, we discussed dataset allocation in "Reserving Disk Space for Your Dataset -- Dataset Allocation" on page 14, which is one of the options available on the DATA SET UTILITY panel shown in Figure 40. As you can see, there are other options available on this screen. These options are mainly related to maintaining a dataset.
+--------------------------------------------------------------------+
|
|
|
Menu Reflist Utilities Help
|
| -----------------------------------------------------------------
|
|
Data Set Utility
|
| Option
===>
|
|
|
|
A Allocate new data set
C Catalog data set
|
|
R Rename entire data set U Uncatalog
data set |
|
D Delete entire data set S Short
data set information |
| blank
Data set information
V VSAM Utilities
|
|
|
| ISPF
Library:
|
|
Project . .
|
|
Group . . .
|
|
Type . . . .
|
|
|
| Other
Partitioned, Sequential or VSAM data set:
|
|
Data Set Name . .
|
|
Volume Serial . . (if not
cataloged, required for "C") |
|
|
| Data
Set Password . . (if password
protected)
|
|
|
|
|
|
F1=Help F3=Exit F10=Actions
F12=Cancel
|
|
|
| Figure
40: Option 2 From the UTILITY SELECTION MENU -- Before
|
|
Completed
|
|
|
+--------------------------------------------------------------------+
14.1 OPTION 3.2 -- USING THE DATA SET UTILITY PANEL
In addition to dataset allocation, this panel also helps you rename a dataset, delete a dataset, display information on a dataset, catalog a dataset, and uncatalog a dataset. We are not going to discuss all of the options here, but we will talk about displaying dataset information, renaming datasets, and deleting datasets.
NOTE: In the following examples, the dataset name will be entered as an ISPF LIBRARY dataset. ISPF LIBRARY datasets are discussed in the section "The ISPF Library Dataset" on page 52.
14.1.1 Displaying Dataset Information
To display information about a dataset (either sequential or partitioned), do not type anything next to OPTION ===> and provide the dataset name as shown in Figure 41.
+--------------------------------------------------------------------+
|
|
|
Menu Reflist Utilities Help
|
| -----------------------------------------------------------------
|
|
Data Set Utility
|
| Option
===>
|
|
|
|
A Allocate new data set
C Catalog data set
|
|
R Rename entire data set U Uncatalog
data set |
|
D Delete entire data set S Short
data set information |
| blank
Data set information
V VSAM Utilities
|
|
|
| ISPF
Library:
|
|
Project . . US123
|
|
Group . . . PERSONAL
|
|
Type . . . . FILE
|
|
|
| Other
Partitioned, Sequential or VSAM data set:
|
|
Data Set Name . .
|
|
Volume Serial . . (if not
cataloged, required for "C") |
|
|
| Data
Set Password . . (if password
protected)
|
|
|
|
|
|
F1=Help F3=Exit F10=Actions
F12=Cancel
|
|
|
| Figure
41: Option 2 From the UTILITY SELECTION MENU -- Dataset
|
|
Information
|
|
|
+--------------------------------------------------------------------+
After you enter this information, press ENTER and a screen will appear which shows you information about the dataset. Press ENTER when you have reviewed the information and the DATA SET UTILITY panel will be displayed.
14.1.2 Renaming a Dataset
To rename an entire dataset (either sequential or partitioned), type:
R
next to OPTION ===> and provide the dataset name as shown in Figure 42.
After you enter this information, press ENTER and a screen will appear which allows you to rename the dataset. Type in the new name of the dataset and press ENTER to complete the rename request. Or, if you decide that you do not want to rename the dataset, issue an END command (either by pressing the PF key marked END or by typing the command END on the COMMAND line and pressing ENTER.)
+--------------------------------------------------------------------+
|
|
| Menu
Reflist Utilities Help
|
| -----------------------------------------------------------------
|
|
Data Set Utility
|
| Option ===> R
|
|
|
|
A Allocate new data set
C Catalog data set
|
|
R Rename entire data set U Uncatalog
data set |
|
D Delete entire data set S Short
data set information |
| blank Data set information
V VSAM Utilities
|
|
|
| ISPF Library:
|
| Project
. . US123
|
| Group
. . . PERSONAL
|
| Type
. . . . FILE
|
|
|
| Other Partitioned,
Sequential or VSAM data set:
|
| Data
Set Name . .
|
| Volume
Serial . . (if not cataloged,
required for "C") |
|
|
| Data Set Password .
. (if password protected)
|
|
|
|
|
| F1=Help
F3=Exit F10=Actions F12=Cancel
|
|
|
| Figure 42: Option
2 From the UTILITY SELECTION MENU -- Dataset |
|
Rename
|
|
|
+--------------------------------------------------------------------+
IMPORTANT: When you rename a dataset, be sure that you have filled out a DASD Protection Request Form to protect the dataset under the new name.
14.1.3 Deleting a Dataset
To delete an entire dataset (either sequential or partitioned), type:
+-----+
D |ENTER|
+-----+
next to OPTION ===> and provide the dataset name as shown in Figure 43.
After you enter this information, press ENTER and a screen will appear which allows you to confirm the delete request. Follow the directions on this screen to confirm the delete request. Once deleted, a dataset may not be recovered; be sure you want to delete the dataset before confirmation.
+--------------------------------------------------------------------+
|
|
|
Menu Reflist Utilities Help
|
| -----------------------------------------------------------------
|
|
Data Set Utility
|
| Option
===> D
|
|
|
|
A Allocate new data set
C Catalog data set
|
|
R Rename entire data set U Uncatalog
data set |
|
D Delete entire data set S Short
data set information |
| blank
Data set information
V VSAM Utilities
|
|
|
| ISPF
Library:
|
|
Project . . US123
|
|
Group . . . PERSONAL
|
|
Type . . . . FILE
|
|
|
| Other
Partitioned, Sequential or VSAM data set:
|
|
Data Set Name . .
|
|
Volume Serial . . (if not
cataloged, required for "C") |
|
|
| Data
Set Password . . (if password
protected)
|
|
|
|
|
|
F1=Help F3=Exit F10=Actions
F12=Cancel
|
|
|
| Figure
43: Option 2 From the UTILITY SELECTION MENU -- Dataset
|
|
Delete
|
|
|
+--------------------------------------------------------------------+
14.2 OPTION 3.1 -- USING THE LIBRARY UTILITY PANEL FOR PARTITIONED DATASET MAINTENANCE
To properly maintain a partitioned dataset -- a dataset which contains individual members -- ISPF/PDF Option 3.1 may be used. The LIBRARY UTILITY panel is shown in Figure 44.
In this section we will talk about the COMPRESS, BROWSE, DELETE, and RENAME functions of the LIBRARY UTILITY.
+--------------------------------------------------------------------+
|
|
|
Menu Reflist Utilities Help
|
| -----------------------------------------------------------------
|
|
Library Utility
|
| Option
===>
|
|
|
| blank
Display member list
E Edit member
|
|
C Compress data set
V View member
|
|
X Print index listing
B Browse member
|
|
L Print entire data set
D Delete mmber
|
|
I Data set information
R Rename member
|
|
S Short data set information P Print member
|
|
|
| ISPF
Library:
|
|
Project . .
|
|
Group . . . . . .
. . . . . .
|
|
Type . . . .
|
|
Member . . . (If B, D,
E, P, R, B, or blank selected) |
|
New Name . . (If R selected)
|
|
|
| Other
Partitioned, Sequential or VSAM data set:
|
|
Data Set Name . .
|
|
Volume Serial . . (If not
cataloged)
|
|
|
| Data
Set Password . . (If password
protected)
|
|
|
| Figure
44: Option 1 From the UTILITY SELECTION MENU -- Before
|
|
Completed
|
|
|
+--------------------------------------------------------------------+
14.2.1 Compressing a Partitioned Dataset
Partitioned Datasets should be compressed regularly to "squeeze" out unused space. If the file is subject to frequent editing, it should be compressed frequently.
First, let's find out some general information about a particular dataset. We talked earlier about retrieving dataset information using Option 3.2. Similarly, we can use Option 3.1 to retrieve the same information.
Suppose Mary wanted to check her dataset US123.PERSONAL.FILE. She would type:
+-----+
I |ENTER|
+-----+
next to OPTION ===> and include the dataset name as shown in Figure 45.
+--------------------------------------------------------------------+
|
|
|
Menu Reflist Utilities Help
|
| -----------------------------------------------------------------
|
|
Library Utility
|
| Option
===> I
|
|
|
| blank
Display member list
E Edit member
|
|
C Compress data set
V View member
|
|
X Print index listing
B Browse member
|
|
L Print entire data set
D Delete mmber
|
|
I Data set information
R Rename member
|
|
S Short data set information P Print member
|
|
|
| ISPF
Library:
|
|
Project . . US123
|
|
Group . . . PERSONAL . . .
. . . . . .
|
|
Type . . . . FILE
|
|
Member . . . (If B, D,
E, P, R, B, or blank selected) |
|
New Name . . (If R selected)
|
|
|
| Other
Partitioned, Sequential or VSAM data set:
|
|
Data Set Name . .
|
|
Volume Serial . . (If not
cataloged)
|
|
|
| Data
Set Password . . (If password
protected)
|
|
|
| Figure
45: Option 1 From the UTILITY SELECTION MENU -- Dataset
|
|
Information Requested
|
|
|
+--------------------------------------------------------------------+
After May supplies this information, and presses ENTER, the dataset information is displayed, as shown in Figure 46.
What to look for here are the numbers for "Allocated kilobytes" and "Used kilobytes." They are the same, which suggests that the dataset should be compressed. After reviewing this information, Mary presses ENTER and the LIBRARY UTILITY panel will be displayed. Mary can compress the dataset US123.PERSONAL.FILE by typing:
+-----+
C |ENTER|
+-----+
next to OPTION ===> and supplying the dataset name, as shown in Figure 47.
+--------------------------------------------------------------------+
|
|
|
Menu Reflist Utilities Help
|
| ----------------------
Data Set Information ----------------------|
|
|
| Command
===>
|
|
|
| Data
Set Name . . . .: US123.PERSONAL.FILE
|
|
|
| General
Data:
Current Allocation:
|
|
Management Class: STANDARD
Allocated kilobytes: 599 |
|
Storage Class: SCPRIME
Allocated extents: 10 |
|
Volume:
UGA906 Maximum dir.blocks:
5 |
|
Device type: 3380
Allocated extents: 8 |
|
Data Class:
|
|
Organization: PO
|
|
Record format: FB
|
|
Record length: 80
|
|
Block size:
27920 Current Utilization:
|
|
1st extent kilobytes: 109
Used kilobytes: 572 |
|
Secondary kilobytes: 2
Used extents:
10 |
|
Data set name type: PDS
Used dir. blocks: 1 |
|
Number of members: 12 |
|
|
|
Creation date: . . : 1994/02/11
|
|
Expiration date . : ***None***
|
|
|
|
|
| Figure
46: Option 1 From the UTILITY SELECTION MENU -- Dataset
|
|
Information Displayed
|
|
|
+--------------------------------------------------------------------+
+--------------------------------------------------------------------+
|
|
|
Menu Reflist Utilities Help
|
| -----------------------------------------------------------------
|
|
Library Utility
|
| Option
===> C
|
|
|
| blank
Display member list
E Edit member
|
|
C Compress data set
V View member
|
|
X Print index listing
B Browse member
|
|
L Print entire data set
D Delete mmber
|
|
I Data set information
R Rename member
|
|
S Short data set information P Print member
|
|
|
| ISPF
Library:
|
|
Project . . US123
|
|
Group . . . PERSONAL . . .
. . . . . .
|
|
Type . . . . FILE
|
|
Member . . . (If B, D,
E, P, R, B, or blank selected) |
|
New Name . . (If R selected)
|
|
|
| Other
Partitioned, Sequential or VSAM data set:
|
|
Data Set Name . .
|
|
Volume Serial . . (If not
cataloged)
|
|
|
| Data
Set Password . . (If password
protected)
|
|
|
| Figure
47: Option 1 From the UTILITY SELECTION MENU -- Dataset
|
|
Compressed
|
|
|
+--------------------------------------------------------------------+
IMPORTANT: Notice the COMPRESS SUCCESSFUL message in the upper right-hand corner of the screen. You should not press any keys until you see this message.
After the COMPRESS SUCCESSFUL message is displayed in the upper right-hand corner of the screen, Mary can request information about the dataset, as described above, and she should see that the number of kilobytes used is less than the number of kilobytes allocated. *
* There is an associated charge for dataset stored on disk units. Disk charges are computed on the number of kilobytes allocated and not on the number used. Reducing the number of kilobytes allocated is discussed in the "TSO Dataset Maintenance Commands" on page 88.
If you forget about compressing your dataset, you may, while editing a dataset, attempt to end the edit session or use the SAVE command to save changes to the dataset and receive an error message. This error message, or "SYSTEM ABEND" will be displayed in the upper right-hand corner of the screen. This error means there is not enough room for this new copy to be placed in the dataset. When this happens, you should:
1. SPLIT the screen.
2. Select Option 3.1.
3. Compress the dataset as described.
4. END the session for Option 3.1
and return to the edit session to either end the edit session or issue
the SAVE command.
For more information on the SPLIT and END commands, see "Commands Associated with Program Function Keys" on page 45.
14.2.2 Using the Member List to BROWSE, RENAME and DELETE Members
You can use Option 3.1 to BROWSE, RENAME,
and DELETE members of a partitioned dataset. While you can do this on a
member by member basis, we are going to describe how this is done from
a member list. If you do not specify a member name, only providing the
name of a partitioned dataset on the LIBRARY UTILITY panel shown in Figure
44 on page 74, ISPF/PDF will display the member list of that dataset when
you press ENTER. Notice also that we have not supplied anything next to
OPTION ===>. Therefore, we have selected "blank - Display member list."
You can then BROWSE, RENAME, or DELETE members from the member list. *
Mary's partitioned dataset specified in this manner will look like the
member list shown in Figure 48.
------------------------
* There are other options in addition
to BROWSE, RENAME, and DELETE, but these three are the most useful and
are the only ones discussed here.
+--------------------------------------------------------------------+
|
|
|
Menu Functions Utilities Help
|
| ------------------------------------------------------------------|
| LIBRARY
US123.PERSONAL.FILE
Row 00001 of 00007|
| Command
===>
Scroll ===> PAGE|
|
Name Rename VV.MM Created
Changed Size Init Mod ID |
| _ CB119L
01.15 86/07/07 88/07/11 21:28 14 6
0 US123|
| _ CB119P
01.06 86/07/07 88/07/07 16:30 6 18
0 US123|
| _ END
01.03 85/10/08 85/10/08 15:16 6 18
0 US123|
| _ EXAMPLE1
01.07 86/01/06 88/01/21 09:09 26 26 0 US123|
| _ EZ
01.03 87/12/10 88/02/03 17:26 6 18
0 US123|
| _ FAC
01.00 85/08/30 87/10/01 13:44 45 45 0 US123|
| _ VITA
01.00 85/10/03 87/01/23 17:02 53 53 0 US123|
|
|
|
|
|
|
|
|
|
|
|
F1=Help F3=Exit F10=Actions
F12=Cancel
|
|
|
| Figure
48: Member List From a Partitioned Dataset Specified on
|
|
the LIBRARY UTILITY Panel
|
|
|
+--------------------------------------------------------------------+
14.2.2.1 To BROWSE a Member in the Member List
1. Locate the member you wish to BROWSE on the screen. If you do not see the member name, you can use the UP and DOWN commands (or PF keys) to locate the member.
2. Position the cursor next to the member on the left side and type:
+-----+
B |ENTER|
+-----+
3. The member you selected will now be displayed. When you have finished browsing the member, either press the PF key which is the equivalent to the command END or type:
+-----+
END |ENTER|
+-----+
next to COMMAND ==> to return to the member list. To return to the LIBRARY UTILITY panel either press the PF key which is the equivalent to the command END or type:
+-----+
END |ENTER|
+-----+
next to COMMAND ==>.
14.2.2.2 To RENAME a Member in the Member List
1. Locate the member you wish to RENAME on the screen. If you do not see the member name, you can use the UP and DOWN commands (or PF keys) to locate the member.
2. Position the cursor next to the member on the left side and type:
R
and do not press ENTER.
3. Now, position the cursor -- pressing the TAB key is the easiest way -- on the right side of the member and type the new name. (If you press ENTER before entering the new name, a message requesting you to enter a new member name will appear in the upper right-hand corner of the screen.)
4. After the new name is entered, press ENTER, and the renamed member will be shown with a *RENAMED message. This message indicates that the member has been successfully renamed.
5. You can continue to rename members in this way, or return the the LIBRARY UTILITY panel by typing:
+-----+
END |ENTER|
+-----+
next to COMMAND ==>.
14.2.2.3 To DELETE a Member in the Member List
IMPORTANT: When you delete a member of a partitioned dataset as described as follows, you WILL NOT be prompted for a confirmation. Be sure you are ready to delete a member of a dataset before using this procedure.
1. Locate the member you wish to DELETE on the screen. If you do not see the member name, you can use the UP and DOWN commands (or PF keys) to locate the member.
2. Position the cursor next to the member on the left side and type:
+-----+
D |ENTER|
+-----+
3. After you press ENTER, the deleted member will be shown with a *DELETED message. This message indicates that the member has been successfully deleted.
4. You can continue to delete members in this way, or return to the LIBRARY UTILITY panel by typing:
+-----+
END |ENTER|
+-----+
next to COMMAND ==>.
14.3 OPTION 3.3 -- USING THE MOVE/COPY UTILITY PANEL
You can use ISPF/PDF Option 3.3 to move or copy from one dataset to another dataset. While this can be done using TSO commands (see "TSO Dataset Maintenance Commands" on page 88), ISPF/PDF provides the MOVE/COPY UTILITY panel to assist you. The MOVE/COPY panel is shown in Figure 49.
While there are many options, we will discuss here the way you can move or copy members of one partitioned dataset to another partitioned dataset (sequential datasets can also be copied and moved using the MOVE/COPY UTILITY panel). A member which is "moved" no longer exists in the partitioned dataset it was moved from. A member which is "copied" still exists in the partitioned dataset it was copied from.
+--------------------------------------------------------------------+
|
|
|
Menu Reflist Utilities Help
|
| ------------------------------------------------------------------|
|
Move/Copy Utility
|
| Option
===>
|
|
More: +|
|
C Copy data set or member(s)
CP Copy and print
|
|
M Move data set or member(s)
MP Move and print
|
|
L Copy and LMF lock member(s)
LP Copy, LMF lock, & print |
|
P LMF Promote data set or member(s) PP LMF Promote and print
|
|
|
| Specify
"From" Data Set below, then press Enter key
|
|
|
| From
ISPF Library:
|
|
Project . . . (--- Options C,
CP, L, and LP only ---) |
|
Group . . . . . . .
. . . . . .
|
|
Type . . . .
|
|
Member . . . (blank or pattern for
member list, |
|
'*' for all members)
|
|
|
| From
Other Partitioned or Sequential Data Set:
|
|
Data Set Name . . .
|
|
Volume Serial . . .
(If not cataloged)
|
|
|
|
F1=Help F3=Exit F10=Actions
F12=cancel
|
| DATA
SET PASSWORD ===>
(If password protected)
|
|
|
| Figure
49: Option 3 From the UTILITY SELECTION MENU
-- The |
|
MOVE/COPY UTILITY Panel
|
|
|
+--------------------------------------------------------------------+
14.3.1 Moving a Member From One Dataset to Another Dataset
1. To move a member from one dataset to another, type:
M
next to OPTION ===>. Do not press ENTER.
2. Specify the dataset name. Notice that the instructions on the screen indicate that you can enter nothing next to MEMBER ===> to have the member list displayed. If you do not enter the dataset as an ISPF LIBRARY dataset -- you enter it in the FROM OTHER PARTITIONED OR SEQUENTIAL DATA SET area -- enter the dataset with no member specified to retrieve the member list. This is the dataset from which members will be moved.
3. Press ENTER and a screen will be displayed where you can enter the name of the partitioned dataset that you want the members moved to.
4. Specify the dataset you want the members moved to. When you press ENTER, the member list of the dataset you are moving from will be displayed.
5. Type:
+-----+
S |ENTER|
+-----+
to the left of each member to be moved. (You can use the UP and DOWN commands or PF keys to page through the member list.)
6. When you have selected the member(s) to be moved, press ENTER and the *MOVED message will appear next to the member(s) moved.
7. Issue the END command (either by pressing the PF key for END or by typing END next to OPTION ===> and pressing ENTER) to return to the MOVE/COPY UTILITY panel.
14.3.2 Copying a Member From One Dataset to Another Dataset
The procedure to copy members is the same as moving members, as described in "Moving a Member From One Dataset to Another Dataset" on page 82. The only differences are:
1. You should type C instead of M next
to OPTION ===> on the MOVE/COPY UTILITY panel.
2. All MOVE or *MOVED messages will
be COPY or *COPIED.
15.1 REMINDER ABOUT LEAVING ISPF/PDF
Leaving ISPF is discussed in "Ending an ISPF/PDF Session" on page 12 and "The = Shortcut" on page 51. When you leave ISPF/PDF you will see the TSO READY message. The TSO READY message is described in "The TSO READY Message" on page 9.
15.2 HOW TSO COMMANDS ARE ENTERED
Normally, TSO commands are entered from the TSO READY message; however, you can also enter TSO commands from within ISPF/PDF in two ways.
15.2.1 ISPF/PDF Option 6 -- The TSO COMMAND PROCESSOR
Option 6 is an ISPF/PDF option which allows you to enter TSO commands without having to leave ISPF/PDF. The Option 6 panel is shown in Figure 50.
Most TSO commands can be entered next to ===>. The only exceptions are those commands which are meaningful to both TSO and ISPF/PDF. The HELP command is an example. You can issue the command HELP from the TSO READY message and receive help about using TSO. You can also enter HELP within ISPF/PDF to receive help on ISPF/PDF functions. So, if you enter the command HELP from the TSO COMMAND PROCESSOR, you will receive help on ISPF/PDF. Whenever this situation appears to be the case, enter the TSO command as follows:
+-----+
TSO command |ENTER|
+-----+
next to ===>. The 'command' is a valid TSO command.
+--------------------------------------------------------------------+
|
|
|
Menu List Mode Functions Utilities Help
|
| ------------------------------------------------------------------|
|
ISPF Command Shell
End of Data|
| Enter
TSO or Workstation command below:
|
|
|
| ===>
|
|
|
|
|
|
|
| Place
cursor on choice and press enter to retrieve command
|
|
|
| =>
|
| =>
|
| =>
|
| =>
|
| =>
|
| =>