IBM System/360 Benutzerhandbuch

Systems Reference Library

IBM

System/360

Operating System

System Programmer's

Guide

This

publication

describes:

File

No.

S360-20

Form

C28-

6550-

•

How

maintain

the

data

set

cataloging

facility

the

Operating

System

and

the

volume-table-of-

contents

(VTOC)

direct-access

volume.

•

How

modify

extend

capabilities

the

Operat-

ing

System

the

areas

job

and

job-step

accounting~

processing

magnetic

tape

labels,

and

SVC

routines.

•

How

implement

the

data

set

protection

feature

the

Operating

System.

•

How

write

shift

initiator

program

for

use

when

the

multiprogramming

with

fixed

number

tasks

(MFT)

option

incorporated

the

Operating

System.

•

How

use

the

EXCP

(Execute

Channel

Program)

and

XDAP

(Execute

Direct-Access

Program)

macro-

instructions,

the

Resident

Access-Method

and

BLDL

Table

options,

and

the

tracing

routine.

Also

included

are

descriptions

system

macro-

instructions

used

modifying

the

control

program.

PREFACE

This

publication

consists

self-

contained

chapters,

each

which

provides

information

how

modify

extend

the

capabilities

the

IBM

System/360

Operating

System

control

program.

Although

the

information

one

chapter

sometimes

information

another,

all

chapters

have

been

written

separate

and

complete

units.

Each

chapter

contains

its

own

introductory

section

and

list

pre-

requisite

publications.

This

organization

has

been

used

reduce

cross-referencing

and

facilitate

the

addition

new

chapters.

Third

Edition

(March

1967)

This

publication

revision

Forms

C28-6550-0

and

C28-6550-1

and

obsoletes

the

editions.

This

publication

retains

the

content

the

editions,

amended

Technical

Newsletters

N28-2145,

N28-2157,

N28-2162, N28-2183,

N28-2188,

and

N28-2207,

with

the

following

exceptions:

The

format

and

field

description

the

Data

Set

Control

Blocks,

the

Data

Extent

Block,

and

the

Job

File

Control

Block

are

dele-ted.

The

chapter

Cataloged

Procedures

deleted.

Additions

and

changes

existing

material

that

are

effective

this

edition,

are

indicated

vertical

bar

the

left

margin.

Specifications

contained

time.

Any

such

change

will

Technical

Newsletters.

herein

are

subject

change

from

time

reported

subsequent

revisions

This

publication

was

prepared

for

production

using

IBM

computer

update

the

text

and

control

the

page

and

line

format.

Page

impressions

for

photo-offset

printing

were

obtained

from

IBM

1403

Printer

using

special

chain.

copies

this

and

other

IBM

publications

can

obtained

through

IBM

Branch

Offices.

form

for

readers'

conunents

appears

the

back

this

publication.

may

mailed

directly

IBM.

Address

any

additional

conunents

concerning

this

publication

the

IBM

Corporation,

Progranuning

Systems

Publications,

Department

D58,

Box

390,

Poughkeepsie,

12602

International

Business

Machines

corporation

1966,

1967

CONTENTS

MAINTAINING

THE

CATALOG

AND

THE

VOLUME

TABLE

CONTENTS. 9

Maintaining

the

Catalog

and

the

Volume

Table

contents.

How

Read

Block

From

the

Catalog

• • • • • •

Specifying

the

Name

Index

Level

Data

Set

•

Specifying

the

Name

Generation

Data

Set

••

Specifying

a Name

Using

Alias.

•

Specifying

TTR • • • • • •

How

Build

Index.

• • • • •

How

Build

Generation

Index.

How

Delete

Index

• •

How

Assign

Alias

• • • • •

How

Delete

Alias

• • • • .

How

Connect

Control

Volumes

•

How

Disconnect

Control

Volumes.

How

Catalog

Data

Set.

• • • • •

How

Remove

Data

Set

References

From

the

Catalog

•

How

Recatalog

Data

Set

••

• •

•

• .

••

• • •

· • .

• • •

•

• .

• • • • • .

•

• • •

How

Read

Data

Set

Control

Block

From

the

Volume

Table

Contents.

• • • • •

How

Delete

Data

Set

How

Rename

Data

Set

Appendix

Catalog

Block

Entries.

Control

Entries

• • • • • • •

Pointer

Entries

• • • • • • •

The

Volume

Control

Block

Contents

• • •

Appendix

Device

Code

Designations

ADDING

SVC

ROUTINES

THE

CONTROL

PROGRAM.

Writing

SVC

Routines.

• • • . • • • • .

Characteristics

SVC

Routines

• • • • . •

Programming

conventions

for

SVc'Routines.

• • •

• • • • • •

• • • • • • • • • •

•

• • • • • • •

• • • •

•

• • •

• •

Inserting

SVC

Routines

Into

the

Control

Progra_

• . • • • • •

Specifying

SVC

Routines

•••

• • • • . • • • . .

Inserting

SVC

Routines

During

the

System

Generation

Process

• •

ADDING

ACCOUNTING ROUTINE

THE

CONTROL

PROGRAM.

•

••

Writing

Accounting

Routine

• •

Inserting

Accounting

Routine

Into

the

Control

Program.

• • .

Inserting

Accounting

Routine

Before

System

Generation..

Inserting

Accounting

Routine

After

System

Generation

• • • •

NONSTANDARD

LABEL PROCESSING ROUTINES;

VOLUME

DUAL-DENSITY TAPE DEVICE EDITOR ROUTINES

•.

LABEL

AND

Section

Writing

Nonstandard

Label

Input

Header

Label

Routines

•

Input

Trailer

Label

Routine

•

Output

Header

Label

Routines.

Output

Trailer

Label

Routines

programming

Conventions

• • •

Program

Functions

. • • • • •

Explanations

Logic

Blocks.

Processing

Routines

• •

Inserting

Nonstandard

Label

Routines

Into

the

Control

Program

•

• •

•

Section

Volume

Label

and

Dual-Density

Tape

Device

Editor

Routines

• • •

Programming

Conventions

• • • •

Entry

Conditions

and

General

Logic

Flow

the

Editor

Routines.

• • •

Entry

Conditions

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

General

Logic

Flow

• • • • • • • •

Logic

Block

Explanations.

• • • •

Inserting

Your

Label

Editor

Routines

Into

the

Control

Program

• . • .

Appendix:

IECDSECT,IEFJFCBN,

and

IEFUCBOB

Macro-Instructions

• · • •

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

EXCP

System

and

Problem

Programs.

•

System

Use

EXCP • • •

Programmer

Use

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)

· • .

· . • • • .

•

• • •

• •

· • •

•

• • • • • •

• •

•

• • •

• • • • • •

•

• •

• • •

•

• •

· 77

•

Channel

Program

Execution

• . • • • • • •

Initiation

Channel

Program.

•

Completion

Channel

Program.

• • • • • • •

• • • • • •

Device

End

Errors

. • • • . •

Interruption

Handling

and

Error

Recovery

Error

Recovery

Procedures

for

Procedures.

•

Channel

Programs.

• • • •

• •

Appendages.

• • •

•••••

Defining

Appendages.

• •

Entering

Appendages

Into

SVC

Library

•

Characteristics

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

Volume.

• • • •

• • • . • • • • • •

Restore

Data

Control

Block

• .

Control

Block

Fields

. • • • . •

Input/Output

Block

Fields

. •

Event

Control

Block

Fields

••

• • •

• •

• • • •

• • • • • •

•

• •

•

• • •

• • • • • •

• • .

• • • •

• • •

•

• •

Data

Extent

Block

Flelds

•.•.•

Appendix:

Restore

Macro-Instruction

.•.

RESTORE

Macro-Instruction

• •

Control

Statements

Required

•

RESTORE

Macro-Definition

•••

. . · .

•

EXECUTE

DIRECT ACCESS

PROGRAM

(XDAP) MACRO-INSTRUCTION. . • • .

Execute

Direct

Access

Program

(XDAP)

Macro-Instruction.

. • •

Requirements

for

Execution

Direct-Access

Program

• •

XDAP

Programming

Specifications

. • . • . . • •

.100

•

.100

Macro-Instructions

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

DCB

Define

Data

Control

Block.

. . •

OPEN

Initialize

Data

Control

Block

XDAP

Execute

Direct-Access

Program

•

EOV

End

Volume.

. • • •

d • • • •

.100

• • • • . • • •

.100

. • • • . •

.100

.101

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

Relative

Track

Address

Actual

Address

. ·

.103

Appendages

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

L-

and

E-

Forms

XDAP

Macro-Instruction.

Appendix:

CVT

Macro-Instruction.

. • • .

HOW

Format

the

CVT

Macro-Instruction

Control

Statements

Required

•

CVT

Macro-Definition.

• • • •

USE

THE

TRACING ROUTINE

HOW

USE

THE

TRACING ROUTINE

Table

Entry

Formats

• _

Location

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

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

Use.

• • • . . •

The

Resident

Access

Method

Option

•

•.

116

.117

· . • . •

.117

•

••••.

117

.117

Considerations

for

Use

• • • • •

Creating

Procedure

Library

Lists

••

Example.

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

•

.117

.118

Appendix

Resident

Access

Method

Option

Standard

List

IEAIGGOO

.120

CONSTRUCTING A

DUMMY

WAITR

ROUTINE.

Constructing

Dummy

WAITR

Routine.

•

Functions

the

Dummy

WAITR

Routine.

•

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

Read

Job

File

Control

Block.

• • • • • • •

.130

OPEN

Prepare

the

Data

Control

Block

for

Processing

(S>

••.

130

RDJFCB

Read

Job

File

Control

Block

(S> . • • • • •

.131

ILLUSTRATIONS

FIGURES

Figure

Status

Control

Information

and

Pointers

••••••••

Figure

Format

Combined

Work

and

Control

Block

Area

••••••

Figure

General

Flow

Nonstandard

Label

Processing

Routine

After

Receiving

Control

From

the

OPEN

Routine.

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

Figure

General

Flow

Nonstandard

Label

Processing

Routine

After

Receiving

Control

FrOID

the

Routine

• • • • • • • • . • .

Figure

5 •

GenE~ral

Flow

Nonstandard

Label

Processing

Routine

After

Receiving

Control

Frorr

the

EOV

Routine

• • • • • • • • • •

Figure

Editor

Routine

Entry

Conditions.

. • . .

.•

•

Figure

General

Flow

Editor

Routine

After

Receiving

Control

From

the

OPEN

Routine.

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

Figure

General

Flow

Editor

Routine

After

Receiving

Control

From

the

End-of-Volume

Routine

• • • . • • •

Figure

Data

Control

Block

Format

for

EXCP

(After

OPEN).

••

Figure

10.

Input/Output

Block

Format.

• • • • • . • •

•

••

Figure

11.

Event

Control

Block

After

Posting

Completion

Code.

Figure

12.

Event

Control

Block

After

Posting

Completion

Code

•••

102

Figure

13.

The

XDAP

Channel

Programs.

• • • • • • • • . • •

.103

TABLES

Table

Programming

Conventions

for

SVC

Routines

•••••••.••

MAINTAINING

THE

CATALOG

AND

THE

VOLUME

TABLE

CONTENTS

This

chapter

provides

detailed

informa-

tion

how

maintain

and

modify

the

catalog

and

volume

table

contents.

Before

reading

this

chapter,

you

should

familiar

with

the

information

contained

the

prerequisite

publications

listed

below.

Documentation

the

internal

logic

the

routines

used

maintain

and

modify

the

catalog

and

volume

table

contents

can

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

code

programs

the

assemtler

language.

The

IBM

System/360

operating

Systerr:

Data

~anagement

publication

(Form

C28-6537)

contains

general

description

the

structure

catalog

indexes,

well

brief

discussion

the

volume

tatle

contents

(V'roc).

The

IBM

System/360

Operating

System:

Control

Program

Services

publication

(Form

C28-6541)

contains

explanation

of"

the

notation

conventions

used

describe

the

macro-instructions

contained

this

chap-

ter.

The

IBM

System/360

Operating

System:

System

Control

Blocks

publication

(Form

C28-6628)

contains

format

and

field

de-

scriptions

the

system

control

tlocks

referred

this

chapter.

RECOMMENDED

PUBLICATIONS

The

IBM

System/360

Operating

System:

utilities

publication

(Form

C28-6586)

de-

scribes

how

maintain

and

ITodify

the

catalog

and

the

volume

table

contents

through

the

use

utility

programs.

Maintaining

the

Catalog

and

the

Volume

Table

contents

MAINTAINING

THE

CATALOG

AND

THE

VOLUME

TABLE

CONTENTS

This

chapter

describes

how

maintain

and

modify

the

catalog

and

the

volume

table

contents

through

the

use

macro-instructions.

Most

the

maintenance

and

modification

functions

can

also

performed

using

utility

statements.

The

utility

statements

are

described

the

publication

IBM

System/360

Operating

System:

Utilities.

The

functions

you

can

perform

using

the

macro-instructions

are

described

text,

and

the

formats

the

macro-instructions

are

tabulated

fold-out

sheet

the

tack

this

chapter.

The

chart

the

fold-out

sheet

associates

the

function

described

text

with

the

macro-instructions

needed

perform

the

function.

You

should

keep

the

fold-out

sheet

open

when

reading

the

text.

The

functions

that

are

described

text

are

follows:

•

How

read

block

fron:

the

catalog.

•

How

build

index.

•

How

build

generation

index.

•

How

delete

index.

•

How

assign

alias.

•

How

delete

alias.

•

How

connect

control

volumes.

•

How

disconnect

control

volumes.

•

How

catalog

data

set.

•

How

rerr,ove

data

set

references

from

the

catalog.

•

How

recatalog

data

set.

•

How

read

data

set

control

block

from

the

volume

table

contents.

•

How

delete

data

set.

•

How

rename

data

set.

Accompanying

the

function

descriptions

text

are

coding

examples

and

programm1ng

notes;

exceptional-return

condition

codes

for

the

macro-instructions

are

tabulated

the

back

the

fold-out

sheet.

HOW

READ

BLOCK

FROM

THB

CATALOG

read

either

index

block

indicating

the

volumes

Which

data

set

stored

(volume-list

block),

you

use

the

LOCATE

and

CAMLST

macro-instructions.

There

are

two

ways

specify

the

block

that

you

want

read

into

main

storage:

using

the

nawe

the

index

level

data

set,

using

the

block's

location

relative

the

beginning

the

catalog

(TTR).

Specifying

the

Name

Index

Level

Data

Set

you

specify

index

level

name,

the

first

block

the

named

index

read

int,o

main

storage,

and

exceptional

return

code

set.

Index

tlock

formats

are

contained

Appendix

this

chapter.

you

specify

data

set

name,

256-byte

volume-list

block

read

into

main

storage.

The

block

contains

volume

pointers,

each

which

points

volume

which

~art

the

data

set

stored.

The

first

two

bytes

the

block

contain

the

number

volume

pointers

for

the

data

set.

Each

volume

pointer

12-byte

field

that

contains

4-byte

device

code,

6-byte

volume

serial

number,

and

2-byte

data

set

sequence

number.

(Device

codes

are

contained

Appendix

this

chapter.)

Inhaltsverzeichnis

Andere IBM Desktop Handbücher

IBM

IBM Aptiva 2174 Betriebsanleitung

IBM

IBM NetVista 6644 Bedienungsanleitung

IBM

IBM NetVista A40 Service-Handbuch

IBM

IBM NetVista A20 Bedienungsanleitung

IBM

IBM NetVista A21 Bedienungsanleitung

IBM

IBM PC 300GL Types 6275 Bedienungsanleitung

IBM

IBM IntelliStation M Pro Type 6868 Bedienungsanleitung

IBM

IBM Lotus Sametime 3.0 Bedienungsanleitung

IBM

IBM NetVista Kurzanleitung

IBM

IBM PC 300GL Types 6275 Technisches Dokument

IBM

IBM NetVista A20 Service-Handbuch

IBM

IBM SYSTEM/36 5362 Gebrauchsanweisung

IBM

IBM 8841 - eServer xSeries 236 Bedienungsanleitung

IBM

IBM PC 300 Handbuch

IBM

IBM PC 300PL Types 6862 Bedienungsanleitung

IBM

IBM PS/2 90 XP 486 Betriebsanleitung

IBM

IBM PC 300 Bedienungsanleitung

IBM

IBM Types 2193 Betriebsanleitung

IBM

IBM HC10 - BladeCenter - 7996 Bedienungsanleitung

IBM

IBM IntelliStation A Pro 6217 Bedienungsanleitung

IBM

IBM 620410U - IntelliStation E - Pro 6204 Bedienungsanleitung

IBM

IBM 2179 Bedienungsanleitung

IBM

IBM 3278 Einrichtungshandbuch

IBM

IBM NetVista A21 Bedienungsanleitung

Beliebte Desktop Handbücher anderer Marken

HP m9060n - Pavilion - Elite Technisches Datenblatt

Asus

Asus E210 Series Bedienungsanleitung

Dell

Dell Inspiron 600m Bedienungsanleitung

Dell

Dell Inspiron 3662 Bedienungsanleitung

TotalFlow

TotalFlow uFLO Bedienungsanleitung

HP Presario SV7000 - Desktop PC Bedienungsanleitung

HP ProDesk 400 G5 Handbuch

Logitech

Logitech MK320 Bedienungsanleitung

Dell

Dell XPS 730 H2C Bedienungsanleitung

Sony

Sony Vaio Series Bedienungsanleitung

Sony

Sony VGC-LT32E - Vaio All-in-one Desktop Computer Bedienungsanleitung

Alto

Alto MD 250 Bedienungsanleitung

Lenovo

Lenovo ThinkCentre Edge 72 Handbuch

Lenovo

Lenovo ThinkStation D20 Handbuch

Arbor Technology

Arbor Technology FPC-7800 Series Bedienungsanleitung

Sony

Sony VAIO VGX-TP1 Series Bedienungsanleitung

Asus

Asus Eee Box B204 Bedienungsanleitung

Dell

Dell Optiplex 9010 All In One Bedienungsanleitung