IBM 3480 User Reference

Page 1
Page 2
-_
----
::
=-=
.:.
~
-.--'-
.. -
==
---
.:
':'
:.
IBM User's
GC35-0099-3
3480
Reference
Magnetic
Tape
Subsystem
Storage Subsystem Library
Page 3
Fourth
This
is a
Edition
revision
(November
of
and
makes
1987)
obsolete GC35-0099-2.
Changes
or
additions
by a vertical
References services do
all
countries licensed imply
program
that
in
not
only
functionally
Publications Requests
for
representative
A form for
reader's publication. addressed Department distribute
appropriate
©
Copyright
to
61C, Tucson, Arizona, U.S.A. 85744. IBM
whatever
without
1986, 1987
to
line
to
the
left
this
publication
imply
that
in
which
IBM's
equivalent
are
IBM
or
IBM operates.
in
this
licensed
program
not
stocked
publications
to
the
IBM
comments is provided
If
the
form
IBM
Corporation,
information
incurring
International
the
text
or
of
the
to
IBM products, programs,
IBM
intends
publication
program
may
at
the
should
branch
has
been
General
you
any
Business
illustrations
will
change.
to
make
these
Any
reference
is
not
be
intended
may
used
be used.
instead.
to
address given below.
be
made
to
your
office
serving
at
the
your
back
removed, comments
Products
supply
obligation
Machines
Division,
in
any
way
to
you.
Corporation
be
indicated
or
available
to
an
IBM
state
Any
IBM
locality.
of
this
may
be
may
it
believes
or
use
1984,
in
or
Page 4
Preface
Organization
This
manual
Magnetic commands, Publications."
This
Tape
or
manual
"Chapter Tape
Subsystem
"Chapter standard
"Chapter that
are
needed
changes,
"Chapter NOTE, POINT, macro
gives
programmers
Subsystem.
functions,
contains
1.
2.
data
3.
and
4.
the
Introduction,"
and
Tape
Characteristics,"
set
label
Modifying
to
modifications
Controlling
and
For
consult
following:
the
software
Existing
use
the
3480
the
DEVTYPE
information
complete
the
other
gives
an
requirements
Code," describes
including
to
JFCB
I/O Device," describes
macros,
about
information
manuals
overview
describes
DCB
as
well as
using
ofthe
the
parameters,
about
listed
for
the
format
the
the
the
the
IBM
3480
specific macros,
in
"Related
IBM
3480
Magnetic
3480
of
an
IBM
changes
changes
new
to
JCL
SYNCDEV
code
to
the
"Chapter that
"Chapter changes
"Chapter to
use
information
"Chapter restrictions
"Appendix
control
"Appendix B.
completion taking a checkpoint.
5.
allows messages
6.
for
7.
the
3480 for
8.
A.
block
codes for
Displaying
Managing
DFHSM
Recording
Restrictions
to
DFSORT
Data
fields
Checkpoint/Restart
Messages," describes
to
be
displayed
and
when
using
Error
the
IMS/VS log
to
when
Control
the
IBM
to
the
Controlling
the
or
Statistical
Using
using
Block Symbolic
3480
Data
3480
tape
and
Sorting
the
3480
Codes,"
Magnetic
the
new
MSGDISP
operator
Sets,"
Information,"
error
Applications,"
Field
shows
Tape
describes
and
statistical
Names,"
the
return
Subsystem
macro
the
describes
describes
describes
and
when
Preface 111
how
the
the
Page 5
Prerequisite
Knowledge
To
use
this
book
management
procedures.
effectively,
you
should
already
understand
data
Related
IBM 3480
Publications
You below.
Magnetic
Tape
IBM
IBM
GC35-0098
IBM
Status
IBM
Care
IBM
for System/360, System/370,
GC22-7064
may
want
to
reference
information
Subsystem
3480
Magnetic Tape Subsystem Introduction, GA32-0041
3480
Magnetic Tape Subsystem Planning
3480
Magnetic Tape Subsystem Reference: Channel Commands,
and
Sense Bytes,
3480
Magnetic Tape Subsystem Operator's Guide, GA32-0066
and
Handling
Input/Output Equipment: Installation
of
the
and
Error Recovery Procedures, GA32-0042
IBM
Magnetic Tape Cartridge, GA32-0047
and
4300
presented
Manual-Physical
Processors,
in
the
publications
and
Migration Guide,
TNL
GN22-2317
listed
Planning
to
MVS/Extended
Tape and Cartridge Requirements for the
GA32-0048.
Architecture
MVS/Extended
MVS/Extended
MVS/Extended
MVS/Extended Reference,
MVS/Extended
Administration,
MVS/Extended
Volumes 1
MVS/Extended
Architecture Checkpoint/Restart User's Guide, GC26-4139
Architecture System-Data Administration, GC26-4149
Architecture Data Administration Guide, GC26-4140
Architecture Data Administration: Macro Instruction
GC26-4141
Architecture Magnetic Tape Labels
GC26-4145
Architecture Message Library: System Messages,
and
2,
GC28-1376
Architecture Message Library: System Codes, GC28-1157
and
IBM
GC28-1377
3480
Tape Drives,
and
File Structure
IV
IBM 3480
Magnetic
Tape Subsystem
User's
Reference
Page 6
MVS/Extended MVS/System Routing
MVS/Extended
MVS/Extended
and
Information,
MVS/Extended JES2,
5665-291, GC28-1143
MVS/Extended
LIC
MVS/System
Architecture,
Product-JES2
Descriptor Codes, GC28-1194
Architecture Installation: System Generation, GC26-4148
Architecture Data Facility Product: General
GC26-4142
Architecture Conversion Notebook:
PROG 5740-XC6;
Architecture,
Product-JES2
Job Control Language, GC28-1148
MVS/Extended
Architecture
5740-XC6, Initialization
MVS/Extended MVS/System Supervisor
Architecture,
Product Version
Services and Macro Instructions, GC28-1154
MVS/System
Version 2,
MVS/System
MVS/System
Version
MVS/System
and
Tuning, GC28-1149
MVS/System
2-JES2,
Product-JES3
LIC
PROG 5665-291, 5740-XC6,
MVS/System
Product
JES3,
Product-JES3
2,
LIC
PROG 5665-291, 5740-XC6,
Product Version 2 5665-291
Product Version
LIC
PROG 5665-291, 5740-XC6,
Version
LIC
PROG
Version
2-JES3
2,
Product
2,
MVS/Extended MVS/System System
GC28-1151
MVS/Extended
Macros and Facilities,
Architecture
Product-JES2
Architecture,
Modifications, GC28-1152
MVS/Extended MVS/System
Architecture,
Product-JES2
Management Facility, GC28-1153
MVS/Extended 5740-XC6 Operations:
MVS/Extended
PROG
MVS/Extended LIC
MVS/Extended
5740-XC6, Initialization
PROG
Version 2,
Architecture,
JES2
Architecture,
Architecture,
5665-291, Operations:
Architecture System,
LIC
PROG 5665-291, Initialization
MVS/System
Version 2,
Volumes 1 and
LIC
PROG
MVS/System
Version
MVS/System
Product-JES3
LIC
PROG 5665-291, 5740-XC6,
2,
GC28-1150
5665-291, 5740-XC6, System
Product-JES3
2,
5665-291, 5740-XC6, System
Product-JES2
Commands, SC23-0064
MVS/System
and
Tuning, SC23-0065
MVS/System
JES3
Product
Product-JES3
Commands, SC23-0063
MVS/System
and
JES2
Version
and
Version
Version
Version 2,
Version
2,
2,
2,
2,
Product-JES3
Tuning, SC23-0059
LIC
MVS/Extended Version 2,
Architecture Debugging,
MVS/System
Product-JES2
MVS/System
Product-JES3
Version 2,5665-291, 5740-XC6,
Preface
V
Page 7
MVS/370
Handbook,
LC28-1l67
MVS/370
MVS/370
GC26-4063
MVS/370 Instructions,
Volumes 1 through
and
LC28-1l68.
5, LC28-1l64,1 LC28-1l65, LC28-1l66,
Data Facility Product, 5665-295, Checkpoint/Restart, GC26-4054
Data Facility Product, 5665-295, System Generation Reference,
Data Facility Product, 5665-295, Data Management Macro
GC26-4057
MVS/370 Data Management Services, Data Facility Product
GC26-4058
MVS/370
MVS/370
MVS/370
GC28-1374
OS/VS
OS/VS
Data Facility Product, 5665-295, Data Management, GC26-4056
Magnetic Tape Labels
Message Library: System Messages,
and
GC28-1375
and
File Structure, 5665-295, GC26-4064
Volumes
1
and
Message Library: System Codes, GC38-1008
Message Library:
VS2
Routing
and
Descriptor Codes, GC38·1102
MVS/370 Installation: System Generation, GC26-4166
MVS
JCL
MVS/System
Product-JES3
MVS/370
OS/VS2 MVS/System
3, GC28-1047, GC28-1048,
Data Facility Product: General Information, GC26-4160
System Programming Library: Debugging Handbook,
Products,
Release 3.1,
Product-JES2
LIC
PROG 5740-XYS,
LIC
PROG
and
5740-XYN,
GC28-1049
Release 3.3,
-XYN,
-XYS,
MVS/System
GC28-1300
Volumes 1 through
5665-295,
2,
VI
IBM 3480
Magnetic
OS/
OS/
VS2
VS2
Guide, GC28-0681
OS/VS2
OS/VS2 Facilities,
All five volumes
Tape
Subsystem
MVS
Supervisor Services
MVS
System Programming Library: Initialization
MVS
System Programming Library: Supervisor, GC28-0628
MVS
System Programming Library: System Management
GC28-1030.
may
be
ordered
User's
Reference
and
under
Macro Instructions, GC28-0683
one
order
number,
LBOF-I015.
and
Tuning
Page 8
VMjSP
and
VMjHPO
VSEjSP
Other
Related
Virtual Machine/System Product Planning Guide
SC19-6201
Virtual Machine/System Product High Performance Option Planning Guide
IBM Support Extensions, Version
and
Reference, SC19-6223.
Virtual Storage Extended/System Package Hardware
2 Release
1,
SC33-6184.
and
Reference,
Publications
OS/VS
SC33-4035
Data Facility Hierarchical Storage Manager: Version 2 Release 3.0 Installation
Data Facility Hierarchical Storage Manager: Version 2 Release 3.0 System
Data Facility Hierarchical Storage Manager: Version 2 Release 3.0 System
Sort/Merge Programmer's Guide Program Product 5740-SM1,
and
Customization Guide, SH35-0084
Programmer's Guide, SH35-0085
Programmer's Reference Guide, SH35-0083
and
Software
OS/VS2 Program,
GC28-1027
Environmental Recording Editing and Printing (EREP) Program,
GC28-1178
Data Facility/Data Set Services, Reference, SC26-3949
IBM for
IBM
MVS
and
Stand-Alone Versions: Input/Output Configuration
LIC
PROG 5740-XYN,
Input/Output Equipment: Installation
System/360, System/370, and
System/370 Installation Manual: Physical Planning, GC22-7004.
-XYS,
LIC
4300
User's Guide and Reference,
PROG 5740-UT3, User's Guide
Manual-Physical
Processors, GC22-7064
Planning
and
Preface
Vll
Page 9
Page 10
Contents
Chapter IBM Conventions
Chapter Changed
Chapter Selecting
DCB
Coding
Constructing a Data Specifying Modifying
Setting
Example MVS Block
User
EXCP
User
Performance
IEBGENER
Chapter Controlling
How Retrieving Performing
Comparing
Examples
NOTE-Provide
Completion Codes from NOTE
POINT
Completion Codes from Controlling
Example SYNCDEV-Synchronize SYNCDEV-List SYNCDEV-Execute Completion Codes from SYNCDEV
Obtaining
1.
3480
2. Format
3.
Parameters
Search
Exits
Routines
Programs
4.
the
-Moving
BSAM)
The
IBM
3480
Magnetic
Magnetic
Used
Tape
Modifying
Data
the
JCL
the
the
................................................
of
Count
Options for
Controlling
High-Speed
Physical
the
of
...............................................
Data
of
I/O Device
Tape
Subsystem
...........................................
Characteristics
of
IBM
Standard
Existing
Set
Options
..........................................
Block Size
Options
Job
File
Header
How
..............................................
Storage
the
Conventional
How
How
Label
to
Checking
..........................................
..........................................
Block
BLOCKID
High-Speed
to
Relative
Tape
Synchronization
to
Form
Characteristics
....................................
and
Logical Record
Control
......................................
Control
Block
Code
OPEN(J)
..................................
IEBGENER
Requirements
the
110
Search
Identifier
..................................
Search
Search
Code NOTE
Position
to
a Relative Block
POINT
Code SYNCDEV
Device
....................................
Form
Tape
Subsystem
Operating
..........................
Data
Set
Code
in
Block
Block (JFCB)
(NOTE/POINT)
.................................
...........................
ID
in
the
...........................
...........................
...........................
Device
Works
...........................
and
High-Speed
and
POINT
(BPAM
..............................
..............................
(SYNCDEV)
.............................
...........................
(DEVTYPE)
Mode
Label
2 (HDR2/EOV2/EOF2) 5
MVS
Systems
Length
.....................
JFCB
..................•..
.........................
for High·Speed
...................
......................
...................
and
BSAM)
Position
...................
.................
...........
...............
Operands
Search
............
(BP
AM
..........
........
..........
and
1 2 3
5
7 7 7 8 8 9 9
10 11 12 13 13 14 15 15
17 17 17 17 18 19 20 22 23
23 25 25 27 28 29 30 31 32
Contents
IX
Page 11
Chapter Displaying a Message from
Example MSGDISP-Displaying a Ready Message ,MSGDISP-Displaying a Ready Message
5.
Displaying
of
How
Messages
any
to
Code MSGDISP RDY
(MSGDISP)
User
Program
List
•••.•...••.•••.•
(MSGDISP RDY)
......................
......................
Form
MSGDISP-Displaying a Ready Message Execute Form
Displaying a Message from Authorized Programs
MSGDISP-Displaying a Mount MSGDISP-Displaying MSGDISP-Displaying MSGDISP-Resetting MSGDISP-Providing Return
Codes from MSGDISP
Modifying MSGDISP for
a Verify Message a Demount Message
the
Message Display
the
Other
Message
Full
Range
of
Display Options
...............................
Languages
.......................
..................
......................
......................
....................
.....................
...........
...........
..........
......
l...
33 33
34 35 36 37 38 39 42 46 50 53 57 58
Chapter Specifying Esoteric Recycling Tapes
Establishing
(SETSYS)
Specifying
Specifying
Specifying Esoteric Tape
6.
Managing
or
Changing
...............................................
the
(DENSITY)
the
(UNITNAME)
and
Controlling
Unit
Names
...............................
...........................................
the
Values of DFHSM Control
Tape Density When Allocating
............................................
Type
of
Unit
for
Mounting a Scratch
..........................................
Unit
Name
(USERUNITTABLEI NOUSERUNITTABLE)
Adding
Chapter Using Using Using IMS/VS Logging
Chapter SORTWKnn SORTOUT
or
Changing Specifying Specifying
7. EREP Error
8.
DD
the
Volumes Managed by DFHSM (ADDVOL)
the
Type
of
Device (UNIT)
the
Tape Density (DENSITY)
Recording
Reports
Error
or
Statistical
........................................
Recovery Procedures (ERP)
......................................
Restrictions
DD
statement
Statement
to
Using
Sorting
...................................
....................................
Data
Sets
Scratch
to
DFHSM
..................
........................
......................
Information
........................
Applications
.•....••.•••.
Parameters
Tapes
Tape
.......•.
(DFSORT)
61 61 61
62
62
62
63 64 64 65
67 67 67 67
69 69 69
x IBM 3480
Magnetic
Appendix Magnetic Tape Interface
Appendix Return
A.
Data
B.
Programming
Code from
Control
.....................................
the
CHKPT Macro
Block
ABEND Completion Codes Issued by ABEND
Glossary
Index
Tape Subsystem
Return
Codes
......................................
.•..•.••.•.•••....•.........•..............•
...............................................
User's
Reference
Symbolic
Messages
Instruction
Checkpoint/Restart
and
Field
Codes
for
Names
•.•..••.•..••
the
3480 for
........
........
the
3480
..
71 72
73 73 73
73
75
79
Page 12
Figures
1.
JFCB
Layout
2.
Sample Message Display
3.
Description
of
.........................................
Language
CSECT IGXMSGOI
Modification
.........................
..............
11 58 59
Figures
Xl
Page 13
Page 14
Summary
of
Amendments
IBM
Release
Release
Release
3480
Magnetic
GC35-0099-3,
GC35-0099-2,
GC35-0099-1,
Tape
July
This edition.
January
This Model
There previous
July
This information
1987
edition
edition
Bll
are
edition.
1986
edition
Subsystem
includes
1987
adds
information
Tape
Drive.
also
miscellaneous
incorporates
on
the
changes
Technical
Automatic
to
correct
on
the
changes
Newsletter
Cartridge
User's
errors
3480 Model
to
correct
Loader
Reference
or
omissions
All
Control
errors
number
Feature.
or
omissions
GN35-0319
in
Unit
the
previous
and
in
the
and
adds
Summary
of
Amendments
XUl
Page 15
Page 16
Chapter
1.
The
IBM
The
IBM 3480 Model tape
unit
Communications allow Cartridge premounted cartridges, channel channels.
The
subsystem second. linear
The
control between delays start data
to
is
ready while reading, as
to
3480
All
or
contains
mutual
Loader
can
attachment
This
data
recording
the
in
the
and
stop
be
written
to
accept
the
data
data
be
available
Magnetic
Magnetic
A22,
and
two
Coupler
control
feature,
tape
cartridges
be
added
features,
can
read
high
data
unit
contains
tape
drive
operations
actions
are
them.
transfers
is
transferred
when
Tape
Subsystem
up
to
four
magnetic
feature, two
of
eight
tape
which
and
to
any
each
and
write
rate
is achieved by
density
of transferred
of
a buffer
and
the
of
the
individual
The
channel
from
the
from
the
controlling
Tape
3480
Tape
tape
drives.
control
units
allows
the
or
about
controlling
processor
the
manual
all
of
control
data
38000
that
drives.
to
the
is
control
tape
both
at
stores
processor
Subsystem
consists
(16
the
unit
rates
recording
processor.
that
Because control then
unit
drive
of
Units,
With a Dual
units
drives).
the
automatic loading tape
units.
can
up
to
bytes
per
the
data
are
normally
unit
released
to
the
to
the
requests
a 3480
Model
can
be
The
Automatic
of
single
With
connect
three
18
data
inch.
being
The
of
the
before
to
do
tape
control
Control
Bll
or
B22.
Control
connected
loading
tape
additional
with
megabytes
tracks
transferred
buffer
caused
buffer,
the
tape
other
drive.
During
unit
it.
Unit,
Each
Unit
to
of
up
to
four
per
at
a
reduces
by
the
blocks
drive
work
buffer
of
so
Because soon provides a tape-write-immediate mode Tape-write-immediate mode forces tape mode reduces
The search, disconnected reading the
Each messages tape messages
the
as
the
before
should
subsystem
3480
subsystem
you
and
channel
tape
on
drive.
to
3480 subsystem
write
data
it
indicates
be
used
only
performance.
provides a high-speed
can
search
from
the
writing.
to
signal
drive
this
In
an
the
When
that
has
a message display
display
MVS system,
drive
message display.
indicates
has
been
transferred
the
that
the
action
when
the
data
for specific blocks
channel)
can
Chapter
at
much
the
block is found,
it
is
ready
keep
the
the
1.
program
The
that
the
writing
to
the
of
writing
subsystem
is complete. Tape-write-immediate
is
critical
search on
the
higher
for
the
on
operator
IBM 3480
next
its
operator's
can
speed
the
informed
action
buffer,
data
to
to
write
because
function.
tape
(with than
subsystem
command.
panel.
write
any
Magnetic
is
the
subsystem
tape.
the
data
this
With
the
is
used
reconnects
of
the
necessary
Tape
complete
on
mode
high-speed
subsystem
for
The
status
Subsystem
the
of
as
also
to
the
1
Page 17
The
tape
drives This assignment assignment for assignment, see
earlier
Migration Guide.
can
be assigned
ability
IBM
3480
to
specific
replaces
tape
drives.
the
mechanical
For
more
Magnetic Tape Subsystem
channels
switching
information
by
program action.
used for
on
channel
Planning
and
channel
IBM 3480
Magnetic
In
MVS systems, mode, controls function generated a
3480
any
other
and
the catalog. This allows you full function catalog that
system. VM
provided
When
Tape write-immediate mode (OPT
Buffered
the
features
Full
Tape
or
it
can
the
mode
at
in
full function mode, you
3480s
3420C
entry
in
3480
are
error
Subsystem
the
3480 subsystem
operate
mode
and
the
on
are
3480
appropriate
MVS compatibility mode. i
is
supported:
recovery (ERP)
read
in
in
which
the
3480
same
time
the
system. However,
synonymous,
to
without
and
VSE/SP
operating
and
write mode
Operating
can
operate
3420
compatibility mode. System
the
3480 operates.
in
3420
compatibility
on
the
same
cannot
and
both
share
catalogs among systems
changing
to
the
in
catalog
3480
device type
support
compatibility mode,
support
for
CD = W)
Both
system.
generate
catalog
entries
entries.
the
3480
Mode
as a 3480
compatibility mode for
entries
can
that
is
the
in
full function
generation
the
3480
in
mode
exist
Each
cannot
If
you
are
for
both
in
the
or
migrate
system uses
was
generated
comparable
following
full
both
generating
the
same
on
to
that
3480
3480
to
a
the
be
2 IBM
3480
Magnetic
Hardware-initiated message display.
When
High-speed
Program-initiated message display (MSGDISP macro)
Processor assignment
Tape Subsystem
the
3480
is
operating
features
Dynamic device
User-requested
Automatic
For compatibility mode, see and
are
more
IBM
not
supported:
search
reconfiguration
synchronization
cartridge
information
3480
Magnetic Tape Subsystem Planning
User's
on
Reference
in
compatibility mode,
(block locate)
loader
IBM
the
functions
3480
in
System mode.
Magnetic Tape Subsystem Introduction
(DDR)
of
the
3480
the
following
in
full function
and
Migration Guide.
3480
or
Page 18
Conventions
Used
The
following used for macro
list
the
3480,
statement.
of
symbols
but
you
are
should
used
never
to
type
define
the
the
format
symbols
in
of
the
the
actual
macros
Braces
items appears
Brackets
Items
otherwise stated, selected.
An ellipsis ( ... ) indicates
preceding
Other
must be
Boldface must be
({
})
indicate a required
within
([
])
indicate
separated
punctuation
entered
entered
by a
no
the
ellipsis
as
type indicates
exactly
field
or
parameter.
braces, you
an
optional field
vertical
more
than
that
are
allowed.
(parentheses, commas, slashes, spaces,
shown.
the as
bar
one
multiple
exact
shown.
must
choose
or
(I)
represent
of
the
entries
characters
one
parameter.
alternative
alternative
of
to
Italic type indicates fields to be supplied by you.
Underscored type indicates a default option. omitted,
the
default is assumed.
If
When
of
the
be entered.
the
a group
the
items.
items. Unless
items
type immediately
and
parameter
can
be
so forth)
Such
is
of
items
Chapter
1. The IBM 3480
Magnetic
Tape Subsystem 3
Page 19
Page 20
Chapter
2.
Tape Characteristics
The 3480 subsystem uses compact cartridges containing i/2-inch (l2.65-mm) chromium dioxide tape. The cartridge
(731-meter) reel Only a single density reading and writing.
of
magnetic tape, but it stores up to 20% more data than the reel.
is
about 25% the size
is
available for tape cartridges and
of
is
used by the system for
Changed Format for the IBM Standard Data-Set Label 2 (HDR2/EOF2/EOV2)
a standard 2400-foot
The following fields contain changed
Field
6,
Tape Density
• Contents: A code indicates the recording density equivalent to the
Use code = 0 for the 3480. Processing: The field
creates labels, the information for this field
Field 13, Reserved
• Contents:
reserved for possible future use. reserved, byte the last four digits subsystem, bytes four digits device address (for
The serial numbers in the header and trailer labels may
data set data set
• Processing: A unique number identifying the recording unit tape during open processing, converted into hexadecimal, and inserted into the UCBCTD field in the
is is
(1
byte)
DEN
parameter value on the
is
neither used
(8
bytes)
For
2400 and 3410 tape drives (for MVSj370 only), the entire field
43
contains the model number, and bytes 44 through
of
the serial number
40
through
of
the serial number
MVSj370)
opened for update
being created.
UCB tape extension.
data
for the IBM standard
of
the tape. The code
data
definition (DD) statement.
nor
verified. When
is
obtained from the JFCB.
For
3420 drives, bytes 40 through
of
the creating tape unit.
42
are reserved, bytes of
the control unit, and byte
or
the device number (for MVSjXA).
or
if
DDR
is
used to swap tape units while the
43
through
not
file
data
management
46
47
be
the same
is
read from the
label
42
47
For
contain the last
contains the
2:
is
are
contain
the 3480
if
the
is
Chapter
2.
Tape Characteristics
2-1
~
?
Page 21
Recording Mode for the IBM Standard Data Set Label 2 (HDR2/EOF2/EOV2)
If
the Improved on the subsystem, the existing two-byte field, which technique (previously used for seven-track tapes), indicates the data-set attribute for the IBM standard label IECDSECT macro:
Data
Recording Capability feature
file
2.
This field is
is
installed, enabled,
is defined as the tape recording
FL2TRTCH
and defined in the
and
invoked
'P , (P
,
(two
followed
bl
anks)
by
a blank)
The The
file file
is
written
is
not
in
written
compacted
in
compacted
mode.
mode.
h 2-2 IBM 3480 User's Reference
Page 22
I
Chapter
3.
Modifying
Existing
Code
in
MVS
Systems
Selecting
DeB
Parameters
Data
Introducing modifications
JCL,
and
Set
For
each
and
DD information supply
requests,
documentation.
statement
DD
of
field
the
data
After
you
can
change
of
the access appropriate
the
JFCBs
Options
data
statement.
can
data
set
and
related
the
DCB macro,
set.
have
them
DCB discussed below
techniques.
data
3480 subsystem
to
your
existing
should
set
be
identification, device
You
by specifying
specified
only by
management/administration
be
you
want
The
characteristics
supplied
information
establish
or
the
(For
more
changing
into
code.
examined
to
process,
by
either
as
the
logical
the
name
by
completing
data
set
are
common
information
your
Such
for needed changes.
characteristics,
specified
characteristics
the
operations
areas
as
there
must
of
the
data
source. Also,
in
the
connection
of
the
DD
statement
the
field
DCB
during
to
most
data
about
the
macro
can
require
DCBs, DD
be a
corresponding
set
and
device-dependent
the
DD
statement
space
allocation
appropriate
between
in
the
yourself
in
processing.
DCB fields, see
instruction
before
the
DCB macro,
organizations
some
statements,
DCB
must
JES
a DCB
and
DDNAME
opening
you
The
fields
and
reference.)
a
Density
Option
(DEN)
Note: When using the
OPTeD = Wand
The
tape
density bits-per-inch-per-track. capable
by
Note: The
parameter
the
unit
is used.
3480
does not need the option is ignored. specify only
DEN
IBM
3480,
you need
the
DEN
options.
(DEN) specifies
When
DEN
DEN
In
compatibility mode,
=
4.
Chapter
3.
Modifying
is
not
option.
to
consider the effect
the
recording
specified,
Existing
the
If
UNIT = 3480,
if
DEN
Code
of
the
density
highest
in
density
the
DEN
is specified, you can
in
MVS Systems 7
Page 23
Write-Validity-Check
Option
You parameter 3480
For interrupt validity buffering. blocks
The
buffering each before (The read-back written).
(OPTCD=W)
can
specify
of
to
operate
buffered
until
check
per
second.
OPTCD = W
in
block
the
control
the
the
DD
in
tape-write-immediate mode.
tape
devices,
the
data
option, you do
This
causes
parameter
the
control
of
data
is
unit
check
write-validity-check
statement
is
the
unit
physically
gives
is
done by
or
the
DCB macro. OPTCD = W
write
validity
physically
not
maximum I/O
of
the
be bypassed
write·
on
benefit
DCB
written
completion
the
hardware
option
check tape.
from rate
can
when
on
the
in
delays
When
the
to
be
be
used
writing
tape
indication
while
either
performance
the
the
device-end
you
use
reduced
to
request
data.
and
read-back
to
the
data
DCB
the
to
It
the
is being
causes
write
advantage
about
10
that
data
ensures
checked,
processor.
the
of
that
Coding
the
Block
Size
Constructing a Data
Macro
Instructions
Available
Generally, you write
operations control and
unit
EXCP.
and
The
3480 provides good performance for all block sizes, provide optimal performance for kilobytes.
Control
The
access
the
for
used
3480. QSAM, BSAM,
is buffered
by
MACRO INSTRUCTION
DCB X X X DCBD X X X MSGDISP NOTE X POINT SYNCDEV X X X
use
the
write-validity-check
go
directly
buffer. OPTCD = W is
Logical
Record
Block
method
Access
support
data
Method
EXCP
that
transfer
X
to
the
Length
block
exists
and
EXCP
for
both
BSAM
X
X
tape
instead
generally
Operands
sizes
for
data
are
read
QSAM
X
option
in
supported.
and
of
storing
only
meaningful
the
sets
write.
to
make
range
on
magnetic
the
the
but
is designed
of 8 to
The
default
application's
data
in
the
with
BSAM
to
32
tape
is used
mode
8
IBM
3480
Magnetic
Tape
Subsystem
User's
Reference
Page 24
Specifying
JCL
Options
The W option the
3480.
"Write-Validity-Check Option (OPTCD = W)"
Use
the
The
The
The
That uses
That until
If
you
request
or
the
proper
function
For
further
MVS/Extended MVS/System Control Language MVS/System
for OPTCD
For a discussion
UNIT
specific device you
types
number
parameter
of
devices you
of
the
system is
(unit
affinity)
the
system is
the
data
set
the
3480 subsystem
esoteric
mode, code
information
devices you
requests a validity
to
to
assign
not
is opened (deferred volume mounting).
name.
UNIT
on
Architecture,
Product-JES2
or
MVS
Product-JES3
of
the
OPTCD = W option, see
specify:
want
the
want
the
want
data
to
request
in
If
you
= 3480
the
or
use
of
MVS/System Version 2,
JCL
MVS/System
Release 3.1,
system
system
the
system
sets
to
the
operator
compatibility
request
the
proper
the
UNIT
Product-JES3
LIC
LIC
check
to
the
the
for
on
page
assign
to
assign
to
assign
same
to
mode, code
3480
esoteric
parameter,
write
operations
8.
to a data
to a data
to a data
unit
another
mount
subsystem
the
name.
see
Version
set
set
volume
UNIT
in
full
2,
on
set
data
set
= 3400-9
PROG 5665-291, 5740-XC6, Job
Product-JES2
PROG 5740-XYS,
Release 3.3,
-XYN.
Modifying
the
Job
The supplied the
In before to to further
File
OPEN
system
certain
issuing specify permit
information
Control
macro
in a data
in a job
applications, you
the
a high-speed
instruction
definition
file
an
OPEN
physical
about
search
control
macro
block
Library: Data Management Administration.
Block
requires
(DD)
statement.
block
might
the
or
have
instruction.
identifier
of
a specific
JFCB,
MVS/Extended
(JFCB)
access
(JFCB).
in
see MVS/370 System Programming
to
modify
the
data
to
information
This
information
the
For
example, you
JFCB
(explicitly
block
contents
on a tape
that
you
is
stored
of a JFCB
might
or
by
volume.
Architecture System-Data
have
want
default)
by
For
Chapter
3.
Modifying Existing Code in
MVS
Systems 9
Page 25
Setting
the
Header
Label
Block
ID
in
the
JFCB
for
High-Speed
Search
To use label certain The software support.
The high-speed search:
1.
2.
3.
4.
If
the
If
OPEN header
the
high-speed
tape
data
set, you
fields
in
ability
following
Use
Set provided.
Move field JFCRBIDO. (The block ID example, from
Use
the
high-speed
the
to
use
procedure
the
RDJFCB
the
JFCPOSID
the
block ID
the
OPEN
JFCPOSID
search
fast
positioning
moves
record
the
into
search
must
the
JFCB
the
high-speed
macro
bit
of
the
ID
macro
bit
is
set
function
bit
tape
normally
JFCRBIDO.
should
in
the
available
with
is
function specify
and
using
to
read
field JFCBFLG3
first
TYPE=J
off,
OPEN
is
set
on
of
the
OPEN
search
be used
the
standard
must
at
close time.)
moves
not
active.
but
no
and
inserts
the
3480
subsystem
block
ID for
TYPE
function
to
modify
JFCB
into
to
header
have
to
open
the
block ID is found
the
= J
is
supported
the
your
indicate
label
been
saved
the
tape
block
the
to
data
normally, as
ID
data
open
JFCB
work
that
of
set.
of
on a standard
by modifying
the
data
only by 3480
for a
area.
a block ID is
the
tape
to
earlier,
in the
for
though
JFCRBIDO,
first label
set.
the
If
the
JFCPOSID match IEC147I
If
block specified. previous
During first label inserted device should
Note FREE
CLOSE macro),
program.
the
block
indicates
the
block ID specified does
or
file
The
block
CLOSE processing,
header
into
and
save
that
if
= CLOSE
This
bit
is
set
on
but
ID
on
the
tape,
OPEN
that
the
block ID
not
mark
preceding
drive moves
or
file mark.
record
the
JFCRBIDO field. Therefore,
plan
to
use
the
block ID before you close
dynamic
in
the
the
block ID for
is
because
unallocation
the
if
of
the
the
current
DD
statement,
dynamic
the
tape
the
next
the
block ID
processing fails
could
not
exist,
the
control
one
that
the
to a position
JFCPOSID
data
block ID for
is specified (with SVC
or
the
next
unallocation
set
the
with
data
bit (which
Note: The data set sequence number (as coded
be
specified as
usual
(either explicitly or by
the tape at high-speed.
in
JFCRBIDO does
and
be found
Locate
is on,
if
you
subsequent
data
the
set
frees
in
on
unit
searches
Block command
to
write
the
may
deallocate
set.
FREE
is
option
not
the
available
LABEL
default)
not
error
message
the
tape.
for
the
data
following
block ID for
not
exist) is
the
3480
processing, you
99,
with
in
the
to
your
JFCB.
= (seqno,SL))
when you move
the
the
must
10
IBM
3480
Magnetic
Tape
Subsystem
User's
Reference
Page 26
Example
of
How
to
Code OPEN(J)
The
example program, following, shows how existing multifile volume. the
predecessor file was created),
file
to
be added
The
example program opens sequence number
and
BLOCKID Figure
The beginning
CLOSE, picked from
stored
The
1.)
subsequent OPEN TYPE = J performs a high-speed
the
back
fields
are
are
of
the
new
BLOCKID
the
JFCB,
into
the
in
the
JFCB
and
stored
the
stored
tape
of
the
control
that
to
add
another
The
last
time
this
program was processed (after
the
file number
in
a small control
the
control
BLOC KID
into
the
file.
The
the
next
file sequence number is increased,
data
set.
are
referred
data
of
the
JFCB
of
new file is
file (the one
to
data
set file the
in
the
and
the
BLOCKID
set
on
DASD.
and
retrieves
to
be created.
new
tape
file. (see
search
created
to
and
be
created
example program are:
data
set
to
an
of
the
the
file
File
number
to
the
closed. After
next
time) is
and
both
are
Offset
+56
+108
+163 JFCBFLG3 1 New
Figure
Dec.
1.
Name JFCRBIDO 4
JFCRBIDC 4
JFCPOSID
JFCB
Layout
Length
-
Comment Physical
of processed by
Physical of same of tape
3480. Bit
request identifier processing OpenjClosejEOV.
block identifier
SL HDR1
final
as
the
volume.
bit
3 (hex 10) indicates
to
be
Open.
block identifier
tape
mark.
the
first SL HDR1
next
data
set
defined for
for physical block
The on
the
in
the
Chapter
3.
Modifying Existing Code
in
MVS Systems
11
Page 27
CDSDCB
TAPEDCB
DCB DCB
DDNAME=CDSDD,DSORG=PS,MACRF=(GM,PM)) DDNAME=TAPEDD,DSORG=PS,MACRF=(PM),EXLST=JFCBP
JFCBP JFCB
*
CDSBUF CDSFLSQ CDSRBID
LPI
EOF
DS DC DS ORG IEFJFCBN ORG
DS DS DS ORG
OPEN GET CLOSE
RDJFCB MVC MVC
01
OPEN
PUT B
CLOSE
0F X'87' CL176 JFCB
0CL80 CL2 CL4
CDSDCB CDSDCB,CDSBUF CDSDCB
TAPEDCB JFCBFLSQ,CDSFLSQ JFCRBIDO,CDSRBID JFCBFLG3,JFCPOSID
(TAPEDCB,(OUTPUT)),TYPE=J
TAPEDCB,
LPI
TAPEDCB
,AL3(JFCB)
....
OPEN J INDICATOR JFCB
CONTROL SEQUENCE BLOCKID
OPEN READ CLOSE
GET PUT PUT SET
CREATE
DATA
NUMBER
OF
CONTROL CONTROL
CONTROL
JFCB
OF
FILE
SEQ. BLOCKID BLOCKID OPEN/
POSITION
NEW
AND
SET
RECORD
OF
BEGINNING
DATA
SET
DATA
SET
DATA
TAPE
FILE
NO.
INTO
INTO
JFCB
BIT
ON
FILE
JFCB
NEW
FILE
OF
SET
JFCB
HIGH
ADDR
FILE
SPEED
MVS
RDJFCB LH AH STH MVC OPEN PUT CLOSE
TAPEDCB Rl,CDSFLSQ Rl,=H'l' Rl,CDSFLSQ CDSRBID,JFCRBIDC
(CDSDCB, CDSDCB,CDSBUF CDSDCB
Block
(OUTPUT))
Count
When standard block described
MVS/Extended Administration,
For
the These block the
tape
GET
UPDATED
GET
FILE INCREMENT STORE STORE OPEN
CONTROL UPDATE CLOSE
JFCB
SEQUENCE
BY SEQ. BLOCKID
CONTROL
1
NO.
OF
DATA
CONTROL
DATA
Checking
using
MVS
to
read
or
ANSI
tape
labels,
count
count
checking
in
MVS/370 Magnetic Tape Labels and File Structure,
that
Architecture Magnetic Tape Labels
DFP
Version
3480, MVS does block
are
when
the
data
error
on
the
is
written,
rather
OF
TAPEDD
NUMBER
OF
NEXT
FILE
NEXT
FILE
SET
DATA
SET
SET
any
type
of
magnetic
certain
is performed for
1,
count
set
is
written
tape,
the
than
block
and
DFP
checking
system will
when
it
tape
count
checking
all
magnetic
and
Version
and
for all label types.
is
later
2.
under
attempt
read.
volume
tape
that
is done.
devices
File Structure
more
circumstances.
to
discover
If
has
and
there
it
IBM The is
is a
when
12
IBM
3480
Magnetic Tape Subsystem User's Reference
Page 28
This
additional
block
identifier
identifier
For
3480, MVS
to
DCBBLKCT during the done
(imbedded
With processing.
With trailer record
For the
The
label block labels.
CLOSE, EOV
DCBBLKCT
for
an
BSAM
standard
labels. the
tape
devices
correct
block
is performed
count
to
the
MVS
DOS
and
For
labels (IBM
The
block
number
count
checks
block
count
to
each
block
system
compares
when
and
checkpoints)
QSAM,
EXCP
count
other
check
using
the
it
is
being
and
FEOV
block
checkpoint
the
and
installation's
in
the
than
of
blocks.
that
only
on
are
performed
checking
written
the
number
ID
data data is specified.
system
EXCPVR, DCBBLKCT
and
trailer
3480,
compares
input
is possible
on
the
Read
Block
of
blocks
maintained.
operations
do
not
set
or
one
maintains
ANSI)
the
NSL
(nonstandard
labels.
output
the
data
sets
for 3480
data
tape
ID
written
The
and
match.
for
DCBBLKCT
block
sets
DCBBLKCT field with
standard
input
because
and
provides
channel
or
comparison
results
which
count
data
in
This
comparison
OPTCD = H
may
is
label)
cannot
sets
also
the
3480
the
command.
read
in a data
is
done
an
ABEND
during
be
maintained.
recorded
routines
be
checked
to
the
labels.
with
Thus,
standard
appends
block
set
when
is
not
tape
in
the
may
also
for
trailer
two
a
User
EXCP
Exits
Routines
The
additional codes for ABEND messages programs. Return include
certain
For the trailer both prevent
can DCB ABEND
DCBBLKCT is assumed
EXCP
words.
DCBMACRF
that
Codes"
user
user
those
3480-written
label
ABENDs,
the
prevent
DCB
For
the
routine
3480
The
additional
on
exits for
programs.
data
sets
block
to
DCBBLKCT.
you
3480
block
the
DCBBLKCT
exit
that
does
EXCP
must
is
block
count
page
73.
the
additional
that
receive
ID
is
must
handle
count
or
in
the
to
not
have
routines
be
set
to
maintaining
checking
and
may
require
ABEND
Programming
performed before
block
be
this
1.
both
If
both
each
check
to
trailer
count
present
a device
means
Bit 5 of
an
return
block
block
checks
ABEND
ABEND
label
unequal
and
interface
that
MACRF
accurate
provides some
you
to
change
codes
are
explained
changes
count
count
fail
mismatch
valid
any
block
that
check,
checks,
the
check
and
you
independently.
in
the
DCB
ABEND
exit.
in
all
cases
section
of
bits
12,
must
also
count.
additional
some
in
may
be
EXCP
that
routines,
the
check
compares
want
to You
ABEND
except
of
at
least
13,
or
be 1
return
of
your
"ABEND
required
using
prevent
can
exit
and
in
either
for
three
14
of
to
indicate
and
the
the
an
Chapter
3. Modifying
Existing
Code
in
MVS
Systems
13
Page 29
For
further
information
concerning
the
use
of
EXCP
and
EXCPVR,
MVS/370 System Programming Library: Data Management, MVS/Extended
and
DFP
Version
Architecture System-Data Administration,
2.
DFP
and
Version
see
1,
User
Programs
A few block are:
The
Keep
user
programs
count
checking
Programs tape the
Programs count calculated mismatch block
following
the CNTRL macro. IOBINCAM specifies EXCP. A positive forward
that
position
tape
has
that
discrepancies.
from
between
count
are
an
accurate
access
method
If
IOBINCAM is zero,
or
or
backward, respectively,
written
may
not
do
not
cause
when
one
of
non-standard
depend
the
exit
changes
With
negative
on
The
unit
DCBBLKCT
to
be called.
that
block
takes
EXCP,
the
value
for
an
operate
the
the
following is
labels,
the
block
mismatch
causes
you
count
in
care
of
the
number
your
indicates
environment
successfully.
DCBBLKCT field
or
BLP
count
between
an
ABEND
and
the
can
make
DCBBLKCT.
this
except
system
of
blocks
program
the
on
the
where
true:
is used.
exit
to
DCBBLKCT
to
be
tape
label would
to
such
with
will
maintain
read
can number tape.
For
or
the
system
Programs
to
reflect
the
tape
handle
issued
some uses
maintain
known
before
programs:
BSAM
DCBBLKCT
written
of
blocks
does less
that
may
the
correct
is unlabeled,
block
and
the
count
the
cause
the
and
QSAM,
of
the
if
with
each
DCBBLKCT.
going
fail
Set
all
of
bits
12, 13, DCBMACRF because
Supply a DCB ABEND handle
Supply Administration
Supply
is
least
volumes
to
the
block
the
117,
an
installation
an
EST
desirable
cannot
zero.
count
137,
Guide)
AE
exit
because
easily
and
and
14
of
DCBMACRF
This
may
cause
is
not
checked.
exit
routine
214 ABEND.
DCB ABEND
to
handle
routine
the
be
handled.
the
to
handle
DCB becomes
the
(see
exit
117,
to
zero
program
Data
Administration
routine
137,
and
the
new
unusable
and/or
to
be
less
(see
Data
214
ABENDs.
ABENDs.
and
set
bit 5 of
reliable
Guide)
This
action
subsequent
to
14 IBM
3480
Magnetic
Tape Subsystem
User's
Reference
Page 30
Performance
Options
for IEBGENER
IEBGENER
Storage
BUFNO IEBGENER data device, IEBGENER
When the number maximum
IEBGENER buffers BSAM specifies a
If
INPUT
used.
is a
supported
provides
blocks
performance
to
and
allows
provides a
one
or
both
of
buffers above
number
uses
if
the
BUFNO
data
be
sets
Requirements
Using storage REGION ABENDs.
multiple
needed
parameter
You
buffers for to
can
parameter
better
read
and
the
potential
default
of
the
of
IEBGENER
the
of
blocks
the
DCB
parameter
number
are
concatenated,
run
the
for
the
calculate
for
performance
written
for more
value
data
sets
may
default
per
track.
parameter
is
greater
IEBGENER
program.
additional
the
than
region
DeB
with
of
are
on
be
value,
NCP = nn
not
specified. 99,
BUFNO
increases
You
storage
specifications
when
multiple
each
I/O
overlap
5 for
the
DASD
further
may
size
and
improved by
up
to
to
the
value
is
need
to
by
using
for
buffers
operation
of
reading
number
one more
determine
If
ignored
the
avoid 80A
of
has a small
the
parameter
99
is used.
and
amount
to
change
the
IEBGENER.
permit
initiated
with
buffers.
increasing
than
the
the
one
of
virtual
or
system
following formula:
more
to
writing.
block
size,
number
used
buffer
add
a
a
the
of
for
is
50K + ((2+SYSUTl
((2+SYSUT2
Note:
If
BUFNO
formula yields slightly large values for region size
and
different
The
following is
amount
SYSUTl SYSUTl SYSUT2 SYSUT2
of
virtual
BLKSIZE=2K BUFNO=20 BLKSIZE=32K BUFNO=Not
Virtual region =
REGION=318K
DCBBUFNO)*(SYSUTl DCBBUFNO)*(SYSUT2
DCBBLKSIZE)) DCBBLKSIZE))
is not specified, use a value
MVS
environments.
an
example
storage
specified, default is
50K + ((2+20)*(2K))
of
how
needed:
to
used
+
use
((2+5)*(32K))
+
of
5 in the calculation.
the
formula
to
This
to
allow for growth
calculate
the
Chapter
3.
Modifying
Existing
Code
in
MVS
Systems
15
Page 31
INVOKING IEBGENER
The
following is
an
example
of
JCL
to
invoke IEBGENER:
IICOPYJOB II IISYSPRINT IISYSIN IISYSUTl II II IISYSUT2 II II
JOB EXEC
PGM=IEBGENER,REGION=318K
DD
SYSOUT=A
DD
DUMMY
DD
DSNAME=X.FILE,UNIT=3380,
DISP=OLD,VOL=SER=X13380, DCB=(BUFNO=20,RECFM=FB,LRECL=2000,BLKSIZE=2000)
DD
DSNAME=X.FILE.TAPEVER,UNIT=3480, DISP=(NEW,KEEP)
,
DCB=(RECFM=FB,LRECL=2000,BLKSIZE=32000)
16 IBM 3480
Magnetic
Tape
Subsystem
User's
Reference
Page 32
Chapter
4.
Controlling
In
3480 high-speed force before
the
full-function mode, two modified
searches
the
control
continuing
unit
with
I/O
for
to
data
write
other
Device
blocks
all
the
commands.
macros
on
tape. A new
buffered
allow you
macro
write
data
to
perform
allows you
onto
the
to
tape
Controlling
How
the
Physical
High-Speed
The
NOTE
TYPE = ABS is added for full-function mode.
Block
Before should
The written a 3-byte every successive
The
Although Read command. storage when
The
BLOCKID TYPE = ABS keyword functions.
Identifier
using understand
3480
control
to
absolute
absolute
a BLOCKID is
with
writing
NOTE
Search
and
POINT
the
NOTE
tape. A BLOCKID
block
block
Read
the
record.
data.
macro
to
perform a high-speed
macros
Works
and
how
data
unit
records a block
block
number.
on
the
number
normally
operations
The
retrieves
in
the
for
the
(NOTE/POINT)
are
POINT
is
stored
contains
The
tape,
the
do
program does
BLOCKID.
NOTE
modified for
macros
block
including
first
recorded
not
search
and
for high-speed
on
the
3480 tape.
identifier
a I-byte
identifier
block
on
transfer
not
The
for a specific block.
POINT
the
3480
(BLOC KID)
physical
is
labels
on
tape
tape,
the
have
POINT
macros
and
it
BLOCKID to
and
parameter
search,
with
reference
increased
tape
marks.
is
hex
000000.
is invisible
create
macro
cause
BLOCKIDs
uses a
The
these
you
each
value
by
to
into
block
and
1 for
the
main
known
new
Retrieving
the
BLOCKID
The
and
NOTE
depth
macro
of
buffering,
returns
to
two BLOCKID values,
the
application
program.
Chapter
4.
Controlling
the
current
the
block
position
I/O Device 17
Page 33
The first BLOCKID following:
The
data
block
either
The
read
last
or
data
write mode
block
returned
to
be passed between
(in register 0) by NOTE represents one
sent
to
the
the
processor
processor
in
read
backward mode.
and
the
subsystem
of
the
in
Performing
the
High-Speed
next
next
read
buffer
the
1.
the
the
the
BLOCKID
data
data
mode
recent
in
the
number
20
low-order bits
result
result
result
The second the
following:
The buffer for write mode
The for
The most unit
To
obtain subtract register
If
If
If
Search
returned
block
to
block
to
data
block
read-backward mode.
of
blocks
is negative,
is zero, no blocks
is positive,
(in register
be
written
be
read
that
in
in
register 0 from
the
tape is
are
the
tape
to
from
was
the
buffered
is
the
the
read
buffer
in
read
in
write
1)
by NOTE represents one
tape
from
the
control
tape
to
the
control
from
the
tape
in
use for
the
mode
or
the
20
low-order bits
read-backward mode.
unit
to
the
specific DCB,
of
unit
buffer
control
in
18
IBM
The
POINT keyword is used, the
search
When example, in
the
tries
to
number.
Usually, retrieved by specifying speed.
3480
Magnetic Tape Subsystem User's Reference
macro
the
is done
high
speed is used
to
add a block
POINT macro
move
the
tape
If
this
block is also missing,
the
POINT macro only uses BLOCKIDs
the
NOTE macro.
TYPE = ABS,
moves
at
the
search
normal speed.
might
is done
to
move
to
an
not
to
a position
substitute
tape
to
at
the
existing
yet
exist.
after
If
the
zeros
a specific block.
high
speed.
tape
to
data
set,
In
this
a block
an
error
device type is
and
the
end
the
instance,
with
results.
that
the
search
If
BLOCKID
not
If
the
TYPE = ABS
TYPE = REL is used,
of a data
the
were previously
known when
is done
set, for
that
is used
the
subsystem
preceding block
at
normal
Page 34
Comparing
Conventional
This
section conventional search
The
format
format
If
TYPE search independence program Conventional-speed the
3480. However,
Search
(NOTE/POINT
of
of
the
= ABS is
facility,
path
and
discusses
search
the
relative
is required, (using conventional-speed
(NOTE/POINT
BLOCKID
used
an
error
search
the
High-Speed
the
differences
with
with
TYPE
block
with
return
this
is device-independent
two
= ABS).
used
for high-speed
address
a device
code
condition
search
used
that
is
speeds
Search
in
application
TYPE
for conventional-speed
does
returned
must search)
cannot
program
= REL)
search
not
support
in
register
be
checked
must
be
and
can
be mixed for a
and
logic
high-speed
is
different
the
high-speed
15.
If
and
an
provided.
also be
between
from
search.
device
alternate
used
with
data
set.
the
Note:
All
the same
When high-speed
The within
The
can was
applications
With in
register
With
NOTE
the
With
With
information
be
either
just
processed.
The
next
NOTE
and
TYPE
are
search,
TYPE
TYPE = REL,
macro
data
TYPE
TYPE
= ABS,
15.
set.
= ABS,
= REL,
returned
the
next
block
the
The
is
usually
For
for
POINT
macro instructions for a given file
keyword.
converted
following differences exist:
the return
no
return
this
this
describes
block
normal
TYPE
from conventional-speed
NOTE
information
information
and
code
should
code
used
to
the
that
would process
forward
= ABS
POINT
is
provided
locate
is
is
current
read
be
the
returned
returned
macros
checked
current
block
or
in
or
the
write
search
provide a
by
the
register
logical
in
register
in
register
in
the
previous
processing:
must
to
return
program.
15.
position
0
1.
data
set,
block
use
code
which
that
The
the
previous
the
information
next
When to
TYPE=REL.
block
block
for
TYPE
is
used
that
would process for
= REL.
later
in
a POINT
both
Chapter 4. Controlling the I/O Device 19
macro
TYPE
instruction,
= ABS
and
it
refers
Page 35
Examples
of
How
to
Code NOTE
and
POINT
Example
1
This example includes
tape
file. While
about
the
position
that
information
500
and
reads
High-speed
Program instruction in
register
write
from block
obtained
Program macro macro
Conventional
Program instruction in
register write from block obtained by
writing
of a certain
to
Program
it. You
search
A writes
with
the
0 refers to block
number
by NOTE is saved
B uses instruction instruction
this
search
A writes 500 blocks
with
the
1 refers
number
NOTE is saved
Program A and
the
data,
block (for example,
B.
can
select high-speed
Program
Program A must
Program
B moves
search
B.
Program A creates
save
the
information
number
the
or
500)
tape
to block
conventional
implementation
499
blocks
TYPE = ABS parameter. The information
information as a with retrieves block
to
the
tape,
then
calls
number
500
until
and
the
TYPE = ABS parameter. After
500.
the
passed
number
Program A then
end
of
the
file. The
to
Program
search
argument
500.
the
B.
NOTE
in
implementation
to
the
tape,
then
calls
the
NOTE
TYPE
to
block
501
=REL
number
until
to
be passed
parameter. The information
500.
Program A then
the
end
of
the
file. The information
to
Program
B.
a
and
pass
number
search.
macro
returned
continues
information
a POINT
that,
a READ
macro
returned
continues
to
to
Example
2
Program macro macro
The
following search. on
tape
block
in
The
NOTE BLOCKID the
required macro will perform a high-speed block. After BLOCKID) processing is resumed.
B uses instruction instruction
This
example shows how
can
reach a point
the
same
macro
of
the
block is provided
the
brings
this
is
an
example
data
is used
successor block
block is read, a second POINT
the
information as a
with
the
retrieves block
of
at
which
set.
to
save
within
tape
back
TYPE =
using
NOTE
an
application
information
the
current
on
the
the
search
to
the
search
REL
number
tape). Assuming
block
within
original
argument
parameter. After
500.
and
POINT for high-speed reading
is required from
tape
position (it
just
the
data
macro
position where
in
a POINT
that,
a READ
through a data
another
returns
the
BLOCKID
read, issuing a POINT
set
to
reach
(using
the
saved
sequential
set
the
of
that
20 IBM 3480
Magnetic
Tape
Subsystem
User's
Reference
Page 36
DCBIN
---------------------------------------
*
BUFFER
DCB DS
DDNAME=TAPEIN,DSORG=PS,MACRF=(RP) OCLSOO
NORMAL
READ
BUFFER
REFBLKID
*
---------------------------------------
RBUFFER
*---------------------------------------
BLOCKID
LPl
DS ORG DS DS
OPEN
READ
CHECK
L LTR BZ
NOTE LTR BNZ ST
POINT LTR BNZ
READ
CHECK
CL4 BUFFER CL800
F
DECBIN1,SF,DCBIN,BUFFER,800 DECBIN1
2,REFBLKID 2,2 LP1
DCBIN,TYPE=ABS 15,15 NOTEERR O,BLOCKID
DCBIN,(2),TYPE=ABS 15,15 POINTERR
DECBIN2,SF,DCBIN,RBUFFER,800 DECBIN2
+800
(DCBIN,
(INPUT))
BLOCKID
BUFFER BLOCKID
OPEN
READ PROCESS
IS BLOCK NO
REMEMBER ALL
SAVE GO
ALL
READ
PROCESS
REFERENCE
FOR
REFERENCED
SAVE
AREA
TAPE DATA
FROM
TAPE
THIS
BLOCK
THERE A NONSEQUENTIAL
REFERENCED?
TAPE
POSITION
OKAY?
TAPE
POSITION
TO
REFERENCED
OKAY?
REFERENCED
THIS
BLOCK
BLOCK
BLOCK
BLOCK
POINT
LTR BNZ B
EOF NOTE POINTERR
ERR
CLOSE DS DS
DCBIN,BLOCKID,TYPE=ABS 15,15 POINTERR
LP1 DCBIN 0H OH
GO
BACK
ALL
OKAY?
RESUME
SEQUENTIAL
NOTE
ERROR
POINT
ERROR
TO
OLD
RTN
RTN
PLACE
PROCESSING
Chapter
4.
Controlling
the
I/O Device
21
Page 37
NOTE-Provide
Relative
The
NOTE
the
last operations before
The
NOTE
data
set
(BSAM) is used,
indicated
The
NOTE
The
NOTE
Position
macro
block
read
using
the
NOTE
macro
is
used
(DSORG =
in
the
macro
macro
(BP
AM
instruction
from
the
same
macro
instruction
the
use
MACRF
instruction
is
written:
and
causes
or
written
data
control
instruction
is
automatically
PO
or
POU),
of
NOTE/POINT
operand
of
cannot
BSAM)
the
system
into a data
block
is issued.
but
macro
the
DCB
be
used
to
return
set.
All
must
be
provided
when a sequential
instructions
macro
for SYSOUT
the
input
tested
when a partitioned
instruction.
data
position
and
output
for
completion
data
must
be
sets.
of
set
[symbol]
deb
address-RX-type
The
dcb address
block
opened for
processed.
TYPE
= {ABSIREL}
ABS
specifies register for and block between
If
low-order data means the remainder
15
the
next
the
control
identifier
you
subtract
blocks left
the
buffer is
address,
operand
the
that,
is 0),
data
the
control
20
bits
buffer is
in
means
dcb
address
[,TYPE
after
the
either
= {ABSIREL}]
(2
-12),
or
(1)
specifies
partitioned
NOTE processes successfully
register 0 contains
block
unit
buffer,
of
the
next
unit
low-order
of
register
in
the
control
in
read
write
that
no
the
or
waiting
and
data
buffer
20
0,
mode,
or
data
address
sequential
for
transfer
register 1 contains
block
and
bits
the
remainder
unit
buffer. A
and read-backward is buffered.
of
data
the
physical
waiting
the
tape drive.
of
register
a positive
the
data
control
set
being
(contents
block
between
is
negative
mode. A zero
main
the
for
transfer
1 from the
number
remainder
of
identifier
storage
physical
the
of
remainder
means
22
IBM
3480
Magnetic
Tape
causes read the is to standard
Subsystem
the
from
current
in
binary,
zero. Do
labels when:
The
data
macro
The
DISP
specifies
User's
Reference
system
or
instruction)
to
written
volume, is
right-adjusted
not
use
a NOTE
set
is
opened
parameter
DISP
= MOD.
return into a data
the
relative
set.
returned
or
of
in
register
in
register 1 with
macro
for RDBACK (specified
the
instruction
DD
statement
position
The
of
position,
1.
The
high-order
for
for
the
the
in
terms
block
tapes
in
the
data
last
block
of
number
bits
without
OPEN
set
set
Page 38
Completion
Codes
from
NOTE
POINT-Moving
When you to code;
Return
Code
00 (hex 00)
04 (hex 04)
08 (hex 08) 08 08
08
08
12
Tape
have
specified
your
problem program,
the
low-order byte of register 0
Reason
(15)
(hex 08) (hex 08) (hex 08) (hex 08) (hex
OC)
Code
01 (hex 01) 02
03 (hex 03)
11
12
to a Relative
the
(0)
(hex 02)
(hex
OB)
(hex
OC)
Block
ABS
parameter
the
low-order byte
contains a reason
Meaning
Successful completion.
Device does Incorrect Incorrect
Environmental
Unsuccessful
Unsuccessful GETMAIN request. Input/output
Position
and
of
register
not
support parameter. DCB
or
error.
call
error.
(BPAM
the
a DEBCHK
to
and
system
ESTAE macro.
returns
15
contains a return
code:
block identifier.
error.
BSAM)
control
The
POINT macro
specified
macro,
control block that after
issue a WRITE macro immediately
the
specified) before
Note:
data
ensure
was opened for UPDAT, you
the
POINT macro.
data
set, unless you already issued
If
you specify the not issue a end-of-data location that
The
POINT macro is written:
[symbol]
dcb address-RX-type address,
The
dcb address operand specifies
block for
starts
the
next
set
block
on
the
that
all
input
and
are
tested for completion.
If
you
the
POINT macro.
TYPE
WRITE
POINT
the
opened
macro before you close the data set, use the
dcb address ,block address [,TYPE
data
current
output
are
= T option in the CLOSE macro
is determined by TCLOSE.
= {ABSIREL}]
(2
-12),
set
READ
must
that
or
WRITE
volume. Before you issue
operations
If
you
issue a READ macro immediately
processing
after
the
POINT macro before you close
the
CLOSE
or
(1)
the
address
is to be moved
operation
using
are
processing a
an
output
macro
of
the
into
the
data
(with
data
position.
at
the
the
same
data
data
set, you
TYPE
and
you
control
POINT
set
must
= T
do
Chapter
4.
Controlling
the
I/O Device 23
Page 39
block
address-RX-type
The
block
be
processed
address
next.
address, (2
operand
-12),
or
indicates
(0)
which
block
in
the
data
set
is
to
When
TYPE = ABS
is address (on a fullword physical
This macro
When specifies
contains
In
and add 1 if instruction
When must moved
otherwise,
TYPE
EODAD
block
physical
processing.
TYPE =
the the
the
relative
is
right-adjusted
reading
for
The
data
The
DD
an
end-of-data
not
issue
the
tape the
= T is
routine.)
identifier
block
identifier
REL
is specified
address
relative
address specification,
tape
tapes
set
is opened for RDBACK
statement
the
POINT
into
position
POINT
an
easy
method
specified,
boundary)
of
the
the
of
block
is provided
or
(on a fullword
address
in backward. without
for
condition
the
the
macro
of
the
fullword
Do
standard
data
is
encountered
instruction
for processing
operation
will be unsuccessful. (Issuing CLOSE
to
use
block
a fullword
that
as
defaults,
boundary) block
the
block
with
not
use
labels when:
or
set
specifies
to
accomplish
address
that
is
to
be
output
the
block
of
that
is
number
the
high-order
the
POINT
DISP
on
unless
within
operand
contains
specifies
the
processed next.
from
prior
NOTE
address a fullword to
be processed next.
is
in
bits
operand
that
binary
set
macro
= MOD.
magnetic
you
your
tape
tape, you
have
data
set;
position
first
in
to
your
the
0;
The
first
block
specified by
the
TYPE = {ABSIREL}
indicates identifier
whether
or a relative
ABS
indicates a fullword identifier
indicates a fullword
Note:
If
the correct the
next
address
POINT
tape
position
format,
CHECK
of
cannot
the
macro
of a magnetic
hexadecimal
the
block
address.
that
the
block
boundary)
of
the
block
that
the
block boundary) the
block
be
used for
is
not
correct
error
analysis
instruction
tape
cartridge
value
01000000.
address
address
of
a fullword
that
address
of
a fullword
is
to
SYSIN
or
operand
operand
is
to
be processed next.
operand
be processed next.
or
if
the
block
(SYNAD)
is processed.
data
is a
containing
containing
SYSOUT
identification
routine
set
is always
physical
specifies
an
a physical block
specifies
the
an
relative
data sets.
is given
control
block
address (on
address (on
is
not
in
when
the
24 IBM 3480
Magnetic
Tape Subsystem
User's
Reference
Page 40
Completion
Codes
from
POINT
When to code;
Code 00 (hex 00) 04 08 08
your
Return
(hex 04) (hex 08) (hex 08) (hex 08)
08
(hex 08)
08
(hex 08)
08 12
(hex
you
problem program,
the
(15)
OC)
have
specified
low-order
Reason
Code
01 02 03
11 12
byte
of
(0)
(hex 01) (hex 02) (hex 03) (hex
OB)
(hex
OC)
the
ABS
parameter
the
low-order
register 0 contains a reason
Meaning
Successful completion. Device does
Incorrect
Incorrect Environmental Unsuccessful Unsuccessful GETMAIN request. Input/output
and
byte
of
register
not parameter. DCB
or a DEBCHK
error.
call
error.
the
support
to
EST
system
returns
15
contains a return
code:
block
identifier.
error.
AE macro.
control
Controlling
Data
Synchronization
Synchronization other
commands
subsystem forces
addressed commands, any
read
unit
buffer
before
The support only for cannot
The
physical level. On established controlled controls controlled synchronization that that
the
SYNCDEV
buffered
be
SYNCDEV
drive is drive.
tape
drive before
such
command
to
synchronize
control
macro
output
the
data
changed
macro
by
the
as
to
control
as
to
written
means are
the
as
write
the
the
command
ensuring
performed. A
control
Write
issued
unit
performs
controls
mode
sets.
by
the
operates
the
logical level,
access
level
unit
level
on
the
(SYNCDEV)
that
data
synchronization
unit
to
write
it
accepts
Tape
Mark,
after
buffered
by
writing
with
Read
SYNCDEV macro.
method of
buffering.
buffer.
of
buffering.
for a
tape
any
Rewind,
write
all
buffered
the
command.
data
synchronization
full
function
buffering is
on
two levels:
the
macro
programming.
On
The
control
Once
tape
drive,
before
any
is
written
any
buffered
other
commands.
Rewind
commands,
write
programming.
always
the
controls
These
the
physical
unit
the
control
all
the
other
command
on
the
tape
command
write
Certain
Unload,
cause
data
to
for devices
done
automatically
logical level
the
buffers
buffers
level,
buffer
buffered
cannot
unit
write
is
before
to
the
data
to
Locate,
the
control
the
tape
that
The
macro
and
the
can
be
the
macro
be
receives
data
accepted
3480
the
other
and
is
and
a for
for
Chapter
4.
Controlling
the
I/O Device
25
Page 41
If
you
want
to
control
If then
QSAM
issuing
unit
buffer
is
used
a SYNCDEV only clears logical records synchronization or
BSAM,
If
you
control
want
unit
or
QSAM
to
buffer,
value.
wait
until a critical
onto
with
more
that
the
on
the
and
limit
the
the
record
the
tape, you
than
one
can
main
the
access method
has
logical record level
BUFNO = 1
number
of
and
data
unblocked records.
blocks
SYNCDEV macro
is
physically
use
the
storage
control
waiting
can
be achieved only for EXCP
that
can
be used
written
SYNCDEV macro.
buffer
unit
or
blocked record,
buffers,
for service. Therefore,
can
be waiting
to
specify a
from
but
not
in
threshold
the
any
the
Because given
Synchronization is done by comparing
the
this tape causes
The
To
To demand
the
control
to
it, every time synchronization
actual
buffering
data
set).
before
an
unconditional
control
two ways
request
buffering) used
unit
does
depth
(number of blocks buffered
If
BUFBLK is less, all
is
returned
write
to
use
the
SYNCDEV macro include:
information
that
synchronization
in
the
BUFBLK
regarding
not
keep
to
the
of
all
buffered data.
occur, based
parameter
the
last
is
needed, SYNCDEV
the
BUFBLK
data
in
program. A zero BUFBLK
synchronization
synchronization), or, depending on MF-type given
by
the
addressed
Error
codes
are
ABUFBLK parameter.
returned
in
register
15
to
the
threshold
parameter
the
buffer will be
on
the
(0
means
macro.
value (BUFBLK)
must
value
in
the
control
written
value
number
(depth
direct
in
a halfword field
be used.
and
unit
for
to
of
26
IBM
3480
Magnetic
Tape Subsystem User's Reference
Page 42
Example
of
How
to
Code SYNCDEV
DCBOUT BUFFER SWITCH 1 DC CRITICAL
SAMP2
DCB DS
EQU
DS OPEN
*
MSGDISP
LTR
BNZ
LPI
WRITE CHECK TM BZ
*
*
END
SYNCDEV
LTR BNZ MVI B
CLOSE
DDNAME=TAPEOUT,DSORG=PS,MACRF=(WP) CL800 X'OO' X'OI'
OH (DCBOUT,
RDY,DCB=DCBOUT,TXT='OKAY
15,15
MSGERR
DECBOTl,SF,DCBOUT,BUFFER,800 DECBOTl SWITCHl,CRITICAL LPI
DCB=DCBOUT,INQ=NO,BUFBLK=O
15,15
SYNCERR SWITCHl,O LPI
DC
(OUTPUT))
BOUT
WRITE
SWITCH
OPEN DISPLAY A USER
I'
ALL
OKAY?
NO BUILD
SOME SWITCHI
WRITE
CRITICAL NO
WAIT
TO
BE
ALL
OKAY? NO RESET RETURN
CLOSE
BUFFER
FILE
MESSAGE
BUFFER
BLOCKS
DATA
FOR
PHYSICALLY
SWITCH
DATA
WILL
DATA
ALL
TO
LOOP
TO
MAY
BE
BLOCK?
DATA
SET
WRITE BE SET
WRITTEN
CRITICAL
TO
X'OI'
IN
BUFFER
MSGERR SYNCERR
DS DS
OH OH
MSGDISP
SYNCDEV
ERROR ERROR
RTN RTN
Chapter
4.
Controlling
the
I/O Device 27
Page 43
SYNCDEV
-Synchronize
The
synchronization
mode. your
much
You
Request
Demand buffered.
If
control error.
If
affected.
Device
SYNCDEV
Data
records
program
data
can
more
the
is
is
left
use
the
information
synchronization
blocks until
same
macro
number
instruction
for
the
3480 subsystem,
in
the
ready
to
in
the
buffer,
SYNCDEV
are
buffered
all
the
blocks
or
control
send
more.
and
macro
regarding
if
the
than are
fewer
blocks
allows
unit
synchronization
specified
written
you
to
control
which
buffer
There
it
is time-dependent
to
either:
were
are
supports
may
is
no
number
specified,
on
the
buffered, buffering is
not
way
the
tape
data
buffered
yet
to
determine
to
of
data
system
or
be
tape
blocks
it
detects
write
on
tape
motion.
stays
not
when
how
are
in
an
,
I/O
Note: Demands for synchronization are ignored
The
SYNCDEV
[symbol]
The
following describes
DCB
=
addr-A-type
specifies
ABUFBLK
specifies
ABUFBLK
BUFBLK
macro
SYNCDEV
the
=
addrlBUFBLK = {maximum
the
specifies contains a value blocks
= specifies buffered. The
BUFBLK
(2
-12).
is
written:
the
address
address
maximum
=
addr-A-type
the
that
of
address (on a
can
maximum
the
maximum
This
number
value
DCB=addr
[,{ABUFBLK
BUFBLK
[,INQ
= {YESINO}]
operands
or
(2
-12)
the
data
number
address
that
specifies
be buffered.
buffer depth
number
can
can
= addrl
= {maximum buffer depthlO}]
that
can
control
block.
buffer depthlO}
of
data
blocks
or
(2
-12)
halfword
the
maximum
of
data
be
an
absolute
be
in
the
2 low-order
if
the drive is in read mode.
be specified for SYNCDEV.
that
can
be buffered.
boundary)
blocks
of a halfword
number
that
can
value
from 0
bytes
that
of
data
be
to
65535.
of a register
28
IBM
3480
Magnetic
Tape
o
If
data are
Subsystem
neither
blocks
buffered.
User's
ABUFBLK
that
can
Reference
nor
BUFBLK
be buffered
is specified,
defaults
to
0,
the
and
number
no
data
of
blocks
Page 44
INQ
= {YESINO}
specifies synchronization
YES
whether
specifies
If
the
previous
contains
this
is a
or a request
an
inquiry
operation
the
number
request
as
of
for
information
for
synchronization.
to
how
many
data
completed successfully,
buffered
physical
about
blocks
blocks.
the
are
in
register
degree
the
buffer.
0
of
SYNCDEV-List
Form
The
list
[symbol]
The
following describes
ofSYNCDEV.
DCB
BUFBLK
blocks
request
that
specifies a data BUFBLK.
Note: Do not use this option
a 24-bit addressing mode parameter list.
form
of
the
SYNCDEV
SYNCDEV
=
addr-A-type
specifies
=
maximum
specifies
This
number
not
specified,
to
0,
and
the
address
the
maximum
can
the
no
data
[DCB=addr] [,BUFBLK [,INQ ,MF=L
the
address
of
buffer depth
be
an
number
blocks
for
synchronization
can
be buffered as specified
in
31-bit residence mode; it requires
macro
operands
the
is
written:
= {maximum
= {YESINO}]
that
can
data
control
10
number
absolute
are
of
data buffered.
of
data
value
blocks
blocks
from 0
based
on
in
ABUFBLK
buffer
be specified for
block.
that
to
that
can
depthlO}]
can
65535.
be
buffered
the
number
the
be
buffered.
If
BUFBLK
of
or
list
form
defaults
is
INQ={YESINO}
specifies synchronization
YES
whether
specifies
specifies a data
an
blocks
this
is a
request
or a request
inquiry
request
that
as
for
can
be buffered as specified
for
information
for
synchronization.
to
how
many
data
synchronization
Chapter
4.
Controlling
blocks
based
about
are
on
the
in
BUFBLK.
the
I/O
the
degree
in
the
number
Device 29
of
buffer.
of
Page 45
MF=L
generates executable instructions. modified by
a 24-bit addressing-mode
the
execute form
The
parameter
list
can
be used as
of
the
SYNCDEV macro.
list
that
input
contains and
can
no
be
SYNCDEV-Execute
Note: Do not use this option
24-bit addressing-mode parameter list.
Form
The execute form
[symbol]
The
following describes
of
form
DCB =
ABUFBLK = addrlBUFBLK
SYNCDEV.
addr-A-type
specifies
specifies
ABUFBLK
specifies contains blocks
of
the
SYNCDEV
the
address
the
address
the
maximum
=
addr-A-type
the
address (on a halfword boundary)
a value
that
can
SYNCDEV
[DCB= [,{ABUFBLK = addrl BUFBLK [,INQ ,MF=(E,addr)
of
be buffered.
in
3I-bit residence mode,· it requires a
macro
addr]
= {YES INO}]
operands
or
(2
-12)
the
data
= {maximum buffer depthlO}
number
address
that
specifies
is written:
= {maximum buffer depthIO}]
that
can
be specified for
control
of
data
or
the
block.
blocks
(2
-12)
maximum
that
the
can
be buffered.
of
a halfword
number
execute
of
data
that
BUFBLK
INQ=
{YESINO} specifies synchronization
YES
= maximum buffer depth
specifies buffered. This The (2-12).
specifies
specifies a data BUFBLK.
Register 0 previous
the
BUFBLK
whether
or a request
an
request
blocks
contains
operation
maximum
number
value
this
is a request
inquiry
that
can
30 IBM 3480 Magnetic Tape Subsystem User's Reference
number can
can
be
for synchronization.
as
to
for
synchronization
be buffered as specified
the
number
completed successfully.
of
data
be
an
absolute
in
the
2 low-order bytes
for information
how
many
of
buffered physical blocks
blocks
data
based
that
value
about
blocks
on
in
can
be
from 0
are
the
ABUFBLK
to
of a register
the
degree
in
the
number
65535.
of
buffer.
of
or
if
the
Page 46
MF
= (E,addr)
specifies
the
execute
form
of
SYNCDEV.
Completion
Codes
addr-A-type
specifies list.
Note:
from
SYNCDEV
When byte contains a reason
the
of
register
system
Return Code
(15)
00 (hex 00)
04
(hex 04) (hex 04)
04
(hex 04)
04
address,
the
Do
not use this option in 3I-bit residence mode;
RX-type
24-bit addressing-mode
address,
or
(2
address
a 24-bit addressing mode parameter list.
returns
15
contains a return
code:
Reason Code
01
(hex
02
(hex 02)
03
(hex 03)
(0)
01)
control
to
your
problem program,
code;
the
low-order
Meaning
Successful completion. contains the Incorrect
Incorrect Environmental
the
control
parameter. DCB
number
unit
buffer.
or a DEBCHK
error.
-12)
for
byte
Register
of
data
the
parameter
the
of
blocks
error.
it
requires
low-order register
0
0
in
(hex 04)
04 04 (hex 04)
(hex 04)
04
(hex 04)
04
(hex 08)
08
12 (hex
OC)
(hex 04)
04 05
(hex 05)
11
(hex
12 (hex
OB) OC)
Incorrect Device does Unsuccessful Unsuccessful Permanent
ID
or
Permanent program
Note:
input
I/O
synchronize
I/O
with
If
you specified a in the CHECK macro after this error
occurs, your program cannot enter
SYNAD
the
to
NOTE.
not
support
call
to
ESTAE macro.
GETMAIN
error
command.
error
loss
of
DCB
and issue a
routine.
buffering.
request.
during
on
the
data.
SYNAD
read
last
PUT
block
channel
option
or
Chapter
4.
Controlling the I/O Device
31
Page 47
Obtaining I/O
Device
Use
the characteristics into
a specified area. (The processed before a a
checkpoint/restart
by
the
macro, see MVS/370 System Programming Library: Data Management
MVS/Extended
For
the
particular
The
-
Characteristics
DEVTYPE
DEVTYPE macro.
IBM
3480,
output
device
3480 (l8-track)
macro
of
an
I/O device
checkpoint
occurs.)
Architecture
the
DEVTYPE macro, device characteristics,
include:
instruction
For
and
to
results
of
a DEVTYPE
is
taken
The
IHADV A
further
System-Data
(DEVTYPE)
to
request
cause
should
information
information
this
information
macro
not
be considered valid
macro
Administration.
maps
about
relating
to
be placed
instruction
the
data
returned
the
DEVTYPE
and
to
the
after
or
Maximum
32760
-
DEVTAB (words
Not
-
RPS (word
Not
-
The
UCBTYP field for
'78008080' for full function mode
'33008003' for compatibility mode.
record
applicable
5,
applicable.
size (word
2,3,
in
hexadecimal)
the
and
4,
3480 is:
1,
in
in
hexadecimal)
decimal)
32 IBM 3480
Magnetic
Tape Subsystem
User's
Reference
Page 48
Chapter
5.
Displaying
The function display (except macro
MSGDISP
programming
is issued.
Messages
macro
the
allows you
support.
error
message
(MSGDISP)
to
display
Any
hardware-generated
CHK
a message
xy) is
overlaid
on
the message
when
3480
on
an
MSGDISP
using
the
full
Displaying
RDY)
a
Message
This
The
to
display a message.
that
The
7
of
in
parentheses.
console.
The
function
MSGDISP
is
allocated
text
supplied
the
message
following
from
displays
macro
and
in
the
display
The
is
an
example
any
an
application
with
the
The
display
opened by
TXT
while
message
of
User
program
RDY
parameter
request
the
program.
parameter
the
tape
text
is also logged
how
to
Program
message.
allows
can
be
issued
is displayed
data
set
is
open.
to
the
use
the
MSGDISP RDY macro:
(MSGDISP
every
user
program
to
any
tape
in
positions 2 through
The
text
is
tape
pool
operator
device
shown
Chapter
5.
Displaying Messages (MSGDISP) 33
Page 49
Example
of
How
to
Code MSGDISP RDY
DC
BOUT BUFFER SWITCH 1 DC CRITICAL
SAMP2
*
LPI
*
*
END
DCB DS
EQU
OS OPEN
MSGDISP LTR BNZ
WRITE CHECK TM BZ
SYNCDEV LTR BNZ MVI B
CLOSE
DDNAME=TAPEOUT,DSORG=PS,MACRF=(WP) CL800 X'00' X'01'
0H
(DCBOUT,(OUTPUT»
RDY,DCB=DCBOUT,TXT='OKAY 15,15 MSGERR
DECBOTl,SF,DCBOUT,BUFFER,800 DECBOTl SWITCHl,CRITICAL LPI
DCB=DCBOUT,INQ=NO,BUFBLK=0 15,15 SYNC
ERR SWITCHl,0 LPI
DCBOUT
WRITE SWITCH
OPEN DISPLAY A USER
I'
ALL
OKAY?
NO BUILD
SOME SWITCHI WRITE
CRITICAL NO
WAIT TO
BE
ALL
OKAY? NO RESET RETURN
CLOSE
BUFFER
FILE
BUFFER
BLOCKS
WILL
DATA
FOR
PHYSICALLY
SWITCH
TO
DATA
TO
MIGHT
BE
DATA
BLOCK?
ALL
DATA
LOOP
SET
MESSAGE
WRITE
SET
WRITTEN
BE
CRITICAL
TO
X'01'
IN
CU
BUFF
MSGERR SYNCERR
DS DS
0H 0H
MSGDISP
SYNCDEV
ERROR ERROR
RTN RTN
34
IBM
3480
Magnetic
Tape
Subsystem
User's
Reference
Page 50
MSGDISP-Displaying a Ready
The
MSGDISP
Message
macro
is
written:
[symbol]
RDY
specifies positions 2 display display is
descriptor
DCB=addr
specifies volume. directed
Note:
addr-RX-type
MSGDISP
that
text
through 7 of
is
steady
also
written
code
the
address
If
more
to
the
If
more than one device
supplied
(not
7).
than
device
RDY ,DCB=addr
[,
TXT
= {'msgtxt' I addr}]
in
the
the
display while
flashing)
to
of
a DCB opened one containing
and
the
tape pool console
device
or
TXT
parameter
is
enclosed
to a data
is
allocated,
the
volume
more than one volume is allocated,
you can update a message display after
condition by using the the case the open
specifies
of
a concatenated data set with unlike characteristics,
DCB
exit can
address, A-type address,
an
in-storage
EOV
be
used
address
exit specified
to
update the display.
or
of
the
be
displayed
the
data
set
in
parentheses.
(routing
set
on
the
message
currently
an
end-of-volume
in a DCB
(2
-12)
opened DCB.
is open.
code
the
mounted
display
in
use.
exit list.
in
The The
3,
is
In
TXT
=
{'msgtxt'
specifies TXT
'msgtxt'
addr-RX-type
laddr}
up
to
six
is
not
specified,
specifies apostrophes.
specifies be
the 1-to
address, A-type address,
an
displayed.
characters
blanks
6-character
in-storage
be displayed
are
displayed.
text.
address
of
in
positions 2 through
The
text
must
or
(2
-12)
an
area
containing
be
enclosed
the
text
7.
If
in
to
Chapter 5. Displaying Messages (MSGDISP) 35
Page 51
MSGDISP-Displaying a Ready
The
list
form
of
Message
the
MSGDISP
List
macro
Form
is
written:
[symbol]
RDY
specifies positions 2 through (not
flashing)
written
DCB=addr
specifies volume. directed
Note:
If you can update a message display after condition by the case the open
addr-A-type
specifies
MSGDISP
[RDY] [,DCB = addr]
,MF=L
[,TXT =
that
text
supplied
7 while a
and
is enclosed
to
the
tape
pool console
the
If
to
address more the
than
device
of
a DCB one containing
more than one device
using
of
a concatenated data set with unlike characteristics,
DCB
exit can
address
an
in-storage
{'msgtxt'I
in
the data in
parentheses.
(routing
opened
device is
or
the
EOV
be
used
address
addr}]
TXT
parameter
set
is open.
to a data
allocated,
the
volume
more
than
The
The
code
3,
the
currently
one volume is allocated,
an
exit specified in a
to
update the display.
of
the
opened
be displayed
display is
display
descriptor
set
on
message
the
in
use.
is
mounted
display
end-of-volume
DCB
exit list.
DCB.
in
steady
also
code
7).
is
In
MF=L
specifies that input
TXT =
specifies TXT is
'msgtxt'
addr-A-type
the
contains
to
and
{'msgtxt'
up
not
specifies apostrophes.
specifies be displayed.
list
form
of
MSGDISP.
no
executable
can
be modified by
I addr}
to
six
characters
specified,
the 1 to 6 character
address
an
blanks
in-storage
This
instructions.
the
execute
be displayed
are
displayed.
text.
address
of
an
generates a parameter
The
list
can
be used
form
of
the
macro.
in
positions 2 through
Enclose
area
the
text
containing
in
the
list
as
text
7.
If
to
36
IBM
3480
Magnetic
Tape
Subsystem
User's
Reference
Page 52
MSGDISP-Displaying a Ready
The
execute form
Message
of
the
MSGDISP macro
Execute
Form
is
written:
[symbol]
RDY
specifies positions 2 (not flashing) written
DCB=addr
specifies volume. directed
Note:
addr-RX-type
MSGDISP
RDY [,DCB = addr] ,MF
=
(E,addr)
[,TXT = {'msgtxt'laddr}]
that
text
supplied
through 7 while a data
and
is
enclosed
to
the
tape
pool console
the
address
If
more
than
to
the
device
If
more than one device
in
the
in
of
a DCB opened
one
device
containing
or
TXT
parameter
set
is open.
parentheses.
(routing
is
the
code 3,
to a data
allocated,
volume
be displayed
The
display is
The
display
descriptor
set
on
the
the
message display
currently
in
more than one volume is allocated,
you can update a message display after an end-of-volume
condition by using the the case the open
specifies
of
a concatenated data set with unlike characteristics,
DCB
exit can
address, A-type address,
an
in-storage address
EOV
exit specified
be
used
in a DCB
to
update the display.
or
(2
-12)
of
the
opened
DeB.
in
steady
is
also
code 7).
mounted
use.
exit list.
is
In
MF
= (E,addr)
specifies
be used.
addr-RX-type
TXT
=
{'msgtxt'laddr}
specifies TXT is
'msgtxt'
addr-RX-type
that
execute
address, (1),
specifies
not
specifies apostrophes.
specifies be displayed.
an
up
to
six
specified,
the 1 to 6 character
address, A-type address,
an
form
of
MSGDISP
or
(2
-12)
in-storage address
characters
blanks
in-storage address
be displayed
are
displayed.
of
text.
of
and
the
parameter
in
Enclose
or
(2
an
area
an
existing
positions 2
the
text
-12)
containing
parameter
list.
through
in
the
text
7.
list
If
to
Chapter
5.
Displaying Messages (MSGDISP) 37
Page 53
Displaying a Message
The
other
MSGDISP have a storage authorized
from
protect
program
Authorized
macros
facility (APF).
require
key
of 0 through
the
7,
Programs
program
or
to
be
authorized
be
in
supervisor
by
state,
the
The following
Displaying a
The
the
display contain label type. and
mounted.
Displaying a verify volume message
The mounted
Displaying a
The volume
Optionally,
demounted mount
functions
mount
MOUNT
the
VERIFY
DEMOUNT
messages
parameter
area
the
volume
The
device is ready.
parameter
volume
demount
serial
number
another
can
are
available
volume message
specifies
during a mount
serial
number
display flashes
The
displays
to
indicate
parameter
volume
also
be specified.
appear
that
volume message
displays a volume disposition
until
a volume is
to
alternately
for
that
request.
and
repeatedly
M is
the the
be
mounted
If
APF
authorized
an
M be displayed
The
next
the
last
character
until
the
not
displayed
serial volume was verified
demounted
this
option
on
the
if
number
instead
is used,
display.
the
of
programs:
in
six
characters
contains
volume
volume is
and
label
by
the
the
one
the
position 1 of
the
is
loaded
already
type
of
and
accepted.
indicator
operator.
to
be
demount
the
and
and
Resetting
The
previous any
Generalizing
The The to
be swapped
removes a
For
MVS/XA,
the
FORCE
quiescing greater
The
MSGDISP
routine.
a display
RESET
MSGDISP
waiting
GEN
parameter
messages
cartridge.
the
parameter.
with
multilevel
the
user's
macro
The
contents
parameter
hardware-generated
a display
can
either
IOSLEVEL (priority)
priority
clears
request
displays
be
steady
repeatedly
IOSLEVEL
quiescing;
to
generates a parameter
of
the
the
(an
one
or
control
parameter
display
asterisk
messages
or
two 8-byte messages
flashing. Two messages
or
at
the
of
the
support
the
higher
the
device.
list
Programming Library: Debugging Handbook
describes SVC
MSGDISP
can
routines.
be coded
in
the
standard,
execute,
of
any
appears
are
shown.
time
the
request
replaces
the
list
as
are
described
under
and
message
on
operator
can
single level I/O
IOSLEVEL value,
input
the
list
generated
the
display).
of
can
be
to
an
in
OSjVS2
section
forms.
any
content.
be
specified
inserts
specified
SVC
that
by a
Then
or
with
the
System
38 IBM
3480
Magnetic Tape Subsystem User's Reference
Page 54
MSGDISP-Displaying a Mount
The
format
for specifying MSGDISP
Message
with
the
MOUNT
parameter
is:
[symbol]
lIf
the
MF
used.
MOUNT
specifies during a mount and and the
UCB
=
addr-RX-type
specifies a
For
MVS/370
FORCE
= specifies while
MSGDISP
parameter
that
label
type.
ready.
M is
not
users:
whether
1/0 is
is
an
M be displayed
request.
The
If
the
device is
displayed.
address,
register
and
being
quiesced.
MOUNT
,UCB=addr [,FORCE [,LABEL = {'A'I'N'I'S'I'X'laddr}] [,MF [,SER = {'volser' [,TEXT={NOIYES}] [,WAIT
not
specified,
data
containing
when
= {NOIYESlnlkeywordl(reg)}]
= {LI(E,addr)}]l
I addr}]
= {NOIYES}]
the
standard
in
position 1 of
The
M is followed by a volume
flashes
or
repeatedly
ready
at
(2
-12) the
a display
the
UCB
request
form
until
time a mount
address
processes for a device
of
the
the
display
serial
a volume is
request
for
the
device.
macro
area
loaded is issued,
is
number
YES
For
MVS/XA
FORCE
specifies processed. for
If
specifies
1/0 is
specifies being
=
the
the
FORCE
being
quiesced.
users:
the
priority
The
display
that
a display
quiesced.
that
a display
(IOSLEVEL) for
higher
to
be processed.
parameter
request
request
the
IOSLEVEL
is
not
Chapter
cannot
processes for a device while 1/0 is
specified,
5.
Displaying
process for a device
the
1/0
of
the
value,
the
the
greater
default
Messages
request
the
is FORCE = NO.
(MSGDISP) 39
while
to
be
priority
Page 55
specifies
is
being
default,
YES
specifies
though
highest
n
specifies a decimal value. A device.
keyword
specifies a label
that
a display
quiesced.
as
indicated
that
a display
I/O is
being
priority.
high
The
in
quiesced.
number
number
equated
request IOSLEVEL is
the
request
cannot
process for a device
set
CVTIONLV field
processes for a device
The
IOSLEVEL is
from 1
to
9 be used as
indicates a higher
to
an
IOSLEVEL value:
to
the
of
priority
installation
the
CVT.
even
set
to
9,
the
IOSLEVEL
request
if
the
for
I/O
the
NORMAL QUIESCE 2 DAVV 3 DDR 4 DYNPATH UNCRSV CHPRCVY 7 SCHRCVY FDEV
(reg)
Specifies byte
For
all
users:
LABEL
=
specifies label type
If
an
unknown
displayed.
addr-RX-type
specifies or only
1
5
6
8
9
that a value
of
registers 2 through
of
label type
address, A-type address,
an
in-storage address
X (see
explanations
an
A-type address
the
mounted other
of 1 through
12.
volume be displayed
than a blank
of
below for
can
these
be specified.
or
an
9 be
(2
area
passed
in
is specified,
-12)
containing
characters).
the
low-order
in
position
a?
an
For
IS
A, MF
N,
= L,
8.
S,
40 IBM 3480
Magnetic
Tape
'A'
specifies (AUL) labels. Specify
'N'
specifies (BLP).
Subsystem
ISO/ANSI/FIPS (AL)
no
labels (NL), LTM (DOS),
User's
Specify
Reference
in
in
apostrophes.
apostrophes.
or
ISO/ANSI/FIPS
or
bypass label processing
with
user
Page 56
MF=
OS'
specifies IBM labels. Specify
'X'
specifies
specifies parameter
L
specifies list can of
the
(E,addr)
specifies
parameter
nonstandard
either
that
the
is
not
specified,
the
does
be used as
macro.
that
list
Standard
in
apostrophes.
execute
list
form
not
contain
input
the
execute form
be used.
(SL)
or
IBM
Standard
(NSL) labels. Specify
or
list
form
of
MSGDISP.
the
standard
of
MSGDISP.
any
to
and
can
form
This
executable
be modified
of
the
macro
of
with
user
(SUL)
in
apostrophes.
If
this
the
macro
generates a parameter
instructions.
by
and
is
the
execute form
an
existing
used.
The
list
addr-RX-type
specifies
SER=
specifies
number the not
attribute
addr-RX-type
'volser'
TEST
=
specifies
supports a message display before calling routine.
the
serial
is displayed
system supplies
available, a
indicates
specifies MF
= L, only
specifies
apostrophes.
if
the
address,
an
number
in
the
scratch
a default of PRIVAT.
address, A-type address,
an
in-storage address of
an
A-type address
the
volume
UCB is
(1),
in-storage address
of
positions 2
volume
volume
serial
to
be tested
or
(2
the
volume
through
serial
is
used, unless
number
to
-12)
of
the
to
be mounted.
7.
number.
or
(2
-12)
the
volume
can
be specified.
as a literal.
determine
the
parameter
If
SER
If
the
the
volume
serial
whether
message display SVC
list.
The
is
not
serial
use
number.
Specify
the
serial
specified,
number
in
device
is
For
YES
specifies
specifies
Note:
(IEFUCBOB) is
that
that
TEST=
the
the
YES
UCB is
UCB is
to
to
be
be
tested
tested
by
the
before
SVC
the
SVC call.
routine.
requires that the UCB mapping macro
to
be
Chapter
included
5.
Displaying Messages (MSGDISP)
in
the source code.
41
Page 57
WAIT
=
specifies
NO
specifies return same procedure.
when
codes
manner
control
that
control
are
as
is
returned
not
returned,
any
permanent
is
returned
to
the
caller.
before I/O is complete.
and
I/O
error
errors
by
the
are
error
recorded
recovery
I/O
in
the
MSGDISP-Displaying
The
lIf
used.
VERIFY
a
Verify
format
[symbol]
the
MF
specifies been remains processed.
specifies
that
control
is
Message
for specifying MSGDISP
MSGDISP
parameter
that
accepted
blank.
the
be displayed
VERIFY ,UCB=
[,FORCE [,LABEL = {'A'I'N'I'S'I'X'laddr}] [,MF
= {L I (E,addr)}]
[,SER = {'volser'laddr}] [,TEST [,WAIT
is
not
specified,
serial
number
in
The
display
returned
with
after
the
I/O is complete.
VERIFY
parameter
addr
= {NOIYESlnlkeywordl(reg)}]
1
= {NOIYES}]
= {NO I YES}]
the
standard
and
label
positions 2 through
continues
until
type
the
form
of
a volume
8.
next
of
the
Position display
is:
macro
that
1
request
is
has
is
42 IBM 3480
Magnetic
UCB
For
FORCE
Tape
=
addr-RX-type
specifies a
MVS/370
=
specifies being
quiesced.
specifies
I/O is
YES
specifies being
Subsystem
address,
register
containing
users:
whether a display
that
a display
being
quiesced.
that
a display
quiesced.
User's
Reference
or
(2
request
request
request
-12) the
UCB
address
processes for a device
cannot
process for a device
processes for a device while I/O is
for
the
device.
while
I/O
while
is
Page 58
For
MVS/XA
users:
FORCE
specifies processed. for
If
YES
n
keyword
=
the
The
the
display
the
FORCE
specifies is
being
default,
specifies though highest
specifies a value. A high device.
specifies a
priority
(IOSLEVEL) for
higher
to
the
be
processed.
parameter
that a display
quiesced.
as
indicated
that a display
I/O
is
being
priority.
decimal
number
label
equated
IOSLEVEL
is
not
specified,
request
The
IOSLEVEL
in
the
CVTIONLV field
request
quiesced.
number
The
from 1
indicates a higher
to
an
IOSLEVEL
the
I/O
value,
the
cannot
is
set
process
processes
IOSLEVEL
to 9 be
of
the
the
greater
default
to
the
ofthe
for a
used
priority
value:
request
to
the
is
FORCE
for a
device
installation
CVT.
device
is
as
even
set
to
the
IOSLEVEL
9,
request
be
priority
= NO.
if
I/O
the
for
the
NORMAL QUIESCE DAVV 3 DDR DYNPATH UNCRSV CHPRCVY SCHRCVY FDEV
(reg)
Specifies byte
1
2
4
5
6
7
8
9
that a value
of
register 2 through
of 1 through 9 be
12.
passed
in
the
low
order
Chapter
5.
Displaying
Messages
(MSGDISP) 43
Page 59
For
all
users:
LABEL
specifies
If
addr-RX-type
'A'
'N'
OS'
'X'
=
label
type
of
an
unknown
specifies or
X (see
only
specifies
(AUL) labels. Specify
specifies
(BLP). Specify
specifies IBM
labels. Specify
specifies
label
address, A-type address,
an
in-storage
explanations
an
A-type
ISO /
ANSI/FIPS
no
labels (NL),
Standard
Nonstandard
the
mounted
type
other
address below for
address
can
in
in
apostrophes.
in
apostrophes.
(NSL) labels. Specify
volume be displayed
than a blank
or
(2
of
an
area
these
be specified.
(AL)
or
ISO/
apostrophes.
LTM
(DOS),
(SL)
or
IBM
Standard
is specified,
-12)
containing
characters).
ANSI/FIPS
or
bypass
with
in
in
positi.on
a?
displays.
an
A, N, S,
For
MF
with
user
label
processing
user
(SUL)
apostrophes.
8.
= L,
MF=
SER=
specifies parameter
L
specifies
list can of
the
(E,addr)
specifies parameter
addr-RX-type
specifies serial
number specified, number use
is
attribute
either
is
that
be
the
not
the
does
used
execute
specified,
list
not
as
input
macro.
that
the
list
be used.
address, (1),
specifies
the
serial
an
number
is displayed
the
system
not
available, a
supplies
indicates a default
or
the
form
of
contain
to
and
execute
in-storage
of
in
positions 2 through
the
scratch
list
form
standard
MSGDISP,
any
executable
can
be modified by
form
of
the
or
(2
-12)
address
the
volume
volume
volume is used,
of
PRIV
of
MSGDISP.
form
of
which
macro
of
the
that
has
serial
AT.
If
this
the
macro
is used.
generates a parameter
instructions.
the
and
an
parameter
been
7.
If
number.
unless
execute
existing
list.
verified.
SER
is
If
the
the
The
list
form
The
not
serial
volume
44 IBM 3480
Magnetic
addr-RX-type
specifies MF
Tape Subsystem
= L,
User's
address, A-type address,
an
in-storage
only
an
Reference
address
A-type address
or
of
the
can
be specified.
(2
- 12)
volume
serial
number.
For
Page 60
'volser'
specifies apostrophes.
TEST=
specifies supports a message routine.
the
whether
volume
the
UCB
display
serial
is
to
before
number
be
tested
calling
as a literal.
to
determine
the
message
Specify
if
the
display
in
device
SVC
WAIT
specifies
YES
specifies
Note:
=
specifies
NO
specifies return same procedure.
specifies
that
that
TEST= (IEFUCBOB)
when
control
that
codes
manner
that
the
UCB
the
UCB
YES
is
control
are
not
as
any
control
is
tested
is
tested
by
the
before
SVC
the
requires that the UCB
be
included in the source code.
returned
is returned, permanent
is
to
returned
and
returned
the
before
I/O
error
after
caller.
I/O
errors
by
I/O
the
routine.
SVC
call.
mapping
is
complete.
are
recorded
error
is
complete.
macro
I/O
recovery
in
the
Chapter
5.
Displaying Messages (MSGDISP) 45
Page 61
MSGDISP-Displaying
The
a
Demount
format
for specifying
Message
MSGDISP
with
the
DEMOUNT
parameter
is:
[symbol]
lIf
the
MF
used.
DEMOUNT
specifies
until followed display
when
The
demount
next
volume by specifying
UCB
=
addr-RX-type
specifies a
MSGDISP
parameter
that
a volume
a volume is demounted. As
by
the
flashes
the
display
message
register
DEMOUNT ,UCB= [,DISP = {'D'I'K'I'R'laddr}] [,FORCE [,MF
[,MLABEL = {'A'I'N'I'S'I'addr}]
[,MSER [,SER = {'volser'l [,TEST [,WAIT
is
not
serial
number
repeatedly.
request
can
address,
containing
addr
= {NO IYES
= {LI(E,addr)}]1
= {'volser-to-mount' I addr}]
= {NOIYES}]
= {NOIYES}]
specified,
disposition
of
If
a volume is
is processed,
be
alternated
the
MSER
or
(2
-12)
the
the
standard
indicator
an
option,
the
volume
parameter.
UeB
In I keyword
addr}]
form
be displayed
the
indicator
to
be demounted.
not
mounted
blanks
display.
with a mount
address
for
I (reg)}]
of
the
macro
in
can
on
the
message for
the
device.
is
position
be
The
device
the
1
DISP=
specifies a
volume disposition.
addr-RX-type
specifies
(see an
'D'
Demount
Note: 'D' is also displayed when
'K'
Keep a private apostrophes.
character
an
explanations
A-type address
to
be
displayed
address, A·type address,
in-storage
a public volume. Specify
address
below for
can
be specified.
in
of
these
or when the volume use attribute is automatic volume recognition label).
volume
and
return
position 1 representing
or
(2
-12)
an
area
containing
characters).
in
apostrophes.
an
invalid character is specified
unknown
(A
VR)
error
it
to
the
library.
For
in
a D, K,
MF
= L,
(as
in
reading a
Specify
the
only
an
in
or
R
46
IBM 3480 Magnetic Tape Subsystem User's Reference
Page 62
For
'R'
Retain a private in
MVS/370
apostrophes.
users:
volume
near
the
device
for
further
use.
Specify
FORCE
specifies
being
NO
YES
For
MVS/XA
FORCE
specifies processed. for
If
=
specifies I/O
specifies being
=
the
the
FORCE
specifies is default,
whether a display
quiesced.
that a display
is
being
quiesced.
that a display
quiesced.
users:
the
priority
The
higher
display
being
to
be
parameter
that a display
quiesced.
as
indicated
request
request
request
(IOSLEVEL)
the
IOSLEVEL
processed.
is
not
request
The
IOSLEVEL
in
the
processes
cannot
processes
for
the
value,
specified,
cannot
CVTIONLV
for a device
process
I/O
of
the
the
default
process
is
set
field
for a device
for a device
the
request
greater
is
FORCE = NO.
for a device
to
the
installation
of
the
while
while
to
the
CVT.
I/O
while
I/O
be
priority
if
I/O
is
is
YES
specifies though
highest
n
specifies a decimal value. A high device.
keyword
specifies a label
NORMAL QUIESCE DAVV
DDR
DYNPATH UNCRSV CHPRCVY SCHRCVY FDEV
that a display
I/O
is
being
priority.
number
that
1
2
3
4
5
6
7
8
9
request
quiesced.
number
indicates a higher
equates
processes
The
from 1 to 9 be
to
IOSLEVEL
an
IOSLEVEL
for a device
is
set
used
as
the
priority
request
value:
even
to
9,
the
IOSLEVEL
for
the
Chapter
5.
Displaying Messages (MSGDISP)
47
Page 63
(reg)
Specifies byte
For
all
users:
MLABEL=
specifies following a demount
type
other
can
be specified
that a value
of
register 2 through
that
the
label
be
than a blank
only
if
of 1 through 9 be
12.
type
of
the
volume
displayed
in
is specified,
the
MSER
parameter
to position a?
is displayed.
passed
be
8.
in
loaded
If
an
the
and
unknown
This
is specified.
low
order
made
ready
label
parameter
addr-RX-type
'A'
'N'
'8'
'X'
MF=
specifies parameter
address, A-type address, specifies 'S', MF
specifies
an
in-storage
or
'X' (see
= L,
only
ISOjANSljFIPS
explanations
an
A-type
(AUL) labels. Specify
specifies (BLP). Specify
specifies labels. Specify
specifies
no
IBM
Nonstandard
either
is
not
labels
in
Standard
in
the
execute
specified,
(NL),
apostrophes.
apostrophes.
or
(2
-12)
address
address
in
(SL)
of
an
below
for
can
(AL)
or
ISOjANSljFIPS
apostrophes.
LTM
(DOS),
or
IBM
area
these
be specified.
or
bypass
Standard
(NSL) labels. Specify
or
list
form
of
MSGDISP.
the
standard
form
of
containing
characters).
with
label
with
in
apostrophes.
If
the
macro
an
'A',
For
user
processing
user
(SUL)
this
is
used.
'N',
48
IBM
3480
Magnetic
MSER=
Tape
L
specifies list can of
(E,addr)
specifies parameter
addr-RX-type
specifies the
demount
the
current
flashes
Subsystem
the
that
does
be
used
as
the
macro.
that
list
specifies
that a mount
message.
volume
repeatedly
User's
Reference
list
form
of
MSGDISP,
not
contain
input
to
and
the
execute
be used.
address, (1),
an
in-storage
message
The
two
is
demounted,
until a volume
any
executable
can
be
form
of
or
(2
-12)
address
for
the
messages
at
which
is
loaded
which
modified
the
macro
of
the
next
volume
continue
time
and
generates a parameter
instructions.
by
the
and
an
parameter
be
to
alternate
the
mount
ready.
The
execute
existing
list.
alternated
message
If
no
volume
list
form
with
until
is
Page 64
mounted message, only ready.
at
the
time
the
the
mount
demount
message flashes
message is processed
until
a volume is loaded
with
the
mount
and
addr-RX-type
'volser-to-mount'
SER=
specifies number system supplies available, a indicates
addr-RX-type
specifies
A-type address
'volser'
specifies
address, A-type address, specifies to
be mounted.
specified.
specifies as a literal. Specify
displays
paramater
apostrophes.
an
in-storage address
For
the
volume
the
serial
scratch
a default
number
in
positions 2
the
volume
volume is used, unless
of
PRIVAT.
address, A-type address,
an
in-storage address
is
not
valid
can
the
volume
MF = L,
serial
in
of
be specified.
serial
only
number
apostrophes.
the
volume
through
serial
number.
for
the
MF
number
or
(2
of
the
serial
an
A-type address
(of
to
7.
If
If
the
or
(2-12)
of
the
volume
= L form.
as a literaL
-12)
number
the
volume
be demounted.
SER
the
volume
is
not
serial
serial
For
Specify
to
specified,
number
use
MF
of
the
volume
can
be
be mounted)
The
serial
the
is
not
attribute
number.
= L,
This
only
in
an
TEST=
specifies supports routine.
YES
WAIT
specifies
NO
specifies
specifies
Note:
=
specifies return same procedure.
whether
a message display before
when
manner
the
UCB
that
the
UCB be
that
the
UCB be
TEST=
YES
(IEFUCBOB)
control
that
codes
is
control
are
not
as
any
is
to be
tested
tested
requires that the UCB mapping macro
be
included in the source code.
returned
is
returned returned, permanent
tested
calling
by
before
to
the
before 1/0
and
error
to
determine
the
message display SVC
the
SVC
the
SVC call.
caller.
1/0
errors
by
the
if
routine.
is
complete. 1/0
are
recorded
error
the
device
recovery
in
the
specifies
that
control
Chapter
is
returned
after
1/0 is complete.
5.
Displaying Messages (MSGDISP) 49
Page 65
MSGDISP-Resetting
The
the
format
Message
for
specifying
Display
MSGDISP
with
the
RESET
parameter
is:
[symbol]
lIf
the
used.
RESET
specifies WAIT =
the
After message
is ready).
UCB
=
specifies a
UCBL
specifies Each display address the to
MSGDISP
MF
parameter
that
all
NO
is
last
service
being
cleared,
for
the
addr-RX-type
register
=
addr-RX-type
the
address
word
contains
to
be
reset.
word
being
list,
register 1 points
the
caller.
RESET ,{UCB = [,FORCE = {NOIYESlnlkeywordl(reg)}] [,MF [,
TEST = {NO
[,
WAIT = {NO
is
not
specified,
existing
specified,
requested.
the
device (for example, a
address,
containing
address,
of a list
the
The
set.
addrl,UCBL
= {LI(E,addr)})1
the
data
on
the
display
display
or
address
list
If
to
changes
(2
-12)
the
A-type
containing a maximum
of a UCB
is
ended
an
error
the
subject
IYES}]
IYES}]
standard
the
display
does
message
UCB
address
address,
by
the
is
encountered
UCB
= addr}
form
of
the
macro
be
cleared.
not
clear
if a demount
to
show
the
indicating
for
(0),
or
(2
representing a device
high-order
while
when
control
internal
the
device.
-12)
of
64 words.
bit
If
if
in
processing
is
is
was
status
the
device
with
the
last
returned
a
50
IBM
3480
Magnetic
For
FORCE
Tape
UCBL
MVS/370
=
specifies being
quiesced.
specifies I/O
YES
specifies being
Subsystem
cannot
be specified
users:
whether a display
that a display
is
being
quiesced.
that a display
quiesced.
User's
Reference
with
TEST = YES
request
request
request
processes
cannot
processes
and
WAIT = NO.
for a
process
for a
device
while
for a device
device
while
I/O
while
I/O
is
is
Page 66
For
MVS/XA
users:
FORCE
specifies processed. for
If
YES
n
keyword
=
the
The
the
display
the
FORCE
specifies is
being
default,
specifies though
highest
specifies a
value. A high device.
specifies a
priority
(IOSLEVEL) for
higher
to
the
be processed.
parameter
that a display
quiesced.
as
indicated
that a display
I/O
is
being
priority.
decimal
number
label
equated
IOSLEVEL
is
not
specified,
request
The
IOSLEVEL
in
the
request
quiesced.
number
cannot
CVTIONLV field
processes
The
from 1
indicates a higher
to
an
IOSLEVEL
the
I/O
of
value,
the
the
default
process
is
set
IOSLEVEL
to
9 be
the
request
greater
to
the
of
for a
device is
used priority
value:
to
the
priority
is
FORCE
for a
device
installation
the
CVT.
even
set
to
9,
as
the
IOSLEVEL
request
be
= NO.
if
I/O
the
for
the
NORMAL 1 QUIESCE DAVV DDR DYNPATH UNCRSV CHPRCVY SCHRCVY 8 FDEV
(reg)
Specifies byte
2
3
4
5 6
7
9
that a value
of
register 2 through
of 1 through
12.
9 be
passed
in
the
low
order
Chapter
5.
Displaying
Messages
(MSGDISP)
51
Page 67
For
MF=
all
users:
specifies parameter
L
specifies
list
can
of
(E,addr)
specifies parameter
either
is
that
be
the
the
not
specified,
the
does
used
macro.
that
list
execute
list
form
not
as
input
the
be used.
or
the
of
contain
to
and
execute
list
form
standard
MSGDISP,
any
executable
can
be modified
form
of
the
of
MSGDISP.
form
of
which
macro
If
this
the
macro
is used.
generates a parameter
instructions.
by
the
and
an
The
execute
existing
list
form
TEST
WAIT
addr-RX-type
=
specifies supports routine.
specifies
YES
specifies
Note:
=
specifies
NO
specifies return same procedure.
address, (1),
specifies
whether
the
the
address
DCB is
to
of
be
a message display before
that
the
TEST= specified. macro
when
codes
manner
that
the
YES
(IEFUCBOB)
control
that
control
are
as
any
DCB be
DCB
TEST=
is
not
tested
be
tested
is not allowed
YES
returned
is
returned returned, permanent
or
(2
-12)
the
parameter
tested
calling
by
before
to
the
the
if
the UCBL parameter is
list.
determine
message
SVC
routine.
the
SVC call.
if
the
display
requires that the UCB mapping
be
included in the source code.
to
the
caller.
before
and
error
I(O
1(0
errors
by
the
is
complete.
are
recorded
error
recovery
device
SVC
1(0
in
the
52
IBM
3480
Magnetic
Tape
WAIT specified.
specifies
Note: Demount messages can
Subsystem
= NO is
specified.
User's
not
that
control
Reference
allowed
is
returned
when
be
the
DCBL
after
I(O is complete.
reset only
parameter
if
WAIT=
is
YES
is
Page 68
MSGDISP-Providing
The
the
format
Full
of
Range
MSGDISP
of
Display
when
specifying
Options
the
GEN
parameter
is:
[symbol]
1If
the
used.
GEN
specifies
UCB
=
specifies a
FLASH
specifies
Note:
MSGDISP
MF
parameter
the
full
addr-RX-type
register
=
how
to
If
VOL =
FLASH=ALT
GEN
,UCB= [,FLASH
BLINK
[,FORCE [,MF [,TEST [,
TXT = {'msgtxt'
[,
TXT2 = {'altmsgtxt' [,VOL = {STATICIREMOVEIINSERTISWAP}] [,WAIT
is
not
range
address,
containing
display
SWAP
addr
= {STEADYISTEADY21
IBLINK2 IALT}]
= {NOIYESlnlkeywordl(reg)}]
= {LI(E,addr)}]l
= {NOIYES}]
I addr}]
laddr}]
= {NOIYES}]
specified,
of
display options.
or
messages.
(2
the
-12) the
standard
UCB
form
address
for
of
the
the
is specified, messages are shown as
macro
device.
if
was specified.
is
STEADY
specifies flashing).
STEADY2
specifies flashing).
BLINK
specifies rate
BLINK2
specifies rate
ALT
specifies TXT2)
two
that
the
that
the
that
the
of
approximately
that
the
of
approximately
that
the
display
seconds
on
primary
alternate
primary
two seconds
alternate
two seconds
primary
alternately
and a half
message (TXT) be
message (TXT2)
message (TXT) flash
on
and a half
message (TXT2)
on
and a half
and
alternate
and
repeat
second
at a rate
off.
shown
be
flash
messages (TXT
steady
shown
repeatedly
of
steady
second
repeatedly
second
approximately
off.
off.
and
(not
at
at
(not
a
a
Chapter
5.
Displaying Messages (MSGDISP)
53
Page 69
For MVS/370 users:
FORCE
=
specifies being quiesced.
YES
For
MVS/XA
FORCE
=
specifies processed. for
If
the
whether
specifies
I/O is being quiesced.
specifies being quiesced.
a display
that
that
a display
a display
request
request
request
processes for a device while I/O is
cannot
processes for a device while I/O is
users:
the
priority
The
the
display
FORCE
specifies is being quiesced. The lOS LEVEL is default,
parameter
that
as
(IOSLEVEL) for
higher
to
indicated
the
be processed.
a display
IOSLEVEL value,
is
not
specified,
request
in
the
cannot
CVTIONLV field
process for a device while
the
I/O
of
the
request
the
greater
the
default
process for a device
set
to
is
FORCE = NO.
the
installation
of
the
CVT.
the
to
be
priority
if
I/O
YES
specifies though highest
n
specifies a decimal value. A device.
keyword
specifies a label
NORMAL 1
QUIESCE 2 DAVV 3 DDR 4 DYNPATH 5 UNCRSV 6 CHPRCVY 7 SCHRCVY 8 FDEV 9
that
a display
I/O is being quiesced.
priority.
high
number
that
request
number
from 1
indicates a higher
equals
processes for a device even
The
IOSLEVEL is
to
9 be used
priority
an
IOSLEVEL value:
set
as
the
request
to
9,
the
IOSLEVEL
for
the
54 IBM 3480 Magnetic
Tape
Subsystem User's Reference
Page 70
For
MF=
(reg)
Specifies byte
all
users:
specifies parameter
L
specifies list can of
(E,addr)
specifies parameter
addr
that a value
of
register 2 through
either
that
the
the
is
not
specified,
the
list
does
not
be
used
as
macro
that
the
list
specifies Specify of 2 through
either
of 1 through
12.
execute
input
be
an
or
list
the
standard
form
of
MSGDISP,
contain
execute
used.
in-storage address
12.
to
an
RX-type
any
and
form
9 be
form
of
form
executable
can
be modified
of
the
address
passed
MSGDISP.
of
the
which
of
generates a parameter
instructions.
by
macro
and
the
parameter
or a register
in
the
If
this
macro
the
execute
an
low
order
is used.
The
existing
list.
in
the
list
form
range
TEST
TXT
=
specifies supports routine.
YES
=
specifies display.
addr-RX-type
'msgtxt'
whether a message display before
specifies
specifies
Note:
the
that
that
TEST=
the
the
YES
UeB
UeB
UeB
(IEFVCBOB)
eight
characters
The
default
specifies characters.
specifies
an
the
for TXT is
address, A-type address,
in-storage
For
MF
eight
characters
is
to
be
tested
calling
be
tested
be
tested
requires that the
be
included in the source code.
be
shown
all
blanks.
address
=
L,
only
as
to
determine
the
message
by
the
sve
before
the
VCB
in
positions 1 through 8 of
or
(2
-12)
of
an
area
containing
an
A-type
literals.
address
Specify
if
the
device
display
routine.
sve call.,
mapping macro
the
can
be specified.
in
apostrophes.
sve
the
eight
TXT2=
specifies
8
of
the
eight
display.
alternate
The
default
characters
for TXT2 is
Chapter
5.
to
be
shown all
Displaying
in
blanks.
Messages
positions 1 through
(MSGDISP) 55
Page 71
addr-RX-type
'altmsgtxt'
VOL=
specifies status.
STATIC
REMOVE
address, A-type address,
specifies
an
characters.
specifies
specifies until command
specifies
the
the
the
manner
that
next
initiates
that demounted. mounted
at
in-storage
For
eight
in
address
MF
= L,
characters
which
only
messages display,
messages display
message
request
volume movement.
messages display
This
parameter
the
time
the
request
or
of
an
an
A-type
as
literals.
without
processes,
until
is
ignored
is processed.
(2
-12)
area
containing
address
Specify
regard
or
the
current
if
a volume is
based
to
until
the
can
be
specified.
in
apostrophes.
on
volume
volume
the
next
volume is
not
eight
status
WAIT
INSERT
specifies is position. ready
SWAP
specifies specified. repeat TXT2 flashes volume is data
=
specifies
NO
specifies return same procedure.
=
that
threaded,
This
at
the
that
until
mounted
flashes
when
control
that
codes
manner
messages display
and
the
active/inactive
parameter
time
the
request
messages
The
data
from TXT
the
current
until a new
when
until a new
is
returned
control
are
as
not
returned,
any
permanent
is
until
a volume is
is
ignored
switch
if
is
a volume is
is processed.
always
display as
and
TXT2
if
display
volume is demounted,
volume is loaded
this
parameter
volume is loaded
to
the
caller.
returned
before I/O is complete. I/O
and
I/O
error
and
processes,
and
errors
by
the
present,
in
the
FLASH
alternately
at
which
ready.
ready.
are
recorded
error
the
active
loaded
and
= ALT
time
If
no
only
TXT2
recovery
tape
was
and
only
in
the
specifies
that
control
56 IBM 3480 Magnetic Tape Subsystem User's Reference
is
returned
after
I/O is complete.
Page 72
Return
Codes from MSGDISP
When
one
of
Code
00(00)
04(04)
08(08)
control
the
following
is
returned
Meaning
Successful completion.
Device does
Unauthorized
authority DCB
Reason
01 02 03 04 05 06
11
12
to
the
caller
return
Invalid
Invalid Invalid
codes:
not
request
level)
or
or
UCB).
Code (in
Parameter Invalid Environmental Authorization
Unsuccessful Unsuccessful
DCB
UCB
request
support
of
MSGDISP,
MSGDISP.
(failed
invalid
Register
or
violation
ESTAE GETMAIN
0):
DEBCHK
error
TESTAUTH
input
parameters
error
macro
call
request
register
15
contains
for
proper
(including
12(OC)
If
you
a
pointer
specified
to
the
I/O
error
Note:
RESET
UCB
in
(I/O
An
I/O
display
UCBL
which
supervisor
posted
the
request
error occurs for load display
has
a hardware failure.
for
the
return
error
codes 4
was
found.
and
12,
for
an
error)
if
the drive
register 1 contains
Chapter
5.
Displaying Messages (MSGDISP) 57
Page 73
Modifying
MSGDISP
The
messages languages. and
VERIFY CSECT (IGXMSGOl) IGX00030. software-generated using
the
AMASPZAP
page
59). Some system
be
used
instead
message
table
for
Other
produced
For
the
parameters
The
CSECT is
of
in
IGXMSGOI
by
software
of
in
virtual
messages
service
components
the
entries
Languages
the
3480
drive
messages
the
MSGDISP macro,
storage
in
English; however,
to
another
aid
in
CSECT IGXMSGOl.
may
generated
as
program
supply
not
be used
language.
hardware
by
part
·of
the
you
(see
Figure 2 and
their
own
under
are
available
MOUNT,
all
constants extended
can
change
These
changes
messages
Modifications
these
circumstances.
in
several
DEMOUNT,
are
kept
in
SVC
routine
the
are
done
Figure 3 on
which
to
will
the
a
Note: Because some
single-character abbreviations (for example, M for mount), you
want
to leave them
IIZAPJOB
//***************************************************
11*
//***************************************************
IISTEPI
IISYSPRINT
IISYSLIB IISYSIN
NAME VER REP
Figure
JOB
,(USERID),MSGCLASS=A
SYSl.LPALIB(IGX00030) -CSECT:
EXEC DD DD DD
IGX00030
0020
E2C3D9E3,C3C8
0020
CIC2C3C4,C5C6
2.
Sample
of
the software messages consist
in
the
English
IGXMSG01
PGM=AMASPZAP SYSOUT=* DSN=SYSl.LPALIB,DISP=SHR
*
IGXMSG01
Message
Display
Language
version.
of
well-known
***
Modification
might
58
IBM
3480
Magnetic
Tape
Subsystem
User's
Reference
Page 74
Offset In
Hex 0 1 ( RDY identifier 2
3 4
5 6
7
8
9
A D DEMOUNT,DISP = D B K DEMOUNT,DISP C R DEMOUNT,DISP D E
F
10
11
12
13 14
Value
blank
) RDY
M blank blank blank blank blank blank
blank blank blank S SL N NL A AL label
X NSL label
?
Indicator
reserved
identifier
MOUNT
VERIFY
reserved RESET GEN reserved reserved
reserved reserved reserved
label
label
Unknown
Function
(also
BLP
label
= K = R
and
type
LTM)
20-25 26-2B PRIVAT SER/MSER
Figure
SCRTCH
3.
Description
SER/MSER
of
CSECT
default default
IGXMSGOI
Chapter
5.
Displaying Messages (MSGDISP) 59
Page 75
Page 76
Chapter
6.
Managing
The management, hierarchy different This storage under storage
Tape backup more migrate volume
Data
Facility
of
amounts
storage
devices,
OS/VS2
devices.
cartridges
volumes.
than
one
and
must
and
Hierarchical
backup,
storage
of
hierarchy
and
MVS
mounted
The
tape
backup
reside
on
Controlling
Storage
and
recovery devices data
stored,
includes
magnetic
JES2
or
on
migrate
volume.
versions
tape.
that
JES3,
3480
The
made
functions
have
and
different
direct
tape
devices. As a DFHSM
tape
and
backup
space
from
Data
Manager
different
access
can
drives
versions
manager
data
Sets
(DFHSM)
to
manage
costs
of
speeds
storage
can
sets
of devices (DASD),
continuously
automatically
be
used
of a data
can
designate
on a given
provides
data
sets storing accessing
as
data,
running
monitor
migrate
set
whether
primary
on
the
can
space
a
data.
mass
task
and
span
the
Specifying
Recycling
Esoteric
You of a mixture 3420 invalid unit USERUNITTABLE
Tapes
If
you
those
valid
deleted
The
RECYCLE volumes backup volume redefined from a 3420 versa.
Unit
cannot
esoteric
unit.
table.
regularly
volumes
data
on a tape
from
by
volumes,
is
successfully
as
specify
of
3480
names
If
DFHSM
For
more
perform
are
the
volume.
command
moving
enabling
an
unassigned
tape
backup
Names
an
esoteric
and
3420
you
have
rejects
information
parameter
volume
backed
the
up
backup
can
valid
recycled,
volume
volume
the
backup
unit
name
tape
devices.
already
of
many
consolidate
data
tape
all
esoteric
about
the
SETSYS
backup
times. As
decreases
sets
volumes
it
is
deleted
volume.
to
a 3480
defined
in a user
Do
unit
specifying
on
primary
the
from
the to
from You
tape
unit
not
add
because
names,
esoteric
command.
volumes,
this
occurs,
as
old
backup
valid
data
tape
volumes
be
used
DFHSM
can
move
spill
backup
table
3480
tape
DFHSM
there
unit
the
versions
on
tape
again.
control
valid
volume
that
consists
devices
rejects
is
no
user
names,
data
sets
percentage
are
backup
to
tape
spill
When
a
or
data
and
to
each
see
on
of
sets
vice
Chapter
6.
Managing
and
Controlling
Data
Sets
61
Page 77
Establishing
or
Changing
the
Values
ofDFHSM
Control
Parameters
(SETSYS)
When established one used with current Verification
of
If
automatic advantage command.
Do Except SETSYS command specific parameter
The
or
when specific
Version
how
you do
not
3480
you
start
by defaults. You
more SETSYS commands
you
defaults
Procedure
2 Release 3.0 Installation
to
set
not
space
of
confuse DFHSM for
certain
parameter
is
has
DFHSM, a
start
DFHSM.
parameter
until
up
the
ARCMDxx
specify
the
the
changes
the
management
automatic
values,
has
value
default.
subset
values
you
restart
in
Data Facility Hierarchical Storage Manager:
SETSYS command,
functions
defaults
there
no
required
for
to
the
of
DFHSM
can
override DFHSM
in
the
ARCCMDxx P ARMLIB
You
could
then
after
DFHSM
DFHSM. See
and
Customization Guide for
PARMLIB member.
or
backup.
with
are
the
SETSYS command,
parameters
Therefore,
of
DFHSM, use
the
SETSYS
no
SETSYS command defaults. A
parameters,
listed
control
defaults
issue
is
started
DFHSM
DFHSM
command
so,
unless
in
the
parameters
by specifying
the
SETSYS
to
change
Installation
does
not
if
you
want
the
SETSYS
you
the
DFHSM
following sections.
is
member
command the
an
example
do
any
to
take
defaults.
indicate
control
a
Specifying
Specifying
the
the
Tape
Type
Density
Explanation: tape
density
mounted.
If
you specify a
it.
of
Unit
Explanation: UNITN an
optional
the
first time DFHSM
The
types
3400-4, 3400-5, 3400-6, 3400-9, 3480,
USERUNITT when
3480
when
Abbreviations: UNITNAME.
When
DENSITY(21314) is
to
specify
for
AME(3400-3
parameter
of
units
ABLE
your
3480 subsystem
you use all
There
density
Mounting a Scratch
you
parameter
The
Allocating
the
first
time
of
2,
3,
or
13400-4 13400-5
identifying
requests
can
the
TSO
are
no
that a scratch
request
of
simulates
functions
abbreviation
additional
Scratch
an
optional
DFHSM
4 for
the
Tapes
parameter
requests
3480 subsystem,
Tape
13400-6
the
or a name
the
13400-913480
type
of
unit
tape
for
mounting
you specify
SETSYS command.
your
3420
tape
of
the
3480 subsystem.
convention
abbreviations.
(DENSITY)
identifying
that a scratch
DFHSM
(UNITNAME)
I (esoteric
that
be
mounted.
the
scratch
drives.
applies for
should
unit
be
tape
in
the
You
specify 3400-9
You
which
tape
ignores
name) is
specified
are
3400-3,
specify
be
62
IBM
3480
Magnetic
SETSYS
Tape
Subsystem
Defaults:
User's
None.
Reference
Page 78
DFHSM
command,
Defaults:
the
DFHSM
If
you
do
default
not
specify
is 3400-6.
this
parameter
on
any
SETSYS
You cannot specify an esoteric
must
represent tape.
does
not
use
UNITNAME
mounted
same
also
while
continuing
unit
the
volume was
specify DENSITY
for
that
type of
DFHSM
have
when
USERUNITTABLE
Unit
uses
an
esoteric
identified
parameter.
you specify
Name
to
and
unit.
from
UNITNAME,
If
the
highest
unit
the
esoteric
the
with a previous
DFHSM
Specifying
Esoteric
Note:
DFHSM be
the
If
you density DENSITY,
If
you specify must USERUNITTABLE parameter specified startup.
Tape
(USERUNITTABLEINOUSERUNITTABLE)
Explanation: mutually to
DFHSM.
USERUNITTABLE(unit:
exclusive,
optional
parameters
unit
when
another
mounted
you
name
You
UNITNAME
on.
specify
density
with
unit
can
name that represents
it
requests volume.
the
UNIT
for
the
UNIT
name
specify
parameter
SETSYS
...
)\NOUSERUNITTABLE
specifying
that a scratch
Instead,
density
the
the
must
and
do
not
specified
NAME
to
DFHSM
USERUNITTABLE
esoteric
parameter,
or
you
command
tape
DFHSM
match
specify
with
DASD;
unit.
could
during
unit
it
volume
uses
the
you
the
have
this
are
names
USERUNITTABLE identified units least
NOUSERUNITT identified in
effect.
Abbreviations: USERUNITTABLE abbrevia
SETSYS
DFHSM
command,
you
one
tions.
Defaults:
to
DFHSM.
want
to
unit.
ABLE specifies
to
DFHSM.
Defaults:
the
DFHSM
The
specifies
use.
TSO
and
None.
If
all
the
For
unit..., specify
If
you
specify
that
Any
previously
abbreviation
NOUSERUNITTABLE.
you do
default
not
specify
is NOUSERUNITTABLE.
esoteric
the
this
parameter,
no
esoteric
defined
convention
this
tape
unit
esoteric
tape
esoteric
applies for
There
parameter
names
names
you
must
unit
names
are
on
to
of
all
specify
names
are
no
additional
any
be
the
tape at
are
to
no
longer
SETSYS
be
Chapter
6.
Managing
and
Controlling
Data
Sets
63
Page 79
Note: You
any tape written by any other tape
esoteric group.
all esoteric tape
remove from a subsequent system I/O generation those esoteric
names
DFHSM
specified when you issued the
must
make sure
DFHSM
that
the tape
DFHSM
unit
does not verify this for you. You
names
already used
during
during
unit
you specify can read
unit
that belongs
system I/O generation. Do not
its tape processing.
cannot allocate the tape volume whose esoteric
ADDVOL
command.
to
the same
unit
and
must
unit
If
you do,
name you
write
define
Adding
or
(ADDVOL)
Because 3420 3480 unit specify USERUNITTABLE, with previous unit previous user table.
DFHSM
tape
subsystem
name,
this
table
unit
Changing
You
issue
that
DFHSM
change You to level 1 volumes
the
must
manage
esoteric
simulates
it
does
parameter
SETSYS
is
rebuilt.
user
unit
table
until
the
the
ADDVOL
manages
attributes
issue
the
or
own.
again
rejects
unit
not
USERUNITT
names
reject
replace
However,
table
is
it
has
mixed
to
a 3420
the
the
any
still
verified
Volumes
command
or
owns.
of a volume ADDVOL In
addition,
each
command
time
esoteric
include tape
rest
valid
esoteric ABLE command. if a GETMAIN valid,
unit.
of
the
esoteric
because
all
the
unit
the
If
user
tape
entries
names, do
3480
DFHSM
tape unit
DFHSM
Managed
to
add
new
volumes
You
also issue
that
DFHSM
for
each
you
must
respecify
you
start
DFHSM.
tape
unit
unit
names
In
failure
in
by
the
ADDVOL
already
volume
primary
not
change
devices
rejects
table.
other
the
Each
names
identified
words,
occurred,
does
not
new
user
DFHSM
to
the
list
manages
you
want
and
your
even
if
your
an
esoteric
time
identified
with
the
user
the
replace
unit
of
volumes
command
or
owns.
DFHSM
migration
you
a
the
to
Specifying
64
IBM
3480
the
Type
Magnetic
of
Device
Explanation:
of
unit
on
which
For
unittype,
mounted. with specify 3400-9 You
Abbreviations:
There
Defaults:
Note:
The
the
USERUNITTABLE
specify 3480
are
no
None.
If
you specify an esoteric
table, the command fails.
Tape
Subsystem
(UNIT)
UNIT(unittype) is a
the
volume
substitute
valid
types
when
the
when
The
TSO
additional
User's
Reference
can
the
type
of
units parameter
3480
subsystem
you
use
abbreviation
abbreviations.
required
be
mounted.
of
unit
for
all
the
unit
name that does not exist
parameter
on
which
the
3480 are: 3480
of
the
SETSYS command.
simulates
functions
convention
of
specifying
the
volume
your
3420
the
3480 subsystem.
applies for UNIT.
can
or a unit
tape
in
the user
the
type
be
specified
You
drives.
unit
Page 80
Specifying
the
Tape
Density
(DENSITY)
Explanation: DENSITY(21314) is
density
If it.
of
the
tape backup volume.
you specify a density
of
2,
3,
or
an
optional parameter specifying
4 for
the
3480
subsystem, DFHSM ignores
the
Chapter
6.
Managing and Controlling
Data
Sets 65
Page 81
Page 82
Chapter
7.
Recording
Error
or
Statistical
Information
Using
Using
EREP
Error
Reports
Some
of
the errors printing,
The SYSl.LOGREC to aid and compatibility in
and
error
the
processor.
the
service
OBR
the
EREP
statistical
and
records
records
Recovery
Error
recovery
the
3480.
The
With
the
3480,
the
control
error
symptom
maintenance
system
(OBR
contain
An
representative
have
modes.
system
of
information
exception
records)
the
error
the
same
Error
exception
Procedures
procedures
format
most
unit.
code,
of
For
of
the
this
ERP
(ERPs)
the
tape
reason,
programs
the
3480
reports
and
32
sense
code is
in
locating
format
records
reports.
error
error
subsystem
recorded
are
statistics
bytes
included
the
for full
from
different
(ERP)
support
messages
recovery
and
because
are
simplified.
relies
by
the
included
records
that
the
in
the
cause
function
the
new
has
been
sequences
the
on
the
processor.
in
EREP.
(MDR
3480
control
sense
byte
of
the
unit
and
systems
sense
control
can
byte
changed
are
unit
records
Editing,
records)
information
3420
structure
slightly.
initiated
of
unit
sends
check.
be
combined
provides
in
by
to
MDR
of
an
Using
IMS/VS
Logging
IMS/VS tape-write-immediate mode (DCB = OPTCD = W) for should
continue
IMS/VS is
an
has
carefully
to
Release
ideal
device for
not
place
changed
evaluate
log
data
1.3
replaces
archiving
Chapter
any
code for
the
effect
on
unbuffered
the
7.
the
of
this
log
tape
the
1MS
Recording
3480
but
on
performance.)
tape
drives.
with a disk
disk
log.
Error
or
you
might
the
log
log
data
Statistical
want
to
tape.
(You
You
can
set.
The
Information
use
3480
67
Page 83
Page 84
Chapter
8.
(DFSORT)
Restrictions
The
following subsystem, DFSORT always uses buffered mode for writing
input
to
Using
information
and
output
is
the
tapes.
Sorting
support
Applications
for
IBM
DFSORT.
both
For
reading
the
and
3480
SORTWKnn
SORTOUT
DD
DD
statement
The
SORTWKnn used
as
intermediate
indicate
Note: The Sort program prior
the
SORTWKnn
the
DD
location
statements storage of
Statement
The
SORTOUT DD which location.
Note:
the
If standard labeled tape, the the OPTCD = W should not specified for a full function If (specified in
performance might
sorted
LABEL = RETPD
DCB
it is specified for a
statement
or
merged
parameters
JCL
describe
areas
for
these
data
sets.
to
Release
files.
describes
records
is specified in the
DCB
are.
not specified, the tape can
be
specified for a
3480
3480
operating in
as
3400-9),
be
the request is not overridden,
reduced.
the
characteristics
records
the
are
to
parameters must also
tape unit, the request is overridden.
to
be
sorted;
7.0
does not accept 3480 devices for
characteristics
be placed,
SORTOUT
3420
and
3480
tape unit.
compatibility mode
of
the
they
also
of
the
data
indicates
DD
statement for a
be
specified.
be
opened twice.
If
but
data
its
it is
sets
set
in
If
Chapter
8.
Restrictions
to
Using
Sorting
Applications (DFSORT) 69
Page 85
Page 86
Appendix
A.
Data
Data characteristics described DCB program dummy that program the
The and contents
Control
control
macro
through
control
contain
inserts
low-order
contents
access
of
block
and
show
the
instruction.
the
section
addresses
an
three
of
some fields
method
the
field
Block
fields
contain
device
values
These
use
of
(DSECT) for
are
address
bytes
of
being
used. A
are
not
Symbolic
information requirements that
result
a DCBD
aligned
into
the
in
the
common
from specifying
fields
can
macro
the
on
fullword
a field,
field
without
data
separate
to
for a
be
referred
instruction
data
control
the
address
changing
control
description
all
device
Field
that
defines
data
set.
various
to
block.
boundaries.
must
block
depend
is
types
Names
the
Each
by
the
that
creates
Four-byte
If
be
inserted
the
high-order
on
provided
and
access
data
of
the
options
problem
the
problem
the
when
fields
in
the
a
fields
into
byte.
device
the
methods.
Appendix A.
Data
Control
Block
Symbolic
Field
Names
71
Page 87
Magnetic
Tape
Interface
Bytes
Offset
16(10) 1 DCBTRTCH
17(11)
18(12)
Alignment
.1
.. 1
and
Field Name
0010 0011
0011
1011 0001 0011 0010 1011
DCBDEVT 1000 0001
1000 0011 1000 0000
DCBDEN
Description
Tape
recording
for
7-track
Code
E
T
C
ET
Device type. 2400
unit for
3400 unit 3480 Subsystem
Tape tape
Even BCD/EBCDIC Data Even translation
series
(7-track
MVS/370 only)
series Magnetic
density
units*
technique
tape
parity
conversion
parity
magnetic
or
9-track,
magnetic
Tape
of
magnetic
translation
and
tape
tape
0000 0011 0100 0011 1000 0011 1100 0011
1101 0011
*
For
3480s
applicable.
indicates
0011'
Code
o
1 2
3
4
operating
For
3480s
the
data
7-track
200 556 800
Not
Not
in
full
function
operating
set
is
BPI BPI BPI
applicable
applicable
in
3420
to
be
processed
9-track
Not Not
800
1600
6250
mode,
the
compatibility
in
applicable applicable
BPI
BPI
BPI
DCBDEN
tape-write-immediate mode.
mode,
parameter
the
value
is
not
'1100
72 IBM
3480
Magnetic Tape Subsystem User's Reference
Page 88
Appendix
B.
Programming
Messages
and
Codes
Return 3480
ABEND for
the
Code
from
For
further
User's Guide.
Code (Hex)
28
Completion
3480
Code (Hex)
03F
the
CHKPT
information
Meaning
I/O
error
Codes
Meaning
(MVS/370 only) set
on
a 3480 occurred the
media
Macro
about
during
checkpoint/restart,
SYNCDEV
Issued
System
subsystem
while
writing
(deferred-write
Instruction
see
Checkpoint/Restart
caused
by
Checkpoint/Restart
abend
could
data
from a
error).
code not
by a user
03F
indicates
be
synchronized.
previous
data
that a user
channel
for
set.
An
program
the
I/O
data
error
to
ABEND
33F
Return
The
can
Message Library: Messages for
messages
(MVS/XA set occurred the
Codes
ABEND
occur
with
and
only)
on
a 3480
while
media
return
the
any
(deferred-write
codes for
3480
block
System Messages
complete
other
System
subsystem
writing
the
count
text
of
return
codes
Appendix B.
abend
data
following
checking.
the
code
could
not
from a previous
error).
or
MVS/370
messages
associated
Programming
33F
indicates
be
synchronized.
messages
See
reflect
MVS/Extended
Message Library: System
and
explanations
with
the
Messages
that a user
channel
conditions
message.
and
data
An
I/O
error
program
that
Architecture
of
the
Codes
to
73
Page 89
Message
Code
(Hex)
IEC022I
Meaning
137-rc
18
38
Message
Code
(Hex)
OC
Message
Code
(Hex)
38
Message
An
I/O
error
occurred magnetic Block ID command used
An to
establish
IEC023I 237-rc
Meaning
The of
blocks processed
IEC145I 413-rc
Meaning
An to
establish
IEC210I 214-rc
I/O
block
I/O
tape
error
count
error
data
occurred
the
tape
in
occurred
the
tape
set
position.
the
as
position.
while
the
system was
at
the
first
to
establish
during
DeB
determined
during
a Read
does
a Read Block ID
data
not
by
record
the
tape
Block
match
the
position
positioning
or
on a Read
position.
ID
command
the
actual
of
the
command
a
used
count
tape.
used
Code
(Hex)
OC
10
Message
Code
(Hex)
38
3C
Meaning
An
I/O
error
occurred to
establish
The
block
of
blocks processed
IEC218I 117-rc
Meaning
An
I/O
to
establish
The
block
of
blocks processed
count
error
count
the
occurred
the
tape
in
tape
in
during
position.
the
DeB
as
determined
during
position.
the
DeB
as
determined
a Read Block ID
does
not
match
by
the
position
a Read Block ID
does
not
match
by
the
position
command
the
actual
of
command
the
actual
of
the
the
used
count
tape.
used
count
tape.
74 IBM 3480
Magnetic
Tape Subsystem User's Reference
Page 90
Glossary
This
glossary abbreviations, publication. established systems; are
looking
Vocabulary for Data Processing,
Telecommunications,
This
glossary
The
Information Processing,
Computer Manufacturers reproduced Dictionary copyright Equipment of
which National New
are
defines
It
for
therefore,
for,
includes
the
and
acronyms
does
not
include
the
IBM System/370
if
you
refer
to
the
and
definitions
special
that
do
not
index
Office Systems, GC20-1699.
American National Dictionary for
published
and
from
for
1977
Manufacturers
may
Standards
York,
New
identified
Business
Association.
the
Information
by
be
purchased
York
by
American
the
Computer
Institute,
10018.
an
asterisk
Equipment
terms,
are
used
all
terms
or
its
operating
find
the
term
or
to
the
from:
by
the
This
material
National
Processing,
and
Business
Association,
from
the
American
1430
Broadway,
These
definitions
(*).
in
this
previously
you
is
copies
of
the
drive
and
allows
of
premounted
loading
of
tape
single
cartridges,
tape
backup-and-recovery
short-term restoring vital system
basic
access in a continuous access
beginning
magnetic permissible
block.
recorded interblock one
retention
essential
data
has
errors
sequential
method
or a direct
of
tape
* A
as a unit.
gaps (IBG)
or
more
business
been
lost
or
malfunctions.
access
for
storing
sequence,
access device.
tape.
that
indicates
recording
collection
records.
of
Blocks
both
the
cartridges.
application.
records
and
because
method
or
retrieving
using
* (ISO)
area.
of
contiguous
are
and
each
The
the
automatic
and
the
to
be system of
program
manual
The
used
files
loading
for
when
or
(BSAM). An
data
blocks
either a sequential
location
beginning
separated
block
on
records
by
may
contain
of
a
the
The
ISO
developed Organization, Subcommittee sections symbol (ISO) Definitions papers vocabulary
symboll(TC97)",
agreement participating
access
between
archiving
in
machine-readable
of
under
method.
processor
application.
argument.
independent
automatic
3480
tape
variable.
cartridge
drive.
Vocabulary
by
the
International
Technical
1.
Definitions
this
vocabulary
preceding
from
draft
development
subcommittee
indicating
has
not
members.
A
technique
storage
form, for
(1)
* (ISO)
loader.
This
feature
of
Data Processing,
Committee
from
are
the
definition.
proposals
by
the
are
that
yet
been
reached
for moving
and
input/output
The
retention
historical
Any
value
A
attaches
Standards
97,
published
identified
and
working
ISO/TC97
identified
final
among
of
purposes.
of
an
feature
to
for
the
by
the
by
the
its
data
devices.
records,
the
front
BOT.
BSAM. buffer.
for a difference occurrence one
capacity. CCW.
channel. channel
data operation
channel
the channel the operations.
Beginning
Basic
* A
device
Channel
command.
channel,
or
command
location
address
channel
routine
of
to
See
See
set
in
program
of
tape.
sequential
or
in
rate
events,
another.
control
media
command
data
channel.
of
operations.
when
capacity.
An
unit,
word (CCW). A
main
storage
word. One
that
access
storage
of
flow
transferring
word
instruction
or
specified by
or
directs
method
used
of
data,
device
more
data
to
compensate
or
time
data
that
directs
to
perform
doubleword
the
CCW s
make
channel
Glossary
of
from
a
an
at
up
75
Page 91
channel signals and
channel channel and
channel that input/output
command.
contingent device owes a because
conversion. method data
CSW.
data. * Any analog assigned.
path. A communication
can
be
I/O devices.
path
paths
an
I/O device
status
provides
of a unit
of
data
processing
Channel
quantities
sent
between a controlling
group. A group
over
which
can
communicate.
word
(CSW).
information
operations.
See
channel
allegiance.
response
The
processing
system
status
representations
check.
process
to
which
to
to
word.
of
the
controlling
An
about
the
command.
A
condition
a specific
of
changing
to
another
another.
such
meaning
path
along
computer
identified
computer
area
in
storage
termination
in
which
channel
from one
or
from
as
characters
is,
or
might
which
a
path
one
of
or
be,
not
refer
to
the
indication.
disband channel
drive a
tape tape position.
dump. a
part to a external to faults
dynamic facility
moved, abnormally initial
effective
bytes
ERP.
group.
path
loaded. A condition
reel
or
has
been
(ISO)
of
storage,
allow
other
or
errors,
device
that
allows a
and
repositioned terminating
program
recording
per
unit
Error
command
To
group.
cartridge
threaded
To
write usually
medium, for a specific
use
of
or
reconfiguration
load
of
length
recovery
that
remove
of a tape inserted to
the
the
contents
from
storage,
in
connection
demountable
if
necessary,
the
job
procedure.
density.
of
the
procedures
receives
the
grouping
in
beginning-of-tape
an
as a safeguard
with
or
The
recording
the
drive
the
drive
of
storage,
internal
purpose
debugging.
(DDR).
volume
without
repeating
number
medium.
of
a
in
which'
and
or of
storage
such
against
A
to
be
the
of
user
the
as
data
base.
for a
given
system.
data
channel.
and
main
data
control
by
access
data.
data
set.
retrieval,
several control
DCB.
DDR.
data online determined user. another Contrast
deferred device controlling event channel
prescribed information
Data
Dynamic
migration.
device
(2)The moving
I/O device
returns a unit
that
commands.
(TC97) A
purpose
storage
block
method
The
consisting
control
to
by
the
with
staging.
unit
check. A condition
computer,
occurred
set
or
for a
A device
with
(DCB). A control
routines
major
unit
of a collection
arrangements
to
block.
device
(l)The
an
offline
system
of
with
check
which
asynchronously
The
of
data
that
given
data
that
connects a processor
I/O
control
in
of
which
reconfiguration.
moving
or
or
data
different
deferred
units.
storing
data
storage
of
and
the
system
of
data
low-priority
as
requested
from
an
characteristics.
in
indication
pertains
unit
is
sufficient
processing
block
and
retrieving
and
data
in
described
has
from
device,
by
I/O device
which for
the
to
an
error
with
the
check
used
one
of
by
access.
an
as
the
to
a
an
may
error
recovery
designed
recover are record
EXCP.
extended caused the
from
extended controlling retrieves issues a tape
file.
unit, consist
format.
on a data
interchange tapes local another
JCL language
to
from
often
used
the
statistics
Execute
contingent
by a permanent
drive
responds
which
contingent
the
* (ISO) A
for example,
of a set
* (ISO)
medium.
for
use on
or
remote,
system.
(job
control
designed
procedures
help
isolate
errors
in
in
conjunction
channel
only
the
write
computer
unwritten motion
set
of
in
of
invoices.
The
application.
other or
the
language).
to
(ERP).
and,
where
equipment.
with
of
machine
program.
allegiance. A condition
buffered-write
to
the
channel
command
allegiance
in
the
channel
data
from
command.
related
stock
arrangement
systems
express
use
records,
control,
The
or
of
tape
statements
Procedures
possible,
The
procedures
programs
malfunctions.
error
path
was
received.
continues
the
preparation
devices,
data
* A
until
path
group
buffer
treated
a file
could
or
layout
either
prepared
problem-oriented
in a job
to
that
in
which
group
The
a
or
as a
of
of
data
by
76
IBM
3480
Magnetic
Tape
Subsystem
User's
Reference
Page 92
that
are
used
requirements
journalizing.
data
set
so applying previous
load
magnetic
logical
written
magnetic storing magnetizable
transactions
version
point.
tape.
end-of-tape. A point data
recording.
data
to
identify
to
an
Recording
that
the
of
The
normally
by
selectively
material.
the
operating
data
set
in
the
the
data
beginning
ends.
* (ISO) A
job
or
describe
system.
transactions
can
be
reconstructed
journal
set.
of
the
recording
on
the
technique
magnetizing
against
against
tape
portions
its
a
area
where
of
QSAM.
queued
a
by
on
of
a
extended method is formed processing processed storage
quiesce. rejection
read-ahead main obtains requested
Queued
sequential
version
(BSAM).
of
or
and
or
to
To
of
storage
work
by
sequential
access
of
the
When
input
data
blocks
output
an
bring a device
new
queue.
from units
the
data
are
awaiting
output
requests
In
which
in
application.
advance
access
method
basic
sequential
this
method
that
blocks
device.
for
ACF/TCAM,
an
that
transfer
,pr
system
work.
application
of
their
method.
(QSAM).
access
is
used, a
are
awaiting
have
to
auxiliary
to a halt
an
area
program
being
been
of
An
queue
by
a
magnetic surface magnetic
magnetic moving
media contained expressed
migration.
OBR.
outboard pertinent unrecoverable
physical which
primed. when drive
processing systematic data
tape.
layer
recording.
tape
magnetic
capacity.
on a storage
in
Outboard
recorder
data
end-of-tape.
the
tape
Pertaining
the
controlling
but
the
sequence
to
accomplish
application.
(TC97) A
on
which
drive.
tape
bytes
See
conversion.
recorder.
on
the
I/O
is
not
drive
tape
with a magnetizable
data
can
be
(ISO) A
and
The
amount
medium,
of
data.
(OBR). A feature
system
error
occurs.
A
permitted
to a condition
computer
was
not
of
operations
a specific
mechanism
controlling
of
such
recorder
point
on
to
has
in a ready
The
completion
purpose.
stored
its
movement.
data
that
as
tape,
that
file
the
tape
move.
of a tape
addressed
state.
performed
by
for
can
records
when
beyond
drive
the
of
a
on
be
an
record. words, control,
synchronization. activities subsystem buffer position
tape
that container.
task
constructed support allocated
TIOT.
volume.
together conveniently is
mounted
reel
* (ISO) A
treated
each
of
to
is
empty
for
cartridge.
can
be
processed
I/O
table
routines
devices.
Task
(l)(ISO) A
with
and
of
magnetic
invoice
the
obtain
the
by
I/O
its
as a unit.
collection
as a unit;
could
The
controlling
the
and
the
next
operation.
A
container
without
(TIOT). A control
job
management
with
pointers
table
certain
data
carrier,
demounted
tape, a disk
of
for example,
constitute
process
computer
condition
tape
is
in
holding
separating
to
portion
that
(2)(ISO) A
as a unit;
pack.
related
of
to
data
in
one
coordinating
and
in
which
the
correct
magnetic
block
provide
JFCBs
of
data,
can
be
data
carrier
for
or
stock
record.
the
3480
the
it
from
I/O
and
handled
that
example,
the
tape
the
a
Glossary
77
Page 93
Page 94
Index
access
adding a data
adding ADDVOL allocating AMASPZAP
APF
archiving argument, authorized
automatic
method definition macro
example
instructions
of
volumes
command
scratch
modification
See
authorized
application,
definition
program
message
cartridge
75
set
to
11
to
service
for
MSGDISP
display
available
an
existing
DFHSM
(DFHSM)
tapes
aid
program,
program
definition
of
75
facility
38
loader
64
62
facility
(APF)
1
8
multifile
64
language
58
of
(APF)
75
volume,
See
block
BOT
See
beginning
BPAM
See
basic
buffered
buffered
macro
definition
determining
limitations
option SYNCDEV synchronizing waiting
BUFNO
partitioned
write
mode
write
28
75
the
using
8
macro
data
blocks,
parameter
of
tape
access
mode,
using
number
the
data
of
write-validity-check
28
25
threshold
15
method
SYNCDEV
blocks
18
value
26
backup
and definition management
backup basic
volumes
partitioned
NOTE
basic
sequential
effect
of
macro
NOTE
synchronization
basic
sequential beginning block
definition determining
buffer
ID
CLOSE effect how retrieving
specifying physical relative size
8
using
POINT
block
count
EXCP
routines
user
exits
BLOCKID
recovery
of
75
61
(tape
cartridges)
access
method
and
POINT
access
macros
method
write-validity-checking
instructions
and
POINT
of
tape,
75
18
macro
of
it
works
of
access
definition
the
number
FREE
available
macro
requirement
logical
method,
of
of
processing
option
on
17
17
in
the
JFCB
identifier
position
checking
macro
in
23
JFCB
to
12
locate
13
13
61
22
8
records
definition
75
blocks
10
the
10
9
23
8
26
in
block
22
of
the
ID 10
75
calculating
REGION
cartridge
See
tape
cartridge
catalog
entries
2
CCW
See
channel channel channel channel channel channel channel,
command command, path path, status
definition characteristics, CHECK
macro
checking,
group,
definition
block
command
word,
magnetic
relationship
count checkpoint/restart clearing CLOSE
the
message
macro
effect
of
FREE
first
label
set
10
relationship
header
with
command
See
channel
compatibility
catalog
evaluating features restriction specifying
completion
issued POINT SYNCDEV
command
mode
entries
2
supported
2
3480
codes
by
checkpoint/restart
macro
macro
constructing a data
size for
word
word,
definition
definition
definition
of
definition
of
75
tape
12
codes 73
display
option
on
block
POINT
2
and
in
JCL
25
31
control
IEBGENER
of
75
of
76
of
5
to
POINT
38
the
block
ID
of
the
macro
not
supported
9
73
block
of
76
76
8
75
macro
ID 10
next
23
15
24
data
2
Index
79
Page 95
contingent conventional-speed
high-speed conversion, CSECT
description software
CSW
See
DASD
See data data data data
access
constructing
data
definition
density
logical
MACRF
(BSAM)
parameters
selecting
SORTOUT
symbolic Data
(DFHSM)
ADDVOL
DENSITY
DENSITY
esoteric
overview
RECYCLE
SETSYS
tape
UNITNAME
USERUNITTABLEINOUSERUNITTABLE
parameter,
data
DEVTYPE
MSGDISP
MSGDISP
NOTE
POINT
allegiance,
search
definition
of
messages
channel
direct
access
base,
definition
block,
using channel, control
BUFNOinIEBGENER density write-validity-check 3480
Facility
management
definition
block
methods
set
characteristics
76
option
connection
operand,
22
option
restriction
data
DD
references
Hierarchical
command
parameter, parameter,
unit
61
command
command
cartridges
33
macro
macro
macro
definition
search,
19
of
IGXMSGOI
status
word
storage
of
POINT
(DCB)
support
8
(DEN) 7
with
sequential
(DEN) 7
set
options
statement
names
used
parameter,
SETSYS
macros
32
35
22
23
of
comparison
76
59
58
device
76
macro
to
of
76
8
7
a DD
statement
data
15
option
7
7
restriction
71
Storage
64
ADDVOL SETSYS
requirement
61
62
as
backup
SETSYS
command
locate
(OPTCD = W) 8
Manager
command
command
volumes
63
76
with
23
set
69
63
61
command
SYNCDEV
data
migration,
data
set
statement
data
set description device device
recording
data
set,
data,
definition
DCB
operands,
DD
statement,
data
DCB
DFSORT
effect
IEBGENER logical
NOTE restriction selecting SORTOUT, SORTWKnn,
write-validity-check
7
65
62
62
DDR
See
dynamic deferred definition demount density
See
recording DENSITY
SETSYS determining device device device DEVTYPE
DFSORT
direct
address characteristics, number
description restriction
SORTWKnn
access
POINT disband disk
log
drive
loaded,
drive,
magnetic DSECT dummy dump,
definition dynamic
definition header
statement,
control
macro
definition
characteristics,
7
label
5 address number
definition
set
restriction,
of
connection
macro
unit
of
volume
parameter
macro
program
macro
group,
data
device
and
(MVS/370) 5 (MVS/XA) 5
density
of
of
76
symbolic
JCL
characteristics
LABEL=RETPD,
program
FREE
= CLOSE
use
of
22
for
tape,
data
set
DFSORT
DFSORT
device
check,
definition
terms
command
the
storage
set, definition
75
message
density
number
(MVS/370) 5
(MVS/XA) 5
32
32
DD
statement
device
considerations
definition
IMS/VS 67
tape,
DCB symbolic
section
of
76
reconfiguration
of
76
trailer
25, 28
of
76
DCB
macro
5
76
names
69
BUFNO with
POINT
options
program
option
reconfiguration
62
of
I/O 32
of
definition
used
labels,
7
on
the
a DCB
macro
7
program
in
of
38
blocks
of
76
76
for
data
for
15
69
of
DCB
and
71
block
macro
69
69
DCB
76
in
the
23, 24
77
names
set
label
DD
SORTOUT
ID 10
7
24
parameter
buffer
71
71
5
in
8
18
80
IBM
3480
Magnetic
Tape
Subsystem
User's
Reference
Page 96
effective end
end-of-data-set end-of-volume Environmental
Program
EODAD EOF2
EOV2
EREP
ERP
error
macro error error error error
esoteric
establishing
(SETSYS)
.
example
EXCP
execute
execute
macro execute extended
recording
of
tape logical, physical,
overview
See end-of-data-set
See end-of-volume
label
See
See
definition description
requirement specifying
adding a data
volume coding how
high-speed how language
aid MSGDISP
See
effect macro restriction synchronization
definition
(EREP)
routine
Environmental
Printing
error
analysis
24 exits, messages records recovery
unit
OPEN(J)
to
code NOTE
to
code SYNCDEV
58
execute
control
of
instructions
form
37
form
contingent
density,
definition
trailer
trailer
Reporting
67
with
Program
recovery
(I/O),
relationship
POINT
write-validity-checking
macro
73
(LOGREC)
procedures
76
67
names
for
DFHSM
61
DFHSM
62
set
11
search
modification, AMASPZAP
macro, RDY
control
program
in
block
of
description,
of
SYNCDEV
allegiance,
definition
of
77
of
77
label,
data
label
(EOV2),
Editing
POINT
trailer
trailer
control
to
11
label
Reporting
(EREP)
procedures
24
67 (ERP)
parameters
an
existing
and
POINT
20
27
33
program
(EXCP)
available
count
logical
MSGDISP
macro
set
and
macro
label,
(EOV2),
Editing
(ERP)
to
63
macros,
(EXCP)
8
checking
records
definition
of
76
label
data
set
Printing
24
data
set
and
POINT
multifile
service
8
13
26
RDY
30
of
5
label
label
data
76
set
file, format, FREE
block
FREE
5
block
full
generalizing glossary
HDR2
header high high-speed
IEBGENER
IMS/VS interchange interface, intermediate introduction iodev.inputjoutput
IOSLEVEL
definition
definition
option
ID 10
= CLOSE
ID 10
function catalog evaluating restriction specifying
header
See
label
speed
comparing example
macros NOTE performing physical POINT register
REGION storage tuning
refid = iodev.characteristics
of
in
the
in
mode
entries
2 2
3480
a message
of
terms
label
(HDR2), search search
with
of
how
20
macro
18
block
macro
0,
block
size
requirements
15
logging
application,
DCB for
storage
to
the
support
76
of
76
CLOSE
the
2
in
75
(HDR2),
10
conventional-speed to
17
identifier
17
number
calculation
67
magnetic
subsystem
devices
(priority),
DD
statement,
JCL
display
data
set
code
15
definition
devices
macro,
9
NOTE
tape
effect
effect
38
data
set
label
label
5
and
9
20
15
of
72
restriction
1
32
MSGDISP
on
on
search
POINT
76
69
macro
the
the
19
38
Index
81
Page 97
JCL
Gob
control definition DEN
parameter
NOTE
macro restriction specifying UNIT
3480 9
parameter
write-validity-check
JFCB
CLOSE
macro, high-speed JFCPOSID layout
11 modifying 9 physical reading tape
JFCBFLG3 JFCPOSID JFCRBIDO
block CLOSE
ID
journalizing,
label,
density,
ID
10
data
block
(RDJFCB)
field
bit
field
10
macro
definition
set description device device recording
language length, list load log logical
statement logical LOGREC
MACRF macro macros,
address
number
modification,
JFCB
form
of
point,
tape,
IMSjVS
connection
end-of-tape,
data
operand,
instructions
data
density
fields for
the
definition
7
management DEVTYPE MSGDISP
language)
77
5
22
for
tape,
9
saving
search
bit
10
in
JFCBFLG3
identifier
data
set
(JFCPOSID
in
JFCBFLG3
processing,
5
(MVS/370) 5 (MVS/XA) 5
5
AMASPZAP
SYNCDEV
of 67 between
definition
67
sequential
available
32
33
POINT
option
the
block
9
10
label
bit)
field
saving
of
77
example
macro
77
a DCB
of
data
by
macro
(OPTCD =
ID
field
5
10
10
the
service
11
29
macro
77
set
(BSAM)
access
24
W)
10
10
block
aid
and
method
9
a
58
DD
22
8
MSGDISP NOTE POINT
macro
macro
SYNCDEV
magnetic
magnetic
recording,
tape characteristics definition density
(DEN)
restriction
definition
drive, interface
POINT
macro recording restriction
NOTE
POINT managing media message
capacity,
access
data
display
methods DEMOUNT from
authorized
GEN
parameter
how
to
use modifying for MOUNT
parameter MSGDISP non-English RESET VERIFY
messages, mount MSGDISP
parameter
parameter
error
volume
macro clearing DEMOUNT from
authorized
GEN
parameter introduction modifying for MOUNT
parameter non-English RDY
example example execute list
form reason RESET
return TXT VERIFY
multifile
to
codes
parameter
codes 57
parameter
parameter
volume, example
11
MVS/Extended
device
number
IOSLEVEL
MVSj370
device
address
macro
22
23
macro
definition
5
77
in
DCB
of
in
DCB
24
density
macro
macro
sets
61
definition
support
parameter
programs description
MSGDISP
other
macro
messages
73
message
38
parameter
programs
description
33
other
messages 58
33
of
how
form
description
description
57
33
Architecture
5
support,
5
35
25,
28
of
macro
77
72
7
22
24
of
77
8
description
facility
macro languages description
33
58
description
description
38
description
facility
languages
description
to
code
36
description
description
of
adding a data
MSGDISP
77
7
53
33
58
50
53
58
33
37
50
r-
46
(APF)
39
42
46
(APF) 38
39
42
set
38
82
IBM
3480
Magnetic
Tape
Subsystem
User's
Reference
Page 98
name,
JFCB
fields for example
NOTE
NOUSERUNITTABLE
macro
access
methods
block
IDs description example MACRF
set partitioned register register relationship return TYPE = option TYPE
use
command
22
code,
= ABS
for
searching
(DFHSM)
of operand
0, 1,
support
retrieved
17,
22
how
to
data
set
block
number
block
number with register
19
keyword
17
code
of
the
DCB,
(BPAM)
POINT
15
17
19
parameter,
63
11
8
20
sequential
20
20 macro 19
22
22
SETSYS
data
high-speed MACRF
set
22 relationship relationship requirement requirement return return SYSIN TYPE = option TYPE
= ABS TYPE = REL use
for
position
primed, processing
of
POINT
definition
search
operand
to
NOTE
with
for
output
for UPDAT
code,
register
codes
and
searching
25
SYSOUT
keyword keyword
tape macro
application,
24
of
18
of
the
macro
CLOSE
15
data
19
19
77
definition
DCB,
sequential
22
macro
data
set
processing
19
set
restriction
18 18
of
data
23
processing
23
77
23
24
OBR
See
outboard offset dec., OPEN
example first relationship relationship TYPE = J,
UPDAT OPEN(J), opening a data operating OPTCD=W
See outboard
definition
error output
POINT
output
partitioned physical POINT
access
description
example
JFCB
macro
of
label
operand
example
modes 2
write-validity-check
records
records
data
set,
macro
data
sets, SYNCDEV
data
end-of-tape,
macro
methods
of
records
fields for
coding
header
open a
block
to
JFCB
to
NOTE
data
of
coding
set
using
(OBR)
77
67
requirement
23
set
(BP AM),
definition
support
17,
23
how
to
(OBR)
example
OPEN(J)
ID 10
9
macro
set
23
high
option
for
macro
8
code
20
11
22
10
11
speed
search
(OPTCD = W)
WRITE
NOTE
of
77
11
macro
25
macro
10
22
after
queued
queued quiesce,
RDJFCB RDY READ read-ahead reason
record, recording
RECYCLE recycling REGION register relative
resetting retrieving
sequential effect macro SYNCDEV
sequential
definition
description,
macro
code MSGDISP NOTE POINT SYNCDEV
definition
ADDVOL data
set definition DEN DEN restriction
contents,
position
(BP AM
option parameter
and
access
of
write-validity-checking
instructions
macro
access
macro,
size
the
reading
relationship
queue,
macro
macro
macro
macro
density
command
label
of
effective
in
in
command,
tapes
calculation
BSAM)
message
the
block
MSGDISP
definition
of
a DCB
61
completion
of
available
26
of
77
57
23
25
31
77
5
a DCB
5
DFHSM
last
22
display
ID
method
method,
the
to
65
76
macro
macro
for
block
17
8
8
definition
JFCB
macro
POINT
of
IEBGENER
codes
10
33
macro
77
7
for 3480 7
61
73
read
or
written
38
77
23
15
Index
83
Page 99
return
code issued MSGDISP NOTE POINT register registers 0 and SYNCDEV
by
checkpoint/restart
macro
macro
macro
15
macro
19,
57
19, 23
19,
25
23
1,
block
31
number
73
20
tapes,
recycling
task
I/O
table, threshold track trailer tuning TXT TYPE = option,
value,
addressing,
labels,
IEBGENER
parameter,
data
61
definition
waiting
POINT
set
label
15 MSGDISP NOTE
data
macro
and
77
blocks
5
macro
POINT
24
33 macros
26
19
scratch search,
sense sequential
SORTOUT
SORTWKnn space statistical storage storage symbolic field
SYNAD
macro
SYNCDEV
synchronization,
synchronize
synchronizing
SYSIN
SYSIN
SYSOUT
SYSOUT
tapes,
allocating
comparing
high-speed 19
bytes, LOGREC
data
DD
DD
manager
records
requirements
space
management
names
exit
routine
24
macro access BUFBLK buffered execute how
list return synchronize
NOTE
method
form
to
code
form
codes
data DD
statement, data DD
macro
parameter
write
description
device
sets,
statement
62
conventional-speed
data
set,
NOTE
statement
statement,
command
(LOGREC) 67
support
mode
description
27
31
device
definition
form
data,
POINT
sets,
POINT
22
and
69
DFSORT
64
for
IEBGENER
for DCB
relationship
8
26
25
29
description
of
of
SYNCDEV
buffered
macro
NOTE
macro
67
POINT
61
71
30
77
write
macro
with
28
mode
24
24
and
macros
program
15
POINT
macro
25
22
28
22
69
unit
control
tape
unit
names,
UNIT
ADDVOL
specifying UNITNAME UPDAT update USERUNITTABLE
(DFHSM) 63
values verify volume,
definition
managed position tape
waiting WRITE
relationship relationship
write-validity-check
block
drive
identification
specifying
parameter
command
in
parameter,
operand,
processing,
of
DFHSM
volume
message 38
tape
cartridge
by
24
position,
data
blocks,
macro
job
requirement
77
DFHSM
POINT
with with
esoteric
(DFHSM) 64
control
SETSYS
header
parameter,
control
macro
threshold
CLOSE
POINT
option
5
61
language
for
and
trailer
SETSYS
parameters
64
value
macro
macro
(OPTCD = W) 8
9 command POINT
labels
(SETSYS) 62
23
26
23
23
62
macro
5
command
23
tape
cartridge data definition
introduction used
tape
storage
storage
84
IBM
set
as
69
3480
label
of
backup
devices,
Magnetic
5
77
5
volume
restriction
61
Tape
for
intermediate
Subsystem
User's
Reference
I
Numerics
3480
Magnetic characteristics introduction specifying
Tape
in
I
Subsystem
32
1
JCL
9
Page 100
IBM 3480
User's
Reference
Magnetic
Tape
Subsystem
READER'S
COMMENT
FORM
Order
This
operators
organization, you be
No. GC35-0099-3
manual
of
supply
sent
to
in
the
Note: Copies
any requests for copies representative or
Possible
Clarity
If
you
topics
Accuracy
wish
a reply, give
is
part
of a library
IBM
systems. You may
or
subject
any
author's
of
IBM
matter
way
it
department
publications are not stocked at the location
to
for
comment
that
serves use
with
the
believes
the
Completeness
your
appropriate
for
of
publications, or for assistance
IBM
branch office serving your locality.
are:
name,
company,
as a
reference
this
form
understanding
without
whatever
review
Organization
mailing
source
to
communicate
that
incurring
and
address,
for systems
IBM
may
any
action,
to
in
using your
Coding
and
your
comments
use
obligation
if
any,
analysts,
or
distribute
are
deemed
to
programmers,
about
this
whatever
you.
Your
appropriate.
and
publication,
information
comments
will
its
which this form is addressed. Please direct
IBM
system,
Retrieval
date:
to
your
Legibility
IBM
What
is
Number
Thank office
or
in
the
.Edition
your
occupation?
of
latest
Newsletter
you
for
your
representative
Notice
associated
cooperation.
will
be
on
the
back
No
happy
of
with
postage
to
forward
the
front
this
publication:
stamp
your
cover
necessary
comments
or
title
page.)
if
mailed
or
you
in
may
the
U.S.A.
mail
(Elsewhere,
them
directly
to
an
the
IBM
address
Loading...