IBM System/360 User guide

Systems Reference Library

IBM

System/360

Operating System

System Programmer's

Guide

This

publication

describes:

File

No.

S360-20

Form

C28-

6550-

2

OS

•

How

to

maintain

the

data

set

cataloging

facility

of

the

Operating

System

and

the

volume-table-of-

contents

(VTOC)

of

a

direct-access

volume.

•

How

to

modify

or

extend

capabilities

of

the

Operat-

ing

System

in

the

areas

of

job

and

job-step

accounting~

processing

of

magnetic

tape

labels,

and

SVC

routines.

•

How

to

implement

the

data

set

protection

feature

of

the

Operating

System.

•

How

to

write

a

shift

initiator

program

for

use

when

the

multiprogramming

with

a

fixed

number

of

tasks

(MFT)

option

is

incorporated

in

the

Operating

System.

•

How

to

use

the

EXCP

(Execute

a

Channel

Program)

and

XDAP

(Execute

a

Direct-Access

Program)

macro-

instructions,

the

Resident

Access-Method

and

BLDL

Table

options,

and

the

tracing

routine.

Also

included

are

descriptions

of

system

macro-

instructions

used

in

modifying

the

control

program.

PREFACE

This

publication

consists

of

self-

contained

chapters,

each

of

which

provides

information

on

how

to

modify

or

extend

the

capabilities

of

the

IBM

System/360

Operating

System

control

program.

Although

the

information

in

one

chapter

is

sometimes

information

in

another,

all

chapters

have

been

written

as

separate

and

complete

units.

Each

chapter

contains

its

own

introductory

section

and

list

of

pre-

requisite

publications.

This

organization

has

been

used

to

reduce

cross-referencing

and

to

facilitate

the

addition

of

new

chapters.

Third

Edition

(March

1967)

This

publication

is

a

revision

of

Forms

C28-6550-0

and

C28-6550-1

and

obsoletes

the

This

publication

retains

the

content

of

the

as

amended

by

Technical

Newsletters

N28-2145,

N28-2157,

N28-2162, N28-2183,

N28-2188,

and

N28-2207,

with

the

following

exceptions:

The

format

and

field

description

of

the

Data

Set

Control

Blocks,

the

Data

Extent

Block,

and

the

Job

File

Control

Block

are

dele-ted.

The

chapter

Cataloged

Procedures

is

deleted.

Additions

and

changes

to

existing

material

that

are

effective

as

of

this

edition,

are

indicated

by

a

vertical

bar

in

the

left

margin.

Specifications

contained

time.

Any

such

change

will

Technical

Newsletters.

herein

are

subject

to

change

from

time

to

be

reported

in

subsequent

revisions

or

This

publication

was

prepared

for

production

using

an

IBM

computer

to

update

the

text

and

to

control

the

page

and

line

format.

Page

impressions

for

photo-offset

printing

were

obtained

from

an

IBM

1403

Printer

using

a

special

print

chain.

copies

of

this

and

other

IBM

publications

can

be

obtained

through

IBM

Branch

Offices.

A

form

for

readers'

conunents

appears

at

the

back

of

this

publication.

It

may

be

mailed

directly

to

IBM.

Address

any

additional

conunents

concerning

this

publication

to

the

IBM

Corporation,

Progranuning

Systems

Publications,

Department

D58,

PO

Box

390,

Poughkeepsie,

N.

Y.

12602

~

International

Business

Machines

corporation

1966,

1967

CONTENTS

MAINTAINING

THE

CATALOG

AND

THE

VOLUME

TABLE

OF

CONTENTS. 9

Maintaining

the

Catalog

and

the

Volume

Table

of

contents.

How

to

Read

a

Block

From

the

Catalog

• • • • • •

Specifying

the

Name

of

an

Index

Level

or

Data

Set

•

Specifying

the

Name

of

a

Generation

Data

Set

••

Specifying

a Name

Using

an

Alias.

•

Specifying

by

TTR • • • • • •

How

to

Build

an

Index.

• • • • •

How

to

Build

a

Generation

Index.

How

to

Delete

an

Index

• •

How

to

Assign

an

Alias

• • • • •

How

to

Delete

an

Alias

• • • • .

How

to

Connect

Control

Volumes

•

How

to

Disconnect

Control

Volumes.

How

to

Catalog

a

Data

Set.

• • • • •

How

to

Remove

Data

Set

References

From

the

Catalog

•

How

to

Recatalog

a

Data

Set

••

• •

10

•

10

• .

••

10

• • •

11

· • .

12

• • •

12

•

13

•

13

• .

14

• .

14

• .

15

• • • • • .

15

•

16

•

17

• • •

17

·

18

How

to

Read

a

Data

Set

Control

Block

From

the

Volume

Table

of

Contents.

• • • • •

How

to

Delete

a

Data

Set

How

to

Rename

a

Data

Set

Appendix

A:

Catalog

Block

Entries.

Control

Entries

• • • • • • •

Pointer

Entries

• • • • • • •

The

Volume

Control

Block

Contents

• • •

Appendix

B:

Device

Code

Designations

~

ADDING

SVC

ROUTINES

TO

THE

CONTROL

PROGRAM.

Writing

SVC

Routines.

• • • . • • • • .

Characteristics

of

SVC

Routines

• • • • . •

Programming

conventions

for

SVc'Routines.

• • •

18

·

19

• • • • • •

20

• • • • • • • • • •

25

•

25

• • • • • • •

26

• • • •

28

•

29

• • •

31

• •

32

• •

32

Inserting

SVC

Routines

Into

the

Control

Progra_

• . • • • • •

37

Specifying

SVC

Routines

•••

• • • • . • • • . .

37

Inserting

SVC

Routines

During

the

System

Generation

Process

• •

37

ADDING

AN

ACCOUNTING ROUTINE

TO

THE

CONTROL

PROGRAM.

•

••

39

Writing

an

Accounting

Routine

• •

40

Inserting

an

Accounting

Routine

Into

the

Control

Program.

• • .

41

Inserting

an

Accounting

Routine

Before

System

Generation..

41

Inserting

an

Accounting

Routine

After

System

Generation

• • • •

41

NONSTANDARD

LABEL PROCESSING ROUTINES;

VOLUME

DUAL-DENSITY TAPE DEVICE EDITOR ROUTINES

•.

LABEL

AND

Section

1:

Writing

Nonstandard

Label

Input

Header

Label

Routines

•

Input

Trailer

Label

Routine

•

Output

Header

Label

Routines.

Output

Trailer

Label

Routines

programming

Conventions

• • •

Program

Functions

. • • • • •

Explanations

of

Logic

Blocks.

Processing

Routines

• •

Inserting

Nonstandard

Label

Routines

Into

the

Control

Program

•

43

•

44

• •

44

• •

45

46

•

52

•

53

Section

2:

Volume

Label

and

Dual-Density

Tape

Device

Editor

Routines

• • •

55

Programming

Conventions

• • • •

55

Entry

Conditions

and

General

Logic

Flow

of

the

Editor

Routines.

• • •

56

Entry

Conditions

• • • • • • • • • • • • . • •

56

General

Logic

Flow

• • • • • • • •

58

Logic

Block

Explanations.

• • • •

61

Inserting

Your

Label

Editor

Routines

Into

the

Control

Program

• . • .

63

Appendix:

IECDSECT,IEFJFCBN,

and

IEFUCBOB

Macro-Instructions

• · • •

65

IECDSECT

Macro-Instruction

• • • • • • • . • • • •

Control

Statements

Required

• • • • •

IECDSECT

Macro-Definition

• • • • • .

IEFUCBOB

Macro-Instruction

• . • • • • •

Control

Statements

Required

• • . • .

IEFUCBOB

Macro-Definition

• •

••

• . • • . • •

IEFJFCBN

Macro-Instruction

. . • . . • •

Control

statements

Required

• . • • • • •

IEFJFCBN

Macro-Definition

• . • • • •

EXECUTE

CHANNEL

PROGRAM

(EXCP) MACRO-INSTRUCTION.

Execute

Channel

Program

(EXCP)

Macro-Instruction.

Use

of

EXCP

in

System

and

Problem

Programs.

•

System

Use

of

EXCP • • •

Programmer

Use

of

EXCP

Requirements

• • • • • •

Channel

Program.

• • • • . • • •

Data

and

Command

Chaining

Control

Blocks

• . • • • • •

Input/Output

Block

(lOB).

Event

Control

Block

(ECB)

Data

Control

Block

(DCB)

••.

Data

Extent

Block

(DEB)

· • .

65

·

65

· . • • • .

65

•

70

• • •

70

• •

70

· • •

71

•

72

• • • • • •

72

• •

74

•

75

• • •

75

• • • • • •

76

•

76

• •

76

• • •

77

•

77

• •

77

· 77

•

77

Channel

Program

Execution

• . • • • • • •

78

Initiation

of

Channel

Program.

•

Completion

of

Channel

Program.

• • • • • • •

78

• • • • • • •

79

• • • • • •

79

Device

End

Errors

. • • • . •

Interruption

Handling

and

Error

Recovery

Error

Recovery

Procedures

for

•

Channel

Programs.

• • • •

79

• •

79

Appendages.

• • •

•••••

Defining

Appendages.

• •

Entering

Appendages

Into

SVC

Library

•

Characteristics

of

Appendages

••.•

Start

Input/Output

(SIO)

Appendage.

Program

Controlled

Interruption

(PCI)

End-of-Extent

Appendage

Channel

End

Appendage

• •

Abnormal

End

Appendage.

•

EXCP

Programming

Specifications

Macro-Instructions

• • • . •

Appendage

DCB

--

Define

Data

Control

Block

for

EXCP

.

OPEN

--

Initialize

Data

Control

Block

.

EXCP

--

Execute

Channel

Program

. •

EOV

--

End

of

Volume.

• • • •

~.

• • • . • • • • • •

CLOSE

--

Restore

Data

Control

Block

• .

Control

Block

Fields

. • • • . •

Input/Output

Block

Fields

. •

Event

Control

Block

Fields

••

• • •

80

• •

80

• • • •

80

·

81

• • • •

82

• • • • • •

82

•

82

·

83

•

83

• •

84

•

84

• • •

84

• • • • • •

90

• • .

91

• • • •

91

• • •

92

•

93

•

93

• •

95

Data

Extent

Block

Flelds

•.•.•

Appendix:

Restore

Macro-Instruction

.•.

RESTORE

Macro-Instruction

• •

Control

Statements

Required

•

RESTORE

Macro-Definition

•••

.

'.

. . · .

96

•

97

•

97

EXECUTE

DIRECT ACCESS

PROGRAM

(XDAP) MACRO-INSTRUCTION. . • • .

98

Execute

Direct

Access

Program

(XDAP)

Macro-Instruction.

. • •

99

Requirements

for

Execution

of

Direct-Access

Program

• •

99

XDAP

Programming

Specifications

. • . • . . • •

.100

•

.100

Macro-Instructions

• • • . • . . . • • . •

DCB

--

Define

Data

Control

Block.

. . •

OPEN

--

Initialize

Data

Control

Block

.

XDAP

--

Execute

Direct-Access

Program

•

EOV

--

End

of

Volume.

. • • •

d • • • •

.100

..

• • • • . • • •

.100

. • • • . •

.100

.101

CLOSE

--

Restore

Data

Control

Block

•

.101

The

XDAP

Control

Block

• • •

Event

Control

Block

(ECB) • •

Input/Output

Block

(lOB)

•••

Direct-Access

Channel

Program

. • • • • . • . •

.102

XDAP

Options

•••.••••••••

·

•.

102

•

•.

103

.103

Conversion

of

Relative

Track

Address

to

Actual

Address

. ·

.103

Appendages

• • • • • • • • • • . • • • • • .

L-

and

E-

Forms

of

XDAP

Macro-Instruction.

Appendix:

CVT

Macro-Instruction.

. • • .

HOW

Format

of

the

CVT

Macro-Instruction

Control

Statements

Required

•

CVT

Macro-Definition.

• • • •

TO

USE

THE

TRACING ROUTINE

HOW

TO

USE

THE

TRACING ROUTINE

Table

Entry

Formats

• _

Location

of

the

Table

• • . •

IMPLEMENTING

DATA

SET PROTECTION

Implementing

Data

Set

Protection

.•

Password

Data

Set

Characteristics

and

Record

Format

•

Protecting

the

Password

Data

Set

••

Creating

Protected

Data

Sets

.•••

Protection

Feature

Operating

Characteristics.

Termination

of

Processing

. • . • • • •

Volume

Switching.

. • •

•••

Data

Set

Concatention

• • • •

SCRATCH

and

RENAME

Functions.

Counter

Maintenance

• • • • .

•

•.

104

.104

•

.105

•

••.

105

•

•.

105

•

.108

•

•.

109

·

•.

109

·

•.

109

•

.111

•

•••

112

•

.112

•

.113

·

.•.

113

·

.•.

113

· • • . .

.114

·

•.

114

.114

· . • • .

.114

THE

RESIDENT

BLDL

TABLE

AND

RESIDENT ACCESS

'METHOD

OPTIONS

•.

115

The

Resident

BLDL

Table

and

Resident

Access

Method

Options

•.

·

.116

The

Resident

BLDL

Table

Option.

• . •

Selecting

Entries

for

the

Resident

BLDL

Table.

. . • •

Table

Size.

• • . • • • • •

Frequency

of

Use.

• • • . . •

The

Resident

Access

Method

Option

•

•.

116

.117

· . • . •

.117

•

••••.

117

.117

Considerations

for

Use

• • • • •

Creating

Procedure

Library

Lists

••

Example.

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

•

.117

.118

Appendix

A:

Resident

Access

Method

Option

-

Standard

List

IEAIGGOO

.120

CONSTRUCTING A

DUMMY

WAITR

ROUTINE.

Constructing

a

Dummy

WAITR

Routine.

•

Functions

of

the

Dummy

WAITR

Routine.

•

A

Coding

Example

• • • • • •

Job

Control

Language

Statements

Programming

Considerations.

SYSTEM

MACRO-INSTRUCTIONS

••

Locate

Device

Characteristics

(DEVTYPE)

Macro-Instruction

Device

Characteristics

Information.

• • • • • •

Output

for

Each

Device

Type

• • • • • • • •

Exceptional

Returns

• • • • • • • •

.121

•

.122

••••

122

••••

123

•

.124

.125

•

.126

•

.126

• •

.128

.129

How

to

Read

a

Job

File

Control

Block.

• • • • • • •

.130

OPEN

--

Prepare

the

Data

Control

Block

for

Processing

(S>

••.

130

RDJFCB

--

Read

a

Job

File

Control

Block

(S> . • • • • •

.131

ILLUSTRATIONS

FIGURES

Figure

1.

Status

of

Control

Information

and

Pointers

••••••••

47

Figure

2.

Format

of

Combined

Work

and

Control

Block

Area

••••••

48

Figure

3.

General

Flow

of

a

Nonstandard

Label

Processing

Routine

After

Receiving

Control

From

the

OPEN

Routine.

• • • • . • • • • • • 49

Figure

4.

General

Flow

of

a

Nonstandard

Label

Processing

Routine

After

Receiving

Control

FrOID

the

CLOSE

Routine

• • • • • • • • . • .

50

Figure

5 •

GenE~ral

Flow

of

a

Nonstandard

Label

Processing

Routine

After

Receiving

Control

Frorr

the

EOV

Routine

• • • • • • • • • •

51

Figure

6.

Editor

Routine

Entry

Conditions.

. • . .

.•

•

57

Figure

7.

General

Flow

of

an

Editor

Routine

After

Receiving

Control

From

the

OPEN

Routine.

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

59

Figure

8.

General

Flow

of

an

Editor

Routine

After

Receiving

Control

From

the

End-of-Volume

Routine

• • • . • • •

60

Figure

9.

Data

Control

Block

Format

for

EXCP

(After

OPEN).

••

86

Figure

10.

Input/Output

Block

Format.

• • • • • . • •

..

•

••

93

Figure

11.

Event

Control

Block

After

Posting

of

Completion

Code.

95

Figure

12.

Event

Control

Block

After

Posting

of

Completion

Code

•••

102

Figure

13.

The

XDAP

Channel

Programs.

• • • • • • • • . • •

.103

TABLES

Table

1.

Programming

Conventions

for

SVC

Routines

•••••••.••

33

MAINTAINING

THE

CATALOG

AND

THE

VOLUME

TABLE

OF

CONTENTS

This

chapter

provides

detailed

informa-

tion

on

how

to

maintain

and

modify

the

catalog

and

volume

table

of

contents.

Before

reading

this

chapter,

you

should

be

familiar

with

the

information

contained

in

the

prerequisite

publications

listed

below.

Documentation

of

the

internal

logic

of

the

routines

used

to

maintain

and

modify

the

catalog

and

volume

table

of

contents

can

be

obtained

through

your

IBM

Branch

Office.

PREREQUISITE PUBLICATIONS

The

IBM

System/360

operating

System:

Assembler

Language

publication

(Form

C28-6514)

contains

the

information

neces-

sary

to

code

programs

in

the

assemtler

language.

The

IBM

System/360

operating

Systerr:

Data

~anagement

publication

(Form

C28-6537)

contains

a

general

description

of

the

structure

of

catalog

indexes,

as

well

as

a

brief

discussion

of

the

volume

tatle

of

contents

(V'roc).

The

IBM

System/360

Operating

System:

Control

Program

Services

publication

(Form

C28-6541)

contains

an

explanation

of"

the

notation

conventions

used

to

describe

the

macro-instructions

contained

in

this

chap-

ter.

The

IBM

System/360

Operating

System:

System

Control

Blocks

publication

(Form

C28-6628)

contains

format

and

field

de-

scriptions

of

the

system

control

tlocks

referred

to

in

this

chapter.

RECOMMENDED

PUBLICATIONS

The

IBM

System/360

Operating

System:

utilities

publication

(Form

C28-6586)

de-

scribes

how

to

maintain

and

ITodify

the

catalog

and

the

volume

table

of

contents

through

the

use

of

utility

programs.

Maintaining

the

Catalog

and

the

Volume

Table

of

contents

9

MAINTAINING

THE

CATALOG

AND

THE

VOLUME

TABLE

OF

CONTENTS

This

chapter

describes

how

to

maintain

and

modify

the

catalog

and

the

volume

table

of

contents

through

the

use

of

macro-instructions.

Most

of

the

maintenance

and

modification

functions

can

also

be

performed

using

utility

statements.

The

utility

statements

are

described

in

the

publication

IBM

System/360

Operating

System:

Utilities.

The

functions

you

can

perform

using

the

macro-instructions

are

described

in

text,

and

the

formats

of

the

macro-instructions

are

tabulated

on

a

fold-out

sheet

at

the

tack

of

this

chapter.

The

chart

on

the

fold-out

sheet

associates

the

function

described

in

text

with

the

macro-instructions

needed

to

perform

the

function.

You

should

keep

the

fold-out

sheet

open

when

reading

the

text.

The

functions

that

are

described

in

text

are

as

follows:

•

How

to

read

a

block

fron:

the

catalog.

•

How

to

build

an

index.

•

How

to

build

a

generation

index.

•

How

to

delete

an

index.

•

How

to

assign

an

alias.

•

How

to

delete

an

alias.

•

How

to

connect

control

volumes.

•

How

to

disconnect

control

volumes.

•

How

to

catalog

a

data

set.

•

How

to

rerr,ove

data

set

references

from

the

catalog.

•

How

to

recatalog

a

data

set.

•

How

to

read

a

data

set

control

block

from

the

volume

table

of

contents.

•

How

to

delete

a

data

set.

•

How

to

rename

a

data

set.

Accompanying

the

function

descriptions

in

text

are

coding

examples

and

programm1ng

notes;

exceptional-return

condition

codes

for

the

macro-instructions

are

tabulated

on

the

back

of

the

fold-out

sheet.

HOW

TO

READ

A

BLOCK

FROM

THB

CATALOG

To

read

either

an

index

block

or

a

block

indicating

the

volumes

on

Which

a

data

set

is

stored

(volume-list

block),

you

use

the

LOCATE

and

CAMLST

macro-instructions.

There

are

two

ways

to

specify

the

block

that

you

want

read

into

main

storage:

by

using

the

nawe

of

the

index

level

or

data

set,

or

by

using

the

block's

location

relative

to

the

beginning

of

the

catalog

(TTR).

Specifying

the

Name

of

an

Index

Level

or

Data

Set

If

you

specify

an

index

level

name,

the

first

block

of

the

named

index

is

read

int,o

main

storage,

and

an

exceptional

return

code

is

set.

Index

tlock

formats

are

contained

in

Appendix

A

of

this

chapter.

If

you

specify

a

data

set

name,

a

256-byte

volume-list

block

is

read

into

main

storage.

The

block

contains

up

to

20

volume

pointers,

each

of

which

points

to

a

volume

on

which

~art

of

the

data

set

is

stored.

The

first

two

bytes

of

the

block

contain

the

number

of

volume

pointers

for

the

data

set.

Each

volume

pointer

is

a

12-byte

field

that

contains

a

4-byte

device

code,

a

6-byte

volume

serial

number,

and

a

2-byte

data

set

sequence

number.

(Device

codes

are

contained

in

Appendix

B

of

this

chapter.)

10

IBM System/360 User guide

Popular Desktop manuals by other brands