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
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.
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.
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.
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.
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
|
|
|
+--------------------------------------------------------------------+
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: *
+--------------------------------------------------------------------+| |
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.
RECORD FORMAT There are several options, but the one most commonly used for program files is FB (Fixed Block). If the dataset is to contain text files, you can type VB (Variable Block).
RECORD LENGTH This is the number of characters for each record. For fixed block records, 80 is the most common value entered here. If you selected VB, 255 is a reasonable value.
BLOCK SIZE Leave this blank.
DATA SET NAME TYPE Leave this blank.
Once you have entered all the information
described above, press ENTER and the message DATA SET ALLOCATED will appear
in the upper right side of the screen. Enter:
+-----+
END |ENTER|
+-----+
on this screen next to OPTION===> to
return to the PRIMARY OPTION MENU. 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.
Note About other Allocation Methods
Allocating a dataset via ISPF/PDF should be sufficient for most (and in a lot of cases all) of your dataset allocations. Other methods, however, do exist. To allocate a sequential dataset via a batch job (using JCL), do the following:
//WEEKLY DD UNIT=SYSDA,DISP=(NEW,CATLG),DSNAME=MYUSERID.MYDATA,
// SPACE=(80,(5000,100)),DCB=(DSORG=PS,LRECL=80,RECFM=FB),
// AVGREC=U,MGMTCLAS=RETAIN7
To allocate a sequential dataset via TSO, do the following:
ALLOC DA('MYUSERID.MYDATA') SPACE(5000,100)
NEW DSORG(PS) -
RECFM(F B) LRECL(80) AVGREC(U) MGMTCLAS(RETAIN7)
It is possible to allocate other kinds of datasets via JCL and TSO that cannot be allocated via ISPF/PDF. These include a Direct Access (DA) dataset. Check with the UCNS Help Desk, Computer Services Annex, or (706)542-3106 for more information on these other types of datasets.
+--------------------------------------------------------------------+
|
|
|
Partitioned Dataset
|
|
e.g., 'US123.TEXT.FILE(MEMBER1)'
|
|
|
| +-----------------------------+
|
| |
|
|
| |
DIRECTORY |
|
| |_____________________________|
|
| |
|
|
| |
MEMBER1 |
|
| |_____________________________|
|
| |
|
|
| |
MEMBER2 |
|
| |_____________________________|
|
| |
|
|
| |
|
|
| |
...etc. |
|
| +-----------------------------+
|
|
|
|
|
|
Sequential Dataset
|
|
e.g., 'US123.DATA.FILE'
|
|
|
|
|
| +-----------------------------+
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
| |
DATASET |
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
| +-----------------------------+
|
|
|
| Figure 11: The Partitioned
and the Sequential Dataset. A par- |
|
titioned dataset differs from a sequential dataset |
|
in that it has a directory of its members. Whenever |
|
you refer to a member of a partitioned dataset, you |
|
include the member name in parentheses.
|
|
|
+--------------------------------------------------------------------+
The most comprehensive Help is the ISPF/PDF Tutorial. This tutorial is available from the ISPF/PDF PRIMARY OPTION MENU, which is shown in Figure 5. From the TSO READY message, enter:
+-----+
ISPF |ENTER|
+-----+
and the ISPF/PDF PRIMARY OPTION MENU will be displayed. On the COMMAND line at the top of the screen, type:
+-----+
HELP TUTORIAL |ENTER|
+-----+
next to the indicating arrow ===>. You are now at the first panel -- or screen -- of the ISPF/PDF Tutorial, and you can follow the directions near the bottom of the screen to read the tutorial.
8.1 THE INTRODUCTION SCREENS FOR THE ISPF/PDF TUTORIAL
As you read through the screens --
you move to the next screen by pressing ENTER -- notice the introduction
screen which looks like the one shown in Figure 12. In addition to providing
some general instructions, this screen shows a set of Program Function
keys -- which are also called PF keys. The PF keys allow you to perform
certain functions while you are reading the ISPF/PDFTutorial and also
while you are using other features
of ISPF/PDF. It is quite likely that the terminal or microcomputer that
you are using does not have PF keys, but does allow you to press certain
keys to accomplish the same function as PF keys.
Please refer to the document Using IBM Services with Your Terminal or Microcomputer described in "Associated Documents" on page 4 for more information on PF keys.
----------------------------------------------------------------------
TUTORIAL ------------
INTRODUCTION (CONTINUED) ------------- TUTORIAL
COMMAND ===>
DEFAULT ARRANGEMENT
FOR PF KEYPAD
You may use the following
program function |-------|-------|------|
(PF) keys while viewing
the tutorial: |HELP
| |END |
|PF1 or | |PF3 or|
|PF13 | |PF15 |
HELP-to get help on
how to use the tutorial. |-------|-------|------|
END -to end the tutorial.
| |
| |
UP -to display
a higher level list of topics.| |
| |
DOWN-to go on to the
next topic (skip). |
| | |
LEFT-to display the
previous page (back). |-------|-------|------|
RIGHT-to display the
next page, which is. |UP
|DOWN | |
the same as pressing ENTER
|PF7 or |PF8 or | |
|PF19 |PF20 | |
|-------|-------|------|
|LEFT |RIGHT | |
|PF10 or|PF11 or| |
|PF22 |PF23 | |
|-------|-------|------|
Figure 12: An Introduction Page from the ISPF/PDF Tutorial
----------------------------------------------------------------------
8.2 THE TABLE OF CONTENTS FOR THE ISPF/PDF TUTORIAL
When you reach the ISPF/PDF Tutorial's
Table of Contents -- shown in Figure 13 -- you can select topics for information
on ISPF/PDF functions. If, for example, you wanted to learn more about
ISPF/PDF EDIT, you would enter:
+-----+
2 |ENTER|
+-----+
next to OPTION ===>. The Option G gives "General Information" on ISPF/PDF, and is recommended for new users. There is also an index (Option I), which can be of great help.
You should go ahead and explore some
of the topics on your own. When you have finished, return to the ISPF/PDF
PRIMARY OPTION MENU before you go on to the next section. To return to
the PRIMARY OPTION MENU at any time while exploring the ISPF/PDF Tutorial,
enter:
+-----+
END |ENTER|
+-----+
next to ===>.
+--------------------------------------------------------------------+
The options shown on this line are series of pull-down menus; move your cursor to the "Function keys" pull-down and press "ENTER." From the menu that will be displayed, select "Global PF Key Settings" (it is the first choice) and press "ENTER".
After you have done this, a list of your PF keys and their associated functions will be displayed, as shown in Figure 16.
We will talk more about the function of these keys in the section "Performing a Specific Task -- Editing the Dataset" on page 32. Most of the functions, however, should be fairly obvious. For example, you can request help by pressing PF1. PF7 and PF8 allow you to move up and down the page; PF10 and PF11 allow you to move across the page in the indicated direction.
Remember, the keys shown in Figure
16 are a standard set. They can be changed if you would like to have a
specific PF key perform a different function. * Many ISPF/PDF users prefer
to map the PF4 key to the command SUBMIT. (The SUBMIT command will be described
in "The SUBMIT Command and FLASHER" on page 55.)
------------------------
* Users wishing to change default
ISPF/PDF settings should acquire an ISPF Profile dataset. Please contact
the UCNS Help Desk, Computer Services Annex, at (706)542-3106 for more
information.
+--------------------------------------------------------------------+
|
|
|
Log/List Function keys Colors Environ GUI
Temporary Help |
| ------------------------------------------------------------------|
|
ISPF Settings
|
| Command
===>
|
|
|
| Selected Options:
Print Graphics Parms: |
|
Enter "/" to select option
Family printer type 2 |
|
Command line at bottom
Device name . . . . |
|
/ Panel display CUA mode
Aspect ratio . . . 0 |
|
Long message in pop-up
|
|
Tab to action bar choices
|
|
Tab to point-and-shoot fields General:
|
|
/ Restore TEST/TRACE options
Input field pad . . N |
|
Session Manager mode
Command delimiter . ; |
|
/ Jump from leader dots
|
|
Edit PRINTDS Command
|
|
|
| Terminal Characteristics:
|
| Screen format
1 1. Data 2. Std 3. Max
4. Part
|
|
|
| Terminal Type
3 1. 3277 3. 3278 5. 3290A 7. 3278CF
9. 3278KN|
|
2. 3277A 4. 3278A 6. 3278T 8. 3277KN
|
|
|
| F1=Help
F3=Exit F10=Actions F12=Cancel
|
|
|
| Figure 15:
The ISPF PARAMETER OPTIONS Screen
|
|
|
+--------------------------------------------------------------------+
To remap the PF4 key to SUBMIT, use your tab key to position the cursor on the R in RETURN. Type:
SUBMIT
and then use your tab key to position your cursor next to PF4 LABEL and type SUBMIT again. Press the PF key for END to exit this screen and save the changes made.
Return to the ISPF/PDF PRIMARY OPTION MENU before continuing with the next section. You may do this by pressing the PF key for END (or EXIT) or type END on the "Command ===>" line.
About "MORE"
When we look at Figure 16 or many of the other ISPF/PDF screens, we will sometimes see the word "More +" in the upper right corner. This simply means there is more to be shown on the screen; but it is covered (often, though not in this case) by a short description of available PF Keys. Simply use your "DOWN" (or "PgDn") key to scroll forward. When you do this, the "More +" will change "More -".
+--------------------------------------------------------------------+
|
|
|
PF Key Definitions and Labels
|
| Command ===>
|
|
More + |
| Number of PF
Keys . . 12
Terminal type . . 3278 |
|
|
| PF1 . . . HELP
|
| PF2 . . . SPLIT
|
| PF3 . . . END
|
| PF4 . . . RETURN
|
| PF5 . . . RFIND
|
| PF6 . . . RCHANGE
|
| PF7 . . . UP
|
| PF8 . . . DOWN
|
| PF9 . . . SWAP
|
| PF10 .
. LEFT
|
| PF11 .
. RIGHT
|
| PF12 .
. RETRIEVE
|
|
|
| PF1 Label
. . PF2 Label
. . PF3
Label . .|
| PF4 Label
. . PF5 Label
. . PF6
Label . .|
| PF7 Label
. . PF8 Label
. . PF9
Label . .|
| PF10 Label
. . PF11 Label
. . PF12 Label
. .|
|
|
| Press ENTER
key to save changes. Enter END command to save ..exit.|
|
|
|
|
| Figure 16:
Twelve Standard PF Keys. This is a typical listing |
|
for the PF keys as shown on a terminal with 12 such |
|
keys defined.
|
|
|
+--------------------------------------------------------------------+
The Pull-Down Menus
To move around in a pull-down menu, you may use the "cursor move" (or "arrow") keys. Press "ENTER" to select an option. To exit a menu, select "EXIT" if that option is available, or press the "EXIT" key (this will usually be PF 12, and may be displayed at the bottom of your screen).