IBM 360 User manual

~I

/

Systems Reference Library

IBM

System/360

Operating System:

Time Sharing

Option

Terminal User's

Guide

OS

Release 21.7

The

Time

Sharing

Option

(TSO>

of

the

IBM

System/360

Operating

System

lets

you

use

the

facilities

of

a

computer

from

a

terminal.

You

define

your

work

to

the

system

through

the

TSO

Command

Language.

This

publication

explains

to

all

users

of

TSO

how

to

use

the

TSO

Command

Language

to

perform

the

following

functions:

•

Start

and

end

a

terminal

session.

•

Enter

and

manipulate

data.

•

Program

at

the

terminal.

•

Test

a

program.

•

Write

and

use

command

procedures.

•

Control

a

system

with

TSO.

After

becoming

familiar

with

the

information

presented

in

this

manual.

you

may

use

IBM

SystefiV360

Operating

System:

Time

Sharing

Option.

Command

Language

Reference,

GC28-6732

for

review

and

reference.

File

No.

8360-36

Order

No.

GC28-6763-3

OS

Fourth

Edition

(August, 1974)

This

is

a reprint

of

GC28-6763-1 and GC28-6763-2 incorporating changes released

in the following Technical Newsletters:

GN28-2522 (dated April 15, 1972 -for

-1

only)

GN28-2555 (dated April 16, 1973)

This edition applies

to

release 21.7

of

IBM

System/360 Operating System. Information

in this publication is subject to change. Before using this publication, be sure you have

the latest edition and any Technical Newsletters.

Requests for copies

of

IBM

publications should be made

to

your

IBM

representative or

to

the

IBM

branch office serving your locality.

A form for readers' comments

is

provided at the back

of

this publication.

If

the form has

been removed, comments may be addressed to

IBM

Corporation, Publications Development,

Department D58, Building 706-2,

PO

Box

390, Poughkeepsie, N.Y. 12602. Comments

become

the

property

of

IBM.

'1

This

publication

describes

how

to

use

the

TSO Command

Language

to

all

TSO

terminal

users.

The

commands

can

be

used

to

perform

the

following

functions:

•

Start

and

end

a

terminal

session.

•

Enter

and

manipulate

data.

•

Program

at

the

terminal.

•

Test

a

program.

•

Write

and

use

command

procedures.

•

Control

a

system

with

TSO.

This

publication

tells

you

what

commands

to

use

to

perform

these

functions.

For

details

on

how

to

code

each

command,

refer

to

the

publication

IBM

System/360

operating

system:

Time

Sharing

Option,

Command

Language

Reference,

GC28-6732.

Before

reading

this

manual

you

should

be

aware

of

three

facts:

•

Program

Products

are

not

discussed

in

this

manual.

•

All

examples

in

this

manual

show

the

user's

input

in

lowercase

letters

and

the

system

output

in

uppercase

letters.

•

All

examples

in

this

manual

assume

that

you

are

using

an

IBM

2741

Communications

Terminal,

and

that

you

must

press

the

RETURN

key

to

enter

data.

For

information

on

your

type

of

Preface

terminal

refer

to

the

publication

IBM

System/360

Operating

system:

Time

sharing

Option,

Terminals,

GC28-6762.

Additional

publications

referenced

in

this

manual

include:

IBM

Data

Processing

Glossary,

GC20-1699.

IBM

System/360

Operating

System:

Assembler

F

Programmer's

Guide,

GC26-3756.

Job

Control

Language

Reference,

GC28-

6704.

Linkage

Editor

and

Loader,

GC28-6538.

Operator's

Procedures,

GC28-6692.

PL/I

(F)

Programmer's

Guide,

GC28-6594.

Time

Sharing

Option

Command

Language

Reference,

GC28-6732.

Time

Sharing

Option

Guide

to

Writing

a

Terminal

Monitor

Program

or

a Command

Processor,

GC28-6764.

4

TSO

Terminal

User's

Guide

(Release

21)

SUMMARY

OF

AMENDMENTS

FOR

GC28-6763-l,-2

AS

UPDATED

BY

GN28-2555

OS

RELEASE

21.7

••••••••••••

7

SUMMARY

OF

AMENDMENTS

FOR

GC28-6763-l

AS

UPDATED

BY

GN28-2522

COMPONENT

RELEASE

360S-0S-586

• • • • • • • •

••

7

SUMMARY

OF

AMENDMENTS

FOR

GC28-6763-l

OS

RELEASE

21

• • • • • • • • • • •

••

7

SUMMARY

OF

AMENDMENTS

FOR

GC28-6763-0

OS

RELEASE

20

• •

••

7

INTRO

DUCT

ION

• 9

WHAT

YOU

MUST

KNOW

TO

USE

TSO

11

Entering

Information

at

the

Terminal

..

•

11

COmmands • • •

..

•

ft

•

..

• •

..

• • • •

12

When

to

Enter

a Command

or

Subcommand

15

How

to

Enter

a Command

or

Subcommand

•

15

Messages

•

..

• •

.. ..

•

..

•

..

15

Mode

Messages

....

•

..

,.

..

16

Prompting

Messages.

..

• •

17

Informational

Messages..

17

Broadcast

Messages

•

..

18

The

Attention

Interruption

• •

18

The

HELP

Command

.. ..

'.

..

•

19

STARTING

AND

ENDING

A

TERMINAL

SESSION •

21

Identifying

Yourself

to

the

System

..

21

Defining

operational

Characteristics

• •

24

Receiving

and

Sending

Broadcast

Messages

• •

..

• •

.. ..

..

• •

Receiving

Broadcast

Messages

..

Sending

Messages

..

,.

.. ..

..

Displaying

session

Time

Used

•

..

Ending

Your

Terminal

Session

..

'.

ENTERING

AND

MANIPULATING

DATA

..

Identifying

the

Data

Set

..

•

..

•

Creating

A

Data

Set

...

• • •

..

Placing

Data

into

Columns

Finding

and

Positioning

the

Current

• •

24

• •

25

..

26

• •

27

..

•

27

• •

28

• •

29

33

•

..

35

Line

Pointer

•

..

•

..

• • • • •

..

• •

37

Finding

the

Current

Li

ne

Pointer

..

'..

37

Positioning

the

Current

Line

Pointer

•

38

Updating

a

Data

Set

....

• • •

..

• •

40

Deleting

Data

From

a

Data

Set

41

Inserting

Data

in

a

Data

Set..

•

..

41

Replacing

Data

in

a

Data

Set

• • • 44

Renumbering

Lines

of

Data

49

Listing

the

Contents

of

a

Data

Set..

• •

50

Storing

a

Data

set

..

•

..

51

Ending

the

Edit

Functions

• • 53

Renaming

a

Data

Set

• • 54

Contents

Deleting

a

Data

set

• • • • •

..

Establishing

Passwords

for

a

Data

Set

Allocating

a

Data

set

• • • •

•

56

,.

57

Assigning

Attributes

to

a

Data

set

•

Freeing

a n

Allocated

Data

Set

58

61

Listing

Inf

ormati

on

About

Your

Data

Sets

• • •

_.

• • •

..

• • •

PROGRAMMING

AT

THE TERMINAL

Creating

a

Pro;Jram

......

Compiling

a

Program

• • • •

Link

Editing

a

Compiled

Program

Executing

a

Program

Loa

ding

a

Pro;J

ram

• • • • • •

.Processing

Background

Jobs

• • •

..

'.

•

Submitting

Background

Jobs

...

Displaying

the

status

of

Background

Jobs

• •

I.

• •

I.

•

I.

• •

.•

• .

Cancellirq

Background

Jobs.

'.

Controlling

the

Output

of

a

Bac

kground

Job.

• • •

,..

TESTING A

PROGRAM

62

•

63

•

64

•

65

•

66

•

68

70

•

73

•

75

,.

76

,.

79

USING

AND

WRITING

COMMAND

PROCEDURES

'.

•

81

Using

Command

Procedures

,.

'.

,.

•

..

,..

•

81

Calling

a Command

Procedure

81

Assignil'J3

Values

to

Symbolic

Values

'.

82

Writing

Command

Procedures

• •

82

Assignil'J3

Symbolic

Values

••

'.

• • •

83

Examples

of

Symbolic

Substitution

'.

•

84

Testing

Conditions

for

Termination

••

85

Ending

the

Command

Procedure

•

85.1

A

Compiler

Command

Procedure.

•

85.1

Nested

Procedures

•

'.

•

,.

• • •

85.3

CONTROLLING

A

SYSTEM

WITH

TSO

• '

••

'

••

86

The

OPERATOR

Command •

'.

..

'.

•

Monitoring

Ternli.

nal

Activity

•

Displaying

TSO

Information

••

Cancelling

a

Session

or

Background

•

86

• •

87

..

•

89

Job

..

• • •

'.

•

..

•

.•

• • • • •

90

Sending

~ssages

to

Terminal

Users

'

••

90

Modifying

Time

Shari

ng

Parameters

91

Ending

Operation

of

the

Operator

Comnand

......

'.

•

,.

..

• •

.•

..

• •

91

The

ACCOUNT

Command • • • • •

91

Adding

New

Entries

or

Data

to

an

Entry

• •

..

• • •

.. .. ..

• •

92

Deleting

Entries

or

Parts

of

Entries

•

96

Changing

Data

in

an

Entry

••••••

100

Displaying

the

Contents

of

an

Entry

.101

Displaying

All

User

Identifications

.102

Ending

Operation

of

the

ACCOUNT

Comma

nd

.......

• • • • •

10

2

GLOSSARY.

.103

Contents

5

Figures

Figure

1.

TSO

Commands

and

Subcommands,

Including

Abbreviations

•

14

Figure

2.

sample

Instruction

Sheet

for

a

Terminal

........,.

'.

..

,.

..

• •

22

Figure

3.

Descriptive

Qualifiers

31

Figure

4,.

Default

Tab

settings

36

Figure

5.

Values

of

the

Line

Pointer

Referred

to

by

an

Asterisk

C*)

38

Figure

6.

Sample

Data

set

.. ..

..

•

..

40

Figure

7.

Allocating

Data

Sets

for

the

Assembler

F •

..

•

..

60

Figure

7,.1

Assigning

Attributes

to

a

Ila

ta

Set

•

'.

• •

.. .. ..

..

••

• • •

61

Figure

8.

Creating

an

assembler

source

program

• •

..

•

64

Figure

9.

Data

Set

Names

of

the

Compi

lers

........................

• •

65

Figure

10.

COBOL

Compilation

66

Figure

11.

Link

editing

and

executing

a

program

..

Q • Q

..

70

Figure

12.

Loading

a

Program

..

• • •

73

6 TSO

Terminal

User's

Guide

(Release

21.7)

Figure

13.

Submi

tti

ng

a

P~ogram

as

a

Ba

ckground

Job

• • • •

.•

• • •

..

•

75

Figure

14..

Symbolic

Values

for

a

Command

Procedure

..

'.

•

..

• • • •

82

Figure

14

..

1..

substitution

Using

Keyword

Parameters

••

'.

•

'.

..

• • '. •

85

Figure

14.2..

A Command

Procedure.

to

Invoke

the

PL/I

CF)

Compiler

85.1

Figure

14.J

3.

Use

of

a Command

Procedur~-

•

..

• • •

85.2

Figure

14

..

4.

Implicit

use

of

Procedure

...........

'.

•

85

• 2

Figure

14

..

5..

A Command

Procedure

to

Invoke

a

User

Program

...........

85.3

Figure

14.6.

A Command

Procedure

for

a

Compile-Load-Go

Sequence

•••••

85.4

Figure

14

..

7..

Using

a

Compile-Load-Go

Command

Procedure

•

••

,.

•

..

•

..

85.4

Figure

15.

The

Simplest

structure

Tha

t

an

Entry

in

the

UADS

Can

Have

'...

93

Figure

16..

A

Complex

Structure

for

an

Entry

in

the

UAOO

............

93

Summary of Amendments

for

GC28-6763-1,-2

as

Updated

by

GN28-2555

OS

Release 21.7

COMMAND

PROCEDURES

Symbolic

substitution

Examples

added.

Compiler

Command

Procedure

A

series

of

examples

added.

"when"

Stat~ment

Text

changed

to

read

that

a

command

procedure

ends

when

it

finishes

processing

a

true

"when

n

statement.

EDITORIAL

CHANGES

Several

minor

editorial

changes

have

been

made.

Summary of

Amendments

for GC28-6763-1

as

Updated

by

GN28-2522

Component

Release

360S-0S-586

DYNAMIC

SPECIFICATION

OF

DCB

PARAMETERS

The

discussion

about

Allocating

a

Data

set

was

expanded

to

include

Assigning

Attributes

to

a

Data

set.

The

discussion

about

Freeing

a

Data

Set

was

expanded

to

include

deleting

a

list

of

attributes.

Summary

of

Amendments

Summary of

Amendments

for GC28-6763-1

OS

Release

21

QUOTED

STRING

NOTATION

FOR

FIND

AND

CHANGE

SUBCOMMANDS

The

FIND

and

CHANGE

subcommands,

of

the

EDIT

command,

can

now

accept

quoted

string

as

~ell

as

special

delimiter

syntax.

STOPMN

The

STOP

subcommand,

of

the

OPERATOR

command,

is

changed

to

STOPMN.

EDITORIAL

CHANGES

Many

editorial

changes

have

been

made.

Summary of

Amendments

for

GC28-6763-0

as

Updated

by

GN28-2483

OS

Release 20.1

CTLX

KEYWORD

FOR

PROFILE

COMMAND

Keyword

added.

COPY

SUBCOMMAND

OF

TEST

Subcommand

added.

Summary

of

Amendments

7

8 TSO

Terminal

User's

Guide

(Release

21.7)

Introduction

TSO

is

the

time

sharing

option

of

the

IBM

System/360

Operating

system.

TSO

le~

you

use

the

facilities

of

a

computer

at

a

terminal.

A

terminal

is

a

typewriter-like

device

connected

through

telephone

or

other

communication

lines

to

the

computer.

A

terminal

can

be

at

any

distance

from

the

computer

--

in

the

same

room

or

in

another

city.

Because

the

system

processes

instructions

much

faster

than

you

can

enter

them

through

the

terminal,

it

can

process

input

from

many

terminals

at

the

same

time

it

is

processing

work

entered

in

the

conventional

manner

in

the

computer

room.

HoweverI

due

to

the

speed

of

the

system,·

you

will

be

able

to

work

as

though

you

had

almost

exclusive

use

of

the

system.

You

can

tell

the

system

what

work

you

want

done

by

typing

in

one

or

more

of

the

commands

that

form

the

TSO

command

language..

The command

language

can

be

used

to:

•

Enter",

store,

modify,

and

retrieve

data

at

the

terminal.

•

Solve

mathematical

problems.

•

Develop

programs

written

in

Assembler,

FORTRAN,

COBOL,

PLlI,

or

other

languages.

•

Execute

programs.

•

Control

the

operation

of

a

system

with

TSO

from

the

terminal.

Your

installation

determines

which

of

the

facilities

of

the

system

you

can

use.

That

is,

the

installation

determines

which

commands

are

available

to

you.

When

you

enter

a command

in

the

system,

the

system

performs

the

work

requested

by

that

command

and

sends

messages

back

to

your

terminal.

The

messages

tell

you

the

status

of

your

program

and

whether

the

system

is

ready

to

accept

another

command. You

can

interrupt

the

processing

of

a

command

at

any

time

and

enter

a new

one.

If

you

make a

mistake

typing

in

a command,

or

if

you

fail

to

include

some

necessary

information

with

the

command,

the

system

sends

you

a

message

prompting

you

for

the

necessary

information.

You may

then

respond

by

typing

in

the

information

requested.

If

you

receive

a

message

you

don't

understand,

you

can

type

in

a

question

mark

to

request

more

information.

The

system

will

then

send

you

a

more

detailed

message,

if

available.

Whenever

you

are

not

sure

which

command

to

use

or

how

to

use

a

particular

command,

you

can

type

HELP.

HELP

is

a command

that

provides

you

with

information

on

all

other

TSO

commands.

This

manual

explains

how

to

use

the

command

language.

The

manual

is

divided

into

the

following

sections:

1.

What

you

must

know

to

use

TSO.

2.

Starting

and

ending

a

terminal

session.

3.

Entering

and

manipul"ating

data.

4.

Programming

at

the

terminal.

S.

Testing

a

program.

6.

Using

and

writing

command

procedures.

7.

Controlling

a

system

with

TSO.

Introduction

9

The

f~st

three

items

must

be

known

by

all

system

users.

Items

4 - 6

describe

specific

functions

a

user

may

wish

to

perform,.

Item

7

describes

capabilities

that

you

may

use

if

your

installation

has

given

you

authorization.

This

manual

tells

you

what

commands

to

use

to

perform

the

functions

mentioned

above.·

For

details

on

how

to

enter

each

command,

refer

to

the

manual

Command

Language

Reference.

10

TSO

Terminal

User's

Guide

(Release

21)

IBM 360 User manual

Popular Desktop manuals by other brands