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)

I

What

You

Must Know to Use

T50

Before

you

begin

a

terminal

session,

you

should

know:

•

How

to

enter

information

at

the

terminal.

•

How

to

use

the

TSO

commands.

•

How

to

interpret

TSO

messages.

•

How

to

use

the

attention

interruption.

•

How

to

use

the

HELP

command.

Entering Information at the Terminal

All

TSO

terminals

have

a

typewriter-like

keyboard

through

which

you

enter

information

into

the

system.

The

features

of

each

keyboard

vary

from

terminal

to

terminal;

for

example,

one

terminal

may

not

have

a

backspace

key,

while

another

may

not

allow

for

lowercase

letters.

The

features

of

each

terminal

as

they

apply

to

TSO

are

described

in

the

publication,

TSO

Terminals.

Certain

conventions

apply

to

the

use

of

all

TSO

terminals.

They

are:

• Any

lowercase

letters

you

type

are

interpreted

by

the

system

as

uppercase

letters.

For

example,

if

you

type

in:

abcDe8-fg

the

system

interprets

it

as:

ABCDE8-FG

The

only

exceptions

are

certain

text-handling

applications

which

allow

you

to

type

in

text

with

both

uppercase

and

lowercase

letters.

Text

handling

is

discussed

in

the

section

"Entering

and

Manipulating

Data".

•

All

messages

or

other

output

sent

to

you

by

the

system

come

out

in

uppercase

letters.

The

only

exception

is

the

output

from

the

special

text-handling

applications

mentioned

previously

which

comes

out

both

in

uppercase

and

lowercase.

TSO

also

provides

a

method

for

you

to

correct

your

typing

mistakes.

You

can

request

that

the

character

you

just

typed

be

deleted

or

that

all

the

preceding

characters

in

the

line

be'deleted.

You

can

define

your

own

character-deletion

and

line-deletion

control

characters,

or

you

can

use

the

default

characters

in

the

system.

For

example,

if

the

control

characters

are

the

quotation

mark

(")

for

deleting

the

preceding

character,

and

the

percent

sign

(%)

for

deleting

all

the

preceding

characters

of

the

line,

and

you

type

the

following

message:

first

ent%Sect"onft""d

ENR"try

it

is

received

by

the

system

as:

SECOND

ENTRY

Note

that

you

can

use

the

character-deletion

character

repetitively

to

delete

more

than

one

of

the

preceding

characters

in

the

line.

What

you

Must

Know

to

Use

TSO

11

The

blank

space

produced

when

you

hit

the

space

bar

is

also

considered

to

be

a

character,

and

you

can

delete

it

using

the

character-deletion

or

line-deletion

characters.

For

example,

if

you

type

the

following

line:

a

blcd

liE

IIf

it

is

received

by

the

system

as:

CD

EF

After

you

type

a

line

and

make

any

necessary

corrections,

you

can

enter

that

line

as

follows:

•

Press

the

RETURN

key

on

an

IBM

2741

Communications

Terminal.

•

Press

the

RETURN

key

on

an

IBM

1052

Printer-Keyboard

(If

the

1052

does

not

have

the

automatic

EOB

feature,

hold

down

the

ALTN

coding

key

and

press

the

EOB(s)

key.)~

•

Hold

the

CTRL

key

and

press

the

XOFF

key

on

a

Teletype

2

terminal.

Notes:

•

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

a

line.~

•

If

you

want

to

enter

a

null

line,

that

is

a

line

with

no

characters

in

it,

press

the

key

used

to

enter

a

line

(RETURN

key

on

the

2741).

You

cannot

use

the

character-deletion

and

line-deletion

characters

to

make

corrections

to

the

line

after

you

enter

it.

If

the

line

you

entered

was

a command,

you

must

use

the

attention

interruption

(described

later

in

~his

section)

to

cancel

the

command,

and

then

you

must

reenter

the

command.

If

the

line

you

entered

was

data,

you

can

change

it

by

using

the

EDIT

command

(described

in

the

section,

"Entering

and

Manipulating

Data").

Normally..

you

will

use

the

default

characters

in

the

system,

(usually

the

backspace

and

the

attention

key).

However,.

you

can

use

the

PROFILE

command

to

establish

your

own

character-deletion

and

line-deletion

characters.

The

PROFILE command

is

described

in

the

section,

"Starting

and

Ending

a

Terminal

Session".

The

ability

to

change

the

character-deletion

and

line-deletion

characters

is

particularly

useful

when

you

use

more

than

one

type

of

terminal.

For

example,

any

time

you

have

to

use

a

terminal

that

does

not

have

backspace

and

attention

keys,

you

can

use

the

PROFILE command

to

select

two

other

suitable

characters

as

the

character-deletion

and

line-deletion

characters.

Commands

You

can

communicate

with

the

system

by

typing

requests

for

work,

commands,

at

the

terminal.

Different

commands

specify

different

kinds

of

work.

You

can

store

data

in

the

system,

change

the

data,

and

retrieve

it

at

your

convenience.

You

can

create

programs,

test

them,

execute

them

and

obtain

the

results

at

your

terminal.

The commands make

the

facilities

of

the

system

available

at

your

terminal.

~For

information

about

the

terminal

you

are

using,

refer

to

TSO

Terminals.

2

Trademark

of

the

Teletype

Corporation

.•

12

TSO

Terminal

User's

Guide

(Release

21)

When

you

use

a

command

to

request

work,

the

command

establishe~

the

scope

of

the

work

to

the

system.

For

some

commands,

the

scope

of

the

work

encompasses

several

operations

that

you

can

identify

separately.

After

entering

the

command,

you

may

specify

one

of

the

separately

identifiable

operations

by

entering

a

subcommand.

A

subcommand.

like

a

command,

is

a

request

for

work;

however,

the

work

requested

by

a

sUbcommand

is

a

particular

operation

within

the

scope

of

work

established

by

a

command.

The

commands

and

subcommands

recognized

by

TSO

form

the

TSO

command

language.

The

command

language~is

designed

to

be

easy

to

use.

The

command

names

and

subcommand

names

are

typically

familiar

English

words,

often

verbs,

that

describe

the

work

to

be

done.

The

number

of

command

names

and

subcommand

names

that

you

must

learn

has

been

kept

to

a

minimum.

(Your

installation

can

add

its

own

commands

to

perform

functions

not

provided

by

the

TSO

command

language.)

Besides

entering

the

name

of

the

command

or

subcommand,

you

are

often

required

to

specify

additional

information

to

pinpoint

the

function

you

want

performed.

You

define

the

additional

information

with

operands

(words

or

numbers

that

accompany

the

command

names

and

subcommand

names).

Most

of

the

operands

have

default

values

that

are

used

by

the

system

if

you

choose

to

omit

the

operand

from

the

command

or

subcommand.

However,

some

operands

do

not

have

default

values.

If

you

fail

to

provide

a

required

operand

for

which

there

is

no

default,

the

system

sends

you

a

prompting

message

asking

you

to

supply

the

operands.

The

publication,

Command

Language

Reference

shows

all

operands

for

each

command,

indicates

the

default

values

where

applicable,

and

describes

how

to

enter

the

commands.

You

can

abbreviate

many

of

the

command

names,

subcommand

names

and

operands.

Together,

the

defaults

and

abbreviations

decrease

the

amount

of

typing

required.

(The

abbreviations

and

their

use

are

discussed

in

the

publication,

Command

Language

Reference.)

Figure

1

lists

the

commands

and

their

subcommands

in

alphabetical

order.

Wha

t

you

Must

Know

to

Use

TSO

13

r----------------------------------T-----------------------------------,

I

COMMAND

(abbreviation)

J

COMMAND

(abbreviation)

I

SUBCOMMAND

(abbreviation)

I

SUBCOMMAND

(abbreviation)

I

~----------------------------------+-----------------------------------~

ACCOUNT

I

LOGOFF

ADD

(A)

LOGON

CHANGE

(C)

*

MERGE

DELETE

(D)

OPERATOR

(OPER)

END

CANCEL

(C)

HELP

(H) DISPLAY (D)

LIST

(L)

END

LISTIDS

(LISTI)

HELP

(H)

ALLOCATE

(ALLOC)

MODIFY

(F)

*ASM

MONITOR

(MN)

ATTRIB (ATTR)

SEND

*

CALC

STOPMN

(PM)

CALL

OUTPUT

(OUT)

CANCEL

CONTINUE

(CONT)

*COBOL

(COB)

END

*CONVERT

(CON)

HELP

(H)

*COpy

SAVE

(S)

*PLI

*PLIC

DELETE

(D) PROFILE (PROF)

EDIT (E)

PROTECT

(PROT)

BOTTOM

(B)

RENAME

(REN)

CHANGE

(C)

RUN

(R)

DELETE

(D)

SEND

(SE)

DOWN

STATUS

(ST)

END

SUBMIT

(SUB)

FIND

(F)

TERMINAL

(TERM)

*FORMAT

(FORM)

TEST

(T)

HELP

(a)

Assign

(=)

INPUT

(I)

AT

INSER'!'

(IN)

CALL

LIST

(L)

COpy

(C)

*MERGE

(M)

DELETE

(D)

PROFILE (PROF)

DROP

RENUM

(REN)

END

RUN

(R)

EQUATE

(EQ)

SAVE

(S)

FREEMAIN

(FREE)

SCAN

(SC)

GETMAIN

(GET)

TABSET

(TAB)

GO

TOP

HELP

(H)

UP

J

LIST

(L)

VERIFY

(V)

I LISTDCB

EXEC

(EX) I LISTDEB

*FORMAT

(FORM)

I

LISTMAP

*FORT I LISTPSW

FREE

I LISTTCB

HELP

(a)

I

LOAD

LINK I

OFF

*LIST

(L) I

QUALIFY

(Q)

LISTALC (LISTA) I

RUN

(R)

LISTBC (LISTB) I

WHERE

(W)

LISTCAT (LISTC) I TIME

LISTDS (LISTD) I **PROC

LOADGO

(LOAD)

I **END

I I

**WHEN

~----------------------------------~-----------------------------------~

I

*Available

as

program

products

I

1**For

use

in

command

procedures

I

L

______________________________________________________________________

J

Figure

1.

TSO

Commands

and

Subcommands,

Including

Abbreviations

14

TSO

Terminal

User's

Gu~de

(Release

21.7)

WHEN

TO

ENTER

A

COMMAND

OR

SUBCOMMAND

The

system

lets

you

know when

it

is

ready

to

accept

a new command

by

sending

you

the

message:

READY

The

ACCOUNT.

EDIT,

OPERATOR,

OUTPUT

and

TEST

commands

have

subcommands.

After

entering

one

of

these

commands

the

system

lets

you

know

it

is

ready

to

accept

a subcommand

by

sending

you

the

name

of

the

cQmmand.

For

example,

in

the

following

sequence

you

enter

the

OPERATOR

command

after

receiving

a

READY

message.

The

system

then

sends

you

the

OPERATOR

message

indicating

that

you

can

enter

any

of

the

subcommands

of

the

OPERATOR

command:

READY

operator

OPERATOR

If

instead

of

entering

a subcommand

you

want

to

enter

a command,

enter

the

END

subcommand

to

make

the

READY

message

appear

again.

The

system

remains

able

to

receive

commands

until

you

enter

one

of

the

five

commands

that

have

subcommands.

The

system

then

accepts

only

that

command's

subcommands

until

you

request

a

READY

message

by

entering

the

END

subcommand.

HOW

TO

ENTER

A

COMMAND

OR

SUBCOMMAND

After

you

receive

a

message

letting

you

know

the

system

is

ready

to

receive

a command

or

subcommand, do

the

following:

1.

Type

the

command

or

subcommand name

and

the

selected

operands.

2.

Correct

any

typing

mistakes

with

the

character-deletion

and

line-deletion

characters.

3.

Press

the

RETURN

key.

If

all

the

operands

do

not

fit

in

one

line

you

should

follow

this

sequence:

1.

Type

the

command

and

subcommand name

and

the

selected

operands.

2.

Type

a

hyphen

(-)

at

the

end

of

the

line.

3.

Press

the

RETURN

key.

4.

Continue

entering

the

operands.

If

they

do

not

fit

in

the

second

line

repeat

from

2,.

5.

Press

the

RETURN

key

to

enter

the

command.

You

can

type

command

and

subcommand

names

and

operands

in

either

uppercase·

or

lowercase

letters.

You may

prefer

to

type

your

commands

and

subcommands

in

lowercase

since

it

is

usually

more

convenient,

and

it

allows

you

to

distinguish

your

input

from

the

system's

messages

in

your

listing.

(The

system

prints

in

uppercase

letters.)

All

examples

in

this

manual

show

the

user's

input

in

lowercase

letters,

and

the

system

output

in

uppercase

letters.

Messages

There

are

four

types

of

messages:

• Mode mes

sages.

•

Prompting

messages.

•

Informational

messages.

•

Broadcast

messages

.•

What

you

Must

Know

to

Use

TSO

15

MODE

MESSAGES

A mode

message

tells

you

when

the

system

is

ready

to

accept

a new

command

or

subcommand.

(See

"When

to

Enter

a

Command

or

Subcommand" •)

When

;~he

system

is

ready

to

accept

a new command

it

prints:

READY

When

you

enter

a command

that

has

subcommands

and

the

system

is

ready

to

accept

its

subcommands,

it

prints

the

name

of

the

command,

which

can

be

anyone

of

the

following:

ACCOUNT

EDIT

OPERATOR

OUTPUT

TEST

You

can

then

enter

the

subcommands

you

want

to

use.

The

TEST

message

also

appears

after

each

TEST

subcommand

has

been

processed.

If

the

system

has

to

print

any

output

or

other

messages,

as

a

result

of

the

or

TEST

subcommand.

it

does

so

before

printing

the

mode

message.

(The

use

of

mode

messages

in

the

EDIT command

is

discussed

in

the

section

"Entering

and

Manipulating

Data".)

Sometimes

you

can

save

a

little

time

by

entering

two

or

more commands

in

succession

without

waiting

for

the

intervening

READY

message.

The

system

then

prints

the

READY

messages

in

succession

after

the

commands.

For

example,

if

you

enter

the

DELETE,

FREE,

and

RENAME

commands

and

wait

for

the

intervening

mode

message

between

the

commands,

the

output

(or

listing)

will

be:

READY

delete

•••

READY

free

•••

READY

rename

•••

READY

If

you

enter

the

same commands

without

waiting

for

the

intervening

mode

messages,

your

listing

will

be:

READY

delete

•••

free

•••

rename

•••

READY

There

is

a

drawback

to

entering

commands

without

waiting

for

the

intervening

mode

messages.

If

you

make a

mistake

in

one

of

the

commands,

the

system

sends

you

messages

telling

you

of

your

mistake,

and

then

it

cancels

the

remaining

commands

you

have

entered.

After

you

correct

the

error,

you

have

to

reenter

the

other

commands.

Unless

you

are

sure

that

there

are

no

mistakes

in

your

input.

you

should

wait

for

a

READY

message

before

entering

a new command.

Note:

Some

terminals

"lock"

the

keyboard

after

you

enter

a command,

and

therefore

you

cannot

enter

commands

without

waiting

for

the

intervening

READY

message.

Terminals

which

do

not

normally

lock

the

keyboard

may

occasionally

do

so,

for

example

when

all

buffers

allocated

to

the

terminal

are

used.

See

the

publication

TSO

Terminals

for

information

on

your

terminal.

16

TSO

Terminal

User's

Guide

(Release

21)

PROMPTING

MESSAGES

A

prompting

message

tells

you

that

required

information

is

missing

or

that

information

you

supplied

was

incorrectly

specified.

A

prompting

message

asks

you

to

supply

or

correct

that

information.

For

example,

data-set-name

is

a

required

operand

of

the

CALL

command;

if

you

enter

the

CALL command

without

that

operand

the

system

will

prompt

you

for

the

data-set-name

and

your

listing

will

look

as

follows:

READY

call

ENTER

DATA

SEn'

NAME

-

You

should

respond

by

entering

the

requested

operand,

in

this

case

the

data

set

name,

and

by

pressing

the

RETURN

key

to

enter

it.

For

example

if

the

data

set

name

is

ALPHA.

DATA

you

would

complete

the

prompting

message

as

follows:

ENTER

DATA

SEn'

NAME-

alpha.

data

TO

specify

whether

or

not

you

want

to

receive

prompting

messages,

use

the

PROMPT

or

NOPROMPT

operand

of

the

PROFILE

command.

This

command

is

described

in

the

section,

"Starting

and

Ending

a

Terminal

Session".

sometimes

you

can

request

another

message

that

explains

the

initial

message

more

fully.

If

the

second

message

is

not

enough,

you

can

request

a

further

message

to

give

you

more

detailed

information.

To

request

an

additional

level

of

messaqe:

1.

Type a

question

mark

(?)

in

the

first

position

of

the

line.

2•

Press

the

REn'URN

key.

If

you

enter

a

question

mark,

when

there

are

no

messaqes

to

provide

further

detail,

ydu

receive

the

~ollowing

message:

NO

INFORMATION

AVAILABLE

you

can

stop

a

prompting

sequence

by

entering

the

requested

information

or

by

requesting

an

attention

interruption.

INFORMATIONAL

MESSAGES

An

informational

message

tells

you

about

the

status

of

the

system

and

your

terminal

session.

For

example

l

an

informational

message

can

tell

you

how

much

time

you

have

used.

Informational

messages

do

not

require

a

response.

If

an

informational

message

ends

with

a

plus

sign

(+)

you

can

request

an

additional

message

by

entering

a

question

mark

(?)

after

READY,

as

described

in

"Prompting

Messages."

Informational

messages

have

only

one

second

level

message,

while

prompting

messages

may

have

more

than

one.

What

you

Mu~t

Know.

to

Use

TSO.

17

BROADCAST

MESSAGES

Broadcast

messages

are

messages

of

general

interest

to

users

of

the

system.

Both

the

system

operator

and any

user

of

the

system

can

send

broadcast

messages.

The

system

operator

can

send

messages

to

all

users

of

the

system

or

to

individual

users.

For

example,

he

may

send

the

following

message

to

all

users:

DO

NOT

USE

TERMINALS

# 4, 5

AND

6

ON

6/30.

THEY

ARE

RESERVED

FOR

DEPARTMENT

791'.

You,

or

any

other

user,

can

send

messages

to

other

users

or

to

the

system

operator.

For

example,

you

may

send,

or

receive.

the

following

message:

ACCOUNT

NO.

4672

WILL

BE

CHANGED

TO

4675

STARTING

8/25

A

message

sent

by

another

user

will

show

his

user

identification

so

you

will

know who

sent

you

the

message,.

To

find

out

how

to

send

or

receive

broadcast

m~ssages,

refer

to

the

section

"Starting

and

Ending

a

Terminal

Session".

The Attention Interruption

The

attentiQn

interruption

allows

you

to

interrupt

processing

of

your

job

so

that

you

can

enter

a new

con~and

or

subcommand. The

ability

to

interrupt

processing

prevents

you

from

being

"locked

out"

by

the

system

while

a

long-running

program

executes

or

while

voluminous

output

is

displayed

at

your

terminal.

You

can

use

the

attention

interruption

for

access

to

the

system.

When

you

enter

an

attention

interruption,

the

system

suspends

processing

and

sends

you

a mode

message,.

If

the

system

was

processing

a

command,

you

receive

the

following

mode

message:

READY

you

can

then

enter

a new command.

If

the

system

was

processing

a

subcommand,

the

mode

message

will

be

the

name

of

the

command

to

which

the

subcommand

belongs:

ACCOUNT

EDIT

OPERATOR

OUTPUT

TEST

If

you

do

not

want

to

enter

another

subcommand,

you

should

enter

another

attention

interruption

which

will

cause

the

READY

message

to

appear.

See

the

section

"Displaying

Session

Time

Used"

for

other

uses

of

attention

interruption.

There

are

two

ways

to

cause

an

attention

interruption:

1.

Press

the

attention

(or

substitute

attention)

key:

•

ATTN

key

on

an

IBM

2741

Communications

terminal.

18

TSO

Terminal

User'

s

Guide

(Release

21)

• LINE

RESET

key

on

an

IBM

1052

Printer-Keyboard.

(If

the

"proceed"

light

is

on,

press

the

ALTERNATE

CODING

and

"6"

keys

instead

of

the

LINE

RESET

key.)

•

BREAK

key

on

a

Teletype

terminal.

If

the

attention

key

is

also

the

line-deletion

character

key

and

you

have

entered

any

characters

in

a

line

of

input,

you

must

press

it

twice

to

enter

an

attention

interruption.

(You

need

only

press

it

once

if

you

have

not

entered

any

characters

in

the

line.)

2.

Use a

simulated

attention

key:

If

your

terminal

does

not

have

a

key

that

can

be

used

for

attention

interruption,

you

can

use

the

facilities

of

the

TERMINAL

command

to

simulate

the,

attention

key.

The

TERMINAL

command

lets

you

specify

a

string

of

characters,

such

as

HALT

or

ATTN,

that

when

entered

as

a

line

of

input

is

interpreted

by

the

system

as

a

request

for

an

attention

~nterruption.

The

TERMINAL

command

also

lets

you

request

an

interruption

at

specified

intervals

while

output

is

being

produced.

The

TERMINAL

command

is

described

in

the

section,

"Starting

and

Ending

a

Terminal

Session".

Note:

The

attention

interruption

will

not

halt

the

output

from

system

operator

commands,

such

as

DISPLAY

A.

The

HELP

Command

The

HELP

command

provides

you

with

information

about

all

other

TSO

commands.

At

the

most

general

level

you

can

enter:

help

This

will

cause

you

to

receive

a

list

of

all

commands

and

a

brief

explanation

of

their

functions.

If

you

want

all

the

information

available

on

a

specific

command,

for

example

CALL,

enter

the

HELP

command

and

use

the

other

command's

name

as

an

operand:

help

call

If

you

want

to

know

only

the

function,

syntax,

or

operands,

of

the

CALL

command,

enter

one

of

the

following:

help

call

function

help

call

syntax

help

call

operands

You

can

also

obtain

the

same

information

for

the

subcommands

of

the

ACCOUNT.

EDIT,

OPERATOR.

OUTPUT

and

TEST

commands. To

do

this,

enter

the

command

with

any

required

operands

and

wait

for

the

mode

message.

After

you

have

received

it,

you

can

enter:

help

This

will

cause

you

to

receive

a

list

of

all

subcommands

for

the

command

that

you

specified.

What

you

Must

Know

to

Use

TSO

19

If

you

want

all

the

available

information

on

a

given

subcommand,

enter

the

HELP

command

and

use

the

subcommand

name

as

an

operand.

For

example,

the

following

sequence

could

be

used

to

obtain

all

the

information

available

on

the

DISPLAY

subcommand

of

the

OPERATOR

command:

READY

operator

OPERATOR

help

display

If

you

want

to

know

only

the

function,

syntax,

or

operands

of

the

DISPLAY

subcommand

you

would

enter

one

of

the

following:

help

display

function

help

display

syntax

help

display

operands

There

is

one

restriction

on

using

the

HELP

command:

you

cannot

use

it

before

you

use

the

LOGON

command.

As

explained

in

the

section

"starting

and

Ending

a

Terminal

Session",

LOGON

must

be

the

first

command

used

in

your

session

because

it

identifies

you

as

an

authorized

user

of

the

system.

Note:

Your

installation

can

add

"help"

information

to

the

system

by

following

the

instructions

in

the

publication.

Time

Sharing

Option

Guide

to

Writing

a

Terminal

Monitor

Program

or

a Command

Processor.

20

TOO

Terminal

User's

Guide

(Release

21)

IBM 360 User manual

Popular Desktop manuals by other brands