Time sharing option

INTRODUCTION TO TIME SHARING OPTION (TS0)

TSO stands for Time Sharing Option. It is a subsystem which lets the user's session
invoke mvs facilities interactivity. Each user is treated as job. TSO submits job
stream to JES2/JES3 when user logs in. Each user is given unique address space and
can allocate data sets and invoke programs just as a batch job can.

ISPF stands for Interactive System Productivity Facility which runs under the control
of TSO. Program development facility is a segment of ISPF which provides powerful
program development environment. It provides a full-screen text editor and facilities
to manage background job processing. Not all MVS installations use TSO or ISPF for
text entry. For example some installations use an IBM product called CMS
(CONVERSATIONAL MONITOR SYSTEM) for text entry, and some installations use
text editors supplied by third-party suppliers.

ISPF on the mainframe is typically used for line of business and mission critical
application program development. SPF/Win in conjunction with popular compiler
technologies like Micro Focus COBOL you can develop client/server applications on
your PC taking advantage of the higher performance and improved local control
offered by PCs.

SPF/Win like its mainframe counterpart approaches the problem of program

development in a way that may be unfamiliar to you. All interactions with SPF/Win
are through SPF/Win panels which are analogous to Windows modal dialogs. In
SPF/Win there are only four basic panel types.

STARTING A TSO/E SESSION

The objectives of this module is to make understand

TSO/E SESSION

LOGGING ON WITH THE LOGON COMMAND

LOGON PANEL

TSO LOGON MESSAGES

MESSAGES

INTERRUPTING A PROCESS

ENDING A TSO/E SESSION

TSO/E SESSION
TSO/E is a base element of the OS/390 operating system that allows users
to interactively work with the system.

It is a tool with which you can:

• Communicate with other TSO/E users

1
 Time sharing option

• Create an office environment

• Develop and maintain programs in languages such as ASSEMBLER,
COBOL, FORTRAN, PASCAL, PL/I, REXX, and CLIST
• Process data
• Access the MVS operating system.

LOGGING ON WITH THE LOGON COMMAND

Use the LOGON command to identify yourself to the system and request use of its
resources. When you use the LOGON command, the system requires your TSO/E
user ID, which tells the system who wants to use it.

A user ID can be no longer than seven characters and can contain numeric (0-9) and
alphabetic (A-Z) characters, but must begin with an alphabetic character. Often a
USERID is your name, your initials, your department number, or any combination of
valid characters your installation chooses. There are some restrictions on which
characters can be used in your USERID, particularly if your system uses JES2.

LOGON PANEL

ENTER LOGON PARAMETERS BELOW: RACF LOGON PARAMETERS:

USERID ===> USERID

PASSWORD ===> NEW PASSWORD ===>

PROCEDURE ===> USERPROC GROUP IDENT ===>

ACCT NMBR ===> ACCT#

SIZE ===>

PERFORM ===>

COMMAND ===>

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.

TSO LOGON MESSAGES

2
 Time sharing option

TSO MESSAGES
You can receive five types of messages at your terminal:

• Mode messages
• Prompting messages
• Informational messages
• Broadcast messages
• Messages from other users

MODE MESSAGES

A mode message indicates that the system is ready for a new command or
subcommand. The most common mode message is :

READY

PROMPTING MESSAGES

A prompting message indicates that you need to supply required information or that
you supplied incorrect information. Prompting messages include a message identifier
(message ID) and are documented in TSO/E messages. If messages at your terminal
do not display a message ID, you can change your profile with the PROFILE MSGID
command to display message IDs.

INFORMATIONAL MESSAGES

An informational message tells you about the status of the system or of your
terminal session. You do not need to respond to an informational message.
Informational messages include a message identifier (message ID) and are
documented in TSO/E Messages.

BROADCAST MESSAGES

3
 Time sharing option

Broadcast messages are messages that an operator sends using the MVS SEND
command or the TSO/E OPERATOR SEND subcommand. The system operator can
send messages of general interest to all users of the system or specific messages to
individual users.

When an operator sends a message, a console identifier or the characters OPER

appear at the end of the message

INTERRUPTING MESSAGES
You can interrupt processing at any time by pressing the key assigned as the
attention interrupt key on your terminal. On some terminals such as the IBM 3270
display terminal, the attention interrupt key is labeled "PA1". You can cause an
attention interrupt to :
ENDING A TSO/E SESSION
When you are finished using TSO/E, issue the LOGOFF command to SIGN OFF from
the system and end your terminal session. The system releases your USERID until
the next time you issue the LOGON command.

Example

To log off the system, enter at the READY mode message: LOGOFF

You can also sign off from the system by issuing the LOGON command. When you
sign off using the LOGON command, the system terminates your current session and
starts a new one using the options specified on the LOGON command.

ISPF GETTING STARTED

We require the ISPF(Interactive System Productivity Facility) in order to Interactively
work with the Operating System it means that user need not remember any TSO
commands they can use the ISPF panels
ISPF GETTING STARTED
ISPF helps programmers develop interactive applications called dialogs.

ISPF consists of four major components; DM, PDF, SCLM, and C/S.

• The DM component is the Dialog Manager, which provides services to dialogs

and end-users.

• The PDF component is the Program Development Facility, which

provides services to assist the dialog or application developer.

• The SCLM component is the Software Configuration Library Manager, which

provides services to application developers to manage their application
development libraries.

• The C/S component is the Client/Server, which allows you to run ISPF on a
programmable workstation, to display the panels using the display function of
your workstation operating system, and to integrate workstation tools and
data with host tools and data.

4
 Time sharing option

STARTING ISPF
To start ISPF, log on to TSO.

· When the READY prompt appears, type ISPF or PDF and press Enter

THE ISPF SCREEN

The ISPF Primary Option Menu contains the options that you can use to create your
own applications online. If your installation has a customized ISPF Primary Option
Menu, the menu might not contain all of the following options; or, it might contain
certain installation-specific options.
WHAT ARE ISPF MENU OPTIONS?

Menu Utilities Compilers Options Status Help

ISPF Primary Option Menu

Option ===>----------------------------------------------------------------------

0 Settings ....Terminal and user parameters ........User ID. : MTPL003

1 View .........Display source data or listings .......Time. . . : 18:59
2 Edit ..........Create or change source data .......Terminal. : 3278
3 Utilities ..... Perform utility functions ................Screen. . : 1
4 Foreground .Interactive language processing .....Language. :
ENGLISH
5 Batch ........Submit job for language processing ..Appl ID. : ISR
6 Command....Enter TSO or Workstation commands ...TSO logon :
USERPROC
7 Dialog Test .Perform dialog testing .....................TSO prefix: MTPL003
8 LM Facility ..Library administrator functions ..........System ID : P390
9 IBM Products ..BM program development products ....MVS acct. : ACCT#
10 SCLM ........SW Configuration Library Manager .......Release. : ISPF 4.5
11 Workplace ..ISPF Object/Action Workplace
S SDSF ..........Spool Search and Display Facility
D DITTO ........ DITTO/ESA for MVS Version 1
DF DFSORT .....Data Facility Sort
DB DB2...........Data Base Product
O OMVS .........MVS Open Edition

Enter X to Terminate using log/list defaults

F1=Help...... F2=Split..... F3=Exit ......F7=Backward .......F8=Forward ......F9=Swap

F10=Actions .......F12=Cancel

OPTION DESCRIPTION
Option 0 - Settings
Settings displays and changes selected ISPF parameters, such as terminal
characteristics and function keys.

Option 1 - View
View displays data (you cannot change it) using the View or Browse function. Use
View or Browse to look at large data sets, such as compiler listings. You can scroll
the data up, down, left, or right. If you are using Browse, a FIND command, entered
on the command line, allows you to search the data and find a character string. If

5
 Time sharing option

you are using View, you can use all the commands and macros available to you in
the Edit function.

Option 2 - Edit
Edit allows you to create or change source data, such as program code and
documentation using the ISPF full-screen editor. You can scroll the data up, down,
left, or right. You can change the data by using Edit line commands, which are
entered directly on a line number, and primary commands, which are entered on the
command line.

Option 3 - Utilities
Utilities perform library and data set maintenance tasks, such as moving or copying
library or data set members, displaying or printing data set names and volume table
of contents (VTOC) information, comparing data sets, and searching for strings of
data.

Option 4 - Foreground
Foreground calls IBM language processing programs in the foreground, thus
interactively executes language-processing programs.

Option 5 - Batch
Batch calls IBM language processing programs as batch jobs. ISPF generates Job
Control Language (JCL) based on information you enter and submits the job for
processing.

Option 6 - Command
Command Lets you enter TSO commands, including CLIST and REXX command
procedures, while ISPF is running.

Option 7 - Dialog Test

Dialog Test Helps you test individual dialog elements or entire dialogs to make sure
everything works the way you want it to.

Option 8 - IBM Products

LM Facility controls and tracks the movement of members into controlled libraries
and throughout library hierarchies.

Option 9 - LM Facility
IBM Products allows you to select other installed IBM program development products
on your system.

Option 10 - SCLM
SCLM controls, maintains, and tracks all of the software components of an
application.

Option 11 - Workplace
Workplace gives you access to the ISPF Workplace, which combines many of the ISPF
functions onto one object-action panel.

6
 Time sharing option

Option X - EXIT
EXIT leaves ISPF using the log and list defaults. You can change these defaults from
the Log/List pull-down on the ISPF Settings panel action bar

USING FUNCTION KEYS

Before you start working with ISPF, you should know the operation of your function
keys. There are 24 Function keys Use the PFSHOW and FKA (function key area)
commands to display function key values on your terminal screen for easy reference.
The function keys on your terminal have default settings provided by ISPF.

F1=Help....... F2=Split....... F3=Exit....... F7=Backward......... F8=Forward F9=Swap

.............F10=Actions............ F12=Cancel

ALLOCATING LIBRARIES

ISPF uses a library structure to name and organize data sets. This naming structure
is similar to that used for TSO partitioned data sets:

A three-part name, with member names following in parentheses. The parts of the
ISPF library name are: project.group.type for most organizations, the project name
is your USERID.

Before you can create a member of an ISPF library, you must allocate the library.
This is a different allocation from that which pairs a data set with a ddname that the
operating system can recognize.

TO ALLOCATE AN ISPF LIBRARY OR OPTION 3.2

1. Select Utilities (option 3) from the ISPF Primary Option Menu or from the action
bar. The panel shown

Menu Utilities Compilers Options Status Help

ISPF Primary Option Menu

Option ===> 3

0 Settings ........Terminal and user parameters .................User ID :

1 View .............Display source data or listings ................Time . . :
2 Edit ..............Create or change source data ................Terminal :
3 Utilities..........Perform utility functions .........................Screen. :
4 Foreground ....Interactive language processing ..............Language :
5 Batch ...........Submit job for language processing ..........Appl ID :
6 Command ......Enter TSO or Workstation commands .......TSO logon :
7 Dialog Test ....Perform dialog testing .......................... TSO prefix:
8 LM Facility......Library administrator functions ...............System ID :
9 IBM Products .IBM program development products .........MVS acct :
10 SCLM ..........SW Configuration Library Manager ...........Release. :
11 Workplace ....ISPF Object/Action Workplace
S SDSF ............Spool Search and Display Facility
D DITTO ...........DITTO/ESA for MVS Version 1

7
 Time sharing option

DF DFSORT ...... Data Facility Sort

DB DB2 ............ Data Base Product
O OMVS ...........MVS Open Edition

2) Press ENTER

TO ALLOCATE AN ISPF LIBRARY OR DATASET

1) On the Utility Selection Menu, select the Data Set Utility(Option2).

Menu Help

Utility Selection Panel

Option ===> 2
More:
+
1 Library Compress or print data set. Print index listing.
Print,
Rename, delete, browse, edit or view 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 names.
Print or display VTOC information
5 Reset Reset statistics for members of ISPF library
6 Hardcopy Initiate hardcopy output
7 Download Download ISPF C/S, VA for ISPF, transfer map, or data set.
8 Outlist Display, delete, or print held job output
9 Commands Create/change an application command table
10 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 (Extended Dialog)
14 Search-For Search data sets for strings of data (Standard Dialog)

2) Press ENTER

3) On the Data Set Utility panel, select option A, Allocate new data set, and
fill in the name of an ISPF library, as follows, using your USERID as the
project name.

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 Data set information (short)

blank Data set information M Allocate new data set

V VSAM Utilities

8
 Time sharing option

ISPF Library:

Project . . Userid
Group . . . TSO
Type . . . . FILE

Other Partitioned, Sequential or VSAM Data Set:

Data Set Name . . .

Volume Serial . . . ..............(If not cataloged, required for option "C")

Data Set Password. ............ (If password protected)

4) Press Enter

5). On the Allocate New Data Set panel shown are characteristics that you
can specify for the new data set.

Menu RefList Utilities Help

Allocate New Data Set

Command ===>
More: +
Data Set Name . . . : MTPL003.TEST.SAMPLE

Management class . . . ................ .(Blank for default management class)

Storage class . . . . ......................(Blank for default storage class)
Volume serial . . . ... STOR01 .......... .(Blank for system default volume) **
Device type . . . . ....................... (Generic unit or device address) **
Data class . . . . . . .......................(Blank for default data class)
Space units . . . . . ...TRACK ..............(BLKS, TRKS, CYLS, KB, MB, BYTES
or RECORDS)
Average record unit (M, K, or U)
Primary quantity . . ..5.................. (In above units)
Secondary quantity ..5 ..................(In above units)
Directory blocks . . ..0 ...................(Zero for sequential data set) *
Record format . . . . FB
Record length . . . . 80
Block size . . . . ..... 6160
Data set name type. : .................(LIBRARY, HFS, PDS, or blank) *

6)Press Enter.

7) Check to see if the message Data set allocated appears in the upper right
corner of the Data Set Utility panel

Menu RefList Utilities Help

Data Set Utility Data set allocated

Option ===>

9
 Time sharing 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 Data set information (short)
blank Data set information M Allocate new data set
V VSAM Utilities

ISPF Library:

Project . . MTPL003
Group . . . TEST
Type . . . . SAMPLE

Other Partitioned, Sequential or VSAM Data Set:

Data Set Name . . .
Volume Serial . . . (If not cataloged, required for option "C")

Data Set Password . . (If password protected)

SHORTCUTS FOR MOVING WITHIN ISPF PANELS

You can use the jump function to move from one option to another under the same
primary option menu. Type an equal sign followed by a ISPF option number in any
input field that is preceded by ===> For example, =2 and press Enter., and you can
go directly to that option without going back to the ISPF Primary Option Menu

EDITING AN ISPF LIBRARY WITH OPTION 2

This exercise explains how to use option 2 to edit an ISPF library. Remember that the
ISPF library must have been allocated before you can edit it.

Menu Utilities Compilers Options Status Help

ISPF Primary Option Menu

Option ===> 2

0 Settings Terminal and user parameters User ID . :

1 View Display source data or listings Time. . . :
2 Edit Create or change source data Terminal. :
3 Utilities Perform utility functions Screen. . : 1
4 Foreground Interactive language processing Language. :
5 Batch Submit job for language processing Appl ID . :
6 Command Enter TSO or Workstation commands TSO logon :
7 Dialog Test Perform dialog testing TSO prefix:
8 LM Facility Library administrator functions System ID :
9 IBM Products IBM program development products MVS acct. :
10 SCLM SW Configuration Library Manager Release. :
11 Workplace ISPF Object/Action Workplace
S SDSF Spool Search and Display Facility
D DITTO DITTO/ESA for MVS Version 1
DF DFSORT Data Facility Sort
DB DB2 Data Base Product
O OMVS MVS Open Edition

10
 Time sharing option

Press Enter

CREATING AND EDITING AN ISPF LIBRARY MEMBERS

1. To create and edit member of the ISPF library that is allocated,

Menu RefList RefMode Utilities LMF Workstation Help

Edit Entry Panel

Command ===>

ISPF Library:
Project . . . USERID
Group . . . . TSO . . . . . . . . . . . . . . . . . . . .
Type . . . . FILE
Member . . . NEW (Blank or pattern for member selection list)

Other Partitioned or Sequential Data Set:

Data Set Name . . .
Volume Serial . . . (If not cataloged)

Workstation File:
File Name . . . . . Options
Initial Macro . . . . / Confirm Cancel/Move/Replace
Profile Name . . . . . Mixed Mode
Format Name . . . . . Edit on Workstation
Data Set Password. . . Preserve VB record length

. You do not need to fill in or change any of the other information on this
panel. Press Enter.

2. On the panel, press the Tab key to move to the text area and enter the
following (or some text of your own choice):

File Edit Confirm Menu Utilities Compilers Test Help

EDIT USERID. TSO.FILE(NEW) - 01.00 Columns 00001 00072

Command ===> Scroll ===> PAGE
****** ******* Top of Data *****************************

==MSG> -Warning- The UNDO command is not available until you change
==MSG> your edit profile using the command RECOVERY ON.
'''''' Hello welcome to VISA
''''''
''''''
''''''
''''''
''''''
''''''

11
 Time sharing option

''''''
''''''
''''''
''''''
''''''
''''''
''''''

3. When you finish typing the text, press Enter. The cursor moves below the
last line of input, and all the text you just typed is now in capital letters

File Edit Confirm Menu Utilities Compilers Test Help

EDIT USERID. TSO.FILE(NEW) - 01.00 Columns 00001 00072

Command ===> Scroll ===> PAGE
****** *********** Top of Data ************************

000100 HELLO WELCOME TO VISA

****** ********** Bottom of Data **************************

• Utility Selection Panel Action Bar

• Library Utility (Option 3.1)

Compress or print data set. Print index listing. Print,

Rename, delete, browse, edit or view members

• Data Set Utility (Option 3.2)

Allocate, rename, delete, catalog, uncatalog, or display
Information of an entire data set

• Move/Copy Utility (Option 3.3)

Move, copy, or promote members or data sets

• Data Set List Utility (Option 3.4)

Print or display (to process) list of data set names.
Print or display VTOC information

• SuperC Utility (Option 3.12)

Compare data sets (Standard Dialog)

• Search-ForE Utility (Option 3.15)

Search data sets for strings of data

USING EDIT COMMANDS

There are two kinds of commands within the Edit option:

• Primary commands

12
 Time sharing option

• Line commands

Primary commands are the ones you type in on the edit Command line at the top of
your data. For example: PROFILE, CAPS OFF, UNNUM, and RESET.

Line commands are commands that you enter on the edit line numbers, which are
located on the left side of the data.

The line commands are:

13