TSO and ISPF/PDF
The University of Georgia

Contents

SECTION 1: TSO and the ISPF/Program Development Facility: Software To Help You Do Your Work
 The IBM Resource
  The TSO Service

SECTION 2: Conventions Used in This Guide
 The ENTER Key
 Command Indication -- What You Should Enter or Type
 What "Next to" Really Means

SECTION 3: Associated Documents

SECTION 4: Identifying Yourself to TSO -- The User Identification and Password
 The LOGON Process
  Entering the User Identification -- the USERID
  Entering the Password

SECTION 5: A Little About TSO Before We Go On
 The TSO READY Message
 Screen Clearing
 The Logoff Command -- Ending Your TSO Session
 Time-Out Period
 LOGON REJECTED Message -- How to Reconnect

SECTION 6: Beginning and Ending the ISPF/PDF Session
 Beginning an ISPF/PDF Session
 Ending an ISPF/PDF Session

SECTION 7: Files on the TSO Service
 Naming of Datasets
 Reserving Disk Space for Your Dataset -- Dataset Allocation

SECTION 8: Using the ISPF/PDF Tutorial
 The Introduction Screens for the ISPF/PDF Tutorial
 The Table of Contents for the ISPF/PDF Tutorial

SECTION 9: Checking To See What Your PF Keys Are Set Up To Do

SECTION 10: Performing a Specific Task -- Editing the Dataset
 The Example File
 What to Know Before You Key In the Data -- or Text
  The RESET Command
  The HELP Key -- PF1
  The PROFILE Command
   CAPS ON or CAPS OFF
   NUMBER ON or NUMBER OFF
   RECOVERY ON or RECOVERY OFF
  PFSHOW
 Inserting and Deleting Characters -- The INSERT and DELETE Keys
  INSERT Key
  DELETE Key
 Important Line Commands
  Inserting and Deleting Lines
   Inserting Lines
   Deleting Lines
  Moving and Copying Lines in the Dataset
 Important Primary Commands
  Finding Character Strings in the Dataset With the FIND Command
  Changing Characters With the CHANGE Command
  Undoing Changes with the UNDO Command
 Commands Associated with Program Function Keys
  HELP Command (PF1)
  SPLIT Command (PF2)
  END Command (PF3)
  RETURN Command (PF4)
  RFIND Command (PF5)
  RCHANGE Command (PF6)
  UP Command (PF7), Down Command (PF8), LEFT Command (PF10), and RIGHT Command (PF11)
  SWAP Command (PF9)
  RETRIEVE Command (PF12)
  A Few Notes About the PF Keys
 CANCEL and SAVE Commands
 Leaving ISPF/PDF Edit

SECTION 11: VIEWING A DATASET -- THE VIEW OPTION

SECTION 12: Tips and Techniques Before Continuing
 The = Shortcut
 Option with Suboption Specified
 The ISPF Library Dataset
 The Partitioned Dataset Member List

SECTION 13: The SUBMIT Command and FLASHER
 Job Control Language -- IBM JCL
 Submitting the Batch Job -- A SAS Example
 Viewing Job Output with Option F -- FLASHER

SECTION 14: ISPF/PDF Dataset Maintenance Techniques
 OPTION 3.2 -- Using the DATA SET UTILITY Panel
  Displaying Dataset Information
  Renaming a Dataset
  Deleting a Dataset
 Option 3.1 -- Using the LIBRARY UTILITY Panel for Partitioned Dataset Maintenance
  Compressing a Partitioned Dataset
  Using the Member List to BROWSE, RENAME and DELETE Members
   To BROWSE a Member in the Member List
   To RENAME a Member in the Member List
   To DELETE a Member in the Member List
 Option 3.3 -- Using the MOVE/COPY UTILITY Panel
  Moving a Member From One Dataset to Another Dataset
  Copying a Member From One Dataset to Another Dataset

SECTION 15: Reminders, Tips, and Techniques Before Continuing
 Reminder About Leaving ISPF/PDF
 How TSO Commands Are Entered
  ISPF/PDF Option 6 -- The TSO COMMAND PROCESSOR
  The TSO Prefix

SECTION 16: Important TSO Commands
 TSO Help
 The IDS Command
 The LIST Command
 The PRINTOFF Command for Printing Datasets
 TSO Dataset Maintenance Commands
  The LISTCAT Command
  The LISTP Command
  The LISTDOG Command
  The SPACECHG Command
  The COPY Command
  The DELETE Command
  The RENAME Command
 Tape Backup Procedures

SECTION 17: The Resource Access Control Facility (RACF)
 The PERMIT Command
 The SEARCH Command

Appendix A: Acccess Document Information

Appendix B: Some Condition Codes and Their Meaning

Appendix C: TSO Tape Procedures for Securing Datasets
 STDLABEL
 BACKUP
 RETRIEVE
 For More Information

Appendix D: Page Printer SYSOUT Classes

Appendix E: UCNS Computer Services Sites


SECTION 1 - TSO AND THE ISPF/PROGRAM DEVELOPMENT FACILITY:

SOFTWARE TO HELP YOU DO YOUR WORK


1.1 THE IBM RESOURCE

At the University of Georgia, mainframe computing facilities are referred to as resources. For the purpose of this guide, you need only be concerned with the IBM resource at the University of Georgia.

1.2 THE TSO SERVICE

The IBM resource provides several services. You may already be familiar with one of the other services available on the IBM resource. The Library service, for example, allows you to access the University of Georgia Libraries' Online Catalog (GALIN).

The IBM Time Sharing Option -- TSO for short -- is a service available on the IBM resource. The "long" form of the name for TSO is MVS/TSO. We only point this out because other documents you reference may refer to MVS/TSO. In this document, we will use the "short" name. TSO is a general-purpose service which allows you to perform tasks in an interactive environment. Performing tasks in an interactive environment means that you will be using a terminal, or a microcomputer which functions as a terminal, to connect to the TSO service. While connected, or logged on, you will issue commands. When you issue a command, the computer will respond to your command. For example, when you are connected to the TSO service, you can type the command:

TIME

and press the ENTER or RETURN key on your terminal. The service will respond by telling you the time of day.

The Interactive System Productivity Facility/Program Development Facility -- ISPF/PDF for short -- is a component of TSO. Its purpose is to facilitate interaction with the TSO service. A large portion of this guide is dedicated to describing the use of ISPF/PDF while connected to the TSO service.
 

SECTION 2 - CONVENTIONS USED IN THIS GUIDE

2.1 THE ENTER KEY

You will often be instructed to type in certain characters and press ENTER. Or, in some cases, you may be instructed to press ENTER without having to type in any characters. The ENTER key may be shown on your terminal as RETURN or a similar label.

2.2 COMMAND INDICATION -- WHAT YOU SHOULD ENTER OR TYPE

When you are instructed to issue a command, the characters that you should enter -- or type -- as shown will be in all UPPERCASE letters. If you are to supply information along with the command, the information that you are to provide will be shown in lowercase letters.

Following is an example of how you will be shown to enter a command:
----------------------------------------------------------------------
 
             +-----+
LIST dataset |ENTER|
             +-----+

where 'dataset' is the name of the dataset that you wish to list. When you actually type the commands, you can use uppercase or lowercase letters.

Figure 1: Command Indication Convention
----------------------------------------------------------------------

NOTE: We will discuss the LIST command and the meaning of datasets later in this document. This example is used here to familiarize you with the command indication convention only.

Notice that the word ENTER included next to a command indicates that the ENTER key should be pressed after the command is typed or entered. If the ENTER key is referenced in text following a command, it will

not be enclosed in a box.

Also notice that the lowercase characters will be included in apostrophes when they are explained in text following an example.

2.3 WHAT "NEXT TO" REALLY MEANS

When you are instructed to type in characters "next to" an indicating arrow, the "next to" will mean the second character position to the right of the arrow. The indicating arrow will look like:

===> x (type beginning at x)

The indicating arrow is frequently encountered when using ISPF/PDF. Your "TAB" key will place the cursor in the correct position.
 

SECTION 3 - ASSOCIATED DOCUMENTS

It is to your benefit to be familiar with the information in these documents if you plan on using TSO regularly: Each of these documents is available via the Information Distribution System (IDS) on the TSO service. As a TSO user, you can access this online document delivery service by using the TSO command IDS, as described in "The IDS Command" on page 86.
 

SECTION 4 - IDENTIFYING YOURSELF TO TSO -

THE USER IDENTIFICATION PASSWORD

To use TSO, you will usually select the TSO option from the IBM Services Access Menu displayed on your terminal or microcomputer screen. If you are at one of the University of Georgia Computer Services Sites, terminals or microcomputers should already be set up so that you can access TSO. (The Computer Services Sites are listed in the appendix "UCNS Computer Services Sites" on page 106.) Otherwise, you may have to make the initial connection to the IBM Services Access Menu on your own. Making the initial connection to the IBM Services Access Menu is described in the appendix "Access Document Information" on page 96.

However you reach the IBM Services Access Menu, once it is displayed on your screen you should type:

  +-----+
T |ENTER|
  +-----+

to select the TSO service.

4.1 THE LOGON PROCESS

The LOGON process is the means by which you identify yourself as a validated TSO user. You are required to supply a User Identification and password before you will actually be ready to use TSO.

4.1.1 Entering the User Identification -- the USERID

To identify yourself to the TSO service, you must first enter your USERID. The USERID is a unique group of seven or fewer characters that identifies an individual user to a specific computer. You are given a USERID when a computer account is established for the IBM TSO service.

After typing:
 
  +-----+
T |ENTER|
  +-----+

from the IBM Services Access Menu and pressing ENTER, the screen shown in Figure 2 will be displayed on your terminal.

+--------------------------------------------------------------------+
|                                                                    |
|  IKJ56700A ENTER USERID -                                          |
|                                                                    |
|  enter userid here                                                 |
|                                                                    |
|                                                                    |
|                                                                    |
|                                                                    |
|                                                                    |
|                                                                    |
|                                                                    |
|                                                                    |
|                                                                    |
|                                                                    |
|                                                                    |
|  Figure 2:  Entering the USER IDentification -- The USERID         |
|                                                                    |
+--------------------------------------------------------------------+

Where you see 'enter userid here' in Figure 2, enter your USERID and press ENTER.  The TSO LOGON screen will appear, as shown in Figure 3.
 
+--------------------------------------------------------------------+
|                                                                    |
|  ------------------------- TSO/E  LOGON ---------------------------|
|                                                                    |
|      Enter LOGON parameters below:        RACF LOGON parameters:   |
|                                                                    |
|      Userid    ===> UGMY                                           |
|                                                                    |
|      Password  ===> _    <----:           New Password ===>  <--:  |
|                               :                                 :  |
|      Procedure ===> PROC      :           Group Ident  ===>     :  |
|                               :                                 :  |
|      Acct Nmbr ===> ACCNMBR   This is an input field.           :  |
|                               Notice that the cursor            :  |
|      Size      ===> 2048      is positioned where you           :  |
|                               should enter your password.       :  |
|      Perform   ===>                                             :  |
|                                   This is also an input field.  :  |
|      Command   ===>               You can use the tab key to       |
|                                   move to this field.              |
|                                                                    |
|      Enter an 'S' before each option desired below:                |
|                                                                    |
|              -Nomail     -Nonotice     -Reconnect     -OIDcard     |
|                                                                    |
|  PF1/PF13==>Help  PF3/PF15==>Logoff  PA1==>Attention  PA2==>Reshow |
|  You may request specific HELP information by entering a '?' in    |
|  any entry field.                                                  |
|                                                                    |
|                                                                    |
|  Figure 3:  TSO LOGON SCREEN -- A Formatted Display Screen.  This  |
|             figure shows how a  formatted display screen appears.  |
|             Notice that the cursor is postioned in the user input  |
|             area, and that the user  input area contains several  |
|             "fields" --  including the  "PASSWORD" field  and the  |
|             "NEW PASSWORD"  field.   You can  use the TAB  key to  |
|             move from field to field.                              |
|                                                                    |
+--------------------------------------------------------------------+

4.1.2 Entering the Password

The password ensures that the USERID is correct and that the person who is using the account is authorized to do so. You have the responsibility of remembering the password and for guarding the security of the password.

When a USERID is created, UCNS initially establishes the password as your User Account Number. (User Account Numbers are explained in the document Computer Account Management and Creation Procedures, which is described in "Associated Documents" on page 4.)

You are required to set a new password the first time you use TSO. *

Referring to Figure 3 on page 7, the cursor will be positioned at

PASSWORD===>.

To set a new password, type in your current password (it will not be shown on the screen as you type it), use the TAB key on your keyboard to tab over to NEW PASSWORD ===>, and type in a new password and press ENTER. Passwords must be 6-8 characters, and can include any combination of letters or numbers. You will be asked to type in your new password a second time for verification.

If you do not need to set a new password, type in your current password and press ENTER.

On the IBM system, a password will automatically expire after 91 days. If the password has expired, the cursor will automatically move to NEW PASSWORD==> when you type in your current password and press the ENTER key. If this should happen, type in a new password and press the ENTER key.

------------------------
* If you should ever forget your password, UCNS will have to reset your password for you. Contact the UCNS Help Desk, Computer Services Annex, at(706)542-3106 if you should forget your password. For security reasons, a written request from your departmental account manager is required for resetting your password. The password is reset to your User Account Number and you are required to change the password when you log on to TSO.
 

SECTION 5 - A LITTLE ABOUT TSO BEFORE WE GO ON

5.1 THE TSO READY MESSAGE

Once you have correctly entered the required information on the LOGON screen, you will be logged on to TSO. There may be some messages for you - some will be news messages sent by system administrators. It is well to pay attention to such messages, as they usually have the latest information on the status of the system or products on it.

When using TSO, you enter commands at the position of the cursor, below the READY message, as shown in Figure 4.

+--------------------------------------------------------------------+
|                                                                    |
|  READY                                                             |
|  _           <-- The cursor is positioned here to indicate         |
|                  the start of the input area.  Commands            |
|                  are entered here.                                 |
|                                                                    |
|                                                                    |
|                                                                    |
|                                                                    |
|                                                                    |
|              <-- This area is the output area.  As the             |
|                  command is processed, information is              |
|                  displayed on the screen.                          |
|                                                                    |
|                                                                    |
|                                                                    |
|                                                                    |
|                                                                    |
|  ***         <-- This is the TSO screen status message.            |
|                                                                    |
|  Figure 4:  TSO Display Screen                                     |
|                                                                    |
+--------------------------------------------------------------------+
 

5.2 SCREEN CLEARING

When using TSO, a full screen of information will be indicated by a row of three asterisks positioned in the lower left-hand corner of the screen. Whenever you see these three asterisks, press the ENTER key to continue to the next screen.

5.3 THE LOGOFF COMMAND -- ENDING YOUR TSO SESSION

You should always end your TSO session by typing:
 
       +-----+
LOGOFF |ENTER|
       +-----+

when the READY message is displayed.

5.4 TIME-OUT PERIOD

If you are logged on to TSO between 8:00am and 5:00pm, Monday through Friday workday, you will automatically be logged off the service if no activity is detected on your session. (An example of detected activity is pressing the ENTER key after issuing a command.) This inactivity time-out will occur after about 50 minutes.

5.5 LOGON REJECTED MESSAGE -- HOW TO RECONNECT

Notice that on the TSO LOGON screen, Figure 3, there is a list of options near the bottom of the screen. Among these selectable options is one for RECONNECT. Sometimes while you are using TSO, you can be dropped from the system because of a communications failure, a power outage, or the service just goes down. This doesn't happen very often, but you should know how to reconnect.

If you attempt to log on to the TSO service and receive the following message:

IKJ56425I LOGON REJECTED, USERID XXXX IN USE
IKJ56400A ENTER LOGON OR LOGOFF:

Respond to the "ENTER LOGON OR LOGOFF:" by typing:

               +-----+
LOGON 'userid' |ENTER|
               +-----+

The TSO LOGON screen will be displayed, and the cursor will be positioned next to PASSWORD ===>. Type in your password, but do not press ENTER.

After you type in your password, position the cursor next to -RECONNECT and type:

  +-----+
S |ENTER|
  +-----+

You will now be reconnected to the TSO service. Press ENTER to continue the TSO session.
 

SECTION 6 - BEGINNING AND ENDING THE ISPF/PDF SESSION

6.1 BEGINNING AN ISPF/PDF SESSION

You begin an ISPF/PDF session by entering the command:

     +-----+
ISPF |ENTER|
     +-----+

whenever the TSO READY message is displayed. Much of the remainder of this document will describe what you can do after you have begun an ISPF/PDF session.

6.2 ENDING AN ISPF/PDF SESSION

You can always end your ISPF/PDF session when the PRIMARY OPTION MENU is displayed. This is the first list of options you see after you enter the ISPF command. (The PRIMARY OPTION MENU is shown in Figure 5) From the PRIMARY OPTION MENU, enter:

        +-----+
END |ENTER|
    +-----+

next to the OPTION ===> prompt.

If the TSO READY message is not displayed, you will see a final screen with SPECIFY DISPOSITION OF LOG DATA SET across the top. There should be a letter D next to Process option ===>. If there is no D at this location on the screen, tab next to Process option ===> and type a D. Press ENTER to terminate the ISPF/PDF session and the TSO READY message will be displayed.
 

+--------------------------------------------------------------------+
|                                                                    |
|    Menu  Utilities  Compilers  Options  Status  Help               |
|  ---------------- UGA ISPF/PDF PRIMARY OPTION MENU ----------------|
|                        ISPF Primary Option Menu                    |
|  Option  ===>                                                      |
|                                                   Userid   -UGMY   |
|  0  Settings      Terminal and user parameters    Procedure-PROC   |
|  1  View          Display source data or listing  Prefix   -UGMY   |
|  2  Edit          Create or change source data    Date     -95/07  |
|  3  Utilities     Perform utility functions       Julian   -95.210 |
|  4  Foreground    Interactive language process    Time     -17:24  |
|  5  Batch         Submit job for language prcssng Terminal -3278   |
|  6  Command       Enter TSO or Workstation Cmds   Release  -ISPF4.1|
|  7  Dialog Test   Perform dialog testing                           |
|  8  LM Facility   library administrator functions                  |
|  9  IBM PRODUCTS  IBM program development products                 |
|  10 SCLM          SW Configuration Library Manager                 |
|  I  Internet      Telnet, Gopher, FTP, etc                         |
|  U  UGA Utilities Perform UGA utility functions                    |
|                                                                    |
|  Enter X to terminate using log/list defaults                      |
|                                                                    |
|  Figure 5:  The ISPF/PDF PRIMARY OPTION MENU                       |
|                                                                    |
+--------------------------------------------------------------------+
 

SECTION 7 - FILES ON THE TSO SERVICE

If you have used a computer before, you have already worked with files. Files on the TSO service are called datasets.

7.1 NAMING OF DATASETS

Dataset names on the TSO service have a very specific form. Primarily, the dataset name consists of two parts. The first part is your userid, and the second part is a name that you supply. * A typical dataset name would look something like:

userid.data

where 'userid' is your USERID and 'data' is a name that you provide for the second part of the name. Keep the following when naming and using datasets:

1. A dataset name on the IBM TSO service is made up of qualifiers. The first-level qualifier is the USERID. In our example above, 'data' is a second-level qualifier. You can have several qualifiers, but you will probably never have a real need to have more than a third-level qualifier.

2. Each qualifier can contain from one to eight letters or numbers; however, the first character of any qualifier cannot be a number. Qualifiers are separated by a period (.).

3. A dataset name is said to be a fully qualified dataset name when all qualifiers are used when the dataset name is used. When using datasets that you have created on TSO, you will often be required to include single quote marks around the dataset, if you use the fully qualified form of the dataset. Here is an example. Assume that a lady named Mary with a USERID of US123 has created a dataset by the name:

US123.PERSONAL.FILE

------------------------

* There are also datasets known as "group datasets." Instead of the first-level qualifier being an individual's USERID, it can be a group that many USERIDs are connected to. In this document, we will not talk about group datasets.

If she wishes to list the dataset, she can issue the command:

                           +-----+
LIST 'US123.PERSONAL.FILE' |ENTER|
                           +-----+

Or, she can use the LIST command as follows:

                   +-----+
LIST PERSONAL.FILE |ENTER|
                   +-----+

Notice that the fully qualified dataset name requires the single quotation marks. When the dataset name is not fully qualified, the single quote marks are not required.

7.2 RESERVING DISK SPACE FOR YOUR DATASET -- DATASET ALLOCATION

ISPF/PDF provides a quick and easy way to allocate a dataset. After successfully logging on to TSO, at the TSO READY message enter:

     +-----+
ISPF |ENTER|
     +-----+

and the screen shown in Figure 5 will be displayed.

The ISPF/PDF PRIMARY OPTION MENU shows you a list of ISPF/PDF tasks. Select Option 3 by typing:

  +-----+
3 |ENTER|
  +-----+

next to OPTION ===>. The screen shown in Figure 6 will be displayed.

From the UTILITY SELECTION MENU, enter:

  +-----+
2 |ENTER|
  +-----+

next to OPTION ===> and the DATA SET UTILITY screen will be available, as shown in Figure 7.

When the DATA SET UTILITY screen is displayed, type:

A

and do not press ENTER. Position the cursor next to the arrow on: DATA SET NAME ===>. (Use the TAB key on your terminal to position the cursor. You can also use the arrow keys to move around on one of the screens) The name can be in the fully qualified form with the single quote marks before and after. Do not press ENTER after you type in the dataset name.

The completed screen will look like the one shown in Figure 8. Assume that a user Mary (whose USERID is US123) wishes to allocate a dataset she has named US123.PERSONAL.FILE.

If your screen looks correct, press the ENTER key, and you will see a screen -- shown in Figure 9 -- which will allow you to fill in information concerning the size and type of dataset you wish to create. The screen in Figure 9 shows how the screen looks when all the information about the dataset characteristics have been supplied. We will use the characteristics that Mary may have chosen for her dataset.

As you look at the example screen, please read the following explanation of the individual screen items:

DATA SET NAME The name of the dataset entered on the previous screen will be shown next to this item. It will be shown in its fully qualified form but without the single quote marks.

+--------------------------------------------------------------------+
|                                                                    |
|    Menu  Help                                                      |
|  ------------------------------------------------------------------|
|                        Utility Selection Menu                      |
|  Command ===>                                                      |
|                                                                    |
|  1  Library    Compress or print data set.  Print index listing.   |
|                  Print, rename, delete, or browse members          |
|  2  Data Set   Allocate, rename, delete, catalog, uncatalog, or    |
|                  display information of an entire data set         |
|  3  Move/Copy  Move, copy, or promote members or data sets         |
|  4  Dslist     Print or display (to process) list of data set name |
|                  Print ot display VTOC information                 |
|  5  Reset      Reset statistics for members of ISPF library        |
|  6  Hardcopy   Initiate hardcopy output                            |
|  7  ISPF C/S   Install ISPF C/S workstation code                   |
|  8  Outlist    Display, delete, or print held job output           |
|  9  Commands   Create/change an application command table          |
|  *  Reserved   This option reserved for future expansion           |
|  11 Format     Format definition for formatted data Edit/Browse    |
|  12 SuperC     Compare data sets                 (Standard dialog) |
|  13 SuperCE    Compare data sets                 (Extended dialog) |
|  14 Search-For Search data sets for strings      (Standard Dialog) |
|                                                                    |
|   F1=Help     F3=Exit      F10=Actions    F12=Cancel               |
|                                                                    |
|  Figure 6:  Option 3 From the PRIMARY OPTION MENU                  |
|                                                                    |
+--------------------------------------------------------------------+
 

+--------------------------------------------------------------------+
|                                                                    |
|    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 7:  Option 2  From the UTILITY  SELECTION MENU  -- Before  |
|             Completed                                              |
|                                                                    |
+--------------------------------------------------------------------+
 
+--------------------------------------------------------------------+
|                                                                    |
|    Menu  Reflist  Utilities  Help                                  |
|  ----------------------------------------------------------------- |
|                          Data Set Utility                          |
|  Option  ===> A                                                    |
|                                                                    |
|      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  . . 'US123.PERSONAL.FILE'                       |
|     Volume Serial  . .        (if not cataloged, required for "C") |
|                                                                    |
|  Data Set Password . .        (if password protected)              |
|                                                                    |
|                                                                    |
|    F1=Help     F3=Exit     F10=Actions  F12=Cancel                 |
|                                                                    |
|  Figure 8:  Option 2 From the UTILITY SELECTION MENU -- When Com-  |
|             pleted                                                 |
|                                                                    |
+--------------------------------------------------------------------+
 

+--------------------------------------------------------------------+
|                                                                    |
|    Menu  Reflist  Utilities  Help                                  |
|  -------------------- Allocate New Data Set -----------------------|
|                                                                    |
|  Command ===>                                                      |
|                                                                    |
|  Data Set Name . . . : US123.PERSONAL.FILE                         |
|                                                                    |
|  MANAGEMENT CLASS   =>RETAIN7 (Blank for default management class) |
|  STORAGE CLASS      =>        (Blank for default management class) |
|   Volume Serial     =>        (blank for authorized default volume)|
|  DATA CLASS         =>        (Blank for default data class)       |
|   Space units       => KB     (BLKS, TRKS, CYLS, KB, MB or BYTES)  |
|   Primary quantity  => 40     (In above units)                     |
|   Secondary quantity=> 2      (In above units)                     |
|   Directory blocks  => 5      (Zero for sequential data set)*      |
|   Record format     => fb                                          |
|   Record length     => 80                                          |
|   Block size        =>                                             |
|                                                                    |
|                                                                    |
|    Enter "/" to select option                                      |
|      Allocate Multiple Volumes                                     |
|                                                                    |
|   F1=Help   F3=Exit   F12=Cancel                                   |
|                                                                    |
|  Figure 9:  Allocating  a New  Dataset --  Supplying the  Dataset  |
|             Characteristics                                        |
|                                                                    |
+--------------------------------------------------------------------+
 

MANAGEMENT CLASS MANAGEMENT CLASS is used to tell the system how long to keep the dataset. The following management classes have been established:

MGMTCLAS Days Retention MGMTCLAS Days Retention
RETAIN0 0 (DEFAULT) RETAIN8 8
RETAIN1 1 RETAIN9 9
RETAIN2 2 RETAIN10 10
RETAIN3 3 RETAIN14 14
RETAIN4 4 RETAIN28 28
RETAIN5 5 RETAIN56 56
RETAIN6 6 RETAIN95 95
RETAIN7 7 STANDARD (18 months past last use)

As indicated, the default MANAGEMENT CLASS is RETAIN0. A RETAIN0 dataset will be deleted from the system the next morning shortly after midnight, unless the next morning is a Saturday or Sunday. Deletion of RETAIN0 datasets are postponed until Monday over the weekend. If you want to ensure that a dataset is kept for 3 days, use a MANAGEMENT CLASS of RETAIN3.

Datasets with a MANAGEMENT CLASS of RETAIN95 or STANDARD will automatically be backed up. A two-generation backup is performed (copies of the dataset after the last two updates). The backups for RETAIN95 and STANDARD datasets are automatically deleted after 91 days.

All datasets will be deleted when the retention period expires. The backups for RETAIN95 and STANDARD datasets will automatically be deleted 91 days later.

Datasets that have a MANAGEMENT CLASS other than RETAIN0 will be charged to the User Account Number of the high-level qualifier (left-most part of dataset name) at the standard UCNS online storage charges. Less frequently used datasets will be "compressed," saving disk space and costs. Rarely used datasets will be automatically moved to tape.

These datasets will still be available by using the dataset name, the same as if the dataset were still on disk. When you reference one of these "migrated" datasets during an interactive session, you may receive a message and experience a small delay while the dataset is returned active status.

It is recommended that you initially create a dataset with a short retention period. When you are sure that the dataset has been properly created and you want to save it for a long period of time, use the following TSO command to set a longer retention period:

                                 +-----+
ALTER dataset MGMTCLAS(newclass) |ENTER|
                                 +-----+

where 'dataset' is the name of the dataset and 'newclass' is the new retention period. NOTE: The retention period is measured from the dataset creation date, not the alter date.

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|
                   +-----+

After pressing ENTER, information about the dataset (or datasets) will be displayed: *

 +--------------------------------------------------------------------+
|                                                                    |
|                                LAST    KILO BYTES SCRATCH  DS      |
|  DATASET-NAME---------MGMTCLAS-USED----ALLOC--USED-DATE----TYP-COST|
|  US123.PERSONAL.FILE  STANDARD11FEB94     40    30 7DEC94  MT $0.02|
|  US123.PYRO           RETAIN2817FEB94     10     5 21FEB94 AC $0.05|
|                                ESTIMATED COST PER DAY    =    $0.41|
|                                ESTIMATED COST PER MONTH  =   $12.30|
|                                                                    |
|  Figure 1:  Information from LISTP Command                         |
|                                                                    |
+--------------------------------------------------------------------+

In addition to information about the management class of the dataset and the last time the dataset was used, LISTP also shows:

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
------------------------
* You can type LISTP by itself and you will be prompted for a dataset name. If you want to list all of your datasets, just press ENTER.

You can also use Option 2 or Option 4 from the UTILITY SELECTION MENU (shown in Figure 6) to retrieve information about datasets.

STORAGE CLASS \
VOLUME SERIAL > Leave these three items blank.
DATA CLASS /

SPACE UNITS You have several options here, but a suggested value is for kilobytes (KB). To select this unit, position your cursor next to SPACE UNITS ==> and type:

KB

Do not press ENTER.

PRIMARY QUANTITY This is the number of kilobytes you estimate that you will need for your dataset. The SECONDARY QUANTITY on the next line will be allocated automatically when and if your dataset requires more space than the PRIMARY QUANTITY. In the example shown in Figure 9, 40 KB are requested right away.

SECONDARY QUANTITY For each one of these requested, 15 additional increments will be made available should the need arise. For example, a 2 entered here will provide a maximum of 30 KB of secondary space which will be allocated in 2 KB increments as needed.

DIRECTORY BLOCKS If the dataset is to be a sequential dataset, type 0. If the dataset is to be a partitioned dataset (one dataset with several members), the number typed here represents approximately the number x 5 members. Figure 11 provides an explanation of the differences between a partitioned and sequentional dataset. A 5 typed here, for example, will allow you to place 25 members in the partitioned dataset.

The most common types of datasets are partitioned and sequential. These are the only ones that can be allocated using ISPF/PDF.