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
|
|
|
| =>
|
| =>
|
| =>
|
| =>
|
| =>
|
| =>
|
| =>
|
| =>
|
| =>
|
| =>
|
|
|
|
|
|
F1=Help F3=Exit F10=Actions
F12=Cancel
|
|
|
| Figure
50: Option 6 -- The TSO COMMAND PROCESSOR
|
|
|
+--------------------------------------------------------------------+
15.2.2 The TSO Prefix
Whenever you are using any of the ISPF/PDF options, you can enter a valid TSO command on the COMMAND ===> or OPTION ===> lines by preceding the command with TSO as follows:
+-----+
TSO command |ENTER|
+-----+
The 'command' is a valid TSO command.
While this is similar to using ISPF/PDF Option 6, notice that all TSO commands
must be preceded by TSO.
Whenever you are using TSO, you can issue the HELP command to retrieve information about specific commands. You ask for help when the TSO READY message is displayed. The command is entered by typing:
+-----+
HELP command
|ENTER|
+-----+
where 'command' is a TSO command. For example, if you wanted to find out about the LISTCAT command (described in "The LISTCAT Command" on page 89), you would type:
+-----+
HELP LISTCAT |ENTER|
+-----+
After you press ENTER, the help information will be displayed on your terminal screen.
16.2 THE IDS COMMAND
University Computing and Networking Services maintains on online document delivery system know as the Information Distribution System. As a TSO user, you can access IDS by typing the command:
+-----+
IDS |ENTER|
+-----+
whenever you see the TSO READY message. Follow the directions shown by IDS to retrieve a specific document, a list of related documents, or a list of all available documents.
16.3 THE LIST COMMAND
You can list a dataset (or dataset member) to the terminal screen by typing the following command when the TSO Ready message is displayed:
+-----+
LIST dataset numopt
|ENTER|
+-----+
where 'dataset' is the name of the dataset you want to list and 'numopt' is NONUM for a dataset that does not contain line numbers. If the dataset does contain line numbers, do not specify the NONUM option. (See "NUMBER ON or NUMBER OFF" on page 37 for a brief discussion on numbered datasets.)
Of course it is impossible to determine what each of you is likely to do, but many users see no advantage to including line numbers as a part of a dataset. Our user Mary is one of these people. So, if she were going to list member VITA in the dataset US123.PERSONAL.FILE, she would type:
+-----+
LIST 'US123.PERSONAL.FILE(VITA)'
NONUM |ENTER|
+-----+
16.4 THE PRINTOFF COMMAND FOR PRINTING DATASETS
You can print a dataset (or dataset member) on one of the printers located at the Central Site -- first floor of the Boyd Graduate Studies Research Center -- or printers located at one of the Computer Services Sites. Datasets are printed by typing the following command whenever the TSO READY message is displayed:
+-----+
PRINTOFF dataset DEST(dest)
CLASS(class) COPIES(copies) |ENTER|
+-----+
where:
'dataset' is the name of the dataset to be printed.
'dest' is the place you want the dataset to be printed. If you do not supply a destination, the dataset will be printed on the printers located on the first floor of the Boyd Graduate Studies Research Center and placed in the output bins located there. The printed dataset will be filed in the bin under the first letter of your USERID. Other destinations are provided in the appendix "UCNS Computer Services Sites" on page 106 as "destination code" for each listed site.
'class' is a printer class to select the format of the printed page.
If you supply a destination, indicating that you do not want the dataset printed on printers located in the Boyd Building, do not supply a class. (In other words, you have no choice. The printers located at the Computer Services Sites are standard line printers. Your dataset will be printed on greenbar, i.e., "computer" paper.)
If you do not supply a destination, indicating that you want the dataset printed on the printers located in the Boyd Building, you should supply a class. The available print classes are shown in the appendix "Page Printer SYSOUT Classes" on page 105.
'copies' is the number of copies you want to print. This must be a number less that 255. If you do not supply a number for copies, one copy of the dataset will be printed. When printing the dataset on one of the printers at the Computer Services Sites, you are restricted to the number of lines that you can print.
Mary would issue the following command to print the member VITA in here dataset S123.PERSONAL.FILE. Notice that she has not supplied a destination (indicating that the dataset will be printed on the printers in the Boyd Building). In addition, she would like to print using the print class K and she would like 5 copies of the printed dataset. The command is:
+-----+
PRINTO 'US123.PERSONAL.FILE(VITA)'
CL(K) COP(10) |ENTER|
+-----+
The PRINTOFF command can be shortened to PRINTO, the CLASS option can be shortened to CL, and the COPIES option can be shorted to COP. She could also print the dataset on the printer located in the Journalism Computer Services Site with the command:
+-----+
PRINTO 'US123.PERSONAL.FILE(VITA)'
DEST(SSS02) COP(10) |ENTER|
+-----+
16.5 TSO DATASET MAINTENANCE COMMANDS
It is sometimes necessary to use commands not available in ISPF/PDF to be assured of dataset security and integrity. In this section we will discuss the commands LISTCAT, LISTP, LISTDOG, SPACECHG, COPY, DELETE, and RENAME. Information on tape backup procedures is also a part of this section.
16.5.1 The LISTCAT Command
The LISTCAT command (the short form of the command is LISTC) is used to list all the datasets which you have created; i.e., those datasets which have a first-level qualifier of your USERID.
The command is entered as follows:
+-----+
LISTC |ENTER|
+-----+
If Mary were to issue the LISTC command, information similar to that shown in Figure 51 will be displayed.
+--------------------------------------------------------------------+
|
|
| IN CATALOG:SYS1.ICFUSER1
|
| US123.PERSONAL.FILE
|
| US123.PYRO
|
| US123.PINK.FILES
|
| US123.PROGRAMS
|
|
|
| Figure
51: Information from LISTC Command
|
|
|
+--------------------------------------------------------------------+
16.5.2 The LISTP Command
You can use the TSO command LISTP to get information about a dataset:
+-----+
LISTP DSN(characters)
|ENTER|
+-----+
where 'characters' matches all or part of a dataset name (or names), starting with the first-level qualifier. For example, Mary may want to see the protection information on all of her datasets which have the letter P as the first letter of the second-level qualifier. Since Mary's USERID (and first-level qualifier) is US123, she would enter the command as follows:
+-----+
LISTP DSN(US123.P) |ENTER|
+-----+
and the information shown in Figure 52 will be displayed.
In addition to information about the MANAGEMENT CLASS of the dataset and the last time the dataset was used, LISTP also shows:
+--------------------------------------------------------------------+
|
|
|
LAST KILO BYTES SCRATCH DS
|
| DATASET-NAME---------MGMTCLAS-USED----ALLOC--USED-DATE----TYP-COST|
| US123.PERSONAL.FILE
STANDARD11FEB94 400 300 7DEC94 MT $0.02|
| US123.PYRO
RETAIN2817FEB94 100 50 21FEB94 AC $0.05|
|
ESTIMATED COST PER DAY = $0.41|
|
ESTIMATED COST PER MONTH = $12.30|
|
|
| Figure
52: Information from LISTP Command
|
|
|
+--------------------------------------------------------------------+
KILOBYTES ALLOC The number of kilobytes allocated for the dataset. This includes the PRIMARY QUANTITY and SECONDARY QUANTITY that has been allocated as needed.
KILOBYTES USED The actual number of kilobytes the dataset is using, which can be less than the number of kilobytes allocated.
SCRATCH DATE The date the dataset will be removed. For STANDARD datasets, this will be 18 months from the LAST USED date.
DS TYP The three DATASET TYPES are MT and AC. MT datasets have been migrated to tape. AC datasets are active on disk. MD datasets are migrated to the compression disk.
COST The approximate cost for dataset storage. Disk charges are computed on the number of bytes allocated and not on the number of bytes currently used.
16.5.3 The LISTDOG Command
The LISTDOG command is used to list the characteristics of a specified dataset. The information you receive about the dataset includes record format (shown as RECFM), record length (shown as LRECL), etc.
The command is entered as follows:
+-----+
LISTDOG dataset options
|ENTER|
+-----+
where 'dataset' is the name of the dataset that you want to find out more about. The 'options' include: STATUS, HISTORY, and MEMBERS. STATUS and HISTORY provide all the information you need if the dataset is not a partitioned dataset. You can include the additional option MEMBERS if you want to see a list of all the members in a partitioned dataset.
For example, Mary may want to see the information on her dataset US123.PERSONAL.FILE. This is a partitioned dataset, so she will use the MEMBERS option to also list all the members of the dataset. She would enter the command as follows:
+-----+
LISTDOG PERSONAL.FILE
S H M |ENTER|
+-----+
Notice that Mary did not use the fully qualified form of the dataset name; therefore, she did not use the single quote marks around the name. Also she used the short form of the options -- only the first letter of each is required. The information shown in Figure 53 will be displayed.
+--------------------------------------------------------------------+
|
|
| US123.PERSONAL.FILE
|
| -RECFM-LRECL-BLKSIZE-DSORG-CRDT--LUDT--EXDT--SECURITY-DDNAME--DISP|
|
FB 80 9040 PO
032488 091888 000 RACF SYS0004 KEEP,KEEP|
|
-VOLUMES--TRKS ALLOC--TRKS USED--
|
|
UGAK00 11
5
|
|
-MEMBERS
|
|
HOME
|
|
KIDS
|
|
VITA
|
|
|
| Figure
53: Information from LISTDOG Command. Notice the allo-
|
|
cation amount is shown in "tracks." One track is
|
|
about 50KB.
|
|
|
+--------------------------------------------------------------------+
16.5.4 The SPACECHG Command
SPACECHG allows you to add space to a dataset or reduce space from a dataset. SPACECHG allows you to change the number of directory blocks, the primary quantity, and the secondary quantity. Directory blocks and quantities are discussed in "Reserving Disk Space for Your Dataset -- Dataset Allocation" on page 14.
Begin by typing:
+-----+
SPACECHG |ENTER|
+-----+
You will then be asked to supply the new information for the dataset. Notice that the request for "unit of allocation" does not include a choice for kilobytes. You can use "trk" (for tracks). One track is about 50KB.
After all the information is supplied, the TSO service will respond with a "JOB USERIDC SUBMITTED" message. The characters "USERID" will be replaced with your USERID.
16.5.5 The COPY Command
In the section "Option 3.3 -- Using the MOVE/COPY UTILITY Panel" on page 81, we described how you can use the ISPF/PDF MOVE/COPY UTILITY to copy datasets and dataset members. You can also do this with the TSO command COPY. The command is issued from the TSO READY message as follows:
+-----+
COPY from_dataset to_dataset
numopt |ENTER|
+-----+
where 'from-dataset' is the name of the dataset you want to copy from, 'to-dataset' is the dataset you want to copy to, and 'numopt' is NONUM for a dataset that does not contain line numbers. * If the dataset does contain line numbers, do not specify the NONUM option. (See "NUMBER ON or NUMBER OFF" on page 37 for a brief discussion on numbered datasets)
Of course it is impossible to determine what each of you is likely to do, but many users see no advantage to including line numbers as a part of a dataset. Our user Mary is one of these people. So, if she were going to copy the member VITA in the dataset US123.PERSONAL.FILE to a member VITBAC in the dataset US123.TMP.BCK, she would type:
+-----+
COPY 'US123.PERSONAL.FILE(VITA)'
US123.TMP.BCK(VITBAC) NONUM |ENTER|
+-----+
16.5.6 The DELETE Command
To delete a dataset (or dataset member), type the following command at the TSO READY message:
+-----+
DELETE 'dataset' |ENTER|
+-----+
where 'dataset' is the name of the dataset you wish to delete.
------------------------
* You cannot use the TSO command COPY to copy a member of a partitioned dataset to another member of the same partitioned dataset.
16.5.7 The RENAME Command
To rename a dataset (or dataset member), type the following command at the TSO READY message:
+-----+
RENAME 'old_dataset'
'new_dataset' |ENTER|
+-----+
where 'old_dataset' is the present name of the dataset and 'new_dataset' is the new name for the dataset.
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.
16.6 TAPE BACKUP PROCEDURES
As we have discussed datasets so far,
we have limited our discussion to disk-resident datasets. With all data,
it is always in your best interest to keep backup copies. Magnetic tape
is the most economical way to store your backed up data. The appendix "TSO
Tape Procedures for Securing Datasets" on page 98 is a complete description
of procedures involved in securing your TSO disk-resident datasets on magnetic
tape.
17.1 THE PERMIT COMMAND
When you create a dataset (with your USERID as the first-level qualifier), you own that dataset exclusively. This implies that others may access that dataset only with your explicit permission. You can allow other users to access your datasets with varying degrees of control by issuing the PERMIT command. The PERMIT command is issued by typing:
+-----+
PERMIT dataset ID(yyxxx)
ACCESS(nnnnn) |ENTER|
+-----+
where 'dataset' represents the dataset which you are allowing others to access, 'yyxxx' represents the USERID of the person you wish to allow to access the dataset, and 'nnnnn' represents the type of control you wish that other user to exercise over the dataset. Only enclose the dataset name in single quotes if you are using the fully qualified dataset name.
There are four types of access permission that are commonly granted to another user. Going from the lowest level of control to the highest level of control, these are NONE, READ, UPDATE, and ALTER.
NONE NONE is the level of control allowed other users at the time of the creation of the dataset. As the word implies, other users have no access to your datasets. You would use NONE to remove a user from having access to your dataset.
READ READ allows the user to read or copy from your dataset into his or her own dataset. The user can do nothing to your original dataset except list its contents, read its contents as input to a program, or copy its contents.
UPDATE UPDATE allows the user to edit your dataset -- insert lines, change lines, and delete lines. The user may, in fact, delete all the lines within the dataset, but he cannot delete the dataset itself.
ALTER ALTER allows the user to alter the RACF protection of the dataset, thereby permitting others to have access to the dataset. If someone has ALTER access to your dataset, he can delete the dataset.
Use of the PERMIT command is advisable when you wish to permit only limited numbers of users to your dataset.
17.2 THE SEARCH COMMAND
The SEARCH command is commonly used to list datasets and the volume that the datasets reside on. The SEARCH command, as shown following, can also be used to list datasets that other users may have permitted you access to. The form of the command is:
SEARCH MASK(characters) VOLUME
where 'characters' is all or part of a dataset name. (SEARCH can be shorted to SR, MASK to MA, and VOLUME to VOL.). Our user Mary, for example, can list all her datasets with second-level qualifier starting with the letter P by issuing the command:
+-----+
SR MA(US123.P) VOL |ENTER|
+-----+
The information listed will include each dataset and the volume on which the dataset resides.
This document is now available on the UGA Gopher via: Navigate --> UCNS --> Documentation
or via WWW at http://www.uga.edu/~ucns
(Note: The character in front of ucns is a tilde.)
0000 Program ran to completion; no errors, no warnings.
0004
Program ran to completion; no errors, but warning messages were issued.
Depending on these messages, the warnings issued may or may not be
serious.
0008 Errors encountered, output may be flawed.
0012 Fatal errors encountered, any output produced may be flawed.
Other Condition Codes may be produced; contact Client Services for further assistance with them.
A Condition Code of 0000 does not necessarily mean correct output. It simply means that there were no language or logic errors or system conflicts in the program.
First of all, you need to provide the UCNS tape librarian with a magnetic tape to be used as the medium on which you will back up and retrieve desired datasets. Take a magnetic tape which you have purchased (or already have) to the librarian, located in the machine room on the first floor of the Boyd Graduate Studies Building. The librarian will ask you to fill out a Tape Library Submission/Removal Form and then insert your tape in the library. You should have the submission/removal form close by when following the procedures described here.
C.1 STDLABEL
STDLABEL creates the Job Control Language (JCL) and submits a batch job which will write an IBM standard label on the tape. One word of caution before using STDLABEL; if there is already data on the tape, it will be erased.
At the READY prompt enter: STDLABEL and respond to system inquiries.
DO YOU WISH TO CONTINUE WITH THIS LABEL PROCEDURE (Y/N)?
A response of Y continues the procedure as shown following; an N entered here will terminate the procedure.
ENTER VOLUME SERIAL NUMBER OF TAPE (VSN - INTERNAL LABEL)
The standard label can be from 1 to 6 characters long. You may enter any combination of letters and/or numbers, but this label should begin with a letter. In the future, you will refer to this particular tape by this particular label. Sometimes the standard label is referred to as the VSN (Volume Serial Number) or internal label. If asked to supply the VSN or internal label in other procedures which involve this tape, use the standard label.
ENTER VISUAL REEL NUMBER OF TAPE (VRN)
The VRN is assigned to the tape by the tape librarian, and it is the actual number of the slot where the tape is stored. Refer to your tape submission/removal form for the VRN. The VRN is usually 5 characters, in the form: #nnnn
ENTER TAPE KEYWORD
The keyword is a 1 to 4 character word of your choice. This word is affixed to the tape when submitted to the tape library and serves as a security check. The keyword to be entered is shown on the submission/removal form.
ENTER JOBNAME
Choose a name to identify your job.
ENTER DESTINATION CODE WHERE YOU WOULD
LIKE YOUR OUTPUT TO PRINT
(EXAMPLE: SSS03 FOR ADERHOLD, DEFAULT
IS LOCAL)
To print the output at the UGA central site, simply enter a carriage return. To have the output printed at one of the UGA campus computer services sites, enter the appropriate identifying number, which is in the form SSSxx.
This completes the STDLABEL procedure. The information that you entered at each of these prompts will be displayed and you will be asked if the information is correct. Provided that the information is correct, enter Y at the final prompt to submit the job. The jobname and the job number (in the form Jxxxx) will then be displayed.
C.2 BACKUP
BACKUP provides an easy way to make backup copies on tape of your "permanent" datasets. The tape must be standard labeled.
At the READY prompt, enter: BACKUP and respond to system inquiries.
DO YOU WISH TO CONTINUE WITH THIS BACKUP PROCEDURE (Y/N)?
A response of Y continues the procedure as shown following; an N entered here will terminate the procedure.
ENTER VOLUME SERIAL NUMBER OF TAPE (VSN - INTERNAL LABEL)
This is the VSN -- internal label -- that was assigned in the STDLABEL procedure. The standard label can be from 1 to 6 characters long. You may enter any combination of letters and/or numbers, but this label should begin with a letter. In the future, you will refer to this particular tape by this particular label. Sometimes the standard label is referred to as the VSN (for Volume Serial Number) or internal label. If asked to supply the VSN or internal label in other procedures which involve this tape, use the standard label.
ENTER VISUAL REEL NUMBER OF TAPE (VRN)
The VRN is assigned to the tape by the tape librarian, and it is the actual number of the slot where the tape is stored. Refer to your tape submission/removal form for the VRN.
ENTER TAPE KEYWORD
The keyword is a 1 to 4 character word of your choice. This word is affixed to the tape when submitted to the tape library and serves as a security check. The keyword to be entered is shown on the submission/removal form.
ENTER JOBNAME
Choose a name to identify your job.
WHAT FILE ON TAPE #____ DO YOU WANT TO BACK UP TO? (FILE 1 IS THE BEGINNING OF TAPE)
Choose file # 1 on a new tape.
The information that you entered at each of these prompts will be displayed and you will be asked if the information is correct. Provided that the information is correct, enter Y.
DO YOU WISH TO BACK UP ALL OF YOUR PERMANENT DATASETS (Y/N)?
If you enter Y, all of your permanent datasets will be copied to tape file 1, and the job will be submitted for processing. (All members of a partitioned dataset will be backed up.) If you enter N, you will be asked to enter the datasets you want included in tape file 1. Of course, there are many options here as to which datasets and how many datasets you include in each tape file. You may, for example, wish to have each tape file correspond to each permanent dataset. This may not be practical if you have a lot of datasets, since BACKUP would have to be run for each dataset. Whatever you elect to do, it is probably a good idea to keep a record of the datasets contained in each tape file. After you have selected your datasets for tape file 1, enter a carriage return to submit the job for processing. The jobname and the job number will then be displayed.
Important: The backup file created with the BACKUP procedure is a specially formatted file. It is usually NOT transportable to another institution. Contact Client Services if you need to move files to another institution.
C.3 RETRIEVE
The RETRIEVE procedure is designed to retrieve a dataset from your BACKUP tape created by the BACKUP procedure. Be sure to have your output from BACKUP so that you will be able to provide the necessary information.
At the READY prompt, enter: RETRIEVE and respond to system inquiries.
DO YOU WISH TO CONTINUE WITH THIS RETRIEVE PROCEDURE (Y/N)?
A response of Y continues the procedure as shown following; an N entered here will terminate the procedure.
DSNAME
The name of the tape-resident dataset should be supplied here in its fully qualified form, but WITHOUT the single quotes:
myid.my.data
If the dataset you wish to retrieve exists on any disk volume, you cannot use the original name of the dataset (the name used on the BACKUP tape). You will be prompted for a new name.
ENTER JOBNAME
Choose a name to identify your job.
ENTER VOLUME SERIAL NUMBER OF TAPE (VSN - INTERNAL LABEL)
This is the VSN -- internal label -- that was assigned in the STDLABEL procedure. The standard label can be from 1 to 6 characters long. You may enter any combination of letters and/or numbers, but this label should begin with a letter. In the future, you will refer to this particular tape by this particular label. Sometimes the standard label is referred to as the VSN (for Volume Serial Number) or internal label. If asked to supply the VSN or internal label in other procedures which involve this tape, use the standard label.
ENTER VISUAL REEL NUMBER OF TAPE (VRN)
The VRN is assigned to the tape by the tape librarian, and it is the actual number of the slot where the tape is stored. Refer to your tape submission/removal form for the VRN.
ENTER TAPE KEYWORD
The keyword is a 1 to 4 character word of your choice. This word is affixed to the tape when submitted to the tape library and serves as a security check. The keyword to be entered is shown on the submission/removal form.
WHAT FILE ON TAPE #____ DO YOU WANT TO RETRIEVE FROM? (FILE 1 IS
THE BEGINNING OF TAPE)
This completes the RETRIEVE procedure. The information that you entered at each of these prompts will be displayed and you will be asked if the information is correct. Provided that the information is correct, enter Y at the final prompt to submit the job. The jobname and job number will then be displayed.
C.4 FOR MORE INFORMATION
For further interpretation on the use of the STDLABEL/BACKUP/RETRIEVE procedures, please contact the UCNS Help Desk, Computer Services Annex, at (706) 542-3106.
SYSOUT*
CLASS PAPER ORIENTATION SIDES IMAGES CHAR/LINE
LINES/IMAGE
C hole landscape
1 1 132
62
D hole portrait
1 1 80
62
F bond landscape
2 1 132
62
G bond portrait
2 1 80
62
H bond landscape
2 2 90
80
I bond portrait
2 1 80
70
J hole landscape
2 1 132
62
K hole portrait
2 1 80
62
Q bond landscape
1 1 132
62
S bond portrait
1 1 80
62
W hole portrait
2 2 132
62
X bond portrait
2 2 132
62
Y bond landscape
2 1 132
62
Z hole landscape
2 1 132
62
Graybar Overlay: The paper used for classes C,F,H,J, and Q is shaded to mimic standard greenbar paper.
Service Site Page Printers: To route your output to one of the page printers in the Journalism or Aderhold sites, you must use a SYSOUT class or message class (MSGCLASS) with a paper type of "hole" (C, D, J, K, W, or Z).
Line Printer SYSOUT Class: To route your output to a line printer, use a SYSOUT class or message class (MSGCLASS) of A. Your output will be printed on greenbar paper.
Special Hold Classes: To route your
output to a hold queue, use a SYSOUT class or message class (MSGCLASS)
of 5, 6, 7, 8, or 9.
------------------------
* SYSOUT class values may be used
for message class (MSGCLASS).
or via the WWW at http://www.uga.edu/~ucns
(Note: The character in front of ucns is a tilde.)