Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
mainframe
DLm8000
Version 3.4
User Guide
P/N 300-013-636
REV 01
Copyright © 2012 EMC Corporation. All rights reserved.
EMC believes the information in this publication is accurate as of its publication date. The information is subject to
change without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS IS.” EMC CORPORATION MAKES NO REPRESENTATIONS OR
WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS
IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.
For the most up-to-date regulatory document for your product line, go to the Technical Documentation and Advisories
section on EMC support website.
For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com.
All other trademarks used herein are the property of their respective owners.
Preface
Index
Title Page
Title Page
As part of an effort to improve and enhance the performance and capabilities of its
product lines, EMC periodically releases revisions of its hardware and software.
Therefore, some functions described in this document may not be supported by all
versions of the software or hardware currently in use. For the most up-to-date
information on product features, refer to your product release notes.
If a product does not function properly or does not function as described in this
document, please contact your EMC representative.
Purpose
EMC Disk Library for mainframe (DLm) provides IBM tape drive emulation to the IBM
and IBM-compatible mainframes using disk storage systems in place of physical
tapes. This guide provides information about the features, performance, and
capacities of DLm 3.4 and later. It also includes installation and configuration
information that is required for ongoing operation.
Audience
This guide is part of the EMC DLm documentation set, and is intended for use by
system operators to assist in day-to-day operation. Installation, configuration, and
maintenance tasks must be accomplished by qualified EMC service personnel only.
Readers of this document are expected to be familiar with tape library operations and
the associated tasks in the mainframe environment.
Related documentation
The following EMC publications provide additional information:
◆ EMC Disk Library for mainframe Physical Planning Guide
◆ EMC Disk Library for mainframe DLm8000 Version 3.4 Release Notes
DANGER indicates a hazardous situation which, if not avoided, will result in death or
serious injury.
WARNING indicates a hazardous situation which, if not avoided, could result in death
or serious injury.
CAUTION, used with the safety alert symbol, indicates a hazardous situation which, if
not avoided, could result in minor or moderate injury.
IMPORTANT
An important notice contains information essential to software or hardware operation.
Typographical conventions
EMC uses the following type style conventions in this document.
Normal Used in running (nonprocedural) text for:
• Names of interface elements (such as names of
windows, dialog boxes, buttons, fields, and menus)
• Names of resources, attributes, pools, Boolean
expressions, buttons, DQL statements, keywords,
clauses, environment variables, functions, utilities
• URLs, pathnames, filenames, directory names,
computer names, filenames, links, groups, service
keys, file systems, notifications
Bold Used in running (nonprocedural) text for:
• Names of commands, daemons, options, programs,
processes, services, applications, utilities, kernels,
notifications, system calls, man pages
Used in procedures for:
• Names of interface elements (such as names of
windows, dialog boxes, buttons, fields, and menus)
• What user specifically selects, clicks, presses, or
types
Italic Used in all text (including procedures) for:
• Full titles of publications referenced in text
• Emphasis (for example a new term)
• Variables
Courier Used for:
• System output, such as an error message or script
• URLs, complete paths, filenames, prompts, and
syntax when shown outside of running text
Courier bold Used for:
• Specific user input (such as commands)
Courier italic Used in procedures for:
• Variables on command line
• User input variables
<> Angle brackets enclose parameter or variable values
supplied by the user
[] Square brackets enclose optional values
Technical support — For technical support, go to EMC Online Support website and
choose Support. On the Support page, you will see several options, including one for
making a service request. Note that to open a service request, you must have a valid
support agreement. Please contact your EMC sales representative for details about
obtaining a valid support agreement or with questions about your account.
Your comments
Your suggestions will help us continue to improve the accuracy, organization, and
overall quality of the user publications. Please send your opinions of this document
to:
techpubcomments@emc.com
This chapter provides an overview of EMC Disk Library for mainframe DLm8000.
Topics include:
◆ Introduction to Disk Library for mainframe........................................................ 18
◆ DLm8000 architecture...................................................................................... 19
◆ Tape emulation ................................................................................................ 32
◆ Support for physical tape drives ....................................................................... 34
◆ High availability features of DLm8000 .............................................................. 35
◆ Features and benefits....................................................................................... 38
DLm8000 architecture
The major components of a DLm8000 system are the virtual tape emulation controller
(VTEC) and the backend storage system that comprises of one VG8 gateway and a
VMAX.
Note: Total supported capacity and number of cabinets depend on the drive capacity.
VTEC
The VTEC is the subsystem that connects to an IBM or IBM-compatible mainframe and
provides the emulation of IBM 3480/3490/3590 tape drives. A VTEC contains the
following components:
◆ Two to eight Virtual tape engine (VTE)
◆ Two Access control points (ACPs)
◆ Two 1 Gb Ethernet switches for management network
◆ Two 10 Gb Ethernet switches for data transfer
VTE
Each DLm configuration can have 2—8 VTEs. The mainframe virtual tape emulation
software, Virtuent, executes on the VTEs. Each VTE is connected to the mainframe
through two FICON channels and emulates up to 256 tape drives. VTEs interface to the
mainframe and direct tape data to and from the backend storage arrays. This data is
written to the storage arrays and stored in NFS filesystems over a redundant 10 Gb
data network.
DLm8000 architecture 19
Overview of EMC Disk Library for Mainframe DLm8000
AB C D E F G
Disk 0 Disk 1
L K J
GEN-000718
Do not press the Power button while the VTE is online to the host. Follow the
shutdown procedure in “Power down DLm” on page 63 before pressing the Power
button
D — Power/Sleep LED:
• Continuous green indicates that the system is powered on.
• Blinking green indicates that the system is sleeping.
• No light indicates that the system does not have power applied to it.
◆ E — Disk activity LED.
◆ F — System status LED:
• Continuous green indicates that the system is operating normally.
• Blinking green indicates that the system is operating in a degraded condition.
• Continuous amber indicates that the system is in a critical or nonrecoverable
condition.
• No light indicates that POST is running, or the system is off.
◆ G — System identification LED: A blue light glows when the ID button has been
pressed. A second blue ID LED on the rear of the unit also glows when the ID
button has been pressed. The ID LED allows you to identify the system you are
working on in a bay with multiple systems.
◆ H — System identification button: Toggles the front panel ID LED and the server
board ID LED on and off. The server board LED is visible from the rear of the
chassis and allows you to locate the server from the rear of the bay.
◆ I — Reset button: Reboots and initializes the system.
Do not press the Reset button while the VTE is online to the host. Follow the
shutdown procedure in “Power down DLm” on page 63 before pressing the Reset
button.
◆ J — USB 2.0 port: Allows you to attach a Universal Serial Bus (USB) component to
the front of the ACP.
◆ K — NMI button: Pressing this recessed button with a paper clip or pin issues a
non-maskable interrupt and puts the system into a halt state for diagnostic
purposes.
◆ L — Video port: Allows you to attach a video monitor to the front of the VTE.
DLm8000 architecture 21
Overview of EMC Disk Library for Mainframe DLm8000
ACP
The DLm8000 comes with two ACPs in a primary-secondary configuration. This highly
available configuration requires a highly available IP address that is always
associated with the primary ACP. This ensures management access even when one of
the ACPs fail. If the primary ACP fails, the secondary ACP becomes the primary.
The ACPs provide a user-friendly console (DLm Console) to execute various setup and
configuration tasks. The ACPs connect to the DLm management LAN of the DLm.
A B C D E F G CNS-000979
B MG MT
CS
DLm8000 architecture 23
Overview of EMC Disk Library for Mainframe DLm8000
Connector Description
Mouse Use with KVM mouse. Alternatively, you can use a USB mouse
connected to a USB port.
Keyboard Use with KVM keyboard. Alternatively, you can use a USB
keyboard connected to a USB port.
2
AT-9924TL-EMC
GEN-001778
10 Gb VTEC-VNX connection
In a DLm8000, data from the mainframe is transferred via FICON to the VTE. From the
VTE, it is passed to a VNX Data Mover using a 10 Gb Ethernet connection. The 10 Gb
Ethernet network has a pair of 10 Gb Ethernet switches to protect against a single
switch failure.
Backend storage
The DLm8000 uses the combination of a VNX VG8 gateway connected to a VMAX
storage array to serve as the backend storage. The primary benefit of a
DLm8000-based system is the use of SRDF for replicating data to remote systems
thereby allowing customers to take advantage of the associated Disaster Recovery
(DR) capabilities and applications of SRDF.
VG8 gateway
DLm8000 can be configured with VNX VG8 gateway with:
◆ 2 to 8 storage controllers (Data Movers)
◆ 2 Control Stations
The Control Stations are configured as primary and secondary to ensure high
availability. The VG8 is configured with one standby Data Mover and one to seven
active Data Movers. There are no internal disks or caches in the VG8 gateway.
DLm8000 architecture 25
Overview of EMC Disk Library for Mainframe DLm8000
VMAX storage
The VG8 gateway is attached to a VMAX 20K with a minimum of 7 FC drives (three
RAID1 pairs plus a spare). The data drives are 2TiB 7.2 RPM SATA using FBA 6RAID6.
The Control Devices are 300GB 10K RPM Fibre Channel 4 Gbps. Enginuity 5875 is the
only supported uCode family.
FICON channel
Each DLm VTE FICON interface has a single LC-type fiber-optic connector. The type of
cable you must use depends on the following:
◆ The type of connector on the mainframe (either LC or SC)
◆ The type of fiber-optic cable (single-mode or multi-mode) supported by the
mainframe channel
The DLm FICON interfaces are available either with single-mode or multi-mode
fiber-optic cable support. The micron rating for:
◆ Single-mode fiber-optic cable is 9/125
◆ Multi-mode fiber-optic cable is either 50/125 or 62.5/125.
Status indicators
Each FICON interface has a four-character display visible at the back of the system
adjacent to the interface connector. The display scrolls the status of the interface.
Under normal operating conditions, the version of the emulation firmware interface is
displayed.
In DLm 8000, the FICON adapter has three light-emitting diode (LED) indicators, listed
in Table 2 on page 27, visible from its rear. These LEDs indicate the speed of the link:
1 Gbps, 2 Gbps, or 4 Gbps. When the link is up, the LED glows steadily. It blinks if
there is traffic. The numbers stamped on the faceplate correspond to the speed.
On On On Power on
DLm8000 architecture 27
Overview of EMC Disk Library for Mainframe DLm8000
• A real 3480
◆ The CHPID can be defined as any one of the following:
• SHARED
• DED
• REC
Note: When configuring DLm devices as device type 3490, the maximum number of
devices per control unit is 16.
CNTLUNIT CUNUMBR=EA80,PATH=(0A), +
UNITADD=((00,32)),UNIT=3590
IODEVICE ADDRESS=(EA80,32),CUNUMBR=(EA80), +
STADET=Y,UNIT=3590
Note: With dedicated non-EMIF (non-shared) mode, specify LPAR=0 in the DLm virtual device
configuration program regardless of the LPAR to which it will be connected.
CNTLUNIT CUNUMBR=EA80,PATH=(0A), +
UNITADD=((00,32)),UNIT=3590
IODEVICE ADDRESS=(EA80,32),CUNUMBR=(EA80), +
STADET=Y,UNIT=3590
Note: With reconfigurable non-EMIF (non-shared) mode, in the DLm virtual device configuration
program, specify LPAR=0 regardless of the LPAR to which it will be connected.
CNTLUNIT CUNUMBR=EA80,PATH=(0A), +
UNITADD=((00,32)),UNIT=3590
IODEVICE ADDRESS=(EA80,32),CUNUMBR=(EA80), +
STADET=Y,UNIT=3590
Note: With EMIF (shared) mode, specify LPAR=n in the DLm virtual device(s) configuration
program, where n is the LPAR to which the DLm device is connected.
CNTLUNIT CUNUMBR=EA80,PATH=(0A,0B), +
UNITADD=((00,32)),UNIT=3590
IODEVICE ADDRESS=(EA80,32),CUNUMBR=(EA80), +
STADET=Y,UNIT=3590
Note: With EMIF (shared) mode, specify LPAR=n in the DLm virtual device(s) configuration
program, where n is the LPAR to which the DLm device is connected.
CNTLUNIT CUNUMBR=300,PATH=(22),LINK=(C2), +
UNITADD=((00,32)),UNIT=3590
IODEVICE ADDRESS=(300,32),CUNUMBR=(300),UNIT=3590
DLm8000 architecture 29
Overview of EMC Disk Library for Mainframe DLm8000
Capacity DLm8000
Note: The 1792 TB max raw capacity is calculated as [256 TB/VG8 storage controllers
(Data Movers) * 7 active storage controllers].
Tape emulation
DLm VTEs emulate the IBM tape drives to the mainframe and direct the tape data to
and from the backend storage arrays. Each VTE, operates independently of the other
VTEs in the VTEC and can be configured with up to 256 tape drives. A DLm configured
with two VTEs can emulate up to 512 virtual tape devices, while one with eight VTEs
can emulate up to 2,048 virtual tape devices at one time.
The virtual tape emulation software:
◆ Receives and interprets channel command words (CCWs) from the host
◆ Sends and receives the tape data records and reads and writes corresponding
disk data in response to the CCWs
◆ Presents initial, intermediate, and final status to the host commands and
asynchronous status as needed
◆ Sends and receives control information (such as sense and load display data) to
and from the host in response to the CCWs
Data formats
The default file format for tape data written to the DLm disks is a modified AWSTAPE
format. This format keeps track of record lengths as the file is being written so that the
variable length records can be read exactly as they were originally written.
Optionally, data can also be written as a plain, sequential (flat) file. In this format, the
original data record lengths, labels, and tapemarks are lost, but any open-system
application can read the data as a sequential dataset.
VTEC
DLm8000 contains a minimum of two VTEs and delivers enterprise-class availability
and scalability through a modular design based on high-performance, highly
available VTEs:
◆ VTEs have redundant power supplies, fans, and RAID-protected internal disks.
Emulated tape drives on each VTE can mount any cartridge and any logical
partition (LPAR) can access any cartridge, delivering enterprise-class availability.
◆ DLm8000 has two ACPs with a shared IP address to ensure high availability. If the
primary ACP fails, the secondary ACP takes over as the primary and the shared IP
address moves over to the secondary ACP.
◆ The configuration files are saved on the ACP to allow quick and easy restoration of
a VTE configuration if a VTE is replaced. The files are also copied over to the
secondary ACP. The redundant copies of the configuration files protect against
the single point failure of an ACP.
◆ VTEs provide redundant data and control paths. In DLm8000, two 10 GbE
switches provide a redundant data path, and two 1 GbE switches provide a
redundant control path. The redundant data path provides failover to protect
against link failures, network card failures, and switch failures.
VG8
Each DLm8000 will have one VG8 with a minimum of two storage controllers (Data
Movers) configured in the system.
Each VG8 storage controller has the following I/O :
◆ 4 x 8 GbE FC ports (1 x 4-port card) for connection to FC switches
◆ 4 x 10 GbE optical ports (2 x 2-port cards), providing two connections to the 10
GbE switches.
◆ Management ports for internal management network.
◆ The VNX VG8 supports maximum filesystem size (16 TB) and maximum LUN size
(16 TB).
◆ The VNX VG8 and VMAX sub-systems are dedicated to the associated DLm8000
system. No sharing of DASD data on the DLm8000 is allowed.
◆ Storage controller failover — The VG8 server protects against hardware or
software failure by providing at least one standby storage controller. A standby
storage controller ensures that the VTEs have continuous access to filesystems.
When a primary storage controller fails, the standby storage controller assumes
the identity and functionality of the failed storage controller.
Each VG8 within the DLm8000 can have up to eight storage controllers, where
seven are active and one is a standby. The number of active storage controllers is
based on the storage capacity of the system.
Local storage controllers are not supported in a DLm8000. Only active or standby
are allowed.
Each storage controller is a completely autonomous file server with its own
operating system image. During normal operations, the VTEs interact directly with
the storage controllers. Storage controller failover can protect the VMAX server
against hardware or software failure.
◆ Fail-Safe Network (FSN) — FSN is a high-availability networking feature supported
by the VG8 storage controllers (Data Movers). An FSN appears as a single link with
a single Media Access Control (MAC) address and potentially multiple IP
addresses. An FSN connection may consist of a single link or multiple links. VMAX
defines each set of links to be a single FSN connection. Only one link in an FSN is
active at a time although all connections making up the FSN share a single
hardware (MAC) address. If the VG8 storage controller detects that the active
connection has failed, the storage controller automatically switches to the
standby connection in the FSN, and that connection assumes the network
identity of the failed connection. The individual links in the FSN connect to
different switches so that, if the switch for the active connection fails, the FSN
fails over to a connection using a different switch.To use this feature, each storage
controller in the VG8 server must have:
• Two optical 10 GbE ports to connect the storage controllers to the switches in
the VTEC (one for each 1 GbE switch)
• Two ports configured together using an FSN failure recovery
VG8 server comes with RAID 6 protection to ensure high availability.
Ethernet
switch
VTE-N
Storage Controller !
enclosure 1
!
Lnk
Lnk
Rx
Tx
Rx
Tx
0 2 0 2
1 3 1 3
Storage Controller
enclosure 0
!
VTE1
Lnk
Lnk
Rx
Tx
Rx
Tx
0 2 0 2
1 3 1 3
◆ Support for EMC Secure Remote Support (ESRS) that provides secure, fast, and
proactive remote support for maximum information availability. Contact EMC
Customer Support to configure ESRS.
DLm Operations 41
DLm Operations
DLm Console
Username dlmadmin
ACP1
Username dlmadmin
Password password
ACP2
Username dlmadmin
Password password
Note: This procedure assumes that you have access to and are connected to the Data
Center LAN to which the ACP is connected also.
3. Type the username and password. For a first-time login, enter the following user
and password:
• User: dlmadmin
• Password: password
The DLm Console opens as shown in Figure 11 on page 45. At first login, DLm
prompts you to change the DLm Console password.
2. Click External.
3. Click the Time tab if it is not already displayed.
4. Use one of these two methods to set the date and time on a VTEC:
• Configure the system to use a Network Time Protocol (NTP) server.
If the ACP is connected to the corporate network and one or more NTP servers
are accessible, configure the controller to get date and time from an NTP
server.
Enter either the network name or IP address of up to four NTP servers. When
you make this configuration active by installing it, the ACPs in the
configuration attempt to query the NTP servers from 1 to 4 until they
successfully get the date and time.
Note: If you use a network name to identify an NTP server, you will need to
configure a Domain Name Server (DNS) as part of the network configuration.
User administration
By default, DLm ships with two default user IDs:
◆ dlmadmin
◆ dlmuser
The default password for these two usernames is password.
The dlmadmin user has full administrator rights and can create new configurations or
modify the existing configurations. This user can monitor and control the operation of
the VTE. The dlmadmin user can create new users with the same rights as dlmuser;
dlmadmin cannot create another user with administrative rights.
The dlmuser user can view the configuration and check the status of the VTEs but
does not have the authority to modify configurations or operate the VTEs.
From the Authentication tab of the DLm Console, the dlmadmin user can add, delete,
or modify usernames recognized by the system:
1. Access the DLm Console as described in “Connect to the DLm Console” on
page 43.
2. Click External.
3. Click the Authentication tab.
Native Native user administration stores the usernames and passwords on the VTE and is the
default type.
◆ To modify a user, modify the content of the Name, Password, or Readonly? fields.
Be careful not to delete all usernames with full administrator privileges. If there
are no administrator users you will not be able to modify or operate the system.
LDAP
When you configure DLm user authentication to use an external Lightweight Directory
Access Protocol (LDAP), the usernames and passwords will no longer be maintained
on the ACP. When a user attempts to log in to DLm Console, DLm sends a message to
the LDAP server. The LDAP server searches for the user name and password that has
been entered and informs DLm if the user is found and the password is correct. DLm
then grants access to the user.
Select the LDAP authentication type when the DLm system is attached to your
corporate network, and you already have the appropriate directory server installed
and running on the network. If you select LDAP without the required connectivity, your
login fails and you must try again using the Native authentication type.
◆ For administrative access, enter details under LDAP parameters for administrative
access:
• LDAP server: Enter the hostname or IP address of the LDAP server.
• Base DN: Enter the Distinguished Name (DN) of the entry at which the server
must start the search for authentication credentials.
• Filter: Criteria to use when selecting elements for authentication credentials.
The format is (cn=%s) where the login name is substituted for %s.
• LDAP server bind credentials (optional):
– Bind DN: The DN to bind the server with
– Bind password: The password for the Bind DN
◆ For readonly access, enter details under LDAP parameters for readonly access:
• LDAP server: Enter the hostname or IP address of the LDAP server.
• Base DN: Enter the Distinguished Name (DN) of the entry at which the server
must start the search for authentication credentials. For example, dc=emc or
dc=com.
• Filter: The criteria to be used in selecting the elements to be used in
authentication criteria. For example, (cn=%s) indicates that the Common
Name (cn) field should be compared against the name entered in the User
field of the login screen. (The login name is substituted for %s.)
• LDAP server bind credentials (optional):
– Bind DN: The DN to bind the server with
– Bind password: The password for the Bind DN
IMPORTANT
DR must be disabled in all DLm8000 configurations. The DR daemon enabled check
box should be unchecked on all configurations you define on DLm Console.
The DR daemon enabled check box in the External > DR tab of DLm Console must
always be unchecked for all configurations defined in DLm Console. (DLm Console can
fail if this check box is not unchecked in any of the configurations.) Unchecking the
box will gray out the DR Configuration area as shown in Figure 15 on page 52.
Access a VTE
You can access the VTE through the DLm Console.
1. Access the DLm Console as described in “Connect to the DLm Console” on
page 43.
The System status tab of the System menu opens by default.
The console displays icons for each configured VTE. From the bottom up, the VTEs
in your DLm cabinet are named VTE1, VTE2, VTE3, and so on. DLm 8000 has a
maximum of eight VTEs. Only the icons matching the VTEs installed on DLm are
displayed on the DLm console.
2. In the Console column, click the icon corresponding to the VTE you want to
access.
Figure 16 VT console
VT console A VT console does not need to be open for the VTE to be working. You can open a
specific VT console when you configure that VTE or when you want to monitor the
status of tape operations on that VTE. You can have all VT consoles open
simultaneously. All VTEs continue to operate normally regardless of which console is
open.
The VT console is divided into three sections:
◆ The larger, top section displays log messages as they are issued from the VT
application. On startup, the VT console displays the messages in the log (up to
the last 100,000 bytes) since the last startup of the VT console.
Access a VTE 53
DLm Operations
The following navigation keys (or commands) can be used to scroll through the
messages:
• Home—Move to the top
• End—Move to the bottom
• PgUp—Move up one screen
• PgDn—Move down one screen
◆ The smaller, lower section of the VT console is blue and always shows the current
status of the VT application on this VTE. When the VT application is not active, the
VT status is Not running. When the VT application is active, the VT status on the
VT console is Running. Use the START VT and STOP VT commands to start and stop
the VT applications, respectively. “Start and stop tape devices” on page 69
provides information.
The DLm system time is displayed in the status line at the bottom of the VT
console.
◆ Below the VT Status line is a command line where you may enter and edit VT
commands.
The following navigation keys can be used on the command line:
• Up Arrow or Ctrl+P—Previous command in history
• Down Arrow or Ctrl+N—Next command in history
• Left Arrow—Move 1 character to the left in the command line
• Right Arrow or Ctrl+F—Move 1 character to the right in the command line
• Ctrl+A—Move to the beginning of the command line
• Del or Ctrl+D—Delete one character
• Ctrl+E—Move to the end of the line
• Backspace or Ctrl+H—Backward delete character
• Ctrl+K—Erase to the end of the line
• Ctrl+T—Transpose characters
• Ctrl+U—Discard the line
• Ctrl+W—Word rubout
To close the VT console window, click the close window button in the top right corner
of the screen. Closing the console does not affect the operation of the virtual tape
application in any way.
Note: Vary all the devices on the VTE offline to the mainframe before you reboot the
VTE.
Power up DLm
Note: You must coordinate planned powerdown and powerup events with EMC
Customer Support.
Note: The Ethernet switches are powered up as soon as the cabinets are powered up.
Wait at least 10 minutes for the storage to power up before powering up the ACPs and
the VTEs.
Power up DLm 55
DLm Operations
VMAX
Refer to EMC Symmetrix Power Up and Power Down Procedure (2-PDP Bays or 4-PDP
Bays) [P/N 300-012-669] for information.
6. Connect the power cables for the first Control Station (CS 0) to the PDP. In the
example shown in fgure x, this is power cables 1.
7. If the system power LED on the front of the Control Station indicates that the
Control Station is off, turn on the Control Station by pressing the Power button on
the front. Ensure that the Control Station is powered up before continuing.
8. After you have confirmed that CS 0 is up and healthy, power up CS 1.
9. Check the system and hardware status as follows:
a. From a browser, type the IP address of the primary Control Station.
b. Log in to the Unisphere software as sysadmin and define the scope as Global.
c. Use the drop-down list at the top left Dashboard to select the system name
and view its System Information page.
d. On this page, verify that the Status fields for the VNX display OK
Power up DLm 57
DLm Operations
The DLm bays and power systems are designed to support DLm equipment only.
EMC does not support any other components in these bays, and recommends that
you do not install any additional equipment in the DLm bays.
ACP power-up
To power up and start the ACP:
1. Before powering up the ACP, make sure you are connected to the the storage
systems.
2. Press the power button located in the front of the ACP: button B in Figure 18 on
page 58.
You might hear the fans start and then slow down to adjust the system
temperature. Shortly thereafter, the system begins to boot and the hard drive
activity LED blinks.
A B C D E F G CNS-000979
B MG MT
CS
Connector Description
Power up DLm 59
DLm Operations
Connector Description
Mouse Use with KVM mouse. Alternatively, you can use a USB mouse
connected to a USB port.
Keyboard Use with KVM keyboard. Alternatively, you can use a USB
keyboard connected to a USB port.
Note: You can power up the VTEs in any order as they operate independently of
each other.
You should hear the fans start and then slow down as they adjust for system
temperature. Shortly after that, the VTE's disk activity LED begins blinking indicating
startup of the VTE.
AB C D E F G
Disk 0 Disk 1
L K J
GEN-000718
Figure 20 on page 61 shows these controls and indicators on the front of a VTE.
Power up DLm 61
DLm Operations
G System The ID LEDs allow you to easily identify the VTE you
identification are working on in a rack:
(ID) LED • A blue light that lights when the ID Button has
been pressed.
• A second blue ID LED on the back of the unit also
lights up when the ID Button has been pressed.
K NMI button Pressing this recessed button with a paper clip or pin
issues a non-maskable interrupt and puts the
system into a halt state for diagnostic purposes.
L Video Connector
Normal startup of a VTE takes 5 - 10 minutes. After the VTE starts its network services,
you will be able to access the VTE through the DLm Console.
Note: If the entire VTEC bay is in the powered down state, some of the LED panel
indicators may light when power is applied. This is only an indication that the units
have power available, it is not an indication that the ACP or VTEs are started. You must
press the Power button on the ACPs and each VTE to actually start them when
appropriate.
Powering down DLm, like powering it up, is a multi-step process. This process
includes procedures to suspend processing and then remove power to accomplish a
full system shutdown. Power down the following in this order:
1. Each VTE
Note: Vary off the tape devices from the host before you power down a VTE.
2. VNX VG8
3. VMAX
4. ACP
a. The secondary ACP
b. The primary ACP
Note: The powerdown process takes up to 30 minutes after the tape drives are varied
offline.
When you use the poweroff or reboot command to shut down or reboot an ACP, only
that ACP is affected. All VTEs continue to operate uninterrupted.
When you use the poweroff or reboot command to shut down or reboot any DLm VTE,
only that VTE is affected. All other VTEs continue to operate uninterrupted.
Do not power off the VTE, when devices are online to the host. Follow the shutdown
procedure; do not use the Power button.
Note: Vary the tape drives offline from every LPAR and wait for it to go offline. If a
job is accessing the drive at that point, the drive does not go offline until the job
releases the drive. Depending on the usage, this could take more than an hour.
The quiesce command prevents new tapes from being mounted on that VTE,
but does not affect tapes already mounted.
That command gives a list of the devices and VOLSERs of any mounted tapes.
The heading is always displayed; it is expected to not list any mounted tapes.
h. If any tapes were listed, follow the instructions provided in the EMC
Knowledgebase solution emc280282 "What to do if there are mounted tapes
when shutting down or restarting a VTE".
i. Quit from the VT Console:
quit
where vte# is the VTE name. For example, for VTE 1, type: ssh vte1.
d. To stop the tape emulation application, type:
vtd stop
5. On the ACP console, enter this command to power down the VTEs:
ssh -q vte<n> poweroff
Note: The virtual tape application automatically restarts the next time you start
the system.
After you execute the poweroff command, the VTE powers down. Pressing the Power
button after a poweroff command will turn the VTE on again.
A planned powerdown of the VNX VG8 server and integrated storage array requires
access to the VNX VG8 Control Station. Call EMC Customer Support for assistance.
After ensuring that the Data Movers are shut down, you can now proceed to
powering down the Control station.
4. From the prompt, issue the following command to power down the Control
Station:
ssh -q 192.168.100.200 poweroff
Note: If the primary ACP is powered down, the secondary ACP will take over as the
primary ACP.
3. Power down the secondary ACP before you power down the primary ACP.
a. To power down the secondary ACP:
ssh -q acp<n> poweroff
where <n> is 1 or 2.
b. After you have powered down the secondary ACP, power down the primary
ACP:
poweroff
Note: This may result in an incomplete output tape volume if the host has not yet
completed writing and properly closing the tape. For this reason, the STOPVT!
command should only be used in an emergency situation where VTE must be
brought down immediately. Any virtual tape volumes currently being written
should be considered invalid.
When the VT application is active, the VTE console shows the VT status as "Running"
and informational, warning, and error messages from the VT application scroll on the
console.
To start or stop the virtual tape devices:
1. Access the VTE console as described in “Access a VTE” on page 52.
2. In the VTE console, type the appropriate command. For example, to start the VT
application, type:
STARTVT
The blue bar at the bottom of the VTE console displays the changed status of the VT
application.
ESRS ESRS for VNX monitors the operation of DLm for error events and automatically
notifies your service provider of error events. It also provides a path for your service
provider to use to securely connect to your monitored DLm systems.
Modem support
DLm provides external modems to allow remote access to the ACPs for support and
diagnostic purposes. The supplied modems are attached to the ACPs. A telephone
line should be connected to the ACP modem (which in turn should be cabled to the
COM1 port of the ACP). Figure 4 on page 23 Two modems are supplied and are
connected to each ACP.
The ACP can be configured to send messages to EMC using the ConnectEMC function
when problems are detected within the VG8 or the VTEC. The ConnectEMC options
include sending the messages via a modem through a customer-supplied analog
telephone line.
DLm Administration 73
DLm Administration
Tape libraries
EMC service personnel define your storage during initial setup. This section describes
how the tape libraries are set up. DLm 3.4 supports enhanced filesystem (EFS)
configuration.
In an EFS-enabled DLm system, the tape library is made up of one or more filesystems
and may be sub-divided into storage classes. A virtual tape library is controlled by a
top level directory stored on the VTE's system disks. Each filesystem to be used as
part of the tape library must be mounted as a subdirectory within that top level
directory. The VTE automatically uses all filesystems mounted under the top level
directory to store tape volumes. For example, /tapelib/CEL1_P1_FS1, where /tapelib
is the top level directory and /CEL1_P1_FS1 is the subdirectory.
A DLm system that has EFS enabled stores any number of VOLSERs in the filesytems
within the library until space within the filesystems is depleted. Additional
filesystems can be added to the library at any time without disrupting the operation of
the library. When a new filesystem is available, DLm automatically begins using it
when initializing new tape volumes or writing to scratch volumes. Each tape volume
(VOLSER) is stored as a single file on one filesystem.
Like real tape volumes, virtual volumes are written, read, and scratched. Once a
VOLSER has been scratched within the library, it can be re-used during a future tape
allocation process.
IMPORTANT
Too many VOLSERs in a filesystem leads to performance issues. EMC strongly
recommends that you limit the number of VOLSERS to 30,000 per filesystem.
Tape libraries allow for multiple storage classes to be defined. Each filesystem
defined to a virtual library is assigned to only one storage class. The storage classes
are identified by numbers; for example: 0, 1, 2, etc. If you do not define a class, the
filesystem you define is assigned to the default storage class 0.
At least one filesystem must be defined for each virtual tape library you intend to
define. It is also mandatory to define one small (10 MByte) filesystem to use as a lock
directory.
Tape libraries 75
DLm Administration
The lock directory is identified with a global parameter called VOLSERLOCKDIR. This
parameter is defined as an additional parameter under the Global options on the
Devices panel.
Note: If you do not define a lock directory filesystem, DLm assumes that you want to
operate in compatibility mode using an existing virtual library that was created with
an earlier version of VTE software.
Backward compatibility
If you install a DLm 3.x-based VTE into an existing multiple-VTE environment with an
earlier version of software, you can operate the new VTE in compatibility mode.
To operate in compatibility mode using an existing virtual library, you simply do not
define a lock directory filesystem in the configuration. When the VOLSERLOCKDIR
parameter has not been defined on a VTE, the VTE assumes that the virtual tape
library is an existing library created with DLm software older than release 3.1.
Keep in mind that if the VTE is running in backward compatibility mode the
restrictions of the previous library architecture are all in force. Specifically, each
filesystem must be defined (mounted) in the library using the first 2 characters of the
VOLSERs that will be stored in that filesystem. Filesystems are generally restricted to
10,000 VOLSERs per filesystem and new filesystems added to the library must have
VOLSERs initialized into them before they can be used.
If you are defining a new DLm virtual tape library, EMC strongly recommends that you
define a lock directory filesystem to take full advantage of the DLm 3.x enhanced
filesystem architecture.
to make them available to all VTEs sharing the library. If there are no scratch volumes
in a storage class, DLm will not be able to satisfy a mount request for a scratch within
that storage class and the mount will remain pending.
If you have not defined storage classes (other than the default class 0), you will only
need to initialize a single range of tape volumes to the library. But if you have defined
multiple storage classes, then you must initialize a range of VOLSERs for each class
you have defined.
The command to initialize tapes is:
INITIALIZE VOL=volser DEV=devname COUNT=count [CLASS=n]
[DIR=dirname]
where:
◆ volser is the starting serial number to initialize.
◆ devname is the device name of any tape drive pointing to the tape library.
◆ count is the number of serial numbers to initialize.
◆ n is the class to which these volumes are to be added to. CLASS= is a required
parameter when using Enhanced File System (EFS), and is not valid when EFS is
not being used. Unless DIR= is also specified, the new tapes will be spread
across all subdirectories of the specified CLASS.
◆ dirname optionally specifies the subdirectory to create the volumes in. Specify
only the subdirectory, not the full path; the base tape library directory is derived
from the PATH of the DEV= parameter. For example, if the tape library is /tapelib,
specifying DIR=L2 would initialize the tapes in /tapelib/L2. DIR is an optional
parameter when using Enhanced File System (EFS), and is not valid when EFS is
not being used.
DIR is an optional parameter. DIR is not a requirement. If DIR is not specified,
INITIALIZE spreads the new tapes across all subdirectories of the specified CLASS.
CLASS is a required parameter.
Assuming device E980 is a configured device pointing to your tape library then the
command to initialize 500 serial numbers to the storage class 0 beginning with
VOLSER 000000 would be:
INITIALIZE VOL=000000 DEV=E980 COUNT=500 CLASS=0
This would result with volumes ranging from 000000 to 000499 spread across all
filesystems with class 0.
Tape libraries 77
DLm Administration
If your library has two storage classes defined, class 1 and class 2, the following
commands would initialize 1000 VOLSERs per class in the library making both classes
ready for use:
INITIALIZE VOL=000000 DEV=E980 COUNT=1000 CLASS=1
INITIALIZE VOL=001000 DEV=E980 COUNT=1000 CLASS=2
Note: Since the INITIALIZE program automatically generates VOLSERs starting with the
VOLSER specified with VOL=, make sure you do not overlap VOLSER ranges when
entering these commands.
In the example above VOL=000000 COUNT=1000 will result in the 1,000 tape
volumes being created with serial numbers ranging from 000000 to 000999.
VOL=001000 COUNT=1000 will result in volumes ranging from 001000 to 001999
being created.
Note: If your tape devices are defined in a Manual Tape Library (MTL), you must also
define them in the mainframe's tape configuration database (TCDB). You must run the
DLMLIB utility to do this. Instructions for running DLMLIB are provided in “Locate and
upload the DLm utilities and JCL for z/OS” on page 124
Planning considerations
◆ For z/OS systems, plan for one virtual device that will always be offline and can be
used by DLm utilities to communicate with the VTE.
◆ Additionally, if you plan to run the DLm z/OS started task (DLMHOST), plan for one
virtual device per VTE, (two virtual devices if DLMHOST logging is requested), to
remain offline and be used by DLMHOST to communicate with the VTE.
4. Enter values in the fields under Global options at the top of the Devices panel:
• Warn at: Sets the percentage of disk space usage at which DLm will begin to
warn about usage. Each time the contents of a filesystem changes, the VTE
checks the space used against this value. If the used space in the filesystem
is above this value, a warning will be issued. The valid range is 0 to 100. The
default is 88%.
• Erase policy: Sets the erase policy you want the VTEs to use when recovering
space on scratched tapes: Space, Time-to-Live (TTL) in days or hours, or Both.
Erase policies cannot be changed by a SET command. This is a global
parameter which applies to all tape library directories of a VTE.
“Tape Erase” on page 94 provides more information about DLm’s erase policy.
• Start space recovery at: Sets the percentage of disk space usage at which DLm
starts to recover disk space by deleting the data from scratch volumes. Valid
values are 0 to 100. The default is 85%. If the recovery percentage is set to
100, DLm will never automatically delete scratch volume data to recover disk
space.
Note: This field is visible only if the Erase policy option, Space or Both, is
selected.
• Recover amount (1-100): When DLm starts to recover disk space, it continues
erasing data from scratch volumes until this amount of free space has been
recovered or until there are no more scratch volumes that can be erased. Valid
values are 1 to 100. The default is 5%. Setting recovery amount to 100%
causes DLm to erase the data from all scratch volumes on this filesystem once
the Start space recovery at value has been reached.
Note: This field is visible only if the Erase policy option Space or Both is
selected.
• Erase scratched tapes after: Indicates the duration after which the data of a
scratched tape will be automatically erased . You can specify this time period
in days or hours. Enter a value and select hours or days.
Note: This field is visible only if the Erase policy option TTL or Both is selected.
IMPORTANT
Stagger the Time-to-Live values across VTEs to ensure that multiple VTEs do
not start TTL cleanup at the same time.
Add devices
Define the virtual tape devices (drives) to be emulated to the mainframe by this VTE in
the Control units section.
Note: Filesystems must be created before you try to add devices. This is done by EMC
service personnel during initial setup.“Tape libraries” on page 74 provides more
information about tape libraries and filesystems.
1. Add one or more controllers to the configuration by entering a valid control unit
number and selecting a device type for the devices to be defined on the VTE:
• Control unit
In the text box, type the hexadecimal control unit number that you are
configuring. For FICON, valid values are 00-FF.
• Device Type
Select the device type to be emulated: 3480, 3490, or 3590.
Note: All devices on the same Control Unit must be the same type.
3. Enter values in the fields of the Add devices section to configure the
corresponding parameters for each device:
• Control unit
The hexadecimal control unit number that you are configuring (from the list in
the Control units section under Global options).
• Add address range
The starting and ending hexadecimal device unit addresses you wish to add to
the VTE. You can define sets of 16 or multiples of 16 (n0—nF).
• Initial device name
Each device on each VTE must have a unique device name. EMC recommends
using the same device name that is defined in the UCB name in the mainframe
operating system. The name you type must end in hexadecimal digits, and the
configuration program increments the name for the number of devices you are
defining. For example, if you are defining 16 devices with an address range of
00 - 0F and you type E900 in the Device Name field, the configurator names
the 16 devices E900, E901, E902, ... E90F. The name you type may range from
1 to 8 characters long.
• Tape Library
The library to which this device is connected. To appear in the list of available
libraries, the storage must be defined on the Available tab of the Storage
panel and be connected to the VTE on the VTE tab of the Storage panel.
• IDRC
This parameter turns on or off write compression of the data that the VTE
writes to the library. The available values are Yes, No, and Force. The default
value is Yes.
When IDRC is set to Yes, the VTE compresses the data it writes to a virtual tape
disk file, but only if the mainframe instructs it to do so. Compression is
controlled differently by various host operating systems, but is generally
configurable in the JCL.
When IDRC is set to No, the VTE does not compress the data it writes to a
virtual tape disk file, despite instruction from the mainframe. When IDRC is set
to No, the VTE still reports to the host that it supports compression but it does
not perform any compression on the data it writes to the disk. This is because
some host operating systems or tape managers do not use drives that do not
support compression.
IDRC No affects only the writing of data. When IDRC is set to No, the VTE can
still read (decompress) virtual tape volumes that it previously wrote with
compression on.
IDRC Force configures the DLm virtual tape device to compress the data it
writes to a virtual tape disk file regardless of the mainframe's instructions to
the VTE regarding the tape file.
Note: Using Force with a deduplicating filesystem can severely limit the ability
of the storage system to de-duplicate and will, therefore, use more real disk
storage.
megabytes (SIZE=nnnM)
gigabytes (SIZE=nnnG)
terabytes (SIZE=nT).
Scratch synonyms
When the mainframe wants a tape volume (VOLSER) mounted on a tape device, it
sends a load display command (CCW) over the channel to the device identifying the
VOLSER to be mounted. For example, in z/OS, if a user codes JCL for a tape volume
that reads "VOL=SER=000001", z/OS sends DLm a load display CCW indicating that
the tape volume with VOLSER '000001' needs to be mounted on the drive. After
sending the load display CCW, z/OS waits for the device to become ready and then
reads the VOL1 label to verify the serial number.
z/OS uses the default character strings SCRTCH and PRIVAT to indicate a request for a
scratch tape to be mounted for output. By default, DLm recognizes these two strings
as a request for a scratch tape and mounts an available scratch tape on the requested
device to be used for output.
Most commercial tape management systems (TMS) support the concept of tape pools,
allowing you to define your own scratch pools for use when mounting a new scratch
tape. In support of TMS tape pools, DLm allows you to define unique “scratch
synonyms” to the VTEs. During installation, you can configure your own sub-pools of
scratch tapes to request tape mounts using meaningful names.
DLm accepts up to 64 scratch synonyms.
The field in the Scratch Synonyms section under Global options let you include
whatever names your installation uses to request scratch tape mounts. DLm
recognizes these synonyms, along with SCRTCH and PRIVAT, as a request for a new
scratch volume when they are in a load display CCW.
Note: Synonyms are not case sensitive and may be entered in either upper or
lower case.
• CLASSn - defines the storage class or classes associated with this scratch
synonym. For example, PRIVAT=CLASS=CLASS1 would indicate that any load
request received for PRIVAT must be satisfied by allocating a scratch VOLSER in
storage class 1. When enhanced file system (EFS)is in use, DLm first identifies
all filesystems assigned to the storage class (or classes) for this scratch
synonym and then selects a filesystem from those filesystems based on free
space and frequency of use.
If a class is not specified, then the scratch synonym will by default only apply
to the default storage class of 0.
2. Click the + button to complete the addition.
Example
Consider the following definitions of scratch synonyms:
WORK
SCRTCH=(00,01)
PRIVAT=CLASS=CLASS1
In this example any mount requested with the synonym WORK will be assigned any
available scratch tape in the default storage class 0.
A request for SCRTCH will also go to default storage (class 0), but will only be assigned
a volume with a serial number beginning with 00 or 01. If no scratch tapes with these
prefixes are available the mount will not be satisified and will remain pending.
PRIVAT tapes will go to storage assigned to storage CLASS 1. Any available scratch
tape within that class will be used. If there are no available scratch tapes in CLASS 1,
the mount will remain pending.
The syntax is very important when coding scratch synonyms. For example defining:
◆ DRTAPE=(00,01),CLASS=(CLASS1,CLASS2)
defines two synonyms, DRTAPE and CLASS. The synonym DRTAPE will use volume
serial numbers beginning with 00 or 01 in Class 0 storage. The synonym CLASS
will use only the specific VOLSERs CLASS1 and CLASS2, in Class 0 storage.
◆ DRTAPE=((00,01),CLASS=(CLASS1,CLASS2))
establishes the scratch synonym DRTAPE using VOLSERs beginning with 00 or 01
located in either storage class 1 or storage class 2.
Note: It is not necessary to define any scratch synonyms. By default, DLm allocates
any request for SCRTCH or PRIVAT to any scratch tape available on the default (class 0)
storage class.
Save configuration
1. Select the Configurations menu at the top of the screen.
2. On the Configuration operations panel, click Save Changes to save your
configuration to disk.
3. To activate the configuration file, select the VTE on which it must be installed at
the bottom of the page and click Install on nodes. “Activate or install a
configuration” on page 92 provides more information.
3. Scroll to the device range you want to delete and click the X button next it.
4. Select the Configurations menu at the top of the screen.
5. On the Configurations panel, click Save Changes to save your configuration to
disk.
“Manage configuration files” on page 92 describes the procedure to install the
updated configurations.
Note: In multiple-VTE configurations, all VTEs must be powered on and running when
you click Install.
When you click Install, the virtual tape application (VT) restarts. If your VTE is
currently online with the mainframe, EMC strongly recommends that you idle all tape
drives and vary them offline before installing a new configuration.
If your DLm system has multiple VTEs, the VT on every VTE detecting a change to its
current configuration will automatically restart. However, if you are adding a new VTE
to an existing system, you can install the configuration while the existing VTEs are
active as long as you take care not to modify any of the existing VTE’s configurations.
See “Configuration files on source and target systems” on page 113 for information
about configurations on the source and target systems in the replication environment.
Copy a configuration
1. Select the Configuration menu at the top of the DLm Console.
2. At the top right corner of the page, select the configuration file you wish to copy.
3. From the list box near the Copy to field select the config file to which the
configuration must be copied.
4. Click Copy to.
5. At the top right corner of the page, select the configuration file you just copied
changes to.
6. Click Save changes.
a. Select the Devices menu at the top of the DLm Console and make the
required changes.
b. Return to the Configuration menu and click Save changes.
• To delete the configuration file:
Click Delete.
Tape Erase
DLm supports a space recovery feature that automatically erases data from scratch
tapes on the filesystem based on an erase policy.
The available erase policies are:
◆ Space
◆ Time-To-Live (TTL)
◆ Both (default)
The erase policy is a VTE-wide setting. The erase policy can be different on different
VTEs. These erase policies affect only AWS-format scratch tapes residing on NFS
filesystems. They affect only automatic space recovery erasing. Erase policies have no
effect on erase actions performed by mainframe programs such as DLMSCR. You can
configure the erase policy using the fields described in “Configure global parameters”
on page 79.
IMPORTANT
Stagger the Time-to-Live values across VTEs to ensure that multiple VTEs do not start
TTL cleanup at the same time.
Staggering the Time-to-Live values across VTEs ensures that only the required number
of VTEs are engaged in TTL cleanup. The VTE with the minimum Time-to-Live value
starts recovering space. If that VTE cannot complete erasing the scratched tapes
before the next higher Time-to-Live value, the next VTE joins in and helps to complete
the space recovery.
For example, in a four-VTE system, if you set the Time-to-Live value of VTE4 to 48
hours, set that of VTE3 to 36, that of VTE2 to 24 hours, and that of VTE1 to 12 hours.
In the case of this example, VTE1 starts erasing tapes that were scratched 12 hours
ago. If it cannot complete the recovery, VTE2 starts at the end of the twenty fourth
hour. Both VTEs recover space until all the tapes are cleaned up. If VTE1 and VTE2
cannot complete the space recovery at the end of the thirty sixth hour, VTE3 joins
VTE1 and VTE2 in recovering space.
Both
DLm starts erasing space if either of the both conditions - Space erase or TTL policy is
satisfied.
Tape Erase 95
DLm Administration
VTE logs
VTEs maintain a log of all messages issued by the virtual tape application. Log files
are automatically rotated each day at midnight. Old log files are compressed to
minimize the space they take and then kept for a period of time.
To view the latest VTE logs:
1. Access the DLm Console using the web browser. “Connect to the DLm Console” on
page 43 provides instructions.
The System status tab of the Status menu opens by default.
2. Click the icon in the Logs column corresponding to VTE for which you need
the logs.
The logs appear in a new window or a new tab. Click Previous to view the previous
logs. Use Previous and Next to navigate through the logs.
Support data
To gather ACP and VTE details for diagnostic purposes:
1. On the Status menu, click the Gather logs menu.
The ACPs and VTEs are listed in the Machine name column.
2. Under Support data, click Gather in the row corresponding to the system for which
you want to gather support data.
The Last gathered column displays a link with the time stamp of the last gathered
data.
A pop-up window confirms the request followed later by another pop-up
indicating that the Gather is complete.
3. Click the link in the Last gathered column to download the support data.
The downloaded file is a zip file with the name <machine-date-time-logs.zip>; for
example, acp2-2011-04-26_19-13-08_logs.zip.
Note: DLm supports only point-to-point attachment of a single 3592 or TS1120 tape
drive to the VTE. Connection through a Fibre Channel switch is not supported.
After the drive is physically attached to a VTE, you have two choices:
◆ Map a single mainframe tape drive (device address) to the physical tape drive for
writing real tape cartridges from the mainframe. This capability is referred to as
Direct Tape.
◆ Use the DLm VTE-based Export and Import utilities to copy individual volumes
(VOLSERs) from or to the tape.
Direct Tape
DLm is primarily a tape-on-disk controller, which emulates tape drives to the
mainframe and stores tape volumes on a back-end disk subsystem. However, it also
allows a tape-drive-to-tape-drive mapping of an emulated 3590 tape drive to a
physical IBM tape drive attached to a DLm VTE.
Device mapping
To map a single mainframe device address through to a Fibre Channel attached IBM
3592 or TS1120 tape drive, modify the virtual device definition to point the device to
the physical drive instead of a virtual tape library on disk.
For the device being mapped to the physical drive, you must replace the Tape Library
parameter with the following parameter:
DRIVE-nnnnnnnnnnnn
where nnnnnnnnnnnn is a 12-digit serial number for the tape drive. (Figure 25 on
page 84 shows Tape Library field in the Add devices section of the Tape Device
Configuration page.) If your drive serial number is less than 12 characters in length
then you must pad the number to the left with zeros. For example, if your serial
number is 7818330, then you would enter DRIVE-000007818330 into the Tape
Library field for the mapped drive. The emulated tape drive must be configured to
match the characteristics of the physical tape drive. The device being configured must
be defined as Device Type 3590. (See Figure 24 on page 83.)
On the required VTEn tab under the Devices menu of the DLm Console, make these
changes:
1. In the Control Units section, specify the device type as 3590. “Add devices” on
page 82 provides more information.
2. In the Add devices section, enter DRIVE-<12-digit drive serial number>.
a. Access the VT console as described “Access a VTE” on page 52.
b. Obtain the drive serial number by typing the following on the VT console:
show drive list
If the tape drive is not listed you will need to follow the next steps:
a. Vary the drives defined on this VTE offline to the mainframe.
b. Verify that the external tape drive is powered on.
c. Verify that the external tape drive is connected to the Fibre Channel adapter of
the VTE.
d. Verify that the VTE's operating system driver can see the external tape drive.
Open the VT console as described in “Access a VTE” on page 52 and enter the
following commands:
scsiadd
Ensure that you see the external tape device in the output.
e. Stop and start the VTD to pick up the new tape drive information. Type:
STOPVT
STARTVT
f. Obtain the drive serial number by typing the following on the VT console:
show drive list
If the tape drive is still not listed you will need to reboot the VTE from the
webconsole interface as described in “VTE reboot” on page 55.
Compression
DLm supports IDRC data compression. If a mainframe tape device mapped to a
physical fibre channel attached drive requests compression VTE will instruct the drive
to compress the data before writing it to tape. The tape drive, rather than DLm, will
perform the data compression in order to ensure compatibility with other IBM drives
that may later attempt to read the data.
Note: DLm does not support import and export of scratch tapes.
“EXPORT” on page 150 provides details about how to use the EXPORT command.
“IMPORT” on page 153 provides details about how to use the IMPORT command.
VTEC
The VTEs continually generate informational, warning, and error messages as they
operate. These messages are written to the internal system disk so that they can be
retrieved as necessary during problem determination. Messages will also be
automatically displayed on the VT console.
Additionally, DLm is capable of sending informational, warning, and error messages
to any of the following:
◆ An SNMP management console
◆ The z/OS master console via a z/OS started task
You can configure which messages get sent to each destination using the Messages
panel of the DLm Console.
For sending messages to SNMP:
1. Configure the message destinations.
2. Configure which messages should be sent. “Configure messages and recipients”
on page 104 provides more information.
For z/OS messages you must install the z/OS started task and then configure which
messages you want sent. “DLMHOST” on page 142 provides more information.
SNMP
The VTEC contains SNMP MIBs that monitor the system and report events. Once
configured, the VTEC can send SNMP alerts to a designated SNMP manager. SNMP
alerts are sent as SNMPv2c traps on port 162 using the community name 'public.'
To configure the VTEC to send SNMP alerts:
1. Access the DLm Console as described in “Connect to the DLm Console” on
page 43.
2. Click External.
3. Select the Notify tab.
4. Under SNMP notifications, type the host name or IP address of one or two systems
where you want SNMP management messages to be sent.
If either of the SNMP manager host fields contain a valid host name or IP address,
the VTE forwards messages to that host. If both fields are blank then SNMP
messaging is inactive.
Each tab shows a complete list of all DLm messages in that particular category.
3. Select the tab corresponding to the message type you want to configure.
All messages in the Errors message routing tab are preselected and cannot be
deselected.
4. Select the check boxes in the following columns to send alerts to the
corresponding recipient:
• SNMP
• Mainframe
5. Click the toggle all check boxes to reverse the selection.
ConnectEMC
The VNX VG8 ConnectEMC function can automatically notify the EMC service center or
other service providers if the VTEC or VNX VG8 system detects a serious problem.
ConnectEMC sends messages using email, FTP, or a VNX VG8 modem (through a
customer-supplied analog telephone line).
You can configure the VTEC to generate ConnectEMC events for error level SNMP traps.
“VTEC errors that generate ConnectEMC events” on page 380 provides a list of traps
that generate ConnectEMC events.
The mainframe block in Figure 32 on page 107 can represent multiple mainframes or
multiple LPARS within one, or mainframes with functions that include production
LPARS for both VMAX DASD and VMAX Tape.
The VG8 IP replication is not supported since all replication will be handled by SRDF.
This chapter provides information about the DLm SRDF Replication (SRDF) feature. The
major topics include:
◆ SRDF Replication Overview ............................................................................. 110
◆ SRDF connections and configuration .............................................................. 111
◆ Disaster recovery capabilities ......................................................................... 113
◆ SRDF benefits................................................................................................. 114
1. The local system containing the primary volumes (Source) receives a write option
from the host.
2. The write I/O is transmitted to the remote Symmetrix system (secondary target
volume). The local Symmetrix system does not accept other write options to the
primary volume.
Note: The next write I/O is sent to the destination system only after the first write is
acknowledged in step 3.
The destination remains on standby when the mirroring between the systems is
carried out. The destination is powered up and its Control Station is fully operational
when on standby, and provides complete hardware redundancy for the source.
SRDF benefits
SRDF offers several benefits:
• It protects against local and regional site disruptions.
• It helps in maintaining continuous data availability and multiple remote
recovery sites.
• It assists in meeting regulatory requirements.
• SRDF provides near-instant recovery.
• It migrates, consolidates, or distributes data across storage platforms which
helps in data center consolidations and technology refreshes.
SRDF enables non-stop operations and provides application restart across volumes.
Configure devices
z/OS uses the Hardware Configuration Definition (HCD) utility to define devices on the
system. HCD provides an interactive interface that allows you to define the system's
hardware configuration to both the channel subsystem and the operating system.
The three alternatives for configuring DLm devices on the mainframe are:
◆ Configure the devices as real 3480, 3490, or 3590 tape drives.
◆ Configure the devices as MTL devices.
◆ Configure the devices with a unique device type using the EMC UIM.
These alternatives are discussed in the following sections. The preferred approach is
to configure the devices as MTL devices.
If you are planning to use DLm with IBM's Object Access Method (OAM), you must
configure the devices as MTL devices. OAM needs tape drives to be SMS-managed
and treats them on the host as a single tape library. The IBM document SC35-0427,
DFSMS Object Access Method Planning, Installation, and Storage Administration
Guide for Tape Libraries provides more information on using a library for OAM object.
Note: This does not require the use of the EMC UIM; use the standard HCD 3490
or 3590 definitions.
2. On the Device/Parameter Feature definition screen for each drive, choose YES for
MTL and supply an artificial LIBRARY-ID and LIBPORT-ID.
3. Define the control unit as a 3490 or 3590 with 16 tape drives available.
4. Be sure that all the devices in the same logical library have the same LIBRARY-ID,
with each group of 16 devices having a unique LIBPORT-ID.
IBM requires that there be only 16 tape drives to a LIBPORT-ID. As a result, you
must configure multiple control units on the same channel using different logical
control unit addresses when you want to configure more than 16 drives.
5. Make sure that each control unit's devices have the same LIBRARY-ID, but a
unique LIBPORT-ID per control unit.
6. Maximum number of tape drives defined in an MTL is 512. If more tape drives are
needed, a second MTL must be defined.
Table 6 on page 118 contains an example of having the same LIBRARY-ID with its
unique LIBPORT-IDs.
After defining DLm using HCD, it must be defined to SMS using the library
management function. Then your ACS routines must be updated to allow jobs to
select the new library with appropriate user defined ACS management, data, and
storage classes and groups. For example, if you define a new esoteric called VTAPE,
your ACS routines could allocate the dataset to the SMS storage group using the DLm
MTL whenever UNIT=VTAPE is specified in JCL.
The characteristics of DLm virtual tape cartridges match the SMS Media Type:
"MEDIA2" for 3490 or "MEDIA4" for 3590. Make sure that you specify the appropriate
media type (MEDIA2 or MEDIA4) on the Library Definition screen. In addition, since
SMS requests scratch tapes using media type, you must add MEDIA2 or MEDIA4 to the
list of DLm scratch name synonyms as explained in “Scratch synonyms” on page 88.
Z/OS might request for mounts by media type based upon the DATACLAS definition.
The customer's ACS routines or tape display exits may also change the mount request
to use storage group names, LPAR names, pool names etc. All such names must be
entered into the synonym list.
Note: After you configure the MTL, it is treated as a real library; that is, you must enter
cartridges into the library before DLm can use them. Use the DLMLIB utility to enter
cartridges into the MTL.
Before using the DLMLIB utility, contact your specific tape management system
vendor for their customizations that interface with IBM's MTL.
You must execute DLMLIB out of an authorized library. EMC provides an example of
the JCL required for linking DLMLIB. The sample JCL file is found in the LNKLIB member
of DLMZOS.JCL.CNTL. Step 4 on page 125 provides download instructions.
EMC also provides an example of the JCL required to run DLMLIB. The sample JCL file is
found in the RUNLIB member of DLMZOS.JCL.CNTL. Step 4 on page 125 provides
download instructions.
The log file lists the result of each cartridge entry request, including any error codes.
The utility invokes IBM's LCS External Services (CBRXLCS) macro.
Return codes and reason codes can be found in the chapter “OAM Diagnostic Aids,” of
DFSMSdfp Diagnosis (GY27-7618).
Note: MTL devices do not support the demand allocation (UNIT=xxxx) method, which
selects a specific drive on a particular VTE, thereby enabling a batch utility to
communicate with that VTE.
Use one of these methods to enable a batch utility to communicate with a specific VTE
in an MTL defined with multiple VTEs:
◆ Omit a single drive from the MTL in each VTE's device group.
For example, consider an MTL defined with two VTEs, each configured with 64
devices:
a. In each VTE, define 63 devices as MTL=YES in the HCD. One device would be
MTL=NO in the HCD.
b. Subsequently, use demand allocation in JCL to select the specific drive
address that is outside the MTL.
EMC recommends that you leave this drive offline to prevent inadvertent
allocation by other jobs. One way to accomplish this is to bookend your jobs with
steps to vary the device online and offline with an operator command utility
program.
The DLMCMD, DLMSCR, and GENSTATS batch utility programs now support the
use of the EXEC statement parameter DEV=xxxx, which allows access to an offline
tape device.
Type the code as follows:
EXEC PGM=DLMCMD,PARM='DEV=xxxx'
where xxxx is the offline virtual tape device on the VTE you wish to access.
IMPORTANT
Ensure the tape device is offline before you run any utility with the DEV=
parameter.
The device specified in the DEV= parameter must be offline. When the DLMCMD,
DLMSCR, or GENSTATS utility is used with the DEV= parameter when the specified
device is online, DLm displays the corresponding 182I message and terminates
the operation.
For DLMCMD and DLMSCR steps, this parameter eliminates the need to code a
DLMCTRL DD statement.
For GENSTATS, this parameter eliminates the need to code a GENIN DD statement.
◆ Define a separate MTL for each VTE to enable VTE selection:
a. Similar to the previous method, define only 63 devices on each VTE as part of
the same MTL.
b. For each VTE, define a separate MTL (different LIB-ID) for the remaining device,
as well as a new esoteric.
c. Use ACS routines to select the appropriate library that limits the available
drive selection to that one drive.
After installing the UIM, you can configure the DLm devices in HCD. The UIM provides
the following:
◆ Four control unit types: V3480, V3481, V3482, and V3483
◆ Four supporting device types: V3480, V3481, V3482, and V3483
The generic names for these devices are also V3480, V3481, V3482, and V3483. If
you have already defined a generic name of V348x, contact EMC for support. You must
define multiple virtual device types to support the multiple DLm systems or a single
DLm with multiple virtual tape libraries configured.
You must define a V348x tape drive for each virtual tape device that you have
configured in DLm. All virtual tape drives assigned to the default virtual tape library in
the DLm filing structure (/tapelib) are normally defined with the same generic name
(for example, V3480). If you plan to have a drive assigned to a different tape library
path in the DLm filing structure, you should define that drive with a separate generic
name (for example, V3481).
Once the DLm device definitions are active, you must either specify UNIT=V348x or
hard code the unit address allocated to a device. In this way, regular jobs that call for
real tape drives or use tapes previously cataloged on real 3480s are not allocated to
the DLm devices. After a tape is cataloged as created on a V348x device, it is allocated
to that same device type when called again. Conversely, a tape cataloged as created
on a real tape drive is not allocated to a device.
DFSMShsm considerations
If you plan to use DLm with HSM, the various SETSYS tape parameters do not accept
V348x generic names as valid. In that case, it is necessary to define esoteric names
that are unique to the various V348x devices.
To identify esoteric tape unit names to DFSMShsm, you must first define these
esoteric tape unit names to z/OS during system I/O generation (HCD). Then, you must
include the esoteric tape unit names in a DFSMShsm SETSYS USERUNITTABLE
command. Only after they have been successfully specified with the SETSYS
USERUNITTABLE command are they recognized and used as valid unit names with
subsequent DFSMShsm commands.
Locate and upload the DLm utilities and JCL for z/OS
EMC provides a set of utilities and a UIM for the z/OS environments. The utilities are:
◆ GENSTATS — A utility that generates reports from VTE and VOLSER range statistics
◆ DLMSCR — A scratch utility that sends VOLSER scratch requests to DLm
◆ DLMCMD — A utility that allows the mainframe to send DLm commands
◆ DLMLIB — A utility that is required to define scratch volumes on an MTL
◆ DLMVER — A utility that reports the versions of all the DLm mainframe utilities on
the mainframe and the z/OS release.
◆ DLMHOST — A host utility that provides z/OS Console Operation support.
Chapter 6, “z/OS Console Support,” provides details about this utility.
Downloading and using the DLm utilities and JCL for z/OS
To use any of these utilities, or the UIM:
1. Download the file DLMZOS-<version number>.XMI from the EMC support website
(http://Powerlink.EMC.com). Select Navigator > Disk Library Tools and transfer the
file to the mainframe as follows:
ftp target_system_name
2. After transferring the file, use ISPF function 6 (Command Shell) and type:
receive indataset('uid.dlmzos.xmi')
4. Transfer the DLMZOS.JCL file to the host. You must first unzip this file from the
DLMZOS.JCL <version>.zip file.
The DLMZOS.JCL file contains a sample JCL to link and execute these batch
utilities. The file is available at the EMC support website:
http://Powerlink.EMC.com. Select Navigator > Disk Library Tools. To transfer the
file, type:
ftp target_system_name
Locate and upload the DLm utilities and JCL for z/OS 125
Mainframe Tasks
5. After transferring the file, use ISPF function 6 (Command Shell) and type:
receive indataset('uid.dlmzos.jcl')
6. At the prompt, Enter restore parameters or delete or end, type:
da('DLMZOS.JCL.CNTL')
DLMZOS.JCL.CNTL will then be populated with the sample JCL. See member
$INDEX for a list of its contents.
7. If you plan to use the DLMCMDPR or GENSTATP procedures for Command Process
jobs, (See EMC Disk Library for mainframe Command Processors User Guide)
perform the following steps:
a. Copy the DLMCMDPR and GENSTATP procedures to a common PROCLIB.
b. Create a PDS dataset for the DLMCMD1, DLMCMD2, and DLMCMD3 REXX
programs contained in the DLMZOS.JCL dataset. Specify this REXX dataset in
the REXXLIB parameter in the DLMCMDPR and GENSTATP procedures. You can
optionally keep the REXX programs in the DLMZOS.JCL dataset and instead
just specify the DLMZOS.JCL dataset name in the REXXLIB parameter.
c. Specify the dataset name of the DLMZOS.PGMS dataset created in step 3
above in the BTILIB parameter in the DLMCMDPR and GENSTATP procedures.
GENSTATS utility
The GENSTATS utility generates reports on the tape mount and unmount statistics
logged at the VTE level and at the VOLSER range level. It can selectively present:
◆ Daily and hourly throughput numbers
◆ Mount rates
◆ Concurrent tape drive usage details
◆ Compression ratio
Locate and upload the DLm utilities and JCL for z/OS 127
Mainframe Tasks
Table 7 on page 128 lists the DLMSCR parameters that may need to be specified.
Parameters Specification
TYPE=x Where x is used to select the tape management system. Valid types include
RMM, TLMS, TMS, TSM, ZARA, CTLM, AFM, or CTLT. This is the only required
parameter.
PREFIX=y Where y is a string of prefix characters that limits processing to volumes whose
VOLSER begins with the characters specified. Unless otherwise specified by the
PREFIXLN parameter, the default prefix length is 2.
PREFIX=AAABAC would cause DLMSCR to process only volumes whose serial
numbers begin with AA, AB, or AC. Coding this parameter prevents DLMSCR
from trying to unnecessarily scratch volumes that are not stored on DLm. If no
PREFIX is specified, DLMSCR processes the entire scratch list.
PREFIXLN=n Where n can be a single digit between 1 and 5. This value replaces the default
prefix length of 2 for the PREFIX= parameter.
PARM='PREFIX=ABCD,PREFIXLN=1' causes DLMSCR to process only volumes
whose serial numbers begin with A, B, C, or D.
NODSNCHK DLm normally validates dataset names (dsname) if found in the scratch report
as part of the scratch process. A scratch is not successfully completed if the
dsname in the scratch report does not match the dsname in the HDR1 label on
the volume being scratched. NODSNCHK prevents the data set name check
from being performed and is not recommended for normal use.
FREESPACE By default, DLMSCR reclassifies volumes being scratched as eligible for scratch
allocation requests, without freeing the space occupied by that volume. The
FREESPACE parameter may be used to request that the space be freed.
Keep in mind that DLm automatically frees the space of scratched volumes
when it needs space. So, it is generally not necessary to run DLMSCR with the
FREESPACE parameter.
Note: Once FREEAFTERSCR frees the space associated with the execution
ofDLMSCR, the volume cannot be recovered if it was scratched by mistake.
Parameters Specification
NODATECHK DLm normally checks the creation date of a tape volume and does not allow
any volume to be created and scratched in the same 24-hour period. Setting
this parameter allows volumes to be created and scratched on the same day.
This parameter ignores the default date check in DLMSCR.
IGNLCSERR This parameter ignores any errors reported by Library Call Subsystem (LCS)
used by OAM with the MTL volumes. Normally, DLMSCR logs any error returned
by LCS and stops processing scratch tapes when these errors occur. If this
parameter is set, DLMSCR scratch processing continues even when the LCS
errors are encountered.
ALLVOLS This parameter allows scratch of volumes with dsnames of all zeros.
IGNLCSRC4 This allows DLMSCR processing to continue after receiving a return code of 4
from LCS processing, but terminates if the return code from LCS processing is
greater than 4.
NOTCDB This prevents DLMSCR from attempting any TCDB updates. This should be used
only if the TMS already performs this function.
NOTIFSCR This prevents DLMSCR from attempting to change the TCDB use attribute to
scratch if DLm reports that the VOLSER was already scratched.
TEST This parameter allows for testing—no actual changes will be performed.
DEV=xxxx This allows the specification of an offline virtual tape device and the
elimination of the DLMCTRL DD statement as shown on page 119.
USETMC [CA-1 TMS environments only] This parameter enables DLMSCR to directly read
the CA-1 Tape Management Catalog (TMC) to find DLm-resident VOLSERs which
have been scratched and send the appropriate scratch requests to DLm for
processing. Use of the USETMC option requires that the DLMSCR DD JCL
statement point directly at the TMC (or a copy of the TMC).
SYNC [CA-1 TMS environments only] This parameter is valid only if specified along
with the USETMC parameter. It enables DLMSCR to synchronize the status of
the VOLSERs in the Tape Control Data Base (TCDB) and the DLm library with
those in the CA-1 TMC.
Locate and upload the DLm utilities and JCL for z/OS 129
Mainframe Tasks
Note: ALL messages are proceeded by: mm/dd/yyyy hh:mm:ss VOLUME xxxxxx.
0x01 REQUEST REJECT - INVALID Invalid data length (must be 17, 23, or 40 bytes).
LOAD/DSPLY
0x05 REQUEST REJECT - INVALID Invalid VOLSER specified - The input volume serial number does
VOLSER not conform to the standard volume naming convention. Check the
input TMS report.
0x06 REQUEST REJECT - VOLUME Volume in use on the same or different VTE or there is a possibility
IN USE of a STALE LOCK.
0x07 REQUEST REJECT - VOLUME Volume not found in file system; Make sure input tape device
NOT FOUND number points to correct tape library (i.e /tapelibxxx).
0x08 REQUEST REJECT - I/O ERROR I/O error has occurred during scratching process - refer to btilog for
additional information.
0x09 REQUEST REJECT - VOLSER File is locked - volume might be in use by another tape drive on this
LOCKED VTE or another VTE or there is a possibility of a STALE LOCK
0x0A REQUEST REJECT - Tape library directory is not accessible - Verify tape unit selected for
DIRECTORY PROBLEM A utility points to correct tape library.
0x0B REQUEST REJECT - Tape library directory is not writeable - Verify that tape library is
DIRECTORY PROBLEM B marked for Read/Write.
0x0C REQUEST REJECT - Invalid or missing VOL1 label in volume - Using AWSPRINT verify
INVAL/MISSING VOL1 volume VOL1 record has not been overwritten.
0x0D REQUEST REJECT - VOLSER The volume serial number from the TMS report and the VOL1 HDR
MISMATCH do not match; VOL1 HDR might have been overwritten.
0x0E REQUEST REJECT - Invalid or missing HDR1 label in volume - The HDR1 record is not in
INVAL/MISSING HDR1 the correct format; overlayed because of error; use AWSPRINT
utility to determine error.
0x0F REQUEST REJECT - Data Set Name mismatch - The last 17 alphanumerics of dsname
MISMATCHING DSNAME on the volume from input does not match HDR1 name on the
volume HDR1. This can be overridden using NODSNAMECHK.
0x10 REQUEST REJECT - INVALID The TMS input report date does not match the execution date of
DATE PASSED DLMSCR
0x11 REQUEST REJECT - CREATE Date mismatch - DLMSCR, unless overridden using NODATECHK,
DATE=TODAY defaults to no scratch same day.
0x12 REQUEST REJECT - FILE NOT File not writable - The filesystem directory is probably marked as
WRITEABLE Read Only; This might be target site.
Note: The hex codes listed are the error codes that the VTE returns to DLMSCR when
DLMSCR requests an action on a volume.
Locate and upload the DLm utilities and JCL for z/OS 131
Mainframe Tasks
RMM considerations
Observe the following rules when using DLm with RMM:
◆ Predefine the DLm scratch volumes to RMM. If you have not predefined DLm
VOLSERs as scratch in RMM, RMM rejects the new volumes, which results in an
unsatisfied mount request on the mainframe. To resolve the unsatisfied mount,
define the DLm scratches in RMM, and execute a LOAD command at the
appropriate VT console to satisfy a stalled request.
◆ When defining a new DLm scratch tape to RMM, set the initialize option to no. If
you select yes and RMM detects that the volume must be initialized (or EDGINERS
is run), RMM sends a request to mount a 'blank' VOLSER on a DLm device. DLm is
not automatically ready as it cannot recognize which volume to mount.
Consequently, you must use the LOAD command at the VT console to manually
mount each volume being initialized.
TMS considerations
DLMSCR expects Report-05, Report-06, or Report-87 to be used.
TLMS considerations
DLMSCR expects either the TLMS003 or the TLMS043 report as input.
TSM considerations
DLMSCR expects a Tivoli Storage Manager (TSM) Volume History Report to be used as
input to the DLMSCR DD.
ZARA considerations
DLMSCR expects the LIST SCRATCH type of scratch report to be used as input from
ZARA.
CA-1 considerations
Although there are various reports supported by TMS (CA-1), DLMSCR expects
Report-05 or Report-06 or Report-87 to be used.
The report generation parameters should request the field DSN17 instead of the
default DSN. (See PRIMUS EMC204223.) Otherwise, the report for multi-volume
multi-file tapes will have the incorrect DSN for all but the first VOLSER. Those volumes
with incorrect DSN will fail the DSN validity check performed by DLMSCR before
scratching a tape.
Unique to CA-1 TMS environments only, DLMSCR supports the following 2 additional
run time parameters:
◆ USETMC - When this parameter is specified, DLMSCR directly reads the CA-1 Tape
Management Catalog (TMC) to find DLm-resident VOLSERs which have been
scratched. A separate execution of the CA-1 scratch report utility (EARL) is not
Locate and upload the DLm utilities and JCL for z/OS 133
Mainframe Tasks
required. Use of the USETMC option requires that the DLMSCR DD JCL statement
point directly at the TMC (or a copy of the TMC). DLMSCR scans the TMC and
sends the appropriate scratch requests to the DLm for processing.
Note: When using the USETMC option, DLMSCR sends a scratch request for any
scratch volume (those that pass prefix filtering) it finds in the TMC. This might
result in a large number of DLm500I messages followed by DLm524W messages
being issued to the DLm VTE btilog whenever DLMSCR is run. This is normal. The
DLm500I message indicates that the VTE application has received a request to
scratch a VOLSER. The DLm524W message indicates that the VOLSER was already
scratched.
◆ SYNC - This parameter is valid only if specified along with USETMC. The SYNC
option causes DLMSCR to synchronize the Tape Control Data Base (TCDB) and the
DLm library with the CA-1 TMC. The status of the VOLSERs in the TCDB and in the
DLm library will be changed from active to scratch or from scratch to active as
required to match the status of the CA-1 Tape Management Catalog (TMC).
Note: When using the SYNC option DLMSCR sends an unscratch request for any
active volume it finds in the TMC. This may result in a large number of DLm500I
messages followed by DLm524W messages being issued to the VTE btilog
whenever DLMSCR is run. This is normal. The DLm500I message indicates that the
VTE application has received a request to unscratch a VOLSER. The DLm524W
message indicates the VOLSER was already unscratched.
TMS users who use Scratch Pool Management and need to limit the eligible scratch
volumes to a limited range of VOLSERs must install the TMS usermod CL05219
(CTSMSGEX exit). When this exit is linked into IGX00030, an IPL with CLPA is required
to activate it. The exit causes the first 8 characters of the scratch poolname to be
placed into the Load_Display mount message that is sent to the tape drive. This
poolname can be defined as a scratch synonym so that the VTE application software
can restrict the eligible scratch volumes to a specific prefix group.
Note: The DLMCMD utility accepts input cards up to 256 characters in length.
Continuation lines are not allowed.
Indication of success or failure is logged to the file that the DLMLOG DD statement
points to.
Note: Any messages and other textual results of the command that display on the
DLm Console are not returned to the host.
Locate and upload the DLm utilities and JCL for z/OS 135
Mainframe Tasks
◆ The DLMLOG DD statement points to a sequential file for logging the DLMCMD
results. This file should have a logical record length (LRECL) of 133. If an error
occurs during command processing, the failure is recorded in the log file, and a
non-zero return code from DLMCMD results. Table 9 on page 136 lists the
possible error codes from DLMCMD.
0xFC (-4) An "E" level error other than general syntax error occurred.
(A console error message other than DLM891E was displayed.)
2. Use of PARM='CMD=' — Allows you to pass a single command on the EXEC card
instead of using the DLMCMD input file. This method also allows you to call
DLMCMD from another program, and pass the command as an entry parameter.
For example:
//LOG EXEC PGM=DLMCMD,PARM='CMD=Q SPACE'
//DLMLOG DD DSN=DLM.LOGFILE,DISP=OLD
//DLMCTRL DD DSN=DLM.CTRL,UNIT=3590,VOL=SER=BT9999,
DISP=(,KEEP)
Note: If you experience issues with the DLMCMD, check the /var/log/messages file for
error messages.
Locate and upload the DLm utilities and JCL for z/OS 137
Mainframe Tasks
This JCL example will invoke the DLMVER utility to report on the DLm versions for the
DLm load modules stored in the User.Loadlib. You can modify the STEPLIB to point to
the installed DLm load library.
◆ DLMVER sample JCL 2
//S1 EXEC PGM=DLMVER,PARM='WTO'
Note: DLMVER will report on the DLm load modules present in any active LINKLST
regardless of whether a STEPLIB or JOBLIB is present in the JCL.
DLMVER Messages
The messages related to DLMVER are:
◆ DLV010I UTILITY VERSIONS ( ):
◆ DLV050I LOG FILE FAILED TO OPEN
“DLMVER messages” on page 375 provides the details.
The example creates a non-labeled tape called SAIPL in the tape library assigned
to the virtual tape drive named E980. You may use any VOLSER of your choice.
Replace E980 with the name of a virtual tape drive configured on your DLm.
Specify the "scratch=no" parameter so that that no scratch tape mount request
can acquire the volume before you are ready to use it.
2. On the DLm Console, manually mount this tape on any virtual tape drive assigned
to the tape library where you initialized your stand-alone IPL tape volume:
load SAIPL E980
This command causes the virtual tape volume SAIPL to be mounted on the DLm
virtual tape drive, E980. In your scenario, replace E980 with the name of a virtual
tape drive configured on your DLm. It can be any DLm virtual tape drive that is
assigned to the tape library where the stand-alone IPL tape volume resides.
3. From the mainframe, write the stand-alone IPL tape to the virtual tape drive where
the target tape is mounted. Explicitly specify the VOLSER you mounted in the
previous step.Once the stand-alone IPL tape has been created, it is ready to use.
This command causes the virtual tape volume SAIPL to be mounted on DLm virtual
tape drive, E980. In your scenario, replace E980 with the name of a virtual tape drive
configured on your DLm. It can be any DLm virtual tape drive that is assigned to the
tape library where the stand-alone IPL tape volume resides.
On the mainframe console, select as IPL device the DLm virtual tape drive where the
stand-alone IPL tape is mounted, and perform the IPL.
The mainframe will perform the IPL from the stand-alone IPL tape mounted on DLm.
DLMHOST
DLMHOST is a host utility that provides z/OS Console Operation support. The
DLMHOST utility runs as a started task, and accepts commands from the operator. By
default, DLMHOST uses Write-to-Operator (WTOR) capabilities for sending DLm
commands. Optionally, you may configure DLMHOST to use the z/OS MODIFY
function in place of WTOR.
At startup, DLMHOST reads a configuration file that defines the VTEs to be supported
as well as the device addresses, per VTE, to be used for communication and logging.
Each DLm VTE will be identified with a unique name so that commands can be
targeted to specific VTEs. A tape drive device address must be selected from each
VTE's range of addresses that will be used as the command/communication path. A
second device address is required on each VTE if you want DLm to send log messages
to the z/OS console. These devices will not be eligible for allocation once DLMHOST
has been started.
Only log messages that have passed message filtering will be received by the host.
It should be noted that, depending upon the filtering options set on the VTEs, there
may be many log messages sent to the consoles. Optionally, DLMHOST supports a
configuration option to send the messages to a host file instead of the operator's
console.
Installing DLMHOST
DLMHOST is only supported in a single Logical Partition (LPAR). You cannot connect
multiple DLMHOST tasks running in multiple LPARs to the same DLm VTE.
DLMHOST is distributed in the 3.0 DLMZOS.XMI and the package is available on the
EMC support website. “Downloading and using the DLm utilities and JCL for z/OS” on
page 124 provides more details.
The DLMHOST utility must be linked as an authorized program into an authorized
library under the name DLMHOST. It is highly recommended that RACF be used to
restrict the use of DLMHOST to authorized users only.
An example of the JCL required to link DLMHOST follows:
//L EXEC PGM=HEWL,PARM='MAP,LET,LIST,NCAL,AC=1'
//SYSLMOD DD DSN=USER.LIBRARY,DISP=SHR
//SYSUT1 DD DSN=&&SYSUT1,SPACE=(1024,(120,120),,,ROUND),
// UNIT=SYSALLDA,DCB=BUFNO=1
//SYSPRINT DD SYSOUT=*
//DDIN DD DSN=DLM.MODULE,DISP=SHR
//SYSLIN DD *
INCLUDE DDIN(DLMHOST)
NAME DLMHOST(R)
/*
Running DLMHOST
The following JCL is used to execute DLMHOST:
//DLMSTEP EXEC PGM=DLMHOST,PARM='parameters'
//DLMCFG DD DSN=PARMLIB(nodecfg),DISP=SHR
//DLMLOG DD DSN=logfilename,DISP=SHR
//* THE FORMAT OF THE CONFIG FILE IS AS FOLLOWS:
//* Col 1 -10 Nodename
//* Col 12-15 Command path device address
//* Col 17-20 Log path device address
//* Col 22-29 Console name
Note: EOJ can be specified as the last command to terminate DLMHOST after a
series of commands.
DLMHOST 143
z/OS Console Support
◆ NOLOG—Prevents DLMHOST from receiving continuous log data from any VTE. Set
this parameter if you plan to use DLMHOST only to send commands from the z/OS
Console to the DLm. Command responses will be returned even when NOLOG is
specified.
◆ NOWTOR—Prevents DLMHOST from issuing the normally outstanding WTOR. When
this parameter is specified, MDL commands can be issued using the z/OS
MODIFY command as the method of communication in place of WTOR.
◆ LOGFILE—Causes any received log data from the DLm system to be recorded in the
file pointed to by the DLMLOG DD card. When LOGFILE is specified, the log
messages are not sent to any console via WTO. If LOGFILE is not specified, the
DLMLOG DD card is not required in the JCL. The LOGFILE dataset should be an FB
LRECL 133 file, and will be opened for extend each time the task is started.
◆ EZSM — - EZSM- Causes z/OS Console messages that are replicated from the DLm
to be prefixed with 'DLM' followed by a severity character, ('E' for error, 'W' for
warning, and 'I' for informational messages). This parameter allows for an
installation to use EzSM DLm Message Alerts that have wildcards for DLME,
DLMW, and DLMI for handling these types of messages.
EMC provides sample JCL to run DLMHOST. “Locate and upload the DLm utilities and
JCL for z/OS” on page 124 provides instructions to download the sample JCL. The
sample JCL xmit file includes a sample PROC member to run the DLMHOST utility. This
proc must be customized to point to the APF authorized load library that DLMHOST
has been installed in. Also, one or more configuration statements must be completed
for the DLMCFG DD. The customized proc should be placed into a PROCLIB that is
searched when the START DLMHOST command is issued from the zOS Console.
Col. 1 - 10 : NODENAME
The name used by the mainframe operator to identify which VTE to communicate with.
This command returns the reply message number for any outstanding WTORs on the
system.
To issue a command to DLMHOST, enter the command using the WTOR message
number in the following format:
msg#,COMMAND
Where:
msg# is the reply message number returned from the d r,l command.
COMMAND is the DLMHOST command to be executed.
When DLMHOST is executed with the NOWTOR parameter, the following message is
returned:
DLM002I jobname USE MODIFY TO ENTER COMMAND, EOJ, OR ? FOR HELP
where:
jobname is the job name of DLMHOST reported in the DLM002I message.
command is the DLMHOST command to be executed.
DLMHOST commands
The following commands are recognized by DLMHOST:
◆ CMD
The CMD sends a DLm command to a specific VTE.
This command requires a nodename also be specified by using the NODE=
parameter (or N=).
A nodename of ALL can be specified to send the command to every VTE.
All DLm Operator commands can be entered as parameters to this command.
The following are examples of valid use of this command:
CMD=Q SPACE,NODE=NODE1
CMD=FIND VOLUME 000001,N=N1
◆ STOPLOG
The STOPLOG command requests that DLMHOST stop logging VTE log messages
for a specific VTE. This command requires that a nodename be specified by using
the NODE= parameter (or N=).
A nodename of ALL can be specified to stop host logging for all defined VTEs.
For example:
STOPLOG,N=ALL
STOPLOG,N=VTLNODE1
◆ STARTLOG
The STARTLOG command requests that DLMHOST start host logging of VTE log
data for a specific VTE. This command requires that a nodename be specified by
using the NODE= parameter (or N=). A nodename of ALL can be specified to start
logging for all defined VTEs.
For example:
STARTLOG,N=NODE2
STARTLOG,NODE=ALL
◆ STATUS
The STATUS command requests that DLMHOST display the current configuration
and status of the command and logging functions.
DLMHOST will issue this message followed by the status of each configured node:
DLM2401 NODENAME CMDDEV LOGDEV CONSNAME
A y or n next to the device address indicates whether the command/logging
function is currently active or inactive for that node name, respectively.
For example:
DLM2401 NODENAME CMDDEV LOGDEV CONSNAME
NODE1 038E Y 038F Y CON1
NODE2 048E N 048F Y
◆ EOJ
The EOJ Command will terminate the DLMHOST task.
◆ HELP or ?
The Help (?) command returns the DLM000I message with a list of the valid
DLMHOST commands.
where msg# is the message number returned from the d r,l (/d r,l from SDSF).
The following are valid examples of the same DLMHOST commands when DLMHOST
has been executed with the NOWTOR parameter using the job name DLMHOST:
F DLMHOST,STATUS
F DLMHOST,C=Q SPACE,N=N1
F DLMHOST,STOPLOG,N=ALL
Syntax
Virtual tape operator commands use the following syntax rules:
◆ UPPERCASE words are keywords and must be spelled as shown. You can type the
keywords in either uppercase or lowercase.
◆ Lowercase words in italics are values that you supply. Generally, you can type
these values in either uppercase or lowercase. The exceptions are noted in the
command description.
◆ Values in square brackets [] are optional.
◆ When multiple values are separated by a pipe symbol (|), enter only one of the
choices.
EXPORT
EXPORT from to [NORUN] [COMPRESS] [KEYCLASS=key_class]
where from is the full path of the tape volume (VOLSER) to be copied and to is the
device name of the tape drive that the volume must be written to.
For example:
EXPORT /tapelib/B0/B00104 DRIVE-nnnnnnnnnnnn
The example copies tape volume (VOLSER) B00104 from the back-end tape library to
the tape drive Drive-nnnnnnnnnnn, where nnnnnnnnnnn is a 12-character serial
number of the Fibre channel attached tape drive.
Note: Make sure that the volume does not exceed the physical capacity of the
cartridge being written to. If you attempt to write to tape a volume that cannot fit on
the cartridge, the export fails and invalidates the data on the tape by rewinding and
writing a tapemark in the front of the tape.
Tape volumes written to an IBM 3592 drive by EXPORT which are not encrypted are
compatible with other 3592 drives and can be processed by systems other than
Virtuent. For example, a compressed volume written by EXPORT to an IBM 3592
drive could be mounted on a mainframe channel attached 3592 drive and read
directly by a mainframe application.
FIND
FIND VOLUME volser
The FIND command finds a specific volume (VOLSER) in the DLm tape library and
reports the current status of that volume.
For example:
FIND VOLUME 000001
The example returns the current status of the tape volume with the serial number
000001.
HELP
HELP [ command | message number | ABOUT ]
The HELP command displays the following information about the virtual tape operator
commands and messages:
◆ If the command HELP is typed by itself, a summary of all commands is displayed.
◆ If a command is specified, a more detailed description of that command is
displayed.
◆ If a message number is specified, an explanation of the message is displayed. For
example, HELP 489 displays information about message DLm489E. (Typing the
message number as DLm489E, DLm489, or 489 gives the same result.)
Note: The Help information pertains to the virtual tape application (VT Console)
only.
IMPORT
IMPORT from to [NORUN] [COMPRESS] [CLASS = n|CLASS = CLASSn]
[KEYCLASS=key_class]
Where from is the device name of the tape drive to be read and to is the complete
library name (within the DLm filing structure) of the tape volume (VOLSER) being
imported.
For example:
IMPORT DRIVE-nnnnnnnnnnnn /tapelib/N1/N10000
INITIALIZE
INITIALIZE VOL=volser DEVICE=devname [COUNT=count] [CLASS=n] [DIR=dirname]
[LABEL=S/A/N] [SCRATCH=Y/N] [EPIC=N/Y] [ERRORS=nnnnn]
Note: In DLm command syntax, you can use DEVICE and DEV interchangeably.
Use the INITIALIZE command to pre-initialize any number of scratch volumes in any
DLm tape library filing structure. The description of values within the command is as
follows:
◆ If volser is specified without a count, only the volume specified is created.
◆ If count is specified, volser becomes a template for creating a number of
sequential VOLSERs. volser must end with numeric digits that start with a value
that is low enough and has sufficient digits to contain the number of volumes
specified in count.
For example, VOL=BT0000 COUNT=1000 would create volumes BT0000 through
BT0999. Similarly, VOL=XXX100 COUNT=500 would create volumes XXX100
through XXX599. However, VOL=BTA100 COUNT=1000 would be illegal, as would
VOL=ABCDE0 COUNT=11 or VOL=ABCDEF COUNT=2.
◆ Unless ERRORS=nnnnn is specified, initializations terminate after encountering
five errors (such as volser already exists). If ERRORS=nnnnn is specified, up to
<nnnnn> errors are tolerated and initializations continue until <nnnnn> have
occurred.
◆ Any existing volume in the range is skipped. It will not be altered in any way.
◆ Remember EMC only supports VOLSER ranges limited to 10,000 volumes.
◆ DEVICE=devname instructs the INITIALIZE function to use the tape library pointed
by devname to determine where to create the new scratch tapes.
For example, if device E980 points to /tapelib, the following command causes
100 scratch tapes to be created in the default storage class (CLASS0) of the library
/tapelibwhen using EFS:
INIT VOL=B00000 DEVICE=E980 COUNT=100 CLASS=0
◆ The CLASS parameter directs the new volumes being initialized to a specific
storage class within the library. You must initialize scratch tapes into any new
storage class before you attempt to allocate a new scratch volume from that
class.CLASS is a required parameter when using Enhanced File System (EFS), and
is not valid when EFS is not being used. Unless DIR= is also specified, the new
tapes will be spread across all subdirectories of the specified CLASS.
◆ The DIR parameter is always optional and allows you to direct the new volumes
being initialized to a specific filesytem (directory) within the library. When not
specified, INITIALIZE will spread the new tapes across all subdirectories of the
specified CLASS. During operation, the VTE automatically moves scratch volumes
between filesystems in the same class as needed. Therefore it is not necessary to
initialize tape volumes into all filesystems. You only need to make sure that each
storage class has scratch tapes. Specify only the subdirectory name; the base
tape library directory is derived from the PATH= parameter. For example, if the
tape library is /tapelib, specifying DIR=L2 would initialize the tape(s) in
/tapelib/L2. Note: this parameter is only allowed when the Enhanced File
System (EFS) architecture option is enabled.
◆ The LABEL parameter specifies whether the new volumes are created with
Standard IBM (EBCDIC) labels (S), ANSI (ASCII) labels (A), or no labels (N). The
default is Standard IBM labels.
◆ Volumes are initialized as scratch volumes by default and are immediately
available for allocation in response to a mount scratch tape request from any VTE
in the system. If you want to initialize a volume and do not want it to assume the
default scratch status, specify SCRATCH=NO.
◆ EPIC=YES places an identifier on the HDR1 label signifying that the volume is
owned by BIM-EPIC tape manager causing BIM-EPIC to accept the new volume
without requiring any host operator intervention. The default is EPIC=NO.
LOAD
LOAD [VOL=]volser [ON] [DEVICE=]devicename|* [UNLABELED | LABELED | NL | SL | AL]
[PROTECTED]
Use the LOAD command to perform a manual load of a virtual tape volume.
Use a manual load to load a volume for a host system that does not send Load Display
Mount messages, or in a situation where you want to mount a tape other than the one
the host is requesting.
The description of values within this command is as follows:
◆ If the devicename is specified as *, the volume is loaded on the first available
empty drive.
◆ The label options apply only to volumes that the VTE is yet to initialize. The VTE
ignores these label specifications for existing (non-scratch) volumes:
• LABELED and SL are synonymous and specify that the volume must be
initialized with standard IBM (EBCDIC) labels.
• UNLABELED and NL are synonymous and specify that the volume must be
initialized as an unlabeled tape.
• AL specifies that the volume must be initialized with standard ANSI (ASCII)
labels.
◆ If no label option is specified, the volume is initialized according to the device's
LABEL= configuration parameter. The default is standard IBM (EBCDIC) labels.
◆ The PROTECTED option loads the tape as read-only. Otherwise, the volume is
loaded in normal read-write mode.
QUERY
QUERY [[DEV=]devicename[+]] | ALL | COMPRESSION | CONFIG | ENCRYPTION | LABELS
|LOCKS | MOUNTED | PATHS [ASSIGNED] | SPACE | SCRATCHNAMES | STCLASS | TAPELIB
| VERSION| WARNING | RECOVER | RECOVERAMT]
Use the QUERY command to display the system information. The following is a
description of the values within the command:
◆ QUERY with no operands displays the current status of all virtual tape drives,
while DEVICE=devicename displays a single drive or range of drives. Use * as a
wildcard character to display a range of drives. For example, Q E98* displays all
the devices E980–E98F.
◆ QUERY ALL displays information about the virtual tape application, the channel
interface cards, and all virtual tape devices.
◆ QUERY COMPRESSION lists the status of a VTE's AHA compression adapters.
◆ QUERY CONFIG shows detailed configuration information for all devices.
◆ QUERY ENCRYPTION shows the status of the encryption keys.
◆ QUERY LABELS shows the header labels, if any, for all mounted tapes.
◆ QUERY LOCKS displays two kinds of VOLSER locks currently set: VOLSER short
term locks set by EFS (Enhanced File System) when searching for or moving files
between filesystems. DD locks for Virtuent VOLSER locking used for NFS
filesystems that don't support NFS NLM file locking.
◆ QUERY MOUNTED displays information only about the drives that currently have
virtual tape volumes mounted.
◆ QUERY PATHS shows all the channel paths established for the VTE devices. If
ASSIGNED is specified, only channel paths with a current host assignment
(typically those varied online) are displayed.
◆ QUERY SPACE shows a summary of the disk space used and available in all the
tape libraries.
Note: You can enter additional commands while the QUERY SPACE command is
being processed.
• AMDD signifies that the AMDD feature has modified one or more blocks being
written to this volume.
If a mount previously failed, the most recently requested VOLSER and the reason for
the mount failure are displayed.
0 1 0000 7 00 01 0000000000000000000000
1 0 0000 6 00 01 0000000000000000000000
1 1 0000 7 00 01 0000000000000000000000
1D02 0 0 0000 6 00 02 0000000000000000000000
0 1 0000 7 00 02 0000000000000000000000
1 0 0000 6 00 02 0000000000000000000000
1 1 0000 7 00 02 0000000000000000000000
◆ Tape library space for drives: All devices sharing the same tape library are
grouped together.
◆ Path: The first (or only) entry is the tape library base directory. If the base tape
library contains subdirectories, they are listed separately and a total is printed.
◆ Size: This is the size of the entire filesystem.
◆ Active: This is the amount of space being used by non-scratch tape volumes.
◆ Scratch: This is the amount of space that scratch tape volumes use. The system
can reclaim scratch tape space at any time as needed.
◆ Qty: This is the number of scratch tape volumes in this directory.
◆ Free: This is the amount of free space currently available on the entire filesystem.
Note that if the filesystem holds files in directories other than the tape library
directory, the space of all other files will reduce the free space. For this reason
(Size - Active - Scratch) it may not add up (Unused), as seen in the first example.
◆ Filesystem: The filesystem device name, typically a hard drive partition name or
an NFS or SMB mount point.
QUIESCE
QUIESCE [ [DEVICE=]devicename | ALL | * ] [TAPELIB PATH=path]
The QUIESCE command sets one or all of the virtual drives into the quiesced state.
Quiesced drives cannot accept any further mount requests until they are unquiesced.
Any mount requests executed to a quiesced drive are ignored and remain pending.
The drive stays in the Not Ready state. These ignored mount requests stay pending
just like other unsuccessful mounts, until the host cancels the mount request. It is
automatically retried when a drive is unquiesced.
Other than ignoring any new mount requests, quiesced drives continue to function
normally; any volume already loaded on the drive continues to be normally accessible
until it is unloaded.
READY
READY [DEVICE=]devicename
Use the READY command to change a virtual drive from the Not Ready to the Ready
state.
Typing the READY command for a virtual tape drive is equivalent to pressing the Ready
button on a physical tape drive.
To make a virtual drive ready, it must already have a volume mounted and be in the
Not Ready (Intervention Required) state. If the specified drive does not have a volume
mounted, or is already in the Ready state, the READY command is ignored.
The READY command is not needed during normal processing to make a drive Ready.
Normally, a drive automatically becomes Ready whenever a volume is mounted and
stays Ready until the volume is unloaded.
The Not Ready condition, while a volume is mounted, is an exceptional condition that
occurs only when:
◆ The VTE runs out of disk space in the tape library while writing to a virtual volume.
or
◆ The UNREADY command was entered.
REWIND
REWIND [DEVICE=]devicename
Use the REWIND command to manually rewind the specified virtual tape drive.
Using the REWIND command for a virtual tape drive is equivalent to pressing the
Rewind button on a physical tape drive. Like a physical tape drive, the specified
virtual tape drive must be in the Not Ready state for the REWIND command to be
accepted as described in “UNREADY” on page 172.
The VTE immediately executes the REWIND command regardless of whether the host
might currently be using the tape.
Note: If the host is still processing the volume and has not yet closed the tape,
manual repositioning may make the host read from or write to an incorrect location of
the virtual tape volume. For this reason, use the REWIND command only in an
emergency situation when a tape volume is known and is not in use by a host
application, but needs to be rewound to loadpoint immediately.
SAVE TRACE
SAVE [TRACE]
Use the SAVE TRACE command to write all trace buffers to disk immediately. Normally,
the traces are buffered in memory and only written to disk periodically for
performance reasons. Before examining or copying the trace files, you must perform
the SAVE TRACE command to make sure that all currently buffered trace data is written
to disk. SAVE TRACE also saves channel adapter firmware trace files to disk.
SET
SET [HWCOMP=ON/OFF] [HWDECOMP=ON/OFF] [IDRC=ON|OFF|FORCE]
[PATH=pathname [NOCHECK]] [PENALTYUP=n] [RECOVER=nn] [RECOVERAMT=nn]
[SIZE=xxx] [TIMESTAMPS=NO/YES] [TRACE=n]
[WARNING=nn][KEYCLASS=key_class|NONE] [EFSMOVE=SPACE/RANDOM/NEVER]
[QSPACETIMEOUT=nn] [PROTECTVOL1=ON/OFF] [ ERASEPOLICYTTL=[nnn / nnnH /
nnnD / OFF] [DEVICE=devicename|ALL]
Use the SET command to set various options for the virtual tape devices. Any option
set by the SET command is a temporary change, and the setting reverts to the
configuration file or default value the next time the virtual tape application is started.
To make permanent changes, make the changes in the VTE configuration file.
Following is the description of options within the command.
◆ EFSMOVE=SPACE/RANDOM/NEVER indicates whether files will be moved based
on free space, randomly or never
◆ QSPACETIMEOUT=nn Sets the number of minutes that QUERY SPACE can run
before it is automatically cancelled.
◆ KEYCLASS=[key_class|NONE] sets the encryption key class for the specified
device to the key class name, or to no key class (and thus no encryption). This
option requires a specific DEVICE parameter, and the specified device must not
have a tape mounted for the command to be accepted.
Note: This option is only effective for the first data set on a tape, subsequent data
sets will use the encryption key (if any) of the first data set.
When writing to VOLSERs stored on deduplicating storage, the IDRC setting Yes is
ignored and the VTEs do not compress the data before it is written to the
deduplicating storage. However, using Force with a deduplicating file system can
severely limit the ability of the storage system to de-duplicate and will, therefore,
use more real disk storage.
◆ PATH=pathname sets the path for the virtual tape library for a specific device. This
option requires a specific DEVICE specification. If a tape volume is not currently
loaded on the drive, the new pathname specification takes effect immediately.
Otherwise the change takes effect immediately after the current volume is
unloaded. The pathname is case-sensitive and must exactly match the disk
directory name . Always specify the tape library base directory, that is, /tapelib,
not a subdirectory of the tape library (such as /tapelib/BA). DLm checks the
specified tape library and any subdirectories for logical errors, such as a tape
VOLSER being in the wrong subdirectory, and if it finds any error, it leaves the
path unchanged. If you absolutely must set the path to a directory which cannot
pass validation, you can specify the NOCHECK parameter to accept the path even
if it fails validation.
SET PATH can also be used to assign a virtual device to a Fibre Channel tape drive
to use the Direct Tape feature. To use SET PATH in this manner, specify the tape
drive serial number. For example,
SET PATH=DRIVE-nnnnnnnnnnnn DEV=xxxx
Where nnnnnnnnnnnn is the 12 digit tape drive serial number and XXXX is the
name of the device that is being set to access the tape drive.
◆ PENALTYUP=n helps to prevent filesystem overload. When the VTE receives a
mount request for a scratch tape, DLm tries to distribute the data evenly across
multiple filesystems. It is important that, at a given time, multiple scratch mounts
are not all chosen from the same filesystem because this will cause that
filesystem to be overloaded and impact performance.
DLm prevents filesystem overload by applying a penalty to a filesystem once it has
been chosen (to decrease the chance that it will be chosen again). Following that,
every directory (including the one that was chosen) has 1 subtracted from its
current penalty whenever any directory in that library is chosen. The selection
comparison criteria is (free space * (100% - penalty%.)
The following guidelines should be used to decide a PENALTYUP value:
1. Never decrease the PENALTYUP value below 6.
Note: If the recovery percentage is set to 100, the VTE never deletes scratch
volume data to recover disk space.
The new size specification takes effect immediately. If a tape is being written at
the time the SIZE is changed and the position on the tape is already past the new
SIZE value, VTE sends logical end-of-volume warnings on all subsequent
write/write tapemark commands. DLm signals the physical end of the volume
approximately 1 MB past the current position.
Note: The SIZE= option is not allowed for SCSI tape devices.
Note: The SET TIMESTAMPS command works only when entered directly through
the VT Console. It does not work when sent through the DLMHOST or when used
with CP501.
◆ TRACE=n sets the trace level for a specific device if you specify a
DEVICE=devicename. If SYSTEM is specified, the trace level is set for the general,
non-device-specific system trace. If ALL is specified, the trace level is set for all
devices plus the general system trace at the same time. The default is ALL if no
DEVICE is specified. Valid trace levels are 0 (no tracing) to 5 (maximum tracing);
the default is 1 (trace errors only). This option affects only the virtual tape
application traces.
◆ WARNING=nnn sets the percentage of disk space usage at which the VTE begins
to warn about usage. The valid range is 0 to 100.
◆ ERASEPOLICYTTL=[nnn / nnnH / nnnD / OFF] sets the Erase Policy TTL value to OFF
or sets the Erase Policy TTL to a value in days (default) or hours.
Examples:
• The SET ERASEPOLICYTTL=10D command results in setting the TTL
ERASEPOLICY to 10 days. After the command is executed, a message
"DLm127I "Disk space ERASEPOLICYTTL set to Value" is generated.
• The SET ERASEPOLICYTTL=OFF results in the TTL ERASEPOLICY being turned
off. After the command is executed, a message "DLm127I "Disk space
ERASEPOLICYTTL set to OFF" is generated.
SHOW
SHOW CHANNEL ADAPTERS
SHOW REJECTED PATHS
Use the SHOW command to assist in debugging problems with the configuration of
the VTE or host devices. Following is the description of options in the command:
◆ SHOW CHANNEL ADAPTERS displays information about all channel adapters in the
VTE.
◆ SHOW REJECTED PATHS displays connections that the host has attempted to
establish with the VTE, but which are not configured.
SNMP
SNMP SHOW STATUS
This command shows the current SNMP settings.
SNMP ACKNOWLEDGE FAILURE
Enter this command following the error indicating that message(s) were lost to
acknowledge that the user is aware of the lost message(s). This command also stops
the periodic warnings generated as a result of the error.
STARTVT
STARTVT
This command starts the virtual tape application on the VTE.
This command is only valid when the console window indicates that the VT status is
Not Running.
Once the VT application has initiated the VT Status indicates Running. At this point,
tape devices on this VTE may be varied online on the mainframe.
Note: The STARTVT command works only when entered directly through the VT
Console. It does not work when sent through the DLMHOST or when used with CP501.
STOPVT
STOPVT[!]
This command stops the VT application running on the VTE.
This command is only valid when the console window indicates that the VT status is
Running.
This command causes all tape emulation to stop. To prevent input / output errors
from occurring on the mainframe, all tape devices on this VTE should be varied offline
before issuing the STOPVT command.
STOPVT does not cause emulation to stop if any tape device on the VTE is active.
However, STOPVT! forces termination of the all tape emulation regardless of the
status of the tape devices. Stopping tape emulation results in I/O errors and job
termination on the mainframe when tapes are actively being used when STOPVT! is
issued.
Note: The STOPVT and STOPVT! commands work only when entered directly through
the VT Console. They do not work when sent through the DLMHOST or when used with
CP501.
UNLOAD
UNLOAD [DEVICE=]devicename
Use the UNLOAD command to perform a manual unload of the specified virtual tape
drive.
Entering the UNLOAD command for a virtual tape drive is equivalent to pressing the
Unload button on a physical tape drive. Like a physical tape drive, the specified virtual
tape drive must be in the Not Ready state in order for the UNLOAD command to be
accepted as explained in “UNREADY” on page 172.
The UNLOAD command is executed immediately regardless of whether the host might
currently be using the tape.
Note: Unloading the tape results in an I/O error (Intervention Required) if the host
tries to read from or write to the drive after it is unloaded. For this reason, use the
UNLOAD command only in an emergency situation when a tape volume is known and
is not in use by a host application, but needs to be unloaded immediately.
UNQUIESCE
UNQUIESCE [ [DEVICE=]devicename | ALL | * ]
The UNQUIESCE command takes one or all of the virtual drives out of the quiesced
state. After being unquiesced, drives once again accept mount requests. Any mount
request that was ignored while a drive is quiesced remains in a pending state; it is
automatically retried when a drive is unquiesced.
Unquiescing a drive does not send any signal to the host.
ALL and * are synonymous and mean unquiesce all drives at once.
UNREADY
UNREADY [DEVICE=]devicename
Use the UNREADY command to change a virtual drive from the Ready to the Not Ready
(Intervention Required) state.
Using the UNREADY command for a virtual tape drive is equivalent to pressing the Not
Ready button on a physical tape drive.
The UNREADY command is executed immediately regardless of whether the host
might currently be using the tape.
Note: An I/O error (Intervention Required) occurs if the host tries to read from or write
to the drive when it is not ready. For this reason, use the UNREADY command only in
an emergency situation when a tape volume is known and no host application is
using it.
AWSTAPE format
DLm stores virtual tape volumes on disk in the AWSTAPE format. The AWS format
allows DLm to maintain an exact representation of a physical tape, including variable
block sizes, tapemarks, labels, and so on.
Each AWSTAPE disk file emulates one physical tape volume.
Each emulated physical record in the emulated tape volume is represented by one or
more pairs of block headers followed by data. An emulated tapemark is represented
only by a block header.
Figure 35 on page 174 illustrates an AWSTAPE disk file.
1 2 3 4 5 6 7 8
H H HH H H H HH H H
D 1 D 2 DD 3 D 4 D 5 D 6 DD 7 D 8 D
R R RR R R R RR R R
AWSTAPE-Single Disk File Representing One Physical Tape Volume GEN-001170
Data in an AWSTAPE data block is stored in the same format in which the mainframe
sent it. DLm does not convert any data that passes through it in either direction. Data
written by the mainframe is stored unchanged in the virtual tape file, and returned to
the mainframe in exactly the same way.
Mainframe data is usually in the EBCDIC format. However, if the mainframe
application writes the data in ASCII mode, then the AWSTAPE data block will contain
ASCII data. In general, DLm handles ASCII data in the same way it handles EBCDIC
data or binary data. The host software can write and read the data in the desired
format.
This appendix describes the Load Display command (CCW Opdcode x’9F’). Major
topics are:
◆ Load display messages .................................................................................. 176
◆ Load display data........................................................................................... 178
Messages 0 and 1
If the Format Control Byte (FCB) Alternating Message bit (bit 3) is on, 0 is checked for a
first mount message, then message 1.
If the FCB Alternating Message bit (bit 3) is off, the FCB Display Low/High Message bit
(bit 5) is checked to determine which message (0 or 1) is to be checked for a mount
message. If bit 5 is on, only message 0 is checked for a mount message. If bit 5 is off,
only message 1 is checked for a mount message.
DLm recognizes a mount request by the EBCDIC character M in the first position (byte
0) of the message. The EBCDIC VOLSER is located in bytes 1–6 of the message. The
last character (byte 7) of the message is a label indicator. If byte 7 is EBCDIC A, an
ANSI (ASCII) labeled volume is being requested. If byte 7 is EBCDIC N, an unlabeled
volume is being requested; otherwise, a standard labeled tape is presumed.
If the Load Display message does not pass all the tests to determine a mount request,
the message is simply ignored.
Bits Description
1–8 Message 0
9–16 Message 1
000 The message specified in bytes 1–8 and 9–16 is maintained until
the tape drive next starts tape motion or the message is updated.
001 The message specified in bytes 1–8 is maintained until the tape
cartridge is physically removed from the tape drive or the next
unload or load cycle.
010 The message specified in bytes 1–8 is maintained until the drive is
next loaded.
011 This value is used to physically access a drive without changing the
message display. This option can be used to test whether a control
unit can physically communicate with a drive.
100 to Reserved.
110
111 The message specified in bytes 1–8 and 9–16 is displayed. The
message in bytes 1–8 is displayed until a tape cartridge is
physically removed from the tape drive, or until the drive is next
loaded. The message in bytes 9–16 is displayed until the drive is
next loaded (not including the loading of the cleaning cartridge). If
no cartridge is present in the drive, the first message is ignored and
only the second message is displayed until the drive is next loaded
(not including the loading of the cleaning cartridge).
3 Alternate messages
0 The tape drive displays only the message that is specified in bit 5.
1 The tape drive displays both messages specified in bytes 1–8 and
9–6, respectively, alternating them on the message displays. The
sequence repeats until the message is replaced on the display.
When bit 3 is set to 1, bits 4 and 5 are ignored.
4 Blink message
6 0 Reserved
The following are some sample Load Display messages. The hex values are in EBCDIC:
48D4C2E3 F0F0F0F1 E2000000 00000000 00
Interpretation:
– Display message 0 (bytes 1–8) MBT0001S, blink, and retain until loaded.
In other words, mount volume BT0001. Volume BT0001 is expected to be a
standard labeled volume.
– DLm would interpret this as a valid mount request for standard labeled
volume BT0001.
Interpretation:
– Display message 0 (bytes 1–8) "RBT44," blink it, and retain until the tape is
removed from the drive. In other words, Remove volume BT44.
– DLm would ignore this message because it is not a mount request.
F0D9C2E3 F0F0F2F2 40D4C2E3 F2F7F2F7 E2
Interpretation:
– Display in an alternating fashion message 0 (bytes 1–8) RBT0022 and
message 1 (bytes 9–16) MBT2727S. Stop displaying (or never display)
message 0 when the tape is removed from the drive. Stop displaying (or
never display) message 1 when the tape drive is next loaded. In other
words, remove volume BT0022, then mount volume BT2727.
– DLm would interpret this as a valid mount request for standard labeled
volume BT2727.
This appendix describes how DLm maintains statistics files with information about
data throughput, virtual tape drive usage, and virtual tape volume usage; the data can
be extracted from the DLm statistics files. Major topics are:
◆ DLm statistics files ......................................................................................... 182
◆ Extraction utility ............................................................................................. 182
Extraction utility
DLm is distributed with a Linux utility program that will extract the statistics to a
comma-delimited output format. The format of the statfmt command line is:
statfmt [--help] [--hourly [--minutes]] [--mounts] [--unmount] infile [--startDate]
[--endDate]
select options
[--hourly] [--minutes] [--mount] [--unmount] [--smf] [--drl] [--txt]
[--mountedAt=MM/DD/YYYY:HH:MM:SS] [--volume=VOLSER] [--efs] [--restarts]
limit options
[--volume=VOLSER] [--startDate=MM/DD/YYYY:HH:MM] [--endDate=MM/DD/YYYY:HH:MM]
[--startDate=MM/DD/YYYY] [--endDate=MM/DD/YYYY]
Hourly statistics
To extract the hourly statistics, specify the --hourly parameter. In this case, the infile
parameter must be a DLm hourly statistics file, that is, /var/bti/stats/hourly.
If the optional --minutes parameter is omitted, the following comma-delimited fields
are output to stdout:
Date — In the format MM/DD/YYYY.
Hour — In the format HH, where HH is 00-23.
Mounts — The number of successful mounts performed in this hour.
Drives — The maximum number of drives in use at any one time within this hour.
BlocksRead — The number of tape blocks read by the host from virtual tapes during
this hour. This number does not include tapemarks read.
BlocksWritten — The number of tape blocks written by the host to virtual tapes during
this hour. This number does not include tapemarks written.
BytesRead — The number of bytes read by the host from virtual tapes during this
hour. This number reflects the uncompressed data delivered to the host.
BytesWritten — The number of bytes written by the host to virtual tapes during this
hour. This number reflects the uncompressed data delivered from the host.
If the optional --minutes parameter is specified, the following additional
comma-delimited fields are output for each minute of the hour, where [MM] is the
minute (00-59):
BytesRead[MM] — The number of bytes read by the host from virtual tapes during
this minute. This number reflects the uncompressed data delivered to the host.
BytesWritten[MM] — The number of bytes written by the host to virtual tapes during
this minute. This number reflects the uncompressed data delivered from the host.
If no virtual tape activity occurs within a given hour, the statistics record for that hour
is omitted.
Volume statistics
To extract the volume statistics, specify the --mounts or --unmount parameter. In
either of these cases, the infile parameter must be a DLm volume statistics file, that
is, /var/bti/stats/vstats.
Mount statistics
If the --mounts parameter is specified, the following comma-delimited fields are
output for each virtual tape mounts recorded in the statistics file:
Date — In the format MM/DD/YYYY.
Time — In the format HH:MM:SS in 24-hour time.
Volser — Volume serial number; for scratch tapes, this is the actual volume that was
mounted.
Device — DLm device name.
Error — For successful mounts, this will be zero; for unsuccessful mounts, that will be
non-zero.
Scratch — For scratch mounts, this will be 1; for non-scratch mounts, this will be zero.
Created — If the volume was created in response to the mount request, this will be 1;
otherwise, zero.
Protected — If the volume was mounted read-only ("ring out"), this will be 1;
otherwise, zero.
Howlong — How long it took to perform the mounts, in milliseconds.
Filesize — The size of the virtual tape volume, in bytes, at the time it was mounted.
Unmount statistics
If the --unmount parameter is specified, the following comma-delimited fields are
output for each virtual tape unmount recorded in the statistics file:
Date — In the format MM/DD/YYYY.
Time — In the format HH:MM:SS in 24-hour time.
Volser — Volume serial number; for scratch tapes, this is the actual volume that was
mounted.
BlocksRead — The number of tape blocks read by the host from this virtual tape
during this mounting. This number does not include tapemarks read.
BytesRead — The number of bytes read by the host from this virtual tape during this
mounting. This number reflects the uncompressed data delivered to the host.
BlocksWritten — The number of tape blocks written by the host to this virtual tape
during this mounting. This number does not include tapemarks written.
BytesWritten — The number of bytes written by the host to this virtual tape during
this mounting. This number reflects the uncompressed data delivered from the host.
LowWrite — The lowest byte offset where a host write, write tapemark, or erase was
performed to this virtual tape during this mounting. If no data was written to the tape,
-1 will be output to distinguish it from a write at loadpoint.
Filesize — The size of the virtual tape volume, in bytes, at the time it was unmounted.
If no writes were performed during this mounting, -1 is output to distinguish that the
file is unchanged.
GoodLocates — The number of locates performed to valid block IDs during this
mounting.
BadLocates — The number of locates performed to invalid block IDs during this
mounting.
volumesMounted — The number of concurrent tape mounts there at the time of that
volume allocation (whether its read or write).
pendingMounts — The number of outstanding mounts that have not been serviced
at the volume allocation time. Usually these mounts only last a few seconds.
Example 1
# statfmt --hourly /var/bti/stats/hourly
statfmt - DLm statistics extractor, version 7.03-9725.
Copyright (c) 2012
input file is '/var/bti/stats/hourly'
Date,Hour,Mounts,Drives,BlocksRead,Blockswritten,-
BytesRead,BytesWritten
09/21/2012,14,4,1,-1,-1,968,0
09/21/2012,16,7,2,-1,-1,6198537240,1102968477
09/21/2012,17,4,2,-1,-1,7585128104,1100001400
09/22/2012,15,1,1,-1,-1,0,0
09/23/2012,21,3,3,-1,-1,1000480,1000400
09/23/2012,22,4,4,69,68,1000480,1000400
Example 2
# statfmt --hourly --minutes /var/bti/stats/hourly
statfmt - DLm statistics extractor, version 7.03-9725.
Date,Hour,Mounts,Drives,BlocksRead,Blockswritten,-
BytesRead[00],BytesWritten[00],BytesRead[01],BytesWritten[01],-
BytesRead[02],BytesWritten[02],BytesRead[03],BytesWritten[03],-
BytesRead[04],BytesWritten[04],BytesRead[05],BytesWritten[05],-
BytesRead[06],BytesWritten[06],BytesRead[07],BytesWritten[07],-
BytesRead[08],BytesWritten[08],BytesRead[09],BytesWritten[09],-
BytesRead[10],BytesWritten[10],BytesRead[11],BytesWritten[11],-
BytesRead[12],BytesWritten[12],BytesRead[13],BytesWritten[13],-
BytesRead[14],BytesWritten[14],BytesRead[15],BytesWritten[15],-
BytesRead[16],BytesWritten[16],BytesRead[17],BytesWritten[17],-
BytesRead[18],BytesWritten[18],BytesRead[19],BytesWritten[19],-
BytesRead[20],BytesWritten[20],BytesRead[21],BytesWritten[21],-
BytesRead[22],BytesWritten[22],BytesRead[23],BytesWritten[23],-
BytesRead[24],BytesWritten[24],BytesRead[25],BytesWritten[25],-
BytesRead[26],BytesWritten[26],BytesRead[27],BytesWritten[27],-
BytesRead[28],BytesWritten[28],BytesRead[29],BytesWritten[29],-
BytesRead[30],BytesWritten[30],BytesRead[31],BytesWritten[31],-
BytesRead[32],BytesWritten[32],BytesRead[33],BytesWritten[33],-
BytesRead[34],BytesWritten[34],BytesRead[35],BytesWritten[35],-
BytesRead[36],BytesWritten[36],BytesRead[37],BytesWritten[37],-
BytesRead[38],BytesWritten[38],BytesRead[39],BytesWritten[39],-
BytesRead[40],BytesWritten[40],BytesRead[41],BytesWritten[41],-
BytesRead[42],BytesWritten[42],BytesRead[43],BytesWritten[43],-
BytesRead[44],BytesWritten[44],BytesRead[45],BytesWritten[45],-
BytesRead[46],BytesWritten[46],BytesRead[47],BytesWritten[47],-
BytesRead[48],BytesWritten[48],BytesRead[49],BytesWritten[49],-
BytesRead[50],BytesWritten[50],BytesRead[51],BytesWritten[51],-
BytesRead[52],BytesWritten[52],BytesRead[53],BytesWritten[53],-
BytesRead[54],BytesWritten[54],BytesRead[55],BytesWritten[55],-
BytesRead[56],BytesWritten[56],BytesRead[57],BytesWritten[57],-
BytesRead[58],BytesWritten[58],BytesRead[59],BytesWritten[59]
09/21/2012,14,4,1,-1,-1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
240,0,0,0,0,0,240,0,240,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,248,0,0,-
0,0,0,0,0,0,0,0,0,0,0,0,0
09/21/2012,16,7,2,-1,-1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
0,0,0,0,160,533,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,160,-
370400240,0,531456000,176928720,198145160,287040160,82320,-
305952000,0,292832800,1016128,305952000,0,291872800,1868096,-
306752000,0,305700640,0,308448000,0,306336000,0,308448000,0,-
307168000,0,306880000,0,305056000,0,307776480,0,299392000,0,-
296288160,0,293440080,0,293056000,0,296480000,0,296737080,0
09/21/2012,17,4,2,-1,-1,0,0,0,0,0,0,0,0,0,0,160,216416240,248,-
516192000,63008720,367393160,305056248,0,293248240,0,-
271232000,0,301632008,0,306016000,0,308000000,0,305184000,0,-
306884640,0,306656000,0,299744000,0,291392000,0,293248000,0,-
293664000,0,291360000,0,293344640,0,290784080,0,288704080,0,-
295904080,0,296832160,0,298144080,0,295968080,0,289984240,0,-
291168240,0,295360000,0,297920080,0,114688080,0,0,0,0,0,0,0,0,-
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
0,0,0,0,0,0,0,0,0,0,0,0,0,0
09/22/2012,15,1,1,-1,-1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
0,0,0,0,0,0,0,0
09/23/2012,21,3,3,-1,-1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
1000480,1000400,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
09/23/2012,22,4,4,69,68,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1000480,-
1000400,0,0,0,0,0,0,0,0,0,0,0,0
Example 3
# statfmt --mounts /var/bti/stats/vstats
statfmt - DLm statistics extractor, version 7.03-9725.
Copyright (c) 2012
input file is '/var/bti/stats/vstats'
Date,Device,Volser,Error,Scratch,Created,Protected,Howlong,Filesize,
pending Mounts,volumes Mounted
04/16/2012,11:41:13,,,0,0,0,0,37748736,345745915904,0,0
04/16/2012,11:41:13,,,0,0,0,0,37748736,345745915904,0,0
04/16/2012,12:08:22,,,0,0,0,0,37748736,345745915904,0,0
Example 4
# statfmt --unmount /var/bti/stats/vstats
statfmt - DLm statistics extractor, version 7.03-9725.
Copyright (c) 2012 .
input file is '/var/bti/stats/vstats'
Date,Time,Volser,BlocksRead,BytesRead,Blockswritten,-
BytesWritten,LowWrite,Filesize,GoodLocates,BadLocates
04/21/2012,14:16:30,N47061,3,240,0,0,-1,-1,0,0
04/21/2012,14:19:05,N47061,4,248,0,0,-1,-1,0,0
04/21/2012,14:20:51,N47061,5,256,0,0,-1,-1,0,0
04/21/2012,14:40:07,N47061,3,240,0,0,-1,-1,0,0
04/21/2012,14:43:43,N47061,3,240,0,0,-1,-1,0,0
04/21/2012,14:44:31,N47061,3,240,0,0,-1,-1,0,0
04/21/2012,14:52:11,N47061,4,248,0,0,-1,-1,0,0
04/21/2012,16:27:01,N47062,2,160,6,533,0,593,0,0
04/21/2012,16:40:10,N47064,2,160,10,82320,0,7880,0,0
04/21/2012,16:42:36,N47064,5,400,7,82080,7690,15329,0,0
04/21/2012,16:42:41,N47064,5,400,59,934048,15139,38466,0,0
04/21/2012,16:44:26,N47064,5,400,59,934048,38276,61593,0,0
04/21/2012,16:44:30,N47064,5,400,59,934048,61403,84786,0,0
04/21/2012,17:04:03,N47063,231018,7391304720,34381,-
1100001400,0,1100207710,0,0
04/21/2012,17:06:31,N47061,4,248,0,0,-1,-1,0,0
04/21/2012,17:08:24,N47061,4,248,0,0,-1,-1,0,0
04/21/2012,17:11:17,N47061,4,248,0,0,-1,-1,0,0
04/21/2012,17:33:22,N47065,237081,7585127360,34381,-
1100001400,0,1100207710,0,0
04/21/2012,15:33:30,N47061,0,0,0,0,-1,-1,0,0
04/21/2012,21:09:43,N47068,69,1000480,68,1000400,0,85185,0,0
04/21/2012,22:28:23,N47066,0,0,0,0,-1,-1,0,0
04/21/2012,22:28:24,N47067,0,0,0,0,-1,-1,0,0
04/21/2012,22:53:37,N47072,69,1000480,68,1000400,0,85185,0,0
04/21/2012,12:08:18,N47071,0,0,0,0,-1,-1,0,0
04/21/2012,12:08:18,N47069,0,0,0,0,-1,-1,0,0
04/21/2012,12:08:18,N47070,0,0,0,0,-1,-1,0,0
This appendix lists the DLm system, EMCvts, and z/OS system messages. The major
topics are:
◆ Message format ............................................................................................. 192
◆ DLm system messages ................................................................................... 193
◆ Call home messages ...................................................................................... 363
◆ EMCvts messages .......................................................................................... 364
◆ z/OS system messages .................................................................................. 366
◆ VTEC errors that generate ConnectEMC events ................................................ 380
Message format
The EMC DLm system message format is:
DLmxxxy
where:
xxx = message number
y = message class:
I (Informational)
W (Warning)
E (Error)
DLm000I
<debugging message>
Description: Various debugging messages are displayed if the virtual tape
application's debugging level is set to 1 or higher.
System Action: None.
User Action: You really shouldn't be seeing any DLm000I messages unless you have
invoked a debugging mode. For best performance, debugging should be left off
unless directed otherwise by EMC Support. Enter the command 'SET DEBUG=0' to turn
debugging off.
DLm010I
Compression hardware [not] available
Description: This message reports on the availability of a hardware compression card
in the controller.
System Action: If a hardware compression card is present (and is not disabled through
configuration or operator command), the card will be used for compressing and
decompressing virtual tape data.
User Action: None.
DLm011I
Compression driver version: x.x.x
Description: This message displays the version number of the hardware compression
card driver.
System Action: None.
User Action: None.
DLm012I
Compression card #n: id=xx (model) version=nnn state=xxxxxxxx
DLm013I
Hardware compression/decompression set ON/OFF
Description: This message reports on the status of the hardware compression and
decompression features.
System Action: None.
User Action: None.
DLm014E
Unknown hardware compression card, id=0xXXXX
Description: The identity of the hardware compression adapter cannot be determined.
System Action: Hardware compression and decompression will not be available until
the problem is resolved and the controller is restarted.
User Action: Contact EMC Support for assistance.
DLm015E
Hardware compression driver error
Description: An error has occurred while initializing the hardware compression
adapter.
System Action: Hardware compression and decompression will not be available until
the problem is resolved and the controller is restarted.
User Action: Contact EMC Support for assistance.
DLm016E
Device <devicename> Error opening hardware compression driver: <error message>
Description: An error has occurred while opening the hardware compression adapter.
System Action: Hardware compression and decompression will not be available for
this device until the problem is resolved and the controller is restarted.
DLm017I
Removing all .lk file locks owned by this system...
Description: During startup and shutdown, all file locks held by this application, if
any, are removed.
System Action: All .lk file locks owned by this system are removed.
User Action: None.
DLm018E
Error creating <processname> Thread: <error message>
Description: This internal error can only occur during application startup.
System Action: Application startup terminates.
User Action: Contact EMC Support for assistance.
DLm019E
Error allocating memory for <name>: <error message>
Description: An internal memory allocation error has occurred.
System Action: Depending on the error, the controller may abend or may need to be
restarted to regain some functionality.
User Action: Contact EMC Support for assistance.
DLm020E
Cannot verify <feature> license: <error message>
Description: The controller was unable to validate the license for the specified feature.
System Action: The specified feature will not be available.
User Action: Contact EMC Support for assistance.
DLm021E
<parameter=value> incompatible with <license> license
Description: The specified parameter is not compatible with the specified licensed
feature.
System Action: If the error is in the configuration file, the application startup
terminates. If the error is in a SET command the command is rejected.
User Action: Contact EMC Support for additional assistance.
DLm022E
Unable to find userid 'vtape'
Description: The virtual tape application must run under the user ID 'vtape', but this
user ID does not exist on the system.
System Action: Application startup terminates.
User Action: Contact EMC Support for assistance.
DLm023E
Unable to switch to user and group 'vtape'
Description: The virtual tape application must run under the user ID 'vtape', but the
application was unable to switch to this ID.
System Action: Application startup terminates.
User Action: Contact EMC Support for assistance.
DLm024E
Program not started with effective userid 'root'
Description: The virtual tape application must be started under the userid 'root'.
System Action: Application startup terminates.
User Action: Contact EMC Support for assistance.
DLm025E
Invalid license combination, <license1>+<license2>.
Description: The combination of license files on the system is not valid.
System Action: Application startup terminates.
User Action: Contact EMC Support for assistance.
DLm026E
Pid file <filename> must be full path name. Use -? for Help
Description: The command line that starts the virtual tape application contains an
invalid argument.
System Action: Application startup terminates.
User Action: Contact EMC Support for assistance.
DLm027E
Failed to fork daemon: <error message>
Description: The application failed to daemonize itself.
System Action: Application startup terminates.
User Action: Contact EMC Support for assistance.
DLm028E
Internal Error calling setsid: <error message>
Description: The application failed to daemonize itself.
System Action: Application startup terminates.
User Action: Contact EMC Support for assistance.
DLm029E
Internal Error changing working directory to '/': <error message>
Description: The application failed to daemonize itself.
System Action: Application startup terminates.
User Action: Contact EMC Support for assistance.
DLm030I
Traces are [un]buffered
Description: The virtual tape application trace files are buffered (saved in memory and
written to disk periodically) by default for better performance. If the environment
variable BTITRACEUNBUFFERED has been set to any value when the application starts,
trace files are written in an unbuffered manner (every event is written to disk
immediately).
System Action: None.
User Action: The buffered default should be sufficient for most tracing needs, unless
directed otherwise by EMC Support. When traces are buffered be sure to enter the
command 'Save Trace' to write all trace buffers to disk before examining or copying
the trace files.
DLm031E
Cannot create PID file <filename>: <error message>
Description: The application failed to create the process ID file.
System Action: Application startup terminates.
User Action: Contact EMC Support for assistance.
DLm032E
Trace task error reading pipe, errno=0x<xx> (<nnn>)
Description: An I/O error has occurred during device tracing.
System Action: The application attempts to continue tracing. One or more events may
be lost from the device trace.
User Action: Contact EMC Support for assistance.
DLm033E
Error writing to <file type> file <filename>: <error message>
Description: An I/O error occurred while writing to the specified file.
System Action: The application continues running without writing additional
messages to the specified file.
User Action: Refer to any earlier message(s) and the 'error message' portion of this
message to determine the cause of the failure. If the problem cannot be corrected,
contact EMC Support for assistance.
DLm034I
<STDOUT/STDERR message>
Description: A message was received from Standard OUT or Standard ERROR.
System Action: None.
User Action: None.
DLm035E
Error creating directory 'directory': <error message>
Description: The specified directory did not exist, and the virtual tape application was
not able to create the directory. This error can only occur during application startup.
System Action: Application startup terminates.
User Action: Contact EMC Support for assistance.
DLm036E
Error closing <file type> file <filename>: <error message>
Description: The specified file was not successfully closed. The 'error message' text
explains the reason for the failure.
System Action:
User Action: If you are unable to correct the problem, contact EMC Support for
assistance.
DLm037E
Error creating/opening <feature> message pipe: <error message>
Description: An error occurred while initializing the specified feature. This error can
only occur during application startup.
System Action: Startup terminates or continues without the specified feature. The
'error message' text explains the reason for the failure.
User Action: If you are unable to correct the problem, contact EMC Support for
assistance.
DLm038I
Creating directory 'directory'
Description: The specified directory did not exist, so the application is now creating
the directory.
System Action: The specified directory is created.
User Action: None.
DLm039E
Error opening output <file type> file <filename>: <error message>
Description: The specified output file was not successfully opened. This error can only
occur during application startup.
System Action: Startup terminates. The 'error message' text explains the reason for
the failure.
User Action: If you are unable to correct the problem, contact EMC Support for
assistance.
DLm041E
Device <devicename> error <nnn> going online
Description: The specified device was not able to go online to the channel. This error
can only occur during application startup.
System Action: Startup terminates.
User Action: Verify in the configuration file that the channel configuration data for the
specified device is correct. If the problem recurs, contact EMC Support for assistance.
DLm042E
Error <nnn> going live to channel. Interface=n, slot=nnnnnn
Description: The channel interface number 'n' was not able to go online to the
channel.
System Action: This channel interface will be out of service until the problem is
corrected and the adapter is reset.
User Action: The "RESET CHANNEL ADAPTER" command might be able to bring this
adapter online. Contact EMC Support for more assistance.
DLm044W
WARNING: /var filesystem usage at nn%
Description: The specified critical system filesystem is starting to run low in free disk
space. If this filesystem were to fill, it might have a detrimental effect on the system
operation.
System Action: Warning messages will continue to be displayed at every percentage
of change in usage as long as the usage exceeds the designated warning level.
User Action: Contact EMC Support for assistance in freeing space on the designated
filesystem.
DLm045E
Error getting status of <filesystem> filesystem: <error message>
Description: An unexpected error occurred while trying to get information about the
specified filesystem.
System Action: The system will continue to run, but some features (such as warnings
about the capacity limits of certain filesystems) may not be functional.
User Action: If this problem recurs, contact EMC Support for assistance.
DLm046W
/var has <nnn> remaining bytes, debugging messages turned off
Description: A debugging mode that writes messages to the console log is active, and
the /var filesystem, where the messages are stored, is starting to fill.
System Action: The debugging mode is turned off to suppress further debugging
messages.
User Action: Contact EMC Support for assistance in freeing space on the designated
filesystem.
DLm047E
Internal Error <function>: <error message>
Description: An internal error has occurred.
System Action: The function listed cannot be completed.
User Action: Contact EMC Support for assistance.
DLm048E
Internal Error <process>: <error message>
Description: An internal error has occurred.
System Action: Application terminates.
User Action: Contact EMC Support for assistance.
DLm049E
Internal Error <function>: <error message>
Description: An internal error has occurred due to external conditions.
System Action: The function listed cannot be completed.
User Action: Contact EMC Support for assistance.
DLm050E
Invalid command line parameter: <value>. use -? for help
Description: The command line that starts the virtual tape application contains an
invalid argument.
System Action: Startup terminates.
User Action: Correct the command line argument(s) and restart the virtual tape
application.
DLm052E
Invalid command line Configuration File Name parameter: <value>. Use -? for Help
Description: The command line that starts the virtual tape application contains an
invalid argument.
System Action: Startup terminates.
User Action: Correct the command line argument(s) and restart the virtual tape
application.
DLm055E
Error getting channel driver version number
Description: The virtual tape application was unable to determine the version of the
channel adapter driver.
System Action: Startup terminates.
User Action: Contact EMC Support for assistance.
DLm056I
Channel driver version is x.x.x
Description: This message displays the version number of the channel adapter driver.
DLm057E
This application requires minimum channel driver version x.x.x!
Description: The channel adapter driver is below the minimum release level required
by this version of the virtual tape application. Message DLm056I that precedes this
message identifies the channel adapter driver currently loaded.
System Action: Application startup terminates.
User Action: Contact EMC Support for assistance.
DLm058I
Device <devicename> MIHn set to nnn seconds
Description: The MIH (Missing Interrupt Handler) timeout value that the virtual tape
application reports to the Host has been set to the specified value. "MIHn" will be
MIH1 or MIH2. MIH1 is the primary or "fast" MIH value that most Host operating
systems use for most CCWs, such as reads and writes. MIH2 is the secondary or
"slow" MIH value that some Hosts use for certain long-running CCWs such as Locate,
FSF, and Data Security Erase commands. By default, the application sets these values
to 3000 and 18000 seconds, respectively.
System Action: The specified value is reported to the Host on the next Read
Configuration Data command.
User Action: None.
DLm060E
There is already an instance of <program> running
Description: Another copy of the virtual tape application is currently running.
System Action: The second copy of the virtual tape application terminates.
User Action: Make sure that the application is not already running before starting a
second copy.
DLm061E
Cannot register <function> handler: <error message>
Description: This internal error can only occur during application startup.
System Action: Startup terminates.
User Action: Contact EMC Support for assistance.
DLm062E
Error opening Alert FIFO <filename>: <error message>
Description: The virtual tape application was not able to open the pipe over which it
receives alert (error and warning) information from the channel adapter drivers.
System Action: The virtual tape application continues to function, but channel
adapter alerts will not be noted by the application.
User Action: Contact EMC Support for assistance.
DLm064E
Alert FIFO has been closed
Description: The channel driver has closed the pipe over which it sends alert
messages, which are warning and error messages about channel adapter problems,
to the virtual tape application.
System Action: The application continues to function, but channel adapter alerts will
not be noted by the application.
User Action: Contact EMC Support for assistance.
DLm065E
Invalid data (nn bytes) read from Alert FIFO
Description: The channel driver has sent an unrecognized alert message to the virtual
tape application.
System Action: The application continues to function, but channel adapter alerts will
not be noted by the application.
User Action: Contact EMC Support for assistance.
DLm066E
Error creating/opening Read named pipe <filename>: <error message>
Description: This internal error can only occur during application startup.
DLm067I
BusyType set to Busy/Immediate/Deferred
Description: The virtual tape application can be configured to send various status
codes to hold off the host under busy conditions. The default is to send a true busy
signal.
System Action: The virtual tape application sends a busy status if BusyType is set to
"busy", an immediate command retry for "immediate", and a deferred command retry
for "deferred".
User Action: None. Do not change this setting unless directed to do so by EMC
Support. Changing this value could cause channel errors.
DLm068I
Double testing of compressed data set ON/OFF
Description: By default, the virtual tape application performs an extra CRC check of
data that has been compressed before writing it to the tape library.
System Action: If this option is ON (the default), the data is checked just before it is
written to the library. If a discrepancy is found, an error is returned to the Host's write
command. If this option is turned OFF, no extra integrity check is performed.
User Action: It is recommended that this option always be left ON.
DLm069I
Resetting Events will [not] be sent to firmware
Description: A resetting event is any event that resets a channel-attached device's
pathgroup ID or assignment, such as a physical removal of paths or a system reset or
restarting of the virtual tape application. Normally after a resetting event has occurred
the next command sent by the Host receives a resetting event unit check to notify the
Host that the resetting event occurred. The Host should respond appropriately by
restoring the device's pathgroup ID and assignment information, and re-issue the
unit-checked command. In addition, some channels expect a low-level indication that
a resetting event has occurred. By default, the virtual tape application sends this
special indication to the channel along with the unit check. For exceptional
conditions, the application can be configured to NOT send the low-level resetting
event indication to the channel when it sends a resetting event unit check to the Host.
This message is displayed at virtual tape application startup and whenever the
low-level channel resetting event notification option is switched on or off.
System Action: Low-level channel resetting event status will not be sent to the
channel when this option is set OFF.
User Action: None. Under normal conditions, the low-level channel resetting event
indication should NOT be configured OFF. Under rare conditions, a channel may not
correctly handle the low-level channel resetting event indicator, and channel errors
may occur. In this case, consult EMC Support before configuring this option off. Also
see message DLm082I.
DLm070I
<emulation type> emulation version set to n
Description: The virtual tape application is configured to invoke the specified channel
adapter emulation version.
System Action: None.
User Action: None.
DLm071E
No channel interface cards present!
Description: No channel interface adapters were detected in the system. This error can
only occur during application startup.
System Action: Startup terminates.
User Action: Contact EMC Support for assistance.
DLm072E
This application requires minimum firmware version nnnn!
Description: The firmware in a channel adapter is below the minimum release level
required by this version of the virtual tape application. Message DLm075I that
precedes this message identifies the channel adapter in question.
System Action: Startup terminates.
User Action: Contact EMC Support for assistance.
DLm073E
Interface #<n> (slot <nnnnnn>) returned bad status = <nnn>
Description: The specified channel interface adapter returned an error status to the
virtual tape application. This error can only occur during startup.
System Action: Startup terminates.
User Action: Contact EMC Support for assistance.
DLm074E
Interface #<n> (slot <nnnnnn>) error getting <adapter info>
Description: The specified channel interface adapter returned an error status to the
virtual tape application. This error can only occur during startup.
System Action: Startup terminates.
User Action: Contact EMC Support for assistance.
DLm075I
Interface #n: n (0xxxxxx) bus:n slot:n type:n (adaptertype) media:n (mediatype)
Description: This message displays information about the channel interface
adapter(s) in the controller. This message is displayed at startup and in response to
the QUERY ALL or QUERY CHANNEL ADAPTER command.
System Action: None.
User Action: None.
DLm076I
Interface #n: [hardware s/n | s/n override] xxxxxxxxxxxx
Description: This message displays information about the channel interface
adapter(s) in the controller. This message is displayed at startup and in response to
the QUERY ALL or QUERY CHANNEL ADAPTER command.
System Action: None.
User Action: None.
DLm077I
Interface #n: Firmware emulation type: XXXX, version: nnnn yyyy/mm/dd
DLm078I
Disk usage WARNING level set to nn%
Description: The virtual tape application is configured to warn about tape library disk
utilization when usage reaches nn% full.
System Action: None.
User Action: None.
DLm079I
Disk space RECOVER level [set to nn%]/[is N/A]
Description: The virtual tape application is configured to start erasing scratch tape
volumes to recover disk space when disk utilization reaches nn% full. If "is N/A" is
displayed, the Erase Policy is set to a "time-to-live" policy rather than a space-usage
policy, so the RECOVER setting is irrelevant.
System Action: None.
User Action: None.
DLm080I
Device <devicename> UNISYS detected
Description: The virtual tape application has detected that the specified virtual device
is attached to a Unisys Host. This message will be displayed once for each virtual
device attached to a Unisys.
System Action: The application will automatically make accommodations for the
differences between an IBM and a Unisys Host.
User Action: None (unless the Host is not actually a Unisys Host, in which case EMC
Support should be contacted for assistance).
DLm081I
Interface #n: Current state <state>; Desired state <state>
Description: This message displays information about the channel interface
adapter(s) in the controller. This message is displayed at startup and in response to
the QUERY ALL or QUERY CHANNEL ADAPTER command.
System Action: None.
User Action: None.
DLm082I
Resetting Events will [not] be ignored
Description: A resetting event is any event that resets a channel-attached device's
pathgroup ID or assignment, such as a physical removal of paths or a system reset or
restarting of the virtual tape application. Normally after a resetting event has occurred
the next command sent by the Host receives a resetting event unit check to notify the
Host that the resetting event occurred. The Host should respond appropriately by
restoring the device's pathgroup ID and assignment information, and re-issue the
unit-checked command. Occasionally, especially with older standalone IPL programs,
a Host may not handle a resetting event unit check correctly. In this case, the
controller can be configured to NOT send resetting event unit checks. This message is
displayed when resetting event notification is turned on or off.
System Action: Resetting event unit checks will not be sent to the Host when this
option is set.
User Action: None. Under normal conditions, the controller should NOT be configured
to ignore resetting events. Doing so can cause problems when varying on devices to a
Host that does properly handle, and actually expects, resetting event unit checks.
Contact EMC Support for more information.
DLm083I
Compression level set to n (0=none,1=faster,9=smaller)
Description: This message displays the compression level set by default, in the
configuration file, or by the SET COMPRESSION command. The compression level
ranges from 0 (no compression at all) to 9 (maximum compression with maximum
overhead). The default compression level is 1 (minimum compression with minimum
overhead).
System Action: None.
DLm084I
Disk space RECOVERAMT amount set to nn%
Description: The virtual tape application is configured to stop erasing scratch tape
volumes to recover disk space when disk usage has been reduced by RECOVERAMT
percent of space.
System Action: None.
User Action: None.
DLm085I
<feature> support enabled
Description: This message displays if support for an optional feature is enabled in the
configuration file.
System Action: The optional feature is enabled.
User Action: None.
DLm086I
<WORM-filesystem-type> default retention: nn Days/Months/Years
Description: This message displays if there is a WORM filesystem default retention
period set in the configuration file.
System Action: None.
User Action: None.
DLm087I
Checking of CRCs from channel set ON|OFF
DLm088I
Sending of CRCs to channel set ON|OFF
DLm089I
UNISYS set ON/OFF for device <devicename> / ALL devices
Description: The SET UNISYS command has been accepted for a device or all devices.
System Action: The virtual tape application will adjust for the differences between an
IBM and a Unisys Host for the specified device(s).
User Action: None (unless the Host is not actually a Unisys Host, in which case you
shouldn't have done this).
DLm090I
AMDD feature turned ON/OFF [for device devicename]/[for all devices]
Description: The AMDD feature has been set ON or OFF.
System Action: None.
User Action: None.
DLm091I
AMDD pad boundary is <nnnn> (0xXX) (SET this way/configured this way/by default)
Description: The AMDD pad boundary has been set to the designated value.
System Action: None.
User Action: None.
DLm092E
SET AMDD cannot specify a specific device
Description: For EMC DLm and MDL-1000DD/2000DD models only, AMDD is a global
setting and cannot be SET by individual device.
System Action: The SET command is ignored.
User Action: None.
DLm093I
AMDD support for <application-type> is ON/OFF
Description: This node is configured to perform AMDD processing on the specified
data type. This option affects writing of data only; regardless of this setting, reading of
all data types previously written by AMDD is always supported.
DLm094I
AMDD DD marker insertion algorithm: <method>
Description: This node is configured to insert "extra" DD markers into AMDD records
using the specified algorithm. This option applies only to FDR Upstream data being
written to a Data Domain filesystem.
The possible options are:
• STANDARD - No "extra" markers are inserted (default)
• MARKEVERYD - A marker is inserted on every data record
• MARKFILES - A marker is inserted on the first data record of every file
• MARKEVERY8KD - A marker is inserted on every 8K data record
• MARK8K - A marker is inserted at every 8K interval in the file
• MARK16K - A marker is inserted at every 16K interval in the file
• MARK32K - A marker is inserted at every 32K interval in the file
System Action: None.
User Action: None.
DLm095I
AMDD DD <configuration information>
Description: These messages describe configuration parameters that apply
specifically to FDR Upstream data being written to a Data Domain filesystem. The
values which may be displayed include:
• <minimum markable block size is nnnn>This node is configured to insert AMDD
DD markers only on segments of data larger than <nnnn> bytes.
• <maximum marker length is nnnn> This node is configured to write AMDD DD
markers no larger than <nnnn> bytes.
System Action: None.
User Action: None.
DLm096I
Erase Policy: [retain for <nn> hours/days] [Space needed]
Description: This message displays the current erase policies for this controller.
"Space needed" indicates that the erase policy is to erase scratch tapes when the
tape library disk usage reaches the RECOVER setting. "retain for..." indicates that the
erase policy is to erase scratch tapes as soon as they reach the age specified in hours
or days.
System Action: None.
User Action: None.
DLm097I
Maximum continuous erase time set to <nn> seconds
Description: This message displays the current maximum amount of continuous time
that the application will spend erasing scratch tapes that have exceeded the TTL erase
policy period. If the TTL erase time is exceeded, the application stop erasing for a
short period before resuming erasing. The default time is 30 seconds.
System Action: None.
User Action: None.
DLm098I
Encryption initialized, <#keys> keys ready
Description: Encryption capability was initialized successfully, with <#keys> keys
available for encryption and decryption.
System Action: None.
User Action: None.
DLm099I
New mount on already-mounted drive will be allowed
Description: The virtual tape application has been explicitly configured to honor a
mount request for a drive that already has a virtual tape volume mounted.
System Action: If the virtual tape application receives a mount request on a drive that
already has a tape mounted, and the drive had received an Unassign command from
the Host while that tape was mounted, the application will unload the tape and honor
the new mount request.
User Action: None. This option is not recommended except in specific circumstances.
Contact EMC Support for more assistance.
DLm100I
Configuration file opened: <filename>
Description: The specified input configuration file was successfully opened.
System Action: None.
User Action: None.
DLm101W
Missing or invalid file "/etc/bti/btiximl", using config file "/etc/bti/btixmap0"
Description: The file /etc/bti/btiximl should contain the name of the configuration file
that the virtual tape application will load at startup. If /etc/bti/btiximl does not exist,
the application will load the default configuration file /etc/bti/btixmap0.
System Action: The default configuration file, /etc/bti/btixmap0, is used.
User Action: The /etc/bti/btiximl file should normally point to the desired
configuration file. Reconfigure the system and identify which of the configuration files
you want to use. Contact EMC Support if this problem recurs.
DLm102I
Configuration file is <filename> [(changed!)]
Description: Displays the name of the configuration file currently in use. "(changed!)"
means that the configuration file has changed since the last virtual tape application
startup.
System Action: None.
User Action: None.
DLm104W
Device <devicename>: Warning. no tapelib found for path/Dir: <directory>
Description: During logging of volume statistics, the specified directory was not
found.
System Action: The volume statistics record will not be recorded.
User Action: Contact EMC Support for assistance.
DLm105E
<command> command is no longer supported
Description: The virtual tape application no longer supports this command.
System Action: None, the command is ignored.
User Action: None.
DLm106I
Guaranteed Replication enabled on <nn> devices, checking for any replicating
filesystems...
Description: <nn> virtual tape drives are configured to support the Guaranteed
Replication feature.
System Action: Each of the tape library directories will be checked to see if it is a
replicating filesystem. A subsequent DLm161I message will be displayed for each
tape library found to be on a replicating filesystem.
User Action: None.
DLm107I
Guaranteed Replication delay set to <nn> seconds
Description: The system is configured to wait for <nn> seconds between tape close and
starting a replication-refresh, to make sure that the file is completely written to disk
before replication begins.
System Action: None.
User Action: None.
DLm108I
Guaranteed Replication timeout set to <nnn> seconds
Description: The system is configured to wait <nnn> seconds for a replication-refresh
to complete. If replication does not complete within this time, an error indication is
returned to the host's WTM command.
System Action: None.
User Action: None.
DLm109I
Scratch mounts will [not] ignore full filesystems (UseFullFS=TRUE/FALSE)
Description: By default, filesystems with less than a full tape's worth (based on the
current SIZE= value) will be skipped when searching for a scratch tape. This option
can be overridden with the"UseFullFS TRUE" configuration option or "SET
UseFullFS=TRUE"command.
System Action: Unless overridden, full filesystems will be bypassed when a scratch
tape mount is requested.
User Action: None.
DLm110I
Channel adapter firmware tracing by DEVICE/PATH
Description: The virtual tape application has been configured to trace channel adapter
activity on a "Device" or "Path" basis. When tracing by Device, all of the activity for a
given device on all of that device's channel paths are traced in a common trace buffer
per device; the advantage is an overall larger trace buffer per device; the
disadvantage is that a lot of activity on other channel paths can cause loss of trace
entries for events that occurred on another path. When tracing by Path, each channel
path per device has an independent trace buffer. The advantage is that activity on one
channel path cannot cause loss of trace events on another channel path, but the
overall size of the trace buffer (per path per device) is smaller than with a full device
trace.
System Action: None.
User Action: None.
DLm111I
Maximum tape block size set to nnn
Description: The virtual tape application has been configured to support a maximum
tape block size different from the default of 256K.
System Action: The virtual tape application will support host reads and writes up to
the specified block size.
User Action: None. Do not change this setting unless directed to do so by EMC
Support.
DLm112I
Using NEW/FAST scratch search method
Description: The virtual tape application has been explicitly configured to support
either the standard documented scratch tape allocation technique ("NEW"), or an
alternative faster method that ignores scratch tapes' last-used dates.
System Action: The virtual tape application will use the technique described. The
default method is "NEW".
User Action: None.
DLm113E
ScratchSearchMethod=OLD is no longer a supported option
Description: The value "OLD" was specified for the ScratchSearchMethod parameter.
This value is no longer supported.
System Action: The virtual tape application will use the "NEW" (default) technique.
User Action: Contact EMC Support for more information.
DLm114I
Using DEFAULT/RR method of filesystem allocation
Description: If "RR", the virtual tape application has been explicitly configured to
select filesystems in a round robin fashion when allocating a scratch tape, as
opposed to the default method which is to pick the filesystem with the most free
space.
System Action: The application will use the technique described.
User Action: None.
DLm115E
Error returned from fsync. fd n. <description> file <filename>: error <error message>
Description: An I/O error occurred while syncing virtual tape data to disk.The 'error
message' text explains the reason for the failure.
System Action: The specified file was not sucessfully fsynced.
User Action: If you are unable to correct the problem contact EMC Support for
assistance.
DLm116I
Query Space timeout set to <nnn> minutes
Description: The system is configured to wait <nnn> minutes for a QUERY SPACE
command to complete. If QUERY SPACE does not complete withinthis time, an error
indication is displayed on the console.
System Action: None.
User Action: None.
DLm117I
Query Space <status>
Description: If a QUERY SPACE command is invoked while one is already running, an
'already in progress' status will be displayed. If the QUERY SPACE command exceeds
the QSPACETIMEOUT value, a 'has not completed within the timeout value' status will
be displayed.
System Action: None.
User Action: None.
DLm118I
Celerra report interval set to <nn> seconds
Description: The DLm application is configured to check every <nn> seconds for a
Celerra status report written by the Celerra control station. The default is 15 seconds.
System Action: None.
User Action: None.
DLm119E
Error reading configuration file <filename> line nnn: <error message>
Description: An IO error occurred while reading the specified configuration file.
System Action: Startup terminates.
User Action: Use the configuration program to reconfigure and save the specified
configuration file. If the problem persists, contact EMC Support for assistance.
DLm120I
Disk RECOVERYUPDATE set to <hours>
Description: The Disk Recovery Update time is set to a number of hours in the range of
1 hour to 8760 (365 days) in hours. This is a forced space recovery update based only
on time and not space.
System Action: None.
User Action: None.
DLm121E
Cannot open configuration file <filename>: <error message>
Description: The specified configuration file was not successfully opened.
System Action: Startup terminates.
User Action: Use the configuration program to reconfigure and save the specified
configuration file. If the problem persists, contact EMC Support for assistance.
DLm122E
No devices defined in configuration file
Description: There were no virtual tape drives configured in the configuration file.
System Action: Startup terminates.
User Action: Use the configuration program to reconfigure and save the configuration
file. If the problem persists, contact EMC Support for assistance.
DLm123E
Error in config file, line nn: Unrecognized keyword '<keyword>'
Description: The virtual tape configuration file contained an error.
DLm124E
Error in config file, line nn: Incorrect number of <keyword> parameters
Description: The virtual tape configuration file contained an error.
System Action: Startup terminates.
User Action: Use the configuration program to reconfigure and save the configuration
file.
DLm125E
Error in config file, line nn: Invalid <keyword> value '<value>'
Description: The virtual tape configuration file contained an error.
System Action: Startup terminates.
User Action: Use the configuration program to reconfigure and save the configuration
file.
DLm126E
Maximum number of devices (nnn) exceeded, terminating
Description: Too many devices have been defined in the configuration file.
System Action: Startup terminates.
User Action: Use the configuration program to reconfigure with a valid number of
devices.
DLm127I
ERASEPOLICYTTL set to (nnn)(H/D) (config/default)
Description: Displays the erase Policy TTL Time value in hours or days and the
config/default status.
System Action: None
User Action: None
DLm128I
Watchdog timer set to nnn seconds
Description: The watchdog timer value is used to monitor various processes to try to
determine if a process has stalled. This value is configurable with the "SET
WatchDogTimer=nnn" command, or in the configuration file with the "WatchDogTimer
nnn" option.
System Action: None.
User Action: None.
DLm129E
Error in config file, line nn: <value> is not a valid parameter
Description: The virtual tape configuration file contained an error.
System Action: Startup terminates.
User Action: Use the configuration program to reconfigure and save the configuration
file.
DLm130E
Error in config file, index xx: <value> is not a valid parameter
Description: The virtual tape configuration file contained an error.
System Action: Startup terminates.
User Action: Use the configuration program to reconfigure and save the configuration
file.
DLm131E
Error in config file, line nnn: No <keyword> parameter
Description: The virtual tape configuration file contained an error.
System Action: Startup terminates.
User Action: Use the configuration program to reconfigure and save the configuration
file. If the problem persists, contact EMC Support for assistance.
DLm132E
Error in config file, line nnn: Duplicate <keyword> parameters
DLm133E
Error in config file, line nnn: Too many <keyword> parameters
Description: The virtual tape configuration file contained an error.
System Action: Application startup terminates.
User Action: Use the configuration program to reconfigure and save the configuration
file. If the problem persists, contact EMC Support for assistance.
DLm134E
Duplicate INDEX=0xXX in configuration file, line nnn
Description: The virtual tape configuration file contained an error.
System Action: Startup terminates.
User Action: Use the configuration program to reconfigure and save the configuration
file. If the problem persists, contact EMC Support for assistance.
DLm135E
Error attaching device index xx
Description: The virtual tape configuration file contained an error.
System Action: Startup terminates.
User Action: Use the configuration program to reconfigure and save the configuration
file. If the problem persists, contact EMC Support for assistance.
DLm136E
Error in config file, line nnn: Duplicate "CELERRA DM=" parameter
Description: The Celerra Data Mover address (DM= parameter) on this CELERRA
configuration statement has already been defined on another Celerra definition.
System Action: Application startup terminates.
User Action: Correct the configuration file. For more assistance, contact EMC Support.
DLm137W
Invalid TRACE= value 'value'
Description: The virtual tape configuration file contained an error.
System Action: Startup continues with the default value of 1.
User Action: Use the configuration program to reconfigure and save the configuration
file.
DLm138E
EFS Short Term Lock Directory <DIR> is not mounted correctly.
Description: An NFS EFS Short Term Lock Directory should use the soft instead of the
hard mount option.
System Action: Scratch tapes will not be moved from their initial directory and space
may no longer even out.
User Action: Use the configuration program to reconfigure and save the configuration
file.
DLm139I
Enhanced Filesystem (EFS) support turned ON/OFF
Description: This message reports the status of the Enhanced Filesystem (ESF)
feature.
System Action: None.
User Action: None.
DLm140E
Error in config file, line nnn: <feature> not supported
Description: The virtual tape configuration file contains parameters for a feature that
is not licensed for use by this DLm application.
System Action: Startup terminates.
User Action: Contact EMC Support for more information on enabling the licensed
feature.
DLm141E
<feature> feature not supported on DLm8000
Description: The specified feature is not supported on the DLm8000.
System Action: If the feature parameter was specified in the configuration file, startup
terminates. If the feature parameter was specified in a command, the command is
rejected.
User Action: Contact EMC Support for more information on enabling the licensed
feature.
DLm144E
Duplicate NAME=value in configuration file, line nn
Description: The virtual tape configuration file contained an error.
System Action: Startup terminates.
User Action: Use the configuration program to reconfigure and save the configuration
file.
DLm148I
Firmware takeover feature enabled/disabled
Description: This message displays the status of the "Adapter Takeover" feature. This
feature is enabled by default. When enabled, the channel adapter firmware takes over
responsibility for certain operations on the channel when the Virtuent application is
slow to respond. When the feature is enabled, operations such as cancelling host jobs
or varying devices offline will result in fewer errors and be successful even if the
Virtuent application cannot respond to the host because of heavy or stalled I/O.
System Action: None.
User Action: None. This feature should be left enabled unless directed otherwise by
EMC Support.
DLm150W
Device <devicename> Data path <pathname> not licensed for OCFS2
Description: The specified virtual tape library directory is on a type of filesystem that
is supported only as an optional feature, and the license for that feature is not
installed on this system.
System Action: During system startup, this is a warning message and startup
continues. However, no virtual tape volumes that reside in this directory can be
mounted until the optional feature license is installed. If this error occurs when
processing a SET PATH command, the SET PATH command will fail and the current tape
library path is unchanged.
User Action: If the configured directory name is correct, make sure the proper
filesystem is mounted. If support for the optional filesystem type is desired, contact
EMC Support for information about obtaining the optional feature license.
DLm151E
Device <devicename> OCFS2 Feature not licensed, directory 'pathname' ignored
Description: The specified virtual tape library directory is on a type of filesystem that
is supported only as an optional feature, and the license for that feature is not
installed on this system.
System Action: This tape library directory is ignored for all purposes unless the
optional feature license is installed.
User Action: If the configured directory name is correct, make sure the proper
filesystem is mounted. If support for the optional filesystem type is desired, contact
EMC Support for information about obtaining the optional feature license.
DLm155I
Device <devicename> data path='<pathname>' [by default][, volser prefix=<volid>]
Description: The specified pathname will be the base tape library directory for this
device; virtual tape volumes for this device will reside in this directory and its
immediate subdirectories. '[by default]' signifies that PATH= was not specified for the
device and it was set to the standard default value; otherwise, PATH=pathname was
explicitly set in the device configuration. If a volser prefix is shown, it signifies that
virtual tape volumes that begin with the prefix <volid> will be automatically created as
needed by the virtual tape application, if they haven't been pre-initialized.
System Action: None.
User Action: None.
DLm156W
Device <devicename> Data path <pathname> is not accessible!
Description: The specified virtual tape library directory cannot be accessed.
System Action: During system startup, this is a warning message and startup
continues. However, no virtual tape volumes that reside in this directory can be
mounted on this drive until the specified directory is made accessible. If this error
occurs when processing a SET PATH command, the SET PATH command will fail and
the current tape library path is unchanged.
User Action: If the configured directory name is correct, make sure that it is mounted
and accessible to the user 'vtape'. If the directory name was misconfigured, correct
the PATH= parameter in the configuration file and restart the virtual tape application.
DLm157W
Device <devicename> tapelib subdirectory 'xxx' is not accessible!
Description: The specified virtual tape library subdirectory cannot be accessed.
System Action: During system startup, this is a warning message and startup
continues. However, no virtual tape volumes that reside in this subdirectory can be
mounted on this drive until the specified subdirectory is made accessible. If this error
occurs when processing a SET PATH command, the SET PATH command will fail and
the current tape library path is unchanged.
User Action: Make sure that the proper filesystem is mounted on the specified
subdirectory and it is accessible to the user 'vtape'.
DLm160I
Device <devicename> enabled for Guaranteed Replication
Description: This device is configured to perform Guaranteed Replication.
System Action: None.
User Action: None.
DLm161I
Tape library <pathname> enabled for replication
Description: This tape library directory resides on a filesystem that is enabled for
replication.
System Action: None.
User Action: None.
DLm162I
nn of maximum mm SSH sessions in use
Description: SSH sessions are used to communicate certain special requests to a
Celerra filesystem. This system is configured to support a maximum of 'mm'
concurrent SSH sessions, of which 'nn' are currently being used.
System Action: None.
User Action: None.
DLm163I
nn tasks are waiting to obtain an SSH session
Description: SSH sessions are used to communicate certain special requests to a
Celerra filesystem. 'nn' tasks are waiting for an available SSH session.
System Action: None.
User Action: None.
DLm164I
Device <devicename> enabled for FLR
Description: This device is configured to support File Level Retention.
System Action: None.
User Action: None.
DLm165I
Tape library <pathname> enabled for FLR
Description: This tape library directory resides on a filesystem that is enabled for File
Level Retention.
System Action: None.
User Action: None.
DLm166E
Error reading Celerra #n report file '/pathname/filename': <reason>
Description: An unexpected error occurred while trying to determine the current state
of the specified Celerra by reading the specified report file.
DLm167I
<option> forced to <value> for MDL-1000DD/2000DD
Description: The specified configuration option has been forced to a specific value for
this controller model.
System Action: The normal default value or configured value is ignored, and the
specified value is used.
User Action: None.
DLm168W
Invalid DEBUG= value 'value'
Description: The configuration file or operator SET DEBUG command contained an
error.
System Action: If a configuration error, startup terminates. If a SET DEBUG command
error, the SET command is ignored.
User Action: If a configuration error, use the configuration program to correct the
configuration file. If a SET DEBUG command error, use the HELP command to obtain
correct syntax.
DLm169I
Celerra #n report file 'filename' successfully read
Description: The specified report file written by Celerra #n was successfully read. The
report is read and the new report data is used whenever the report content has
changed from the last time it was read and stored.
System Action: Celerra-related features such as Guaranteed Replication and FLR will
be enabled as appropriate for this Celerra.
User Action: None.
DLm170W
Celerra #n report file is over 30 minutes old; check Celerra control station
Description: The specified status report file written by Celerra #n was written more
than 30 minutes ago. This signifies that the report-writing script on the Celerra control
station is probably not functioning correctly.
System Action: Celerra-related features such as Guaranteed Replication and/or FLR
may not function correctly.
User Action: Contact EMC Support for assistance.
DLm171E
File <filename> line nnn is too long
Description: The configuration file contained an error.
System Action: Startup terminates.
User Action: Reconfigure the specified configuration file. If the problem persists,
contact EMC Support for assistance.
DLm180E
Error [opening|configuring] <NAME> communication device <DETAILS>
Description: An internal error has occurred within either the SNMP or the IPMI
subsystem. The IPMI subsystem is responsible for monitoring and reporting system
events other than those occurring within the virtual tape application, the channel
interface adapter, or the adapter device drivers. The SNMP subsystem is responsible
for broadcasting all event messages that were selected during configuration to the
SNMP management station.
System Action: The controller continues to function in a degraded state. Data transfer
and storage continue to operate normally, but the SNMP and/or the IPMI subsystem
facility is no longer available.
User Action: It may be possible to identify the resource that caused the failure and
correct the problem. If the problem persists, contact EMC Support for assistance.
DLm181I
SNMP data dump file <NAME> has been created
Description: This message displays the name of the file that was created to save
SNMP diagnostic information.
System Action: None.
DLm182W
Unable to save SNMP data dump
Description: The system is unable to create the file to be used to save SNMP
diagnostic information.
System Action: The error is logged and operation continues. If the failure persists, the
SNMP subsystem will be disabled.
User Action: The user may retry the attempt to save the data by entering the command
'SNMP ACKNOWLEDGE FAILURE'. If the problem persists, contact EMC Support for
assistance.
DLm183W
[SNMP|IPMI] [read|write] failure, <additional information>
Description: A management subsystem operation has failed and event messages may
have been lost. This message may be accompanied by additional information
associated with the failure. The IPMI subsystem is responsible for monitoring and
reporting system events other than those occurring within the virtual tape application,
the channel interface adapter, or the adapter device drivers. The SNMP subsystem is
responsible for broadcasting all controller event messages that were selected during
Virtuent configuration to the SNMP management station.
System Action: The error is logged and operation continues. If the failure persists, the
subsystem will be disabled.
User Action: If the SNMP subsystem is disabled as a result of this failure, it can be
re-enabled from the virtual tape application console. If the problem persists, or it
cannot be corrected, contact EMC Support for assistance.
DLm184E
Error <NUMBER> building SNMP OID. Disabling SNMP
Description: SNMP has detected an internal error and SNMP event messages may
have been lost.
System Action: SNMP is disabled.
User Action: It may be possible to restart SNMP from the virtual tape application
console. Contact EMC Support for assistance.
DLm185E
Error - SNMP <ENTITY> initialization failed (<DETAILS>)
Description: ENTITY is 'thread', 'library', or 'IPMI'. A failure has occurred during
initialization of the entity. The IPMI subsystem is responsible for monitoring and
reporting system events other than those occurring within the virtual tape application,
the channel interface adapter, or the adapter device drivers. The SNMP subsystem is
responsible for broadcasting all controller application event messages that were
selected during configuration to the SNMP management station.
System Action: If the failure occurred within the SNMP subsystem, initialization is
aborted and the SNMP services will not be available. If the failure occurred within the
IPMI subsystem, SNMP will continue to function but no system platform events will be
reported.
User Action: Contact EMC Support for assistance.
DLm187E
SNMP message(s) have been lost - <DETAILS>
Description: Due to resource limitations an attempt to send one or more SNMP
messages failed. Failing messages have been lost.
System Action: The failure is logged, and the application continues.
User Action: Examine the controller's log to view the lost message(s). Contact EMC
Support for assistance.
DLm188I
SNMP is [not] operational
Description: This message is used to display the current SNMP operating status.
System Action: None.
User Action: None.
DLm189W
SNMP subagent service is unavailable
Description: SNMP is not initialized or it has terminated.
System Action: None.
User Action: None.
DLm190I
SNMP terminated
Description: The SNMP subsystem has shut down normally.
System Action: None.
User Action: None.
DLm192I
SNMP communication device has closed (flags = 0x<value>). SNMP terminating
Description: The SNMP internal communication mechanism has shut down normally.
System Action: SNMP subsystem terminates.
User Action: None.
DLm193I
IPMI <informational message>
Description: This message describes some event that has occurred within the IPMI
subsystem. The IPMI subsystem is responsible for monitoring and reporting system
events other than those occurring within the virtual tape application, the channel
interface adapter, or the adapter device drivers.
System Action: None
User Action: None
DLm194W
IPMI <warning message>
Description: An internal failure has occurred. The system has recovered, but event
messages may have been lost. The IPMI subsystem is responsible for monitoring and
reporting system events other than those occurring within the virtual tape application,
the channel interface adapter, or the adapter device drivers.
System Action: The condition is logged and operation continues. If the condition
persists, the IPMI subsystem will be shut down.
User Action: If the problem persists, contact EMC Support for assistance.
DLm195E
IPMI <error message>
Description: An error has occurred that has resulted in the loss of the IPMI subsystem
service. The IPMI subsystem is responsible for monitoring and reporting system
events other than those occurring within the virtual tape application, the channel
interface adapter, or the adapter device drivers.
System Action: The error is logged and the IPMI subsystem is shut down.
User Action: If the cause of the problem cannot be determined and corrected, contact
EMC Support for assistance.
DLm196I
(System Event) <informational message>
Description: This is an informational message describing a system platform event
that was detected by the IPMI subsystem. The IPMI subsystem is responsible for
monitoring and reporting system events other than those occurring within the virtual
tape application, the channel interface adapter, or the adapter device drivers.
System Action: The message is saved to both the system event log as well as the
virtual tape application's event log.
User Action: None
DLm197W
(System Event) <warning message>
Description: This message warns of a system platform event that was detected by the
IPMI subsystem. The event should be evaluated to determine if corrective action is
needed. The IPMI subsystem is responsible for monitoring and reporting system
events other than those occurring within the virtual tape application, the channel
interface adapter, or the adapter device drivers.
System Action: The message is saved to both the system event log as well as the
virtual tape application's event log.
User Action: The user action will vary with the event. In some cases, such as a chassis
intrusion warning following the replacement of a system component, the warning may
be ignored. In other cases, the message may indicate a failure or loss of redundancy
in a power supply, fan, memory device, or other component and the component
should be replaced. Contact EMC Support if assistance is needed.
DLm198E
(System Event) <error message>
Description: This message indicates that a system platform event was detected by the
IPMI subsystem that may result in significant functional or security problems. The
event should be evaluated to determine if corrective action is needed. The IPMI
subsystem is responsible for monitoring and reporting system events other than
those occurring within the virtual tape application, the channel interface adapter, or
the adapter device drivers.
System Action: The message is saved to both the system event log as well as the
Virtuent application event log.
User Action: The user action will vary with the event. In some cases, such as a chassis
intrusion warning following the replacement of a system component, the warning may
be ignored. In other cases, the message may indicate a failure or loss of redundancy
in a power supply, fan, memory device, or other component and the component
should be replaced. Contact EMC Support if assistance is needed.
DLm201I
Validating tape library '<pathname>'...
Description: During startup, and any other time a tape library path change is
requested, the virtual tape application validates the tape library for various integrity
issues.
System Action: If any errors are found, subsequent messages will report the
problem(s).
User Action: If any errors are reported, correct the problem(s), then SET PATH= to the
desired path.
DLm202I
Device <devicename> <nn> subdirectories under tape library 'pathname'
Description: While validating the specified tape library, this message displays the
number of subdirectories found in that tape library.
System Action: If any subdirectories exist, they will also be validated.
User Action: None.
DLm203I
Device <devicename> There is no <volser> directory, using <pathname>
Description: When attempting to mount, scratch, unscratch, erase, delete, or initialize
a volume, the virtual tape application found that there was no tape library
subdirectory matching the first two characters ("volser prefix") of the specified
volume.
System Action: The system will search only in the base tape library directory for the
desired volume.
User Action: None.
DLm204E
Device <devicename> tapelib directory '<pathname>' is not browsable!
Description: While validating the tape library, the specified path was found to be not
browsable, which means the contents could not be listed.
System Action: During system startup, this is a warning message. If this error occurs
when processing a SET PATH command, the SET PATH command fails.
User Action: Be sure the tape library is mounted correctly, and that it is owned by user
'vtape' and has the 'x' permission set.
DLm205E
Device <devicename> error while checking tape library '<pathname>' subdirectories:
error message
Description: An I/O error occurred while searching the specified tape library for
subdirectories.
System Action: During system startup, this is a warning message. If this error occurs
when processing a SET PATH command, the SET PATH command fails.
User Action: The 'error message' portion of this message will describe the error that
occurred. Correct the error and retry the SET PATH command to set the tape library
path to the desired path.
DLm206W
Device <devicename> bypassing full filesystem <pathname>
Description: A filesystem with less than a full tape's worth of free space (based on the
current SIZE= value) will be skipped while searching for a scratch tape. This option
can be overridden with the "UseFullFS TRUE" configuration option or "SET
UseFullFS=TRUE" command.
System Action: The specified filesystem is bypassed during this scratch tape search.
User Action: None.
DLm207W
Device <devicename> bypassing stalled filesystem <pathname> (nnn seconds)
Description: The specified filesystem will be skipped while performing a virtual tape
search because it has not responded to I/O requests for the past nnn seconds.
System Action: The specified filesystem is bypassed during this tape search.
User Action: A filesystem should not be this unresponsive. Check your backend
filesystem and network connections for problems. For more assistance, contact EMC
Support.
DLm208W
Device <devicename> bypassing quiesced filesystem <pathname>
Description: The specified filesystem will be skipped while performing a virtual tape
search because it has quiesced.
System Action: The specified filesystem is bypassed during this tape search.
User Action: None.
DLm209E
Cannot unquiesce, tapelib path=<pathname> not accessible.
Description: The specified filesystem cannot be unquiesced because it is not
mounted
System Action: None.
User Action: Mount the file system and then request unquiesce
DLm210I
Validating tape library '<pathname>'...
Description: During startup, and any other time a tape library path change is
requested, the virtual tape application validates the tape library for various integrity
issues.
System Action: If any errors are found, subsequent messages will report the
problem(s).
User Action: If any errors are reported, correct the problem(s), then SET PATH= to the
desired path.
DLm211I
Tape Library SN '<status>'
Description: During startup the virtual tape application determines whether the
discovered tape library is supported or not.
System Action: During system startup this is an informational message.
User Action: If a library is not supported the operator could change the VTL back end
to disable this library and enable a supported library instead.
DLm212I
VTL <VTL-SN> Volume List <status>
Description: During startup, and at any other time a VTL volume list update is
requested, the virtual tape application will display the VTL volume list state.
System Action: None.
User Action: None.
DLm213I
SCSI Media Changer Driver version: x.x.x
Description: This message displays the version number of the SCSI media changer
driver.
System Action: None.
User Action: None.
DLm214E
Error creating/mapping/opening ATL Volume List file <filename>: <error message>
Description: An error occurred while initializing the specified feature. This error can
only occur during startup.
System Action: Startup terminates or continues without the specified feature. The
'error message' text explains the reason for the failure.
User Action: If you are unable to correct the problem, contact EMC Support for
assistance.
DLm216I
VTL-SN Environment Changed, Please Update Volume List. Update of Volume List
could take some time.
Description: The application volume list no longer matches the VTL environment.
System Action: None.
User Action: Invoke the <Update Volume List> command to resynchronize the VTL and
application.
DLm217W
VTL-SN volumes in slots x to y exceed maximum and will not be used
Description: The VTL has defined more slots than the application can support.
System Action: None.
User Action: Define the number of slots on the back-end VTL to within our maximum.
DLm218I
Scanning tape drive devices...
Description: The SCSI tape drives are being scanned and cataloged.
System Action: None.
User Action: None.
DLm219I
No VTL drives available.
Description: The VTL has no drives available. All configured drives are allocated.
System Action: None.
User Action: Configure more VTL drives or fewer channel attached drives.
DLm220I
Validating tapelib subdirectory '<name>'...
Description: During startup, and any other time a tape library path change is
requested, the virtual tape application validates the tape library and each of its
subdirectories for various integrity issues.
System Action: If any errors are found, subsequent messages will report the
problem(s).
User Action: If any errors are reported, correct the problem(s), then SET PATH= to the
desired path.
DLm221E
Device <devicename> subdirectory name '<name>' is not a valid volser prefix
Description: During validation of the tape library, the virtual tape application found
the specified subdirectory, but the subdirectory name does not conform to a valid
volser prefix. Every subdirectory in a tape library must have a two-character name that
consists of valid volser characters (A-Z, 0-9). This message will only occur if enhanced
filesystem support is NOT enabled on this node.
System Action: During system startup, this is a warning message. If this error occurs
when processing a SET PATH command, the SET PATH command will fail.
User Action: Either remove the invalid subdirectory from the tape library base
directory, or rename the subdirectory to a valid volser prefix.
DLm222E
Device <devicename> subdirectory name '<name>' is not a valid tape library
subdirectory name
Description: During validation of the tape library, the virtual tape application found
the specified subdirectory, but the subdirectory name is not a valid enhanced
filesystem subdirectory name. Every subdirectory in an enhanced filesystem tape
library must have an alpha-numeric name containing only upper-case letters and/or
numbers. This message will only occur if enhanced filesystem support is enabled on
this node.
System Action: During system startup, this is a warning message. If this error occurs
when processing a SET PATH command, the SET PATH command will fail.
User Action: Either remove the invalid subdirectory from the tapelibrary base
directory, or rename the subdirectory to a valid enhanced filesystem subdirectory
name.
DLm223I
Device <devicename> volume <volser> not moved because VOLSERLOCKDIR is not
mounted correctly.
Description: The EFS Move feature has been disabled because the VOLSERLOCKDIR
not mounted correctly. The VOLSERLOCKDIR must be mounted with the 'soft' option.
System Action: Scratch tapes will not be moved from their initial directory and space
may no longer even out.
User Action: Use the configuration program to reconfigure and save the configuration
file.
DLm224E
Device <devicename> tapelib subdirectory '<name>' is not browsable!
Description: While validating this tape library subdirectory, the specified path was
found to be not browsable, which means the contents could not be listed.
System Action: During system startup, this is a warning message. If this error occurs
when processing a SET PATH command, the SET PATH command fails.
User Action: Be sure the tape library is mounted correctly, and that each subdirectory
is owned by user 'vtape' and has the 'x' permission set.
DLm225E
Device <devicename> Error while checking tapelib subdirectory '<name>': error
message
Description: An I/O error occurred while searching the contents of the specified tape
library subdirectory.
System Action: During system startup, this is a warning message. If this error occurs
when processing a SET PATH command, the SET PATH command fails.
User Action: The 'error message' portion of this message will describe the error that
occurred. Correct the error and retry the SET PATH command to set the tape library
path to the desired path.
DLm226W
Device <devicename> file '<filename>' does not belong in subdirectory '<name>'
Description: The specified file does not belong in the specified tape library
subdirectory because it does not begin with the same first two characters ("volser
prefix") as the subdirectory name.
System Action: During system startup, this is a warning message. If this error occurs
when processing a SET PATH command, the SET PATH command fails. If this message
occurs during a tape volume mount, the mount fails.
User Action: Correct the error, then retry the SET PATH command to set the tape library
path to the desired path or retry the tape volume mount.
DLm227E
Device <devicename> file '<filename>' in base library belongs in subdirectory '<name>'
Description: The specified file does not belong in the base tape library directory
because it begins with the same first two characters ("volser prefix") as an existing
subdirectory name. The file should reside in that subdirectory.
System Action: During system startup, this is a warning message. If this error occurs
when processing a SET PATH command, the SET PATH command fails. If this message
occurs during a tape volume mount, the mount fails.
User Action: Correct the error, then retry the SET PATH command to set the tape library
path to the desired path or retry the tape volume mount.
DLm230W
WARNING: Device <devicename> path <dirname> is on root filesystem!
Description: The directory assigned to hold the virtual tape volumes for this device is
mounted on the root filesystem. This usually means that the real tape library
filesystem was not mounted, since tapes aren't expected to be stored on the internal
system disk(s), but on a high capacity external disk.
System Action: The specified directory continues to be used as the tape library for this
drive. This message will display every time a virtual tape volume is successfully
mounted and the tape library is still mounted on the root filesystem.
User Action: Make sure that the proper disk filesystem is mounted on the tape library
path specified for this drive.
DLm231W
Unable to determine <pathname> device name: <error message>
Description: The virtual tape application was unable to determine on which disk
filesystem the specified directory is mounted.
System Action: Processing continues normally. This message should not normally
occur, but it will display every time a virtual volume is successfully mounted while the
'pathname' filesystem device cannot be determined.
User Action: Contact EMC Support for assistance.
DLm232W
Device <devicename> Unable to determine <pathname> filesystem type: <error
message>
Description: An unexpected error occurred while trying to determine what type of
filesystem holds the specified tape library.
System Action: The virtual tape application will continue to run, but some features
(such as warnings about the capacity limits of certain filesystems) may not be
functional.
User Action: If this problem recurs, contact EMC Support for assistance.
DLm233E
Device <devicename> data path <pathname> is not accessible
Description: During mounting of an explicit VOLSER, the virtual tape application was
not able to access the specified tape library subdirectory.
System Action: This subdirectory is ignored. If there are other tape library
subdirectories, they will be considered in order to attempt to fulfill the mount request.
User Action: If the configured tape library is correct, make sure that all of its
subdirectories are mounted and accessible to the user 'vtape'. If the tape library is
misconfigured, correct the PATH=parameter in the configuration file and restart the
virtual tape application, or use the SET PATH command to temporarily change the
tapelib path.
DLm234W
Device <devicename> data path <pathname> is not accessible: not readable
Description: During mounting of a scratch volume, the virtual tape application was not
able to access the specified tape library subdirectory.
System Action: This subdirectory is ignored. If there are other tape library
subdirectories, they will be considered in order to attempt to fulfill the mount request.
User Action: If the configured tape library is correct, make sure that all of its
subdirectories are mounted and accessible to the user 'vtape'. If the tape library is
misconfigured, correct the PATH= parameter in the configuration file and restart the
virtual tape application, or use the SET PATH command to temporarily change the
tapelib path.
DLm235E
Device <devicename> failed deferred tapelib path change to <path>
Description: A tape library change was previously deferred while a volume was
mounted on this drive. Now that there is no longer a volume mounted, an attempt to
change the tape library to the new path has failed.
System Action: The tape library path is not changed.
User Action: This message should have been preceded by one or more messages that
explained the problem. Refer to these messages, correct the problem(s), and then SET
PATH= to the desired path.
DLm236W
Error reading filesystem info for <pathname>: error message
Description: An unexpected error occurred while trying to determine what filesystem
holds the specified tape library directory.
System Action: The application will continue to run, but some features that need to
know information about the filesystem, such as Guaranteed Replication, will not be
functional.
User Action: If the error messages describe a correctable problem, correct the problem
and restart the application. Contact EMC Support if more assistance is needed.
DLm237W
Device <devicename> Volume <volser> Error reading Celerra Report: error message
Description: An unexpected error occurred while trying to determine the current state
of replication on a Celerra filesystem.
DLm238I
Guaranteed Replication method is by <method>
Description: The Guaranteed Replication feature is configured to use the specified
method to determine when a given file's replication is complete.
System Action: The specified method will be used to determine when a given file's
replication is complete.
User Action: None.
DLm239E
Error opening Celerra report file <pathname>: error message
Description: An unexpected error occurred while trying to determine the current state
of replication on a Celerra filesystem.
System Action: The application will continue to run, but some features that need to
know information about the filesystem, such as Guaranteed Replication, will not be
functional.
User Action: If the error message describes a correctable problem, correct the problem
and restart the application. Contact EMC Support if more assistance is needed.
DLm240E
Unable to open tape library path: <path>
Description: A tape library path couldn't be opened
System Action: The search for a particular volser was not completed
User Action: Check to be sure the path exists
DLm241E
Device <devicename> Unable to read contents of EFS lock file <volser>: <error>
Description: While unlocking a volume, the contents (owner) of an EFS lock file could
not be read.
System Action: The owner of the EFS lock could not be determined. The lock remains
in place.
User Action: Verify that the EFS lock directory is mounted and accessible.
DLm242E
Device <devicename> Error deleting <description> file <filename>: <error>
Description: An error occurred while trying to delete the specified temporary file.
System Action: The status of the file is unknown. If the specified file is a lock file the
lock may still be in place.
User Action: If possible, correct the problem described in <error>. Contact EMC Support
if assistance is needed.
DLm243E
Unable to open file <file>: <error>
Description: An error occurred while opening a file for reading.
System Action: The file could not be opened.
User Action: Verify that the file exists.
DLm244E
Error reading file <file>: <error>
Description: An error occurred while reading a file.
System Action: The file could not be read.
User Action: Verify the file exists.
DLm245E
Unable to open volser lock directory <directory>
Description: The system was unable to open the volser lock directory.
System Action: The existing locks could not be read.
User Action: Verify the lock directory is mounted and accessible.
DLm246E
Device <devicename> error returned from stat command to file <file>: <error>
Description: A stat command to a file failed.
System Action: Information on the file could not be obtained.
User Action: Verify that the path to the file is mounted and accessible.
DLm247E
Device <devicename> error returned from statfs command to directory <dir>: <error>
Description: An error occurred while getting information about a directory.
System Action: Directory information was not obtained.
User Action: Verify the directory path is online, mounted, and accessible.
DLm248E
Device <devicename> error getting offset to file <file>: <error>
Description: An lseek command to a file returned an error.
System Action: The current file offset to a file could not be obtained.
User Action: Verify that the file path is mounted and accessible.
DLm249E
Device <devicename> error opening file <file>: <error>
Description: A new file could not be created.
System Action: A new file could not be created. The volume will not be moved.
User Action: Verify that the file path is mounted and accessible.
DLm250I
Device <devicename> Incomplete read from file 'filename'
Description: A read of the file returned 0 bytes when data was available.
System Action: This volser will not be moved.
User Action: None. If the problem persists, contact EMC Support.
DLm251I
Problem accessing directory <dirname>: <error>
Description: A problem occurred while accessing the destination directory for the new
volume(s).
System Action: No volumes will now be created in this directory.
User Action: None. If the problem persists, contact EMC Support.
DLm252E
Wrong storage class. REQ <requested class>, WAS <actual class> for <dirname>
Description: The INITIALIZE command specified both CLASS= and DIR= parameters,
but the specified directory has a class different from the specified CLASS.
System Action: No volumes created.
User Action: Retry the command with a different storage class or directory.
DLm253E
No subdirectory found at <base directory> with storage class <requested storage class>
Description: No tape volume libraries of the requested class were found at the tape
library location.
System Action: No volumes created.
User Action: Retry the command with a different storage class.
DLm254I
Invalid storage class file: <directory/filename>
Description: The class file (.CLASSx) found in this directory is invalid.
System Action: Storage class could not be determined.
User Action: Rename or remove the offending file.
DLm255I
Max display count <count> exceeded for key: <key>
Description: The number of matches for the find volume exceeded the limit.
System Action: No more volumes will be displayed for this command, command
processing ended.
User Action: Retry the find command with a key that will have fewer matches.
DLm256I
EFS Short Term Lock Directory set to: <directory>
Description: An EFS short term lock directory has been specified for Enhanced
Filesystem Architecture operations.
System Action: The application will use the specified directory for 'create' locks.
User Action: None.
DLm257I
The Maximum Find Volume Display Count is: <count>
Description: This is the maximum number of volumes displayed by the 'find volume'
command.
System Action: No more that <count> volumes will be displayed for the find volume
command.
User Action: None.
DLm258E
Invalid storage class parameter: <class>
Description: The IMPORT command CLASS= parameter is invalid.
System Action: The command will not be executed.
User Action: Retry the command with valid parameters.
DLm259E
No storage class <class> directory found.
Description: The IMPORT command CLASS= parameter specified a storage class that
cannot be found.
System Action: The command will not be executed.
User Action: Retry the command with valid parameters.
DLm260E
Could not determine the storage class of directory <directory>: <reason>
Description: While processing an IMPORT command, the storage class of the directory
could not be determined.
System Action: The operation will not be executed.
User Action: Retry to a different directory.
DLm261E
Device <devicename> Unable to lock volser <volser>: <reason>
Description: A lock could not be placed on a volser.
System Action: The operation will not be executed.
User Action: verify the VOLSERLOCKDIR setting in the configuration file.
DLm262E
Device <devicename> Unable to unlock volser <volser>: <reason>
Description: A lock could not be removed from a volser.
System Action: The operation will not be executed.
User Action: Verify the VOLSERLOCKDIR setting in the configuration file.
DLm263I
Device <devicename> moved <volser path> to <volser path>, <size> bytes
Description: A device moved a newly acquired scratch volume from one filesystem to
another filesystem of the same class.
System Action: None
User Action: None
DLm264E
Invalid parameter: <import to>
Description: The IMPORT command TO parameter is not a valid VOLSER name.
System Action: The command will not be executed.
User Action: Retry the command with valid parameters.
DLm269I
Device <devicename> forcing CRC storing/large headers for Data Domain filesystem
Description: The device is writing to a filesystem that resides on a Data Domain. This
type of file system requires large headers to be used.
System Action: None
User Action: None
DLm270I
Device <devicename> Volume <volser> writing AMDD optimized volume
Description: During a write operation, the data on this tape volume has been modified
by the AMDD feature to achieve better back-end data duplication. This message will
be displayed only once per volume.
System Action: None. When the data is read back, the AMDD modifications will be
transparent to the host.
User Action: None.
DLm271I
Device <devicename> Volume <volser> reading AMDD optimized volume
Description: During a read operation, the data on this tape volume was found to have
been modified by the AMDD feature to achieve better back-end data duplication. This
message will be displayed only once per volume.
System Action: None. When the data is read back, the AMDD modifications will be
transparent to the host.
User Action: None.
DLm272E
Device <devicename> Volume <volser> block #nnnn contains unknown AMDD version id
Description: During a read operation, the data on the specified tape block was
flagged as having been modified by the AMDD feature, but data in the AMDD block
header isn't recognized as valid.
System Action: An equipment check error status is returned to the Host I/O request.
User Action: Contact EMC Support for assistance.
DLm273W
Device <devicename> Volume <volser> AMDD skipping incompatible <type> block
#nnnnn, offset <nnnn>: <reason>
Description: While considering this block for AMDD processing during a write, it was
found that although the block was initially thought to be of a <type> recognized by
AMDD (DSS, FDR, etc), some inconsistencies in the data prevented AMDD from being
able to process the block.
System Action: The block is written without any AMDD modification.
User Action: Rarely, data that normally isn't handled by AMDD can initially be
mistaken as a recognized data type. In this case, this message can be ignored. If this
message is displayed while the specified <type> of data (i.e. DSS, FDR, etc) is being
written, it signifies an incompatibily that should be reported to EMC Support for
evaluation.
DLm274I
Device <devicename> Volume <volser> AMDD modified <nnnnn> of <nnnnn> blocks
written
Description: AMDD has modified the specified number of blocks in order to improve
back-end data-deduplication performance. This message is displayed when an
AMDD-modified tape is unloaded.
System Action: None.
User Action: None.
DLm275I
Device <devicename> Volume <volser> <AMDD informational message>
Description: This message is used for displaying any number of AMDD
informational/statistical messages. These messages are only displayed when AMDD
debugging is enabled.
System Action: None.
User Action: None.
DLm276I
Device <devicename> Volume <volser> AMDD read <nnnnn> AMDD-modified blocks
Description: The specified number of blocks read from this tape were found to have
been AMDD-modified blocks. This informational message is displayed at unload time
whenever any AMDD-modified blocks had been read.
System Action: None.
User Action: None.
DLm277E
Device <devicename> Volume <volser> Invalid AMDD identifier, block #nnn
Description: The specified block is flagged as an AMDD-modified data block, but does
not contain valid AMDD data.
System Action: An equipment check error status is returned to the Host I/O request.
User Action: Contact EMC Support for assistance.
DLm278I
Device <devicename> Volume <volser> Suppressing IDRC for <type> library
Description: The Host has requested that the data it is writing should be compressed,
but the data will be written uncompressed because the type of tape library filesystem
it is being written to performs better with uncompressed data. <type> may be either
"EMC DLm Data Domain", "MDL-1000DD", or "MDL-2000DD".
System Action: The data being written is not compressed. If desired, compression can
be forced, regardless of filesystem, by setting the IDRC=FORCE option on a
device-by-device basis. This message will display only once per volume as a reminder.
User Action: None.
DLm279W
Device <devicename> Volume <volser> Suppressing AMDD due to encryption
Description: The specified device is configured to use AMDD data optimization, but
the device is also configured to encrypt the data.
System Action: The data being written is encrypted but not optimized by AMDD. This
message will display only once per volume as a reminder.
User Action: None.
DLm281E
EXPORT/IMPORT FROM file not found. EXPORT/IMPORT command aborted.
Description: The file specified in the command does not exist. The command stopped
with no action.
System Action: None.
User Action: Issue the command with the correct file.
DLm282E
EXPORT TO device already in use. EXPORT command aborted.
Description: The SCSI TO device specified in the EXPORT command is already in use.
The EXPORT command stopped with no action.
System Action: None.
User Action: Issue the EXPORT command when the device becomes free.
DLm283E
EXPORT/IMPORT FROM/TO file already in use. EXPORT/IMPORT command aborted.
Description: The file specified in the command is currently in use by another device.
The command stopped with no action.
System Action: None.
User Action: Issue the command again once the current operation that is using the file
has completed.
DLm284E
EXPORT/IMPORT FROM/TO device block could not be created.
Description: An internal error occurred while trying to set up to execute the command.
The command stopped with no action.
System Action: None.
User Action: Check for previous error message that may indicate cause of problem.
Verify that the SCSI device is properly attached to the system. If this problem recurs,
contact EMC Support for assistance.
DLm285E
EXPORT/IMPORT FROM/TO device is not a valid device type for this command.
Description: One of the parameters specified is not a valid type for this command. The
command stopped with no action.
System Action: None.
User Action: Issue the command again with valid parameters.
DLm287E
IMPORT SCSI device is already in use. IMPORT command aborted.
Description: The SCSI device specified in the command is currently in use. The
command stopped with no action.
System Action: None.
User Action: Issue the IMPORT command when the device becomes free.
DLm288E
IMPORT TO file already exists. Import will not overwrite an existing file.
Description: The file specified in the command to write to already exists. Overwriting
an existing file is not allowed. The command stopped with no action.
System Action: None.
User Action: Issue the command again with a file that does not already exist.
DLm289E
EXPORT/IMPORT FROM/TO file is invalid. Scratch file not permitted.
Description: Scratch file specified in EXPORT or IMPORT command. Scratch file use is
not permitted in these operations.
System Action: None.
User Action: None.
DLm290I
<IMPORT/EXPORT> operation starting: FROM=file (dev=EXFRxxxx) TO=device
(dev=EXTOxxxx)
Description: Message indicating the IMPORT or EXPORT operation is starting.
DLm291I
IMPORT/EXPORT operation finished (successfully/with error): FROM=file
(dev=EXFRxxxx) TO=device (dev=EXTOxxxx)
Description: Message indicating the operation has completed. If with error, check
previous messages for cause of error.
System Action: None.
User Action: None.
DLm294I
EXPORT/IMPORT operation performing rewind or rewind/unload: FROM=name
(dev=EX/IMFRxxxx) TO=name (dev=IMTOxxxx)
Description: Message indicating the operation has completed and is now rewinding
and/or unloading the tape device per the NORUN flag.
System Action: None.
User Action: None.
DLm295E
EXPORT operation reached PEOT. Tape invalid: FROM=name (dev=EXFRxxxx)
TO=name (dev=EXTOxxxx)
Description: The EXPORT command reached the physical end of tape before
completing the export operation.
System Action: The incomplete output tape is overwritten by tape marks to invalidate
the incomplete transfer.
User Action: Repeat the EXPORT operation with a larger tape.
DLm296E
Error rewinding tape after PEOT: FROM=name (dev=EXFRxxxx) TO=name
(dev=EXTOxxxx)
Description: The EXPORT command got an error rewinding the tape after it reached the
physical end of tape. The tape contains incomplete contents.
DLm297E
Error writing tapemark after PEOT: FROM=name (dev=EXFRxxxx) TO=name
(dev=EXTOxxxx)
Description: The EXPORT command got an error writing tape marks after a rewind of
the tape after it reached the physical end of tape. The tape contains incomplete
contents.
System Action: None.
User Action: None.
DLm298E
SCSI device not ready, operation aborted: FROM=name (dev=EX/IMFRxxxx) TO=name
(dev=EX/IMTOxxxx)
Description: The SCSI device specified in the command was not in the ready state,
and the operation was aborted.
System Action: None.
User Action: Ready the SCSI device and issue the command again.
DLm300W
Device <devicename>, connection n, received pkt 0xXXXX (packettype )
Description: The channel interface adapter sent an unexpected message type to the
virtual tape application.
System Action: The message from the adapter is ignored.
User Action: If this problem recurs, contact EMC Support for assistance.
DLm301W
Channel event 'eventtype' (0xXXXX) on device <devicename> <pathinfo> [XXXX XXXX]
Description: The specified exceptional channel event 'eventtype' has been detected.
Some common eventtypes which may occur include: Halt I/O: Host has issued a Halt
I/O command, usually as a result of a Host job being cancelled.
System Reset: Host has issued a System Reset, usually as a result of the Host being
reset. Link Error: An error has occurred at the channel link level. This is usually the
result of the channel 'dropping light', most often because the channel cable was
unplugged or is faulty. This can also be the result of a channel protocol error caused
by a faulty channel, director, or channel adapter hardware or firmware problem.
Selective Reset: The Host has issued a Selective Reset to this device, usually because
the device is being varied on or offline, or because a serious I/O error has occurred on
this device. VirtuentNotReponding: The channel adapter has received a Halt I/O
and/or Selective Reset from the host, but the Virtuent application has not responded.
The channel adapter firmware will take over responsibility to respond to the host until
Virtuent resumes communication with the channel adapter.
System Action: Processing continues normally; it is presumed that the Host will
perform the proper error recovery procedure, to which the controller will respond like a
real tape drive.
User Action: Unless this is an expected occurrence (such as the Host job is being
canceled, the Host is being reset, or a channel or device is being varied off or on),
check the Host console logs to determine the cause of the problem. Contact EMC
Support for assistance if the problem persists.
DLm302I
Device <devicename> <pathinfo> Offline to channel
Description: The specified device has been taken offline on the specified channel
interface. This is usually the result of the channel being "varied offline" or unplugged.
System Action: This device will be unavailable to the Host until it is brought back
online.
User Action: None, unless this is an unexpected occurrence, in which case you should
investigate the cause at the Host.
DLm303I
Device <devicename> <pathinfo> Online to channel
Description: The specified device has been brought online on the specified channel
interface.
System Action: This device is available to the Host on this channel interface.
User Action: None.
DLm304E
Interface #n exceeded automatic restart limit of <count>, NOT restarting
Description: The specified channel interface was reset because of an error, or because
of an operator action from outside the virtual tape application.The virtual tape
application will automatically recover from this situation <count> number of times, but
this count has been exceeded.
System Action: This channel interface remains offline.
User Action: The situation causing the channel interface adapter to reset should be
investigated; contact EMC Support for more assistance if necessary. The channel
interface can be brought back online by entering the virtual tape application's "RESET
CHANNEL ADAPTER n" command.
DLm305E
Active path(s) on Interface #n, cannot stop adapter
Description: There was an attempt to reset or stop channel interface #n while there
were active device(s) online.
System Action: The channel interface remains online without having been. stopped or
reset.
User Action: Before stopping or resetting a channel interface, all channel paths using
that channel adapter must be varied offline from the Host.
DLm306W
Active path on Interface #n, device <devicename>
Description: Channel interface #n is being forcefully stopped or reset while there are
active device(s) online. This may cause I/O errors on the Host channel.
System Action: Stopping or resetting of the channel interface continues.
User Action: None.
DLm307I
Device <devicename> Virtuent has resumed responding to adapter #n
Description: After a channel adapter takeover had occurred (see message VIR301W),
Virtuent has resumed responding to the channel adapter and taken back full
responsibility for host-to-Virtuent communication.
DLm308I
Rebooting Interface #n, slot=nnnnnn
Description: Channel interface #n is being reset.
System Action: None.
User Action: None.
DLm309I
Device <devicename> NOT sending a resetting event unit check
Description: A resetting event is any channel event that resets a channel-attached
device's pathgroup ID or assignment, such as a system or selective reset or restarting
of the virtual tape application. Normally, after a resetting event has occurred the next
command sent by the Host receives a resetting event unit check to notify the Host that
the resetting event occurred. The Host should respond appropriately by restoring the
device's pathgroup ID and assignment information, and re-issue the unit-checked
command. Occasionally, especially with older standalone IPL programs, a Host may
not handle a resetting event unit check correctly. In this case, the virtual tape
application can be configured to NOT send resetting event unit checks. This message
is displayed when the controller is so configured and would have normally sent a
resetting event unit check to a Host command.
System Action: Processing of Host commands continues without the occurrence of a
resetting event unit check.
User Action: None. Under normal conditions, the controller should NOT be configured
to ignore resetting events. Doing so can cause problems when varying on devices to a
Host that does properly handle, and actually expects, resetting event unit checks.
Contact EMC Support for more information.
DLm310E
<process> received unexpected packet type 0xXXXX (packettype)
Description: An error was returned from the channel adapter. This error can only occur
during startup.
System Action: Startup terminates.
DLm311W
Device <devicename> received <info> on path <n> but in chain on path <n>
Description: An unexpected message was returned from the channel adapter.
System Action: The application continues to run, but this device may not continue to
function properly.
User Action: Contact EMC Support for assistance.
DLm312E
Device <devicename> Error reading from Interface #n: error message
Description: An error was returned from the channel adapter.
System Action: The application continues to run, but this device may not continue to
function properly.
User Action: Contact EMC Support for assistance.
DLm313E
Device <devicename> error sending <info>, error = nn (0xXX)
Description: An error was returned from the channel adapter.
System Action: The application continues to run, but this device may not continue to
function properly.
User Action: Contact EMC Support for assistance.
DLm314E
Device <devicename> <path> unexpected <type> XX CCW while inccw for XX
Description: An unexpected packet sequencing error occurred. This is an internal
error.
System Action: A Unit Check is returned to the host.
User Action: Contact EMC Support for assistance.
DLm315W
Device <devicename> selection (ccw XX) on path <n> not assigned
Description: The virtual tape device has been Assigned (reserved) by a specific Host
LPAR, but it received an I/O command over a channel path on which it isn't currently
assigned.
System Action: The I/O command is ignored.
User Action: Check that the virtual tape devices' configuration matches the Host's
configuration.
DLm316E
Device <devicename> received <info> on unexpected connection nn, path=nn
Description: A message was received from the channel adapter from a path that the
virtual tape application does not recognize as a valid path.
System Action: The unexpected message is ignored. The application continues to run,
but this device may not continue to function properly.
User Action: Contact EMC Support for assistance.
DLm317E
Device <devicename> received data on unexpected connection nn, path=nn
Description: Data was received from the channel adapter from a path on which the
virtual tape application wasn't currently handling a CCW.
System Action: The unexpected data is ignored. The application continues to run, but
this device may not continue to function properly.
User Action: Contact EMC Support for assistance.
DLm318E
Device <devicename> received unexpected data on connection nn, path=nn
Description: Data was received from the channel adapter while the virtual tape
application was not currently handling a CCW that should send data.
System Action: The unexpected data is ignored. The application continues to run, but
this device may not continue to function properly.
User Action: Contact EMC Support for assistance.
DLm319E
Device <devicename> <path> invalid data chaining flags (XXX) for XX CCW
Description: An invalid message was received from the channel adapter. This is an
internal error.
System Action: The CCW is rejected with a Unit Check.
User Action: Contact EMC Support for assistance.
DLm320I
Firmware trace enabled/disabled interface #n, slot nnnnnn
Description: Firmware tracing was enabled or disabled on the specified channel
adapter.
System Action: Channel adapter tracing will remain in this state until until the virtual
tape application is next restarted.
User Action: None. You can use the "ENABLE FIRMWARE TRACE" or "DISABLE
FIRMWARE TRACE" command to turn tracing on or off.
DLm326E
Channel Adapter #n NOT reset/stopped/started
Description: A "RESET/STOP/START CHANNEL ADAPTER" command was entered, but
the specified action could not be performed.
System Action: None.
User Action: Examine any preceding related messages, if any, for additional error
messages that explain why the action could not be performed, correct the problem,
and try the command again.
DLm327I
Channel Adapter #n reset/stopped/started
Description: The specified action was taken in response to the "RESET/STOP/START
CHANNEL ADAPTER" command.
System Action: None.
User Action: None.
DLm331E
Device <devicename> no <type of path> to send Ready Status
Description: The virtual tape drive has become Ready, but there is no online path to
send the Ready status message to the Host. Most likely the drive, path, or channel
was never configured/varied online on the Host, or has been varied offline.
System Action: The drive is mounted and ready from the virtual tape application's
point of view, but since a Ready status was not presented the Host will most likely
report that the drive is still not ready.
User Action: Check that the specified device is varied online on the Host. You can
cause the virtual tape application to present another 'Ready' signal to the Host by
entering an "Unready" command, followed by a "Ready" command. If this problem
recurs, contact EMC Support for assistance.
DLm332E
Device <devicename> [pathNumber] Error sending Async Ready Status, err=nnn
Description: An error has occurred while attempting to send an unsolicited status
('Ready' signal) to the Host.
System Action: The virtual tape application will attempt to present the status several
more times. If the Host never takes the status, the virtual tape volume will remain
mounted on the drive, but the Host will most likely report that the drive is still not
ready.
User Action: You can cause the virtual tape application to present another 'Ready'
signal to the Host by entering an "Unready" command, followed by a "Ready"
command. If this problem recurs, contact EMC Support for assistance.
DLm333E
Device <devicename> failed to send Ready interrupt to Host
Description: After several retries, the virtual tape application was unable to present
the asynchronous status ('Ready' signal) to the Host.
System Action: The application continues without the status having been presented
to the Host. The virtual tape volume will remain mounted on the drive, but the Host
will most likely report that the drive is still not ready.
User Action: You can cause the virtual tape application to present another 'Ready'
signal to the Host by entering an "Unready" command, followed by a "Ready"
command. If this problem recurs, contact EMC Support for assistance.
DLm335I
Device <devicename> unassigned while volume <volser> mounted
Description: The host has sent an Unassign command to this device while a tape was
mounted on the device.
System Action: The Unassign command is processed normally. The tape remains
ready and at its current position.
User Action: This is a valid but unusual condition. Check that the Host is not having
some kind of problem with this virtual device. Contact EMC Support if you need
additional assistance.
DLm338I
New path established: board=n, path=n, link=xx, lpar=xx, cu=xx
Description: The Host has established a new channel path to the virtual tape
application.
System Action: This path is available now for channel I/O.
User Action: None.
DLm339I
Path removed: board=n, path=n, link=xx, lpar=xx, cu=xx
Description: The Host has removed the specified channel path to the virtual tape
application.
System Action: This path is no longer available for channel I/O.
User Action: None.
DLm340E
Device <devicename> path <pathname> Incorrect CRC in data received from channel,
failed/retrying...
Description: The virtual tape application has detected a corruption of data written by
the Host.
System Action: The virtual tape application will instruct the Host to retransmit the data
up to ten times (displaying "retrying..." each of these times). If the error occurs on
eleven consecutive writes, the virtual tape application will return a unit check to the
Host, with sense of Bus Out Error (displaying "failed" this time).
User Action: A data CRC error may indicate failing hardware, cabling, or a weak data
link between the Host and the virtual tape application. Contact your hardware support
personnel for assistance.
DLm341E
Device <devicename> CRC mismatch in data block...
Description: The virtual tape application has detected a corruption of data when
comparing the CRC value stored in the awsheader from a file with a newly calculated
CRC value after reading the data.
System Action: The virtual tape application will return a unit check to the Host, with
sense of Bus Out Error.
User Action: A data CRC error may indicate failing hardware. Contact EMC Support for
assistance.
DLm342E
Device <devicename> volser <volser> block nnnnn disk read CRC error
Description: After reading data from the tape library storage, the virtual tape
application detected that the CRC stored with the data does not match the data just
read.
System Action: The virtual tape application will return a unit check to the Host, with
sense of Equipment Check.
User Action: A CRC error indicates that corruption of the stored data has occurred.
Contact EMC Support for assistance.
DLm350E
Unable to get trace flags for interface #n
Description: The virtual tape application is attempting to obtain the current trace
options from channel interface number #n, but has failed to do so.
System Action: The current trace settings will not be available to the virtual tape
application. As a result, some subsequent function may not complete.
User Action: Contact EMC Support for assistance.
DLm351E
Unable to set trace flags for interface #n
Description: The virtual tape application is attempting to set the trace options in
channel interface number 'n', but has failed to do so.
System Action: The current trace settings are not changed.
User Action: Contact EMC Support for assistance.
DLm352I
Firmware tracing stopped on interface #n
Description: The virtual tape application has turned tracing off for channel interface
#n.
System Action: Firmware tracing in channel interface #n remains off until turned back
on.
User Action: None.
DLm353I
Firmware tracing restored on interface #n
Description: The virtual tape application has restored the trace options for channel
interface #n.
System Action: Firmware tracing resumes in channel interface #n.
User Action: None.
DLm354E
Error saving firmware trace
Description: An error has occurred while attempting to save the firmware trace from
channel interface #n.
System Action: The trace was not saved.
User Action: Contact EMC Support for assistance.
DLm355W
Device <devicename> Attempting to save firmware trace on interface #n
Description: An error or other unusual event has occurred on channel interface #n,
and the virtual tape application will attempt to save a firmware trace from that
interface.
System Action: The virtual tape application will attempt to stop the firmware trace and
save it to disk. After the trace is saved, firmware tracing will resume.
User Action: Contact EMC Support for assistance.
DLm356E
Interface #n exceeded automatic save trace limit of nn, NOT saving trace
Description: An error or other unusual event has occurred on channel interface #n. The
virtual tape application will automatically save a firmware trace 'nn' number of times,
but this count has been exceeded for this interface.
System Action: The virtual tape application continues running without automatically
saving the firmware trace.
User Action: Contact EMC Support for assistance.
DLm357E
Interface #n NOT saving trace for unexpected packet
Description: An error or other unusual event has occurred on channel interface #n.
Normally, saving of a firmware trace would be triggered by this event, but the virtual
tape application has been configured to not save a trace for this kind of event.
System Action: The virtual tape application continues running without automatically
saving the firmware trace.
User Action: Contact EMC Support for assistance.
DLm358I
Tracing of unexpected packets set ON/OFF
Description: The automatic saving of a firmware trace when an unexpected packet is
received on a channel interface has been turned ON or OFF.
System Action: If ON (the default) a firmware trace is saved when this type of
unexpected event occurs. If set OFF, no firmware trace will be automatically saved.
User Action: Contact EMC Support for assistance with this option.
DLm366E
Device <devicename> <function> error, Interface #n, error=0xXX (nnn)
Description: An error involving channel interface adapter #n has occurred.
System Action: This channel interface may not be available to this device until the
adapter is reset.
User Action: Contact EMC Support for assistance.
DLm370E
Unable to open connection to eslot 0xXXXXXX: err=nn (0xXX)
Description: An error has occurred while opening a channel driver during the virtual
tape application startup.
System Action: Startup terminates.
User Action: Contact EMC Support for assistance.
DLm379E
<function>: <error message>
Description: An internal error has occurred in the virtual tape application during
shutdown.
System Action: Shutdown continues.
User Action: If this problem recurs, contact EMC Support for assistance.
DLm380E
Severity n Alert Interface #n (XXX:YYY) <type:subtype (additional parms)>
Description: The virtual tape application has received an alert message from the
channel adapter driver, for channel adapter 'n'. XXX:YYY are the alert type and
subtype, which are also translated in <type:subtype>.
System Action: Depending on the alert severity and type, the virtual tape application
may continue to function normally, or it may require service or other attention.
User Action: Contact EMC Support for assistance.
DLm381I
Channel Interface #n <message>
Description: The virtual tape application has received an informational message from
channel adapter 'n'.
System Action: None.
DLm390E
Invalid encryption key file (rc=n)
Description: The encryption key file has been corrupted.
System Action: Encryption or decryption will not be available on this controller until
the encryption key file is restored or reconfigured.
User Action: Restore the encryption key file from a backup copy, or reconfigure the
key(s) via the encryption key configuration program. Contact EMC Support for more
assistance.
DLm391I
ENCRYPTKEY set to [KEYn|NONE] for device <devicename>
Description: Key #n will be used for encryption on device <devicename>, or if 'NONE' is
specified, no encryption will be performed on device <devicename>
System Action: The specified encryption key (or none, for 'NONE') will be used for any
blocks written to the specified device.
User Action: None.
DLm392E
Encryption is not available
Description: Encryption is not set up, or the encryption initialization failed.
System Action: Encryption and decryption will not be available for any devices for
which encryption was requested.
User Action: Verify that the encryption key file is installed, or reconfigure the key(s) via
the encryption key configuration program.
DLm393E
No encryption key available for reading encrypted block on <devicename>
Description: Encryption was not set up at all, or the encryption initialization failed,
and then an encrypted block was requested to be read.
System Action: The requested block will not be read. A unit check is returned to the
host.
DLm395E
Device <devicename>, no matching decryption key, block <block#>
Description: No key currently installed on this system was able to decrypt this
encrypted block.
System Action: If this error occurs during an I/O initiated by the host, an I/O error
(equipment check) is returned to the host. During an Import or Export operation, this
is a warning rather than an error; the data will be copied in its original encrypted
format to the new location.
User Action: Check that the virtual tape application is configured with the proper
encryption key(s).
DLm397E
Device <devicename> is not a supported tape type for encryption
Description: Encryption is not supported on this device type.
System Action: The encryption option is not changed for this device.
User Action: The user should choose another device, or reconfigure the given device.
DLm398E
Device <devicename> must be unloaded before changing encryption
Description: Encryption cannot be changed when a device has a tape volume
mounted.
System Action: The encryption option is not changed for this device.
User Action: Wait until the tape is unloaded before setting the encryption key for a
device.
DLm399E
Syntax error. Format is 'DRIVE-', not 'DRIVE='.
Description: The correct format for specifying this device is 'DRIVE-'.
System Action: The command was invalid and not performed.
User Action: Specify the command again with valid syntax.
DLm400E
Device <devicename> Data path <pathname> is not accessible
Description: The specified virtual tape library directory cannot be accessed at the time
of a tape mount.
System Action: The mount is ignored and the drive remains Not Ready without
mounting the virtual tape volume. Virtual tape volumes cannot be mounted on this
device until the specified directory is made accessible to the application.
User Action: If the configured directory name is correct, make sure that it is mounted
and accessible. If the directory name was misconfigured, correct the virtual tape
configuration file PATH= parameter and restart the virtual tape application. (The path
can be temporarily corrected with the SET PATH= command.)
DLm401E
Device <devicename> error opening <filename>, error=nnn; <error message>
Description: The virtual tape file could not be opened.
System Action: The mount is ignored and the drive remains not ready without
mounting the virtual tape volume.
User Action: Examine any preceding related messages and the 'error message' portion
of this message for a description of the problem and correct the problem. If the
problem recurs, contact EMC Support for assistance.
DLm402E
Device <devicename> cannot LOAD PROTECTED, volume <volser> does not exist
Description: The specified virtual tape volume specified in the operator command
'LOAD ... PROTECTED' does not currently exist. Only existing volumes can be mounted
as protected (read-only) volumes.
System Action: The mount is ignored and the drive remains not ready without
mounting the virtual tape volume.
User Action: Specify an existing volume in the 'LOAD ... PROTECTED' command.
DLm403E
Device <devicename> Volume <volser> (filename) invalid AWS block header at nnnnn
(n)
Description: An invalid AWS block header was encountered at offset 'nnnnn' in the
specified volume. (n) is one of the following error codes:
(1) error reading block header;
(2) prvblkl not zero in first block header;
(3) unknown bit in flags1;
(4) unknown bit in flags2;
(5) tapemark record with data length;
(6) non-tapemark record with zero data length;
(7) prvblkl contains zero past first block header;
(8) curblkl or prvblkl contains an invalid length value;
(10-12) unsupported segmented aws block
System Action: The operation reading the volume will fail.
User Action: Delete and re-create the volume that has the invalid format. If this
problem recurs, contact EMC Support for assistance.
DLm404E
Device <devicename> Error deleting unused scratch volume <volser>: error message
Description: The specified volume was created in response to a scratch tape mount
request, it was unloaded without ever having been written to, so the virtual tape
application tried to delete it. An I/O error occurred during the attempt to delete.
System Action: The volume may or may not have been deleted from the tape library.
User Action: The 'error message' portion of this message describes the error that
occurred. Correct the error.
DLm405I
Device <devicename> Display: 'message1' 'message2' [(blink)]
Description: The Host has sent these message(s) to be displayed on the virtual tape
drive's operator display unit.
System Action: If the message is a Mount message, and the virtual tape drive is
currently unloaded, and the volume serial number falls within the range managed by
the virtual tape application, then the specified volume will be mounted.
DLm406I
Device <devicename> CCW:XX @block id nnnnn; rejected due to supervisor inhibit
Description: The Host sent a CCW that can only be executed while in supervisor state
but a prior Mode Set CCW had disabled this state.
System Action: The CCW is not executed, and a unit check status with command reject
sense is sent to the Host.
User Action: Investigate why the Host application is attempting to illegally execute a
supervisor state CCW.
DLm407E
Device <devicename> Rejecting ACLON request - invalid ACLVolser (value)
Description: The mainframe request for ACLON is rejected because the ACLVolser that
was passed is not in the scratch synonyms list.
System Action: The command is rejected. The current ACL state is not changed.
User Action: None.
DLm408I
Device <devicename> ACL turned <ON/OFF> [ACLVolser = 'volser'] [reason]
Description: The ACL (autofill) feature has been turned on or off.
System Action: The ACLON or ACLOFF request was granted. If the request was to turn
ACL on, the new ACLVolser is also displayed. If ACL was turned off by the virtual tape
application rather than by the host the reason will be displayed.
User Action: None.
DLm409I
Command received: 'command'
Description: The specified operator command was received.
System Action: The specified command is processed.
User Action: None.
DLm410E
Device <devicename> error initializing Volume <volser>
Description: An error occurred while creating the specified virtual tape volume.
System Action: The volume is not mounted.
User Action: Examine any preceding related messages for a description of the
problem and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm411E
Device <devicename> AWS block #nnn too large (xxxxxx) to handle (max=yyyyyy)
Description: The virtual tape application has encountered a tape block in the virtual
tape volume that is larger than the maximum tape blocksize ('yyyyyy') it is capable of
presenting to the Host. This block in the virtual tape file is 'xxxxxx' bytes and is not
compressed in the file.
System Action: An I/O error is returned to the Host.
User Action: Contact EMC Support for assistance.
DLm412E
Device <devicename> AWS block #nnn too large to handle (max=yyyyyy)
Description: The virtual tape application has encountered a tape block in the virtual
tape volume that is larger than the maximum tape blocksize ('yyyyyy') it is capable of
presenting to the Host. This block in the virtual tape file is compressed and the exact
un-compressed block length, while larger than 'yyyyyy', is unknown.
System Action: An I/O error is returned to the Host.
User Action: Contact EMC Support for assistance.
DLm413E
Device <devicename> Unexpected EOF in block header at nnnnn, file <filename>
Description: An error occurred while accessing the specified virtual tape volume.
'nnnnn' is the file offset where the error occurred.
System Action: The virtual tape application returns an error status to the current Host
IO request.
User Action: Examine any preceding related messages, if any, for additional error
information, and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm414W
Device <devicename> tape full writing <data/TM> at PEOT, file <filename>
Description: While writing to a physical tape drive, the virtual tape application
received a response that the physical tape cartridge is full.
System Action: The write operation fails with a unit check.
User Action: Investigate why the host application wrote past logical end of tape
(LEOT).
DLm415E
Device <devicename> Unexpected EOF in data block at nnnnn, file <filename>
Description: An error occurred while accessing the specified virtual tape volume.
'nnnnn' is the file offset where the error occurred.
System Action: The virtual tape application returns an error status to the current Host
I/O request.
User Action: Examine any preceding related messages, if any, for additional error
information, and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm416E
Device <devicename> not responding.
Description: The physical tape device is no longer responding to the virtual tape
application.
System Action: The virtual tape application will set the tape device to NA (Not
Accessible).
User Action: The virtual tape application must be restarted after repairing the problem
with the specified tape drive.
DLm417E
Device <devicename> I/O error: <function description>; error=nnn; <error message>
Description: An error occurred while reading or writing a virtual tape file.
System Action: The virtual tape application returns an error status to the current Host
I/O request.
User Action: Examine any preceding related messages, if any, for additional error
information, and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm418W
Device <devicename> Hardware decompression not available, using software only
Description: A hardware-compressed block has been read from the virtual tape
volume, but a hardware compression card is not available on this system to
decompress the data.
System Action: The data is decompressed with software. This message will display
only once per volume as a reminder.
User Action: For best performance, data compressed with a hardware compression
adapter should be decompressed with a compression adapter as well.
DLm419E
Device <devicename> data read [backwards] returned error
Description: An error occurred while reading a virtual tape file.
System Action: The read command is unsuccessful and an error indication (unit
check) is returned to the Host. This message is preceded by one or more messages
that explain the I/O error.
User Action: Examine any preceding related messages, if any, for additional error
information, and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm420W
Device <devicename> write attempt to protected volume
Description: The volume on the specified device is mounted in read-only mode, but
the Host has attempted to perform a write operation to the volume.
System Action: The Host's write command is rejected (with unit check status,
command reject sense).
User Action: Correct the condition that caused the Host to attempt to write to a
read-only volume.
DLm421I
Device <devicename> signaled end of volume to Host on <command>
Description: While writing to a virtual tape volume, logical end of volume (CSW status
Control Unit End plus Unit Exception) was signaled to the Host because the capacity of
the virtual volume is being approached. 'command' could be Write, Write Tapemark,
or Erase Gap.
System Action: The write command was successful. The logical end of volume
condition remains true and will be signaled for all subsequent writes as long as the
virtual tape volume remains positioned past the logical end of volume point.
User Action: The Host is expected to close the virtual tape volume and open a new
volume.
DLm422W
Device <devicename> <command> at loadpoint
Description: The Host has read or spaced backwards from the virtual tape volume's
loadpoint.
System Action: The virtual tape application returns an error status (Read Backwards at
Loadpoint) to the Host I/O request.
User Action: This is most likely a Host application error. Correct the application
causing the error.
DLm423W
Device <devicename> <command> past <place>
Description: The Host read or positioned past the end of data on a virtual tape volume
or a physical tape volume.This message will also be displayed at the end of an Import
or Export command, because these commands will read and copy all data until they
reach the end of the input tape volume. This is normal operation of the Import and
Export commands and does not signify an error.
System Action: If this occurs as a result of a Host I/O request, an error status (Data
Check, Tape Void) is returned to the Host I/O request. For an Import or Export
operation, this message is normal and does not signify an error.
User Action: If caused by a Host operation, correct the application causing the error.
For an Import or Export operation, this message is normal and does not signify an
error.
DLm424I
Device <devicename> Volume <volser> rewound
Description: The operator REWIND command completed successfully.
System Action: The virtual tape volume is now at loadpoint.
User Action: None.
DLm425E
Device <devicename> Data block exceeds maximum of yyyyyy bytes
Description: The Host wrote a block larger than the maximum blocksize supported by
the virtual tape application.
System Action: The block is not written to the virtual tape file, and an I/O error is
returned to the Host's write command.
User Action: Change the Host application and/or JCL to write data blocks within the
virtual tape application capability ('yyyyyy' bytes or less).
DLm426E
Device <devicename> write attempt required expanded headers
Description: The host attempted to write data with options set (such as the 'store CRC'
option) which requires expanded headers, but the tape consists of blocks with regular
headers. Tape header types cannot be intermixed on the same tape.
System Action: An error status (Equipment Check) is returned to the host I/O request.
User Action: Clear the option(s) that require expanded headers, and retry the host job.
Contact EMC Support for assistance.
DLm427W
Device <devicename> write [TM] attempt past end of tape
Description: The Host attempted to write data or a tapemark past the absolute end of
tape capacity.
System Action: The virtual tape application returns an error status (Equipment Check,
Physical End of Tape) to the Host I/O request.
User Action: This is most likely a Host application error, since logical end of tape
signal would have been returned for many writes preceding the failing one. Correct the
application causing the error.
DLm428I
Device <devicename> possibly lengthy operation (<command> from <blockid>) begun
Description: The virtual tape application is executing the specified Host I/O
command, and it has determined that this command might take a considerable period
of time to complete (more than a few seconds) because there is no index to the
desired location in the virtual tape file to perform the operation quickly, so it issues
this message for informational purposes.
System Action: The command continues normally. If, during the possibly lengthy
operation, a suitable index entry to complete the command quickly is encountered,
fast operation will resume (see message DLm431I). If the command takes a very long
time to complete, it is possible that the Host may cancel the operation because it
thinks a "missing interrupt" situation has occurred.
User Action: If the Host cancels a job because it thinks a "missing interrupt" has
occurred while a long positioning command is taking place, consider increasing the
Host's "missing interrupt timer" for the virtual tape application's devices.
DLm429W
Device <devicename> <function description> while device not ready
Description: The requested operation requires a tape to be loaded in the physical
tape drive.
System Action: The virtual tape application returns an error status to the current Host
I/O request.
User Action: Load the tape drive.
DLm430I
Device <devicename> Volume <volser> accommodated old-style AWS header at offset
nnnnnn
Description: Earlier virtual tape application releases could write incorrect metadata in
a virtual tape block under certain specific rare conditions. Subsequent backwards
traversal over such a block would result in an I/O error ("Invalid AWS block header").
Later releases, including this one, automatically recover from this metadata error
without returning an I/O error to the host. This message is displayed strictly for
informational purposes.
System Action: The virtual tape operation completes successfully. There is no data
loss or error indication returned to the host. The invalid metadata in this virtual tape
volume is NOT corrected by this action, so this message may be seen in the future as
long as this data exists on this volume.
User Action: None.
DLm431I
Device <devicename> fast operation <command> resumed
Description: The virtual tape application is executing a Host I/O command that it had
previously determined might take a considerable period of time(more than a few
seconds) to complete (see message DLm428I). During the possibly lengthy operation,
a suitable index entry has been encountered to complete the operation quickly.
System Action: The command continues normally.
User Action: None.
DLm432I
Device <devicename> possibly lengthy operation (<command> from <blockid>) complete
(at <blockid>)
Description: The virtual tape application has completed executing a Host I/O
command that it had previously determined might take a considerable period of time.
System Action: The command completed normally, although possibly slowly.
User Action: None.
DLm433I
Device <devicename> is not writing expanded headers.
Description: The device is set to write expanded headers, but is currently not honoring
the value.
System Action: None.
User Action: None.
DLm434W
WARNING: Path <pathname> disk usage at nn%
Description: The disk usage for the specified tape library has exceeded the current
WARNING value.
System Action: The virtual tape application will continue to warn at every percentage
change as long as the usage exceeds the WARNING value.
User Action: Consider scratching and erasing unneeded virtual tape volumes to free
some disk space.
DLm435I
<this is an informational message>
Description: This message is an informational message
System Action: none
User Action: none
DLm436I
Attempting to recover space from scratch volumes in <pathname>
Description: The disk usage for the specified tape library directory has exceeded the
current RECOVER value.
System Action: The virtual tape application will erase the data from previously
scratched virtual tape volumes until the disk usage is reduced by the RECOVERAMT
percent of space.
User Action: Consider scratching and erasing unneeded virtual tape volumes to free
some disk space.
DLm437I
Finished space recovery, nn bytes recovered from scratch volumes in <pathname>
Description: The virtual tape application has finished attempting to recover space for
the specified tape library directory, because either (1) the disk usage has been
reduced by the RECOVERAMT percent of space, or (2) it has found no more scratched
volumes to erase. 'nn' bytes is the number of bytes erased from scratch volumes and
made available for reuse.
System Action: None.
User Action: None.
DLm438I
Finished space recovery, nn bytes recovered from nn scratch volumes in <pathname>
Description: The virtual tape application has recovered the specified amount of space
from scratch tapes that have exceeded their Erase Policy retention time.
System Action: None.
User Action: None.
DLm439I
Device <devicename> Volume <volser> unloaded without I/O
Description: The specified virtual tape volume was unloaded. During the time that the
volume was mounted, the Host did not perform any reads from or writes to this
volume.
System Action: The specified drive enters the Not Ready state and is available for
another job. If the tape was a scratch tape when it was mounted, it will be returned to
the scratch state.
User Action: None.
DLm440I
Device <devicename> Volume <volser> mounted (filename)
Description: The specified virtual tape volume has been mounted; the device will now
present a "ready" interrupt to the Host.
System Action: None.
User Action: None.
DLm441I
Device <devicename> initializing new [flat] volume <volser> [(labeled)|(unlabeled)]
Description: A mount of a non-existent volume has been requested.
System Action: The new virtual tape volume is created and initialized.
User Action: None.
DLm442E
Device <devicename> unable to allocate an SL/AL/NL scratch volume: <error message>
Description: Loading of a scratch volume was requested, but a scratch volume with
the requested label type could not be found. The 'error message' portion of this
message explains the reason.
System Action: The requested volume is not loaded and the drive remains Not Ready.
User Action: Correct the problem preventing the scratch volume allocation and try to
re-load a scratch tape. If no scratch volumes are available, consider scratching some
old, unneeded volumes or INITIALIZE some more scratch volumes.
DLm443E
Device <devicename> unable to create new scratch volume <volser>
Description: Loading of a new scratch volume was requested, but the new virtual tape
volume could not be created.
System Action: The requested volume is not loaded and the drive remains Not Ready.
User Action: One or more previous message(s) should explain the reason for the
problem. Correct the problem preventing the scratch volume allocation, and try to
re-load a scratch tape. For instance, enter the 'Query Space' command to determine
if any free space exists on the tape library disk; if no space is available, delete some
unneeded volumes to free some disk space. Make sure that a valid, writable directory
is specified in the configuration file for this device, and that the directory is currently
mounted and accessible. If all possible scratch tapes are already in use, scratch some
existing volumes for re-use.
DLm444I
Device <devicename> new scratch volume <volser> created
Description: Loading of a scratch volume was requested, and a new virtual tape
volume was created to accommodate the request.
System Action: The specified volume was created, initialized, and loaded on the
specified drive.
User Action: None.
DLm445I
Device <devicename> cannot initialize protected new volume <volser>
Description: The virtual tape application has created the new volume 'volser', but is
not able to initialize it because it is read-only. This is only possible when a manual
LOAD command with the PROTECTED option is entered for a new (non-existing)
volume.
System Action: The volume is created and mounted, but it will appear to the Host as
an empty, un-initialized (and read-only) tape.
User Action: Don't do this.
DLm446E
Device <devicename> cannot create volume <volser>, path <pathname> is read-only
Description: The specified volume does not exist and cannot be opened for writing
because the virtual tape library directory 'pathname' is write protected.
System Action: The volume is not created, the mount request is ignored, and the
device remains not ready.
User Action: In order to write new volumes, make sure that the virtual tape library is
correctly mounted and is write-enabled for user 'vtape'.
DLm447W
Device <devicename> invalid volid 'volser', mount request ignored
Description: The Host requested the mounting of a volume serial number that is not a
valid IBM volume serial number.
System Action: The mount request is ignored and the device remains not ready.
User Action: Correct the Host JCL to request a valid IBM volume serial number. An IBM
standard volume serial number consists of the upper-case letters A-Z, numbers 0-9,
and the hyphen.
DLm448W
Device <devicename> Volume <volser> already mounted, new mount request ignored
Description: The Host requested the mounting of a volume, but the specified drive
already has a virtual tape volume mounted. The currently mounted tape is NOT at
loadpoint.
System Action: The mount request is ignored. The volume already mounted on the
drive remains mounted.
User Action: Correct the Host JCL that caused a mount request to be sent to a drive
that already has a volume mounted. If the Host is finished with the volume that is
current mounted on the drive, you can manually unload that volume and then
manually mount the new volume.
DLm449I
Device <devicename> Label request changed from ' ' to default 'X'
Description: The current mount request did not specify a desired label type, so it was
set to the default type (which may have been configured in the virtual tape
application) for this virtual tape device. The only value which you'll see for 'X' is 'A' for
ANSI labels, because this message does not display if the default label type is 'S' for
IBM standard labels.
System Action: The mount process continues, using the default label type configured
for this device.
User Action: None, unless the default label type is incorrect, in which case the
configured default should be changed or an explicit label type should be requested in
the JCL.
DLm450W
Volume <volser> file is busy on device devicename1, mount on devicename2 is
ignored
Description: The mounting of a virtual tape volume has been requested, but that
volume is currently mounted on another virtual tape drive. A volume can be mounted
on only one drive at a time.
System Action: The mount request is ignored.
User Action: Correct the Host operational issue that resulted in the duplicate request
for the same volume. Restart the second job when the virtual tape volume becomes
available.
DLm451E
Volume <volser> file is open elsewhere, mount on <devicename> ignored
Description: Mounting of the specified virtual tape volume has been requested, but
the volume is currently open by another program or system.
System Action: The mount will be retried several times over several seconds. If the
volume does not become free during this time, the mount request is ignored.
User Action: Correct the Host operational issue that resulted in the duplicate request
for the same volume by two programs at the same time. Restart the second job when
the virtual tape volume becomes available.
DLm452W
Device <devicename> is quiesced, mount ignored
Description: Mounting of the specified virtual tape volume has been requested, but
the specified drive is in the 'quiesced' state,meaning it will not accept any tape
mounts until it is 'unquiesced' (or until the virtual tape application is restarted).
System Action: The mount request remains pending until the drive is unquiesced or is
cancelled by the host.
User Action: UNQUIESCE the drive, or use a different drive.
DLm453W
Device <devicename> Volume <volser> already mounted, new mount request honored
Description: The Host requested the mounting of a volume, and the specified drive
already has a virtual tape volume mounted, and the currently mounted tape is at
loadpoint.
System Action: The mount request is honored. The volume already mounted on the
drive is unloaded and the new mount request is processed.
User Action: Correct the Host JCL that caused a mount request to be sent to a drive
that already has a volume mounted.
DLm454E
Device <devicename> Volume <volser> not found
Description: The virtual tape application was requested to load a virtual tape volume
that does not exist in the virtual tape library.
System Action: The drive remains unloaded and Not Ready.
User Action: Verify that the correct volume is being requested. Also check that the
tape library directory(s) are properly mounted and are accessible to the virtual tape
application. If the requested volser is for a scratch tape, make sure that there are
scratch volumes, initialized with the correct label type, available.
DLm455E
Error locking volume <volser> (filename): <error message>
Description: An error occurred while trying to mount the specified virtual tape volume.
System Action: The mount request is ignored.
User Action: Consult any preceding related messages and the 'error message' portion
of this message for a description of the problem and correct the problem. If the
problem recurs, contact EMC Support for assistance.
DLm456W
Device <devicename> Volume <volser> already mounted, new mount request honored
Description: The Host requested the mounting of a volume, and the specified drive
already has a virtual tape volume mounted. The currently mounted tape is not at
loadpoint, but the drive had received an Unassign command from the Host while the
currently mounted tape was mounted.
System Action: The mount request is honored. The volume already mounted on the
drive is unloaded and the new mount request is processed.
User Action: Consider correcting the Host JCL or Host operating system that allowed a
mount request to be sent to a drive that already had a volume mounted. Contact EMC
Support for additional assistance.
DLm457E
Device <devicename> Volume <volser> already mounted, new mount request ignored
Description: The Host requested the mounting of a volume, but the specified drive
already has a virtual tape volume mounted, and the currently mounted tape is NOT at
loadpoint, and the drive had not received an Unassign command from the Host while
the currently mounted tape was mounted.
System Action: The mount request is ignored. The volume already mounted on the
drive remains mounted.
User Action: Consider correcting the Host JCL or Host operating system that allowed a
mount request to be sent to a drive that already had a volume mounted. Contact EMC
Support for additional assistance.
DLm458W
Device <devicename> Volume <volser> already mounted, new mount request deferred
Description: The Fujitsu Host requested the mounting of a volume, and the specified
drive already has a virtual tape volume mounted.
System Action: The mount request will be honored after the Host unloads the volume
currently mounted on the drive.
User Action: If possible, correct the Host JCL that caused a mount request to be sent to
a drive that already has a volume mounted.
DLm459W
Device <devicename> Volume <volser> has a corrupted IBM/ANSI label set
Description: During opening of an existing virtual tape volume, the virtual tape
application has determined that the volume contains a valid VOL1 label but the rest of
the header label set is missing, incomplete, invalid, or corrupted in some way.
System Action: This is a warning message only. The mount completes successfully
and is available for normal use by the Host.
User Action: The Host will most likely complain about the invalid labels; take the
appropriate action required by the Host. If the Host refuses to use the corrupted
volume as is, perform a re-initialization of the virtual tape volume using the standard
Host initialization procedures. Try to determine the reason the Host previously wrote
invalid labels to this tape volume. This condition is most often caused by an error on
the Host during volume initialization or at some other time when the Host is writing
the volume labels. In particular, this problem has been seen when a Host job is
cancelled while it is opening an output tape.
DLm460I
Device <devicename> Volume <volser> file renamed to <filename>
Description: The Host has written a HDR1 label in a flat file.
System Action: The virtual volume's disk file was successfully renamed to the new
filename as shown.
User Action: None.
DLm461I
Device <devicename> performing deferred mount request
Description: The Fujitsu Host requested the mounting of a volume while the specified
drive already had a virtual tape volume mounted. The drive is now unloaded and the
mount request will be re-evaluated.
System Action: The mount request will be attempted at this time.
User Action: If possible, correct the Host JCL that caused a mount request to be sent to
a drive that already had a volume mounted.
DLm462W
Mount error renaming volume <volser> (filename to filename): <error message>;
retrying...
Description: The Host has asked for a previously scratched volume by specific volser.
The virtual tape application was unable to rename the scratch volume (~VOLSER) to
an active volume (VOLSER).
System Action: The rename will be retried several times over several seconds. If the
rename does not succeed during this time, the mount request will be ignored.
User Action: Refer to any earlier messages and the 'error message'portion of this
message to determine the cause of the failure.
DLm463W
Volume <volser> file is open elsewhere, retrying...
Description: Mounting of the specified virtual tape volume has been requested, but
the volume is currently open by another program or system.
System Action: The mount will be retried several times over several seconds. If the
volume does not become free during this time, the mount request will be ignored.
User Action: Correct the Host operational issue that resulted in the duplicate request
for the same volume by two programs at the same time.Restart the second job when
the virtual tape volume becomes available.
DLm464E
Device <devicename> volser "volser" prefix differs from existing volser "volser"
Description: The Host is attempting to write a VOL1 label with a different volume serial
number onto the virtual tape volume, but the new VOLSER does not start with the
same 2-character VOLSER prefix as the existing volume serial number.
System Action: The virtual tape application rejects the Host's write, returning a Unit
Check status and Command Reject sense.
User Action: You can only write over an existing VOLSER with a new volume serial
number of the same 2-character prefix. Correct the JCL or operator procedure that
attempted to rename the volume.
DLm465E
Device <devicename> invalid volser 'volser' in VOL1 label
Description: The Host is attempting to write a new VOL1 label to the virtual tape
volume, but the volume serial number in the VOL1 label is invalid.
System Action: The virtual tape application rejects the Host's write, returning a Unit
Check status and Command Reject sense.
User Action: Correct the Host job that is attempting to write the invalid volume serial
number to the virtual tape.
DLm466E
Device <devicename> volser 'volser' from VOL1 already exists [as scratch]
Description: The Host is attempting to write a VOL1 label with a different volume serial
number onto the virtual tape volume, but the new VOLSER is the same as a volume
that already exists in the virtual tape library.
System Action: The virtual tape application rejects the Host's write, returning a Unit
Check status and Command Reject sense.
User Action: Correct the Host job that is attempting to write the duplicate volume
serial number to the virtual tape, or delete the existing volume from the virtual tape
library before rerunning the job.
DLm467E
Device <devicename> error renaming volume <volser1> (filename) to <volser2>
(filename); <error message>
Description: The Host is attempting to write a VOL1 label with a different volume serial
number onto the virtual tape volume, but the virtual tape application is failing in its
attempt to rename the mounted volume to the new volume name.
System Action: The virtual tape application rejects the Host's write, returning a Unit
Check status and Command Reject sense.
User Action: Refer to any earlier messages and the 'error message' portion of this
message to determine the cause of the failure. If the problem cannot be corrected,
contact EMC Support for assistance.
DLm468I
Device <devicename> overwrote VOL1 with [data|tapemark] on volume <volser>
Description: The volume mounted on this device was previously a labeled volume, but
the Host has written either data or a tapemark at loadpoint, erasing the VOL1 label.
The virtual tape is now an unlabeled volume.
System Action: None.
User Action: None.
DLm469I
Device <devicename> Volume <volser1> renamed to <volser2> (filename)
Description: The Host has written a VOL1 label with a different volume serial number
onto the virtual tape volume.
System Action: The virtual volume file was successfully renamed to the new volume
serial number.
User Action: None.
DLm470E
MOUNT volume 'volser' failed
Description: Mounting of the specified virtual tape volume was unsuccessful.
System Action: The mount request is ignored and the drive remains Not Ready.
User Action: This message will be preceded by one or more messages that explain the
reason for the mount failure. Correct the error indicated in the preceding message(s).
DLm471E
Device address xxxx on GROUP n doesn't exist
Description: Mounting of a virtual tape volume on OSADDR 'xxxx' was requested by
the VSE mount program, but the specified device does not exist in the specified
GROUP.
System Action: The mount request is ignored and the drive remains Not Ready. A
return code of 0x82 is returned to the Host program.
User Action: Reconfigure the VSE mount program and/or virtual tape application to
use the proper device address(es).
DLm472I
Volume <volser1> is currently on <devicename>, cannot mount <volser2>
Description: Mounting of volume 'volser2' on the specified drive was requested by the
VSE mount program, but the specified device already has the virtual tape volume
'volser1' mounted.
System Action: The mount request is ignored and the drive remains Not Ready. A
return code of 0x85 is returned to the Host program.
User Action: Correct the operational issues that resulted in the attempt to mount on a
busy drive.
DLm473E
Invalid mount request x'xx' 'aaaaaaaa' 'bbbbbbbb'
Description: Mounting of a virtual tape volume was requested by the VSE mount
program, but the second word of the request ('bbbbbbbb') did not contain a proper
drive designation.
System Action: The mount request is ignored and the drive remains Not Ready. A
return code of 0x90 is returned to the Host program.
User Action: Contact EMC Support for assistance.
DLm474E
No free device in default GROUP n to mount 'volser'
Description: Mounting of a virtual tape volume on ANY available drive address was
requested by the VSE mount program, but there is no free drive in this GROUP.
System Action: The mount request is ignored and the drive remains Not Ready. A
return code of 0x80 is returned to the Host program
User Action: Retry the Host mount when a virtual drive becomes available.
DLm475E
No free device in GROUP n to mount 'volser'
Description: Mounting of a virtual tape volume on ANY available drive address was
requested by the VSE mount program, but there is no free drive on this LPAR and
GROUP.
System Action: The mount request is ignored and the drive remains Not Ready. A
return code of 0x81 is returned to the Host program.
User Action: Retry the Host mount when a virtual drive becomes available.
DLm476W
WARNING: Device <devicename> OSADDR is 000
Description: Mounting of a virtual tape volume was requested by the VSE mount
program, but the device upon which the volume is being mounted has an OSADDR of
000.
System Action: The mount proceeds, but the mount device address of 000 is reported
back to the Host program. If the mount request was for a specific device address, this
probably won't be of any consequence, but if the request was for 'Any' drive, the
Host program won't be able to determine on which drive the volume was mounted.
User Action: Reconfigure the virtual tape application and add the correct OSADDR
parameter for each device that will be attached to a VSE system.
DLm477E
Mount requested on <devicename1> by <devicename2> failed
Description: Mounting of a virtual tape volume on ANY available drive address was
requested by the VSE mount program, but the volume could not be mounted on
<devicename2>. This message will be preceded by one or more messages that explain
the reason for the mount failure.
System Action: The mount request is ignored and the drive remains Not Ready. A
return code of 0x88 is returned to the Host program.
User Action: Refer to any preceding messages for the reason for the mount failure and
correct the problem(s).
DLm478I
Device <devicename> Requesting mount 'volser' on 'device'
Description: Mounting of a virtual tape volume was requested by the VSE mount
program or a tape manager on the host.
System Action: The virtual tape application attempts to mount the requested volume
on the requested drive.
User Action: None.
DLm479W
Device <devicename> Volume <volser> is completely empty!
Description: The specified tape volume was successfully mounted, but contains no
data or tape marks.
System Action: The specified volume is mounted as requested, but any attempts to
read from the volume will result in an I/O error (Unit Check status, Tape Void sense)
being presented to the Host.
User Action: Be certain that the correct volume is being requested. If necessary, delete
and re-initialize the virtual tape volume.
DLm480E
Both active and scratch volser volumes exist in <pathname>, mount ignored
Description: While mounting a volume, the virtual tape application found both active
(VOLSER) and scratch (~VOLSER) copies of the volume in the same tape library.
System Action: The mount request is ignored, and the drive remains not ready.
User Action: Determine which, if any, of the volumes is valid and should be kept, and
delete the invalid volume.
DLm481E
Mount error renaming volume <volser> (filename to filename): <error message>
Description: The Host has asked for a previously scratched volume by specific volser.
The virtual tape application was unable to rename the scratch volume (~VOLSER) to
an active volume (VOLSER).The rename was retried several times over several
seconds, and never succeeded.
System Action: The mount request is ignored, and the drive remains Not Ready.
User Action: Refer to any earlier messages and the 'error message' portion of this
message to determine the cause of the failure. Contact EMC Support for assistance.
DLm482I
Scratch tape <volser> made active
Description: The Host has asked for a previously scratched volume by specific volser.
System Action: The virtual tape application returns the requested volume to active
status by renaming it from ~VOLSER to VOLSER, then mounts the volume.
User Action: None.
DLm483E
Error scratching/unscratching/erasing volume <volser> (filename); <error message>
Description: An error has occurred while scratching, unscratching, or erasing a scratch
tape.
System Action: The scratch, unscratch, or erase function fails.
User Action: Refer to any earlier messages and the 'error message' portion of this
message to determine the cause of the failure.
DLm484W
Mount loop on device <devicename>, volume <volser> mount ignored
Description: The Host repeatedly requested the mounting of the specified volume, but
immediately unloaded the volume each time without reading past labels or writing to
it. This usually signifies that the Host is not satisfied with the contents of the virtual
tape volume, so it unloads it and requests it again.
System Action: The last mount request is ignored, and the drive remains Not Ready.
User Action: Examine the Host console to determine the problem with the volume.
Correct the Host JCL to use the correct volume or a different volume.
DLm485W
Device <devicename> Mount of unlabeled [SCRTCH/PRIVAT] volume ignored
Description: The Host requested the mounting of an unlabeled scratch tape. The
virtual tape application does not support the mounting of unlabeled scratch tapes
because there is no way to track the volume by volser once the Host writes unlabeled
data.
System Action: The mount request is ignored and the device remains Not Ready.
User Action: Specify a specific volume serial number for unlabeled usage, or specify a
labeled tape for scratch usage.
DLm486E
Device <devicename> Unable to allocate a [SCRTCH/PRIVAT] volume
Description: The mount request for a scratch tape failed.
System Action: The mount request is ignored and the device remains Not Ready. This
message is preceded with one or more messages that explain the reason for the
mount failure.
User Action: Correct the error and rerun the job.
DLm487I
Device <devicename> Volume 'filename' mount will be retried
Description: The preceding virtual tape mount request could not be satisfied at this
time.
System Action: The specified mount request will be automatically retried until
successful or until the Host cancels the mount request with a new Load Display
command.
User Action: None.
DLm488I
Device <devicename> Unused scratch volume <volser> deleted
Description: The specified volume was created in response to a scratch tape mount
request, but it was unloaded without ever being written to.
System Action: The volume is deleted from the virtual tape library.
User Action: None.
DLm489E
Device <devicename> Error loading volume 'filename'
Description: The specified virtual tape file could not be opened.
System Action: The load request is ignored and the device remains Not Ready. This
message is preceded with one or more messages that explain the reason for the error.
User Action: Correct the error and rerun the job.
DLm490I
Device <devicename> Volume <volser> unloaded
Description: The specified virtual tape volume was unloaded.
System Action: The specified drive enters the Not Ready state and is available for
another job.
User Action: None.
DLm491I
Device <devicename> on SMB filesystem, max volume size changed to 2G
Description: The virtual tape application has detected that the tape library for the
specified virtual tape drive is on a CIFS/SMB filesystem and the current maximum
volume setting for this drive was greater than 2 GB.
System Action: The maximum volume size for this drive is adjusted to 2 GB. If the tape
library path is ever changed back to a non-SMB filesystem, the maximum volume size
will be automatically changed back to the previous value.
User Action: None.
DLm492I
Device <devicename> not on SMB filesystem, max volume size changed back to size
Description: The virtual tape application has detected that the tape library for the
specified virtual tape drive is no longer on a CIFS/SMB filesystem, and the maximum
volume setting for this drive was previously adjusted down to 2 GB.
System Action: The maximum volume size for this device is adjusted back to the
previous value.
User Action: None.
DLm493W
Device <devicename> write [TM] attempt to protected volume
Description: The Host attempted to write data or a tapemark to this read-only tape
volume.
System Action: The virtual tape application returns an error (Command Reject, File
Protected) to the Host application.
User Action: Correct the JCL, program or operational procedure that caused the Host to
try to write to a protected volume, or mount the volume in read-write mode.
DLm494W
Device <devicename> disk full writing data/TM at nnnnnnn, file <filename>
Description: The virtual tape application received a write operation from the Host, but
the tape library disk is full. 'nnnnnnn' is the number of bytes written to the tape so far.
System Action: The write operation fails (Unit Check status, Intervention Required
sense), and the virtual drive is put into the 'Not Ready' (Intervention Required) state.
The virtual tape application will leave the drive in the Not Ready state until the virtual
tape application operator changes the drive to Ready. Most Host systems will report
the 'Intervention Required' to the Host operator, pause the current job, and wait for
the drive to come ready.
User Action: When space is available on the tape library disk, issue the READY
command to this drive to resume.
DLm495E
Device <devicename> disk full writing data/TM at nnnnnnn, file <filename>
Description: The virtual tape application received a write operation from the Host, but
the tape library disk is full. The virtual tape application cannot recover and continue
because the tape library is on an NFS filesystem. 'nnnnnnn' is the number of bytes
written to the tape so far.
System Action: The write operation fails (Unit Check status, Equipment Check sense).
The contents of the volume being written are unpredictable.
User Action: Rerun the job after more space is made available on the target tape
library filesystem.
DLm496W
Device <devicename> write compression <suppressed by IDRC=NO / forced by
IDRC=FORCE>
Description: Either the Host requested compression of the output data but the virtual
tape drive is currently set to IDRC=NO, or the Host did not request compression but
the drive is currently set to IDRC=FORCE. This message will only be displayed once per
volume.
System Action: If IDRC=NO is set, the data is written uncompressed to the virtual tape
library. If IDRC=FORCE is set, the data is compressed.
User Action: None, unless you truly wanted the data to be compressed or not
compressed in a different way. In that case, reconfigure the virtual tape drive with the
correct IDRC parameter, or enter the command 'SET IDRC=ON/OFF/FORCE
[DEV=devicename]' to temporarily override the virtual tape application's
configuration.
DLm497W
Device <devicename> Hardware [de]compression configured off, using software only
Description: The controller has hardware compression/decompression capability but
is currently configured to not use the hardware facility for
compression/decompression. This message will display once per volume whenever
this condition is true.
System Action: The data is compressed or decompressed with software rather than
with the compression hardware.
User Action: None, unless you truly wanted the data to be compressed and/or
decompressed with the compression hardware (which is much faster than software
compression/decompression). In that case, enter the command 'SET
HWCOMPRESSION=ON' and/or 'SET HWDECOMPRESSION=ON to reactivate the
hardware compression/decompression feature.
DLm499W
Device <devicename> Volume <volser> error compressing data: nnn[, falling back to s/w
compression]
Description: An error occurred while writing compressed data to the virtual tape file.
System Action: The data is written uncompressed to the tape library, unless hardware
compression was in use, in which case software compression is tried.
User Action: If this problem recurs, contact EMC Support for assistance.
DLm500I
Scratching/Unscratching/Erasing of volume <volser> requested by host via device
<devicename> [dsn='datasetname']
DLm501I
Volume <volser> (filename) scratched/unscratched/erased/deleted
Description: Scratching, unscratching, erasing, or deletion of the specified virtual tape
volume was successful.
System Action: The specified virtual tape volume was scratched, unscratched, erased
(data deleted), or deleted (file deleted) from the virtual tape library as requested. If
the request came from the mainframe, a return code of 0 (success) was returned to
the Host application.
User Action: None.
DLm502W
Volume <volser> is currently on <devicename>, cannot scratch/unscratch/erase
Description: Scratching, unscratching, or erasing of the specified virtual tape volume
was requested, but the specified volume is in use.
System Action: The virtual tape volume status is not changed. If the request came
from the mainframe, a return code of 0x06 is returned to the Host application.
User Action: Change the tape status later when it is not in use.
DLm503E
Error scratching/unscratching/erasing volume <volser> (filename); <error message>
Description: An error occurred during the scratching, unscratching, or erasing of the
specified virtual tape volume.
System Action: The volume is in an undefined state. It may have been scratched or it
may still be active, depending on the error that occurred. If the request came from the
mainframe, a return code of 0x07 (volume does not exist) or 0x08 (any other error) is
returned to the Host application.
User Action: Consult any preceding related messages and the 'error message' portion
of this message for a description of the problem and correct the problem. If the
problem recurs, contact EMC Support for assistance.
DLm504E
Scratching/unscratching/erasing of invalid volume 'volser' requested by host via
device <devicename>
Description: Scratching, unscratching, or erasing of the specified virtual tape volume
was requested, but the requested volser is an invalid volume serial number.
System Action: The scratch, unscratch, or erase request is ignored. A return code of
0x05 is returned to the Host application.
User Action: Correct the volume serial number being sent by the Host program.
DLm505E
Device <devicename> received invalid scratch/unscratch/erase/execute request,
length=nnn
Description: Scratching, unscratching, or erasing of the specified virtual tape volume,
or execution of a console command, was requested by the Host, but the data sent by
the Host was of an incorrect length.
System Action: The Host initiated request is ignored. A return code of 0x01 is returned
to the Host application.
User Action: Correct the data being sent by the Host program.
DLm506E
Both active and scratch <volser> volumes exist in <pathname>!
Description: Scratching or unscratching of the specified virtual tape volume was
requested, but the virtual tape application found that the files VOLSER (not scratch)
and ~VOLSER (scratch) both exist in the same tape library.
System Action: The scratch or unscratch request is ignored. If the request came from
the mainframe, a return code of 0x03 is returned to the Host application.
User Action: Determine which of the two files is the correct volume to keep, and delete
the other copy. Contact EMC Support if you need more assistance.
DLm507E
Scratch/Unscratch Error renaming volume <volser> (filename); <error message>
Description: Scratching or unscratching of the specified virtual tape volume was
requested, but the virtual tape application encountered a problem while renaming the
volume to the specified filename.
System Action: The scratch or unscratch request is ignored. If the request came from
the mainframe, a return code of 0x08 is returned to the Host program.
User Action: Refer to the error message portion of this message to determine the
reason for the error.
DLm508I
Volume <volser> (filename) erased
Description: The specified virtual tape volume was erased because the length of time
since it was scratched has exceeded the Erase Policy retention time.
System Action: The specified virtual tape volume was erased (its data deleted) and its
storage space returned to free space for reuse.
User Action: None.
DLm510W
Device <devicename> data path <pathname> is not accessible
Description: Scratching, unscratching, or erasing of a virtual tape volume was
requested, but the specified tape library directory is not currently accessible.
System Action: The scratch, unscratch, or erase request is ignored. If the request came
from the mainframe, a return code of 0x0A is returned to the Host program.
User Action: Make sure that the device via which scratch/unscratch/erase requests
are sent by the Host application is assigned to the correct tape library directory, and
that the directory is read-write accessible by the user 'vtape'.
DLm511W
Device <devicename> data path <pathname> is not writable
DLm512E
Device <devicename> Scratching/Erasing/Unscratching/Deleting not allowed on
<drive>
Description: Scratching, unscratching, or erasing of a virtual tape volume was
requested by the Host, but the virtual device specified is currently assigned to an
active physical tape drive.
System Action: The scratch, unscratch, erase, or delete request is ignored. A return
code of 0x08 is returned to the Host program if the device is busy and 0x0A is
returned to the Host program if the function is not supported.
User Action: Make sure that the device via which scratch/unscratch/ erase/delete
requests are sent by the Host application is assigned to a virtual tape library directory,
not a physical tape drive.
DLm513E
Device <devicename> Volume <volser> error uncompressing data block #nnnnn: nn
(error message), falling back to s/w decompression
Description: An error occurred while reading compressed data from the tape file.
System Action: The virtual tape application will fall back to s/w decompression.
User Action: None.
DLm514E
Device <devicename> Volume <volser> error uncompressing data block #nnnnn: nn
(error message)
Description: An error occurred while reading compressed data from the tape file.
System Action: The virtual tape application returns an error (Data Check) to the Host
User Action: If possible, recreate the corrupted volume. If this problem recurs, contact
EMC Support for assistance.
DLm515W
Volume <volser> file is open elsewhere, cannot scratch/unscratch/erase
Description: While considering the specified virtual tape volume for scratching,
unscratching, erasing, it was found that the specified volume was currently being
accessed on another program or system.
System Action: The scratch/unscratch/erase request is ignored. If the action was
requested by the Host, a return code of 0x09 is returned to the Host application.
User Action: Scratch/unscratch/erase the volume later when it is not in use.
DLm516E
Error locking volume <volser> (filename); <error message>
Description: While considering the specified virtual tape volume for scratching,
unscratching, erasing, an I/O error occurred while trying to lock the file for exclusive
access.
System Action: The scratch/unscratch/erase request is ignored. If the action was
requested by the Host, a return code of 0x08 is returned to the Host program.
User Action: Make sure that the specified volume exists, is owned by the user 'vtape',
is writable, and is not in use by any other program. Scratch/unscratch/erase the
volume later when it is not in use. If the problem recurs, contact EMC Support for
assistance.
DLm517E
Invalid VOL1 label in volume <volser> (filename)
Description: While considering the specified virtual tape volume for scratching,
unscratching, erasing, it was found that the specified volume does not contain a valid
VOL1 label.
System Action: The scratch/unscratch/erase request is ignored. If the action was
requested by the Host, a return code of 0x0C is returned to the Host program.
User Action: Specify a valid standard labeled tape in the request. If the volume has
somehow been overwritten with incorrect contents, delete and reinitialize the volume.
DLm518E
Mismatched volser <volser1> found in <volser2> (<filename>)
Description: While considering the specified virtual tape volume for scratching,
unscratching, erasing, it was found that the volume serial number (volser1) found in
the VOL1 label on the volume does not match the one expected (volser2).
System Action: The scratch/unscratch/erase request is ignored. If the action was
requested by the Host, a return code of 0x0D is returned to the Host program.
User Action: If the volume has somehow been overwritten with incorrect contents,
delete the volume manually and reinitialize the volume.
DLm520E
Invalid HDR1 label in volume <volser> (<filename>)
Description: While considering the specified virtual tape volume for scratching,
unscratching, erasing, it was found that the volume does not contain a valid HDR1
label.
System Action: The scratch/unscratch/erase request is ignored. If the action was
requested by the Host, a return code of 0x0E is returned to the Host program.
User Action: If the volume has somehow been overwritten with incorrect contents,
delete and reinitialize the virtual tape volume.
DLm521E
Volume <volser> (filename) has data set 'dataset1', not 'dataset2'
Description: While considering the specified virtual tape volume for scratching,
unscratching, erasing, it was found that the volume contains the dataset 'dataset1',
not the dataset specified by the Host request ('dataset2').
System Action: The scratch/unscratch/erase request is ignored. A return code of 0x0F
is returned to the Host program.
User Action: Correct the data being sent by the Host application.
DLm522E
Invalid date in scratch request 'xxxxxxxxxxxx'
Description: Scratching, unscratching, or erasing of a volume was requested by the
Host, but the data sent by the Host program contains an invalid date. The date shown
(xxxxxxxxxxxxx) is in hexadecimal as received from the Host program.
DLm523E
Volume <volser> (filename) created too recently (nnnnnn) to scratch today (nnnnnn)
Description: Scratching of a virtual tape volume was requested by the Host, but the
date found in the virtual tape volume's HDR1 label shows that the file was created on
the same date that (or later than) the scratch request is being made. A volume can
only be scratched one or more days later than the day on which it was created.
System Action: The scratch request is ignored. A return code of 0x11 is returned to the
Host program.
User Action: Resubmit the scratch request to the virtual tape application at least one
day after the file on the volume was created.
DLm524W
Volume <volser> (filename) already scratched/unscratched/erased
Description: Scratching, unscratching, or erasing of a virtual tape volume was
requested by the Host, but the specified virtual tape volume is already in the state
designated in the message.
System Action: The scratch/unscratch/erase request is ignored. A return code of 0x02
is returned to the Host program.
User Action: Be careful not to submit duplicate scratch/unscratch/erase requests to
the virtual tape application.
DLm525E
Volume <volser> (filename) not a scratched/erased tape
Description: Erasing or deleting of a scratch volume was requested by the Host, but
the specified virtual tape volume is not in the scratched (for erase) or erased (for
delete) state.
System Action: The erase or delete request is ignored. A return code of 0x04 is
returned to the Host program.
User Action: Be careful to submit erase requests for previously scratched volumes
only, and delete requests for previously erased volumes only.
DLm526E
Volume <volser> (filename) cannot un-scratch, already erased
Description: Un-scratching of the specified virtual tape volume was requested by the
Host, but virtual tape volume has already been erased and cannot be un-scratched. Its
former data cannot be recovered.
System Action: The unscratch request is ignored. A return code of 0x02 is returned to
the Host program.
User Action: Once a virtual tape volume has been erased, it cannot be un-scratched.
DLm527W
Device <devicename> unable to allocate an SL/AL/NL scratch volume: <error message>
Description: Loading of a scratch volume was requested, but a scratch volume with
the requested label type could not be found. The 'error message' portion of this
message explains the reason.
System Action: The requested volume is not loaded and the drive remains Not Ready.
User Action: Correct the problem preventing the scratch volume allocation and try to
re-load a scratch tape. If no scratch volumes are available, consider scratching some
old, unneeded volumes or INITIALIZE some more scratch volumes.
DLm530E
OCFS/2 feature not available
Description: An OCFS/2 support license is installed, but an error occurred during
OCFS/2 initialization.
System Action: OCFS/2 support is disabled until the problem is corrected and the
controller is restarted.
User Action: If the preceding error message(s) describe a correctable problem, correct
the problem and restart the controller. Contact EMC Support if more assistance is
needed.
DLm539E
Device <devicename> volser <volser> write verification error: error message
Description: An error occurred while verifying the data just written to disk.
System Action: An I/O error status is returned to the current host operation. This
message should be preceded by one or more messages that explain the problem(s)
encountered.
User Action: If the error messages describe a correctable problem, correct the problem
and retry the failing job. Contact EMC Support if more assistance is needed.
DLm540W
Unexpected response received from <servername>: message
Description: While attempting to get filesystem information from the specified server,
an unexpected response was received.
System Action: Any feature such as Guaranteed Replication or FLR that depends on
knowing information about the back-end filesystem may not function properly on this
filesystem.
User Action: If the message describes a correctable problem, correct the problem and
restart the DLm application. Contact EMC Support if more assistance is needed.
DLm541I
Device <devicename> Volser <volser> GR device writing to replicating filesystem
Description: The specified device is configured to use Guaranteed Replication, and
the volume being written is on a replication-enabled filesystem.
System Action: When the tape is closed, a replication-refresh will be performed on the
filesystem.
User Action: None.
DLm542I
Device <devicename> Volser <volser> preparing GR replication (nn second delay)
Description: The specified device is configured to use Guaranteed Replication, the
virtual tape volume resides on a replication-enabled filesystem, the host has written
two consecutive tapemarks to the volume, and a Guaranteed Replication delay has
been configured.
System Action: A replication-refresh is being prepared, and will start in <nn> seconds.
User Action: None.
DLm543I
Device <devicename> Volser <volser> starting GR replication-refresh (nn second
timeout)
Description: The specified device is configured to use Guaranteed Replication, the
virtual tape volume resides on a replication-enabled filesystem, and the host has
written two consecutive tapemarks to the volume.
System Action: A replication-refresh is being performed. If the replication- refresh
does not complete in <nn> seconds, an error status will be returned to the host's WTM
command.
User Action: None.
DLm544I
Device <devicename> Volser <volser> GR replication-refresh complete
Description: A Guaranteed Replication replication-refresh has completed successfully.
System Action: Normal ending status is returned to the host's WTM command.
User Action: None.
DLm545W
Device <devicename> Volser <volser> GR device writing to non-replicating filesystem
Description: The specified device is configured to use Guaranteed Replication, and
the volume being written is NOT on a replication-enabled filesystem.
System Action: When the volume is unloaded, no replication-refresh will be
performed.
User Action: None.
DLm546I
Device <devicename> Volser <volser> retrying replication through 'csname'
Description: A Guaranteed Replication replication-refresh attempt previously failed,
but there is an alternate control station on which to retry the request.
System Action: The replication-refresh request will be retried on the specified
'csname' control station.
User Action: Check the Celerra configuration to make sure that the Celerra control
stations are properly configured.
DLm547W
Device <devicename> Volser <volser> ssh error with control station 'csname'
Description: A Guaranteed Replication replication-refresh attempt sent to the Celerra
control station 'csname' failed.
System Action: If there is an alternate control station address, the replication- refresh
will be attempted on the alternate address. Otherwise, the replication-refresh will
have failed.
User Action: Check the Celerra configuration to make sure that the Celerra control
stations are properly configured.
DLm548E
Device <devicename> Volser <volser> Guaranteed Replication error: <error message>
Description: A Guaranteed Replication replication-refresh has encountered an error.
System Action: The tape volume will be unloaded, with an error status returned to the
host's unload command. The file is intact on the local storage attached to the DLm,
but replication is not guaranteed.
User Action: Check the <error message> for a description of the problem and correct
the problem, check the replication status, and/or force a manual replication of the
filesystem. If necessary, contact EMC Support for more assistance.
DLm549E
Device <devicename> Guaranteed Replication cannot locate info for 'pathname'
Description: A Guaranteed Replication replication-refresh is being attempted, but
detailed replication information about the filesystem cannot be obtained at the time.
System Action: The Guaranteed Replication replication-refresh is not performed. An
error status is returned to the host's WTM command. The file is intact on the local
storage attached to the DLm, but replication is not guaranteed.
User Action: Force a manual replication of the filesystem to guarantee that the tape
has been replicated. Contact EMC Support for assistance.
DLm550I
Command received from Host: device <devicename>: cmd = 'command'
Description: The specified virtual tape application command was sent from the Host
via the specified virtual tape device.
System Action: The command will be executed. Depending on the results of the
command, a return code will be returned to the Host program.
User Action: If the command is successful, none. Otherwise, determine the reason for
the command failure and correct the problem.
DLm551E
Host-initiated commands not allowed
Description: A virtual tape application command was sent from the Host, but the
application is not configured to allow Host-initiated commands.
System Action: The command will not be executed. A failure code will be returned to
the Host program.
User Action: If you want the Host to be able to initiate virtual tape application
commands, correct the configuration to allow for this feature.
DLm552E
Unable to locate script <scriptname>: <error msg>
Description: A virtual tape application RUN command was sent from the Host, but the
application is not able to locate the specified script.
System Action: The command will not be executed. A failure code will be returned to
the Host.
User Action: Check that the correct script name was specified in the RUN command,
and that the script file has the proper permissions to be executed by the virtual tape
application user 'vtape'.
DLm553E
Unable to execute script <scriptname>
Description: A virtual tape application RUN command was sent from the Host, but the
application is not able to execute the specified script.
System Action: The command will not be executed. A failure code will be returned to
the Host.
User Action: Check that the correct script name was specified in the RUN command,
and that the script file has the proper permissions to be executed by the virtual tape
application user 'vtape'.
DLm555E
RUN command not allowed
Description: A virtual tape application RUN command was sent from the Host, but the
application is not configured to allow the RUN command.
System Action: The command will not be executed. A failure code will be returned to
the Host.
User Action: If you want the Host to be able to initiate virtual tape application RUN
commands, correct the configuration to allow for this feature.
DLm556W
RUN process #nnnnn has not finished in nn seconds
Description: A virtual tape application RUN command was sent from the Host and
executed by the application, but the specified script did not complete within the
specified time limit.
System Action: The virtual tape application will cancel the process identified by
process ID #nnnnn. A failure code will be returned to the Host.
User Action: If the specified script normally takes longer than the time specified,
specify a longer time on the RUN command.
DLm560E
Device <devicename> Error gathering file segment data for volume <volser>
Description: An error has occurred while opening a previously extended virtual tape
volume on a WORM filesystem. This message should be preceded by one or more
messages that explain the problem(s) encountered.
System Action: The volume is not mounted, and the drive remains Not Ready.
User Action: If the preceding error message(s) describe a correctable problem, correct
the problem and retry mounting the tape volume. Contact EMC Support if more
assistance is needed.
DLm561E
Device <devicename> Missing or invalid AWSMAP in <filename>
Description: An error has occurred while opening a previously extended virtual tape
volume on a WORM filesystem. The format of the specified file is invalid.
System Action: The volume is not mounted, and the drive remains Not Ready.
User Action: Contact EMC Support for assistance.
DLm562E
Device <devicename> Error extending volume <volser>: <error message>
Description: An attempt was made to write to (modify) a previously locked virtual tape
volume on a WORM filesystem, but an error occurred while trying to create a new file
to extend the volume. The <error message> portion of this message explains the
problem that occurred.
System Action: The Host write command is rejected with a Unit Check.
User Action: Contact EMC Support for assistance.
DLm563E
Device <devicename> Info in file <filename> doesn't match previous segment
Description: An error has occurred while opening a previously extended virtual tape
volume on a WORM filesystem. The previous file segment information stored in file
segment 'filename' does not match the actual contents of the immediately preceding
file segment.
System Action: The volume is not mounted, and the drive remains Not Ready.
User Action: Contact EMC Support for assistance.
DLm564E
Device <devicename> Invalid segment number in segment <n>
Description: An error has occurred while opening a previously extended virtual tape
volume on a WORM filesystem. The file segment number stored in the file
VOLSER_nnnnn, where nnnnn is the segment number <n> shown in the message, is
not <n>.
System Action: The volume is not mounted, and the drive remains Not Ready.
User Action: Contact EMC Support for assistance.
DLm565E
Device <devicename> Illegal volume mod attempt, volume <volser>, offset <nnnnnn>,
block <nnn>
Description: An attempt was made to write to (modify) a previously locked virtual tape
volume on a WORM filesystem, at a location other than at the end of the existing data.
Once a virtual tape volume is locked on a WORM filesystem, you can append to the
dataset but you cannot modify it in any other way.
System Action: The Host write command is rejected with a Unit Check.
User Action: Correct the Host job or application so that it does not try to write
anywhere but at the end of the existing data.
DLm566E
Device <devicename> Volume <volser> maximum number of modifications exceeded
Description: An attempt was made to write to (modify) a previously extended virtual
tape volume on a WORM filesystem, but the volume has already been modified the
maximum of 9999 times.
System Action: The Host write command is rejected with a Unit Check.
User Action: Keep the number of modifications to a virtual tape volume on a WORM
filesystem to a minimum, for performance reasons as well as to avoid reaching the
maximum allowable modifications.
DLm567I
Device <devicename> Volume <volser> WORM file has <nn> modifications
Description: The specified volume resides on a WORM filesystem. If the volume had
been previously modified since it was first placed into WORM mode, this
informational message displays the number of times it has been modified.
System Action: None.
User Action: None.
DLm568I
Device <devicename> Volume <volser> writing modification #nn
Description: The specified volume resides on a WORM filesystem, and is in WORM
mode. The system is configured to allow appending to WORM files (FLRMOD=YES) and
the host has performed a write to append to this tape.
System Action: The append to the WORM file is allowed. This message will be
displayed once per mounting of any given tape.
DLm569E
Device <devicename> error extending volume <volser>
Description: An error occurred during an attempt to write to (modify) a previously
locked virtual tape volume on a WORM filesystem. This message should be preceded
by one or more messages that explain the problem(s) encountered.
System Action: The Host write command is rejected with a Unit Check.
User Action: If the preceding error message(s) describe a correctable problem, correct
the problem and retry the failing job. Contact EMC Support if more assistance is
needed.
DLm570W
HDR1 has invalid expiration date `xxxxxx'
Description: During opening of an existing virtual tape volume, or when the Host
wrote a new HDR1 label, the virtual tape application determined that the expiration
date in the HDR1 label (xxxxxx) was invalid.
System Action: Processing continues. The virtual tape application treats the volume
as if no expiration date was specified in the HDR1. The only time a volume's
expiration date is of any consequence to the application is if the file is being written to
a WORM filesystem. In this case, if the virtual tape application is configured with a
default retention value, that retention period will be used. Otherwise, the retention
period is treated as zero (no retention) and the file will be written in a non-WORM
mode.
User Action: Correct the host JCL to write a valid expiration date.
DLm571W
Device <devicename> Retention date <yyyy/ddd> out of range, using YYYY/DDD
Description: During opening of an existing virtual tape volume, or when the Host
wrote a new HDR1 label, the virtual tape application determined that the expiration
date in the HDR1 label (xxxxxx) was outside of the range that can be converted to a
retention period by the virtual tape application. The application can process HDR1
expiration dates in the range Jan. 1, 2003, through Jan. 18, 2038.
System Action: Processing continues. If the HDR1 date was prior to Jan. 1, 2003, the
virtual tape application regards the volume's expiration date to be Jan. 1, 2003. If the
HDR1 date was after Jan. 18, 2038, the application regards the volume's expiration
date to be Jan. 18, 2038. The only time a volume's expiration date is of any
consequence to the virtual tape application is if the file is being written to a WORM
filesystem. In this case, the file will be written in WORM mode with the modified
retention date.
User Action: Correct the host JCL to write a valid expiration date.
DLm572E
Unable to calculate retention time for xxxxxx (out of range?)
Description: During opening of an existing virtual tape volume, or when the host wrote
a new HDR1 label, the virtual tape application was unable to convert the HDR1
expiration date (xxxxxx) to a retention period, for an unknown reason.
System Action: Processing continues. The virtual tape application treats the volume
as if no expiration date was specified in the HDR1. The only time a volume's
expiration date is of any consequence to the virtual tape application is if the file is
being written to a WORM filesystem. If the virtual tape application is configured with a
default retention value, the default retention period will be used. Otherwise, the
retention is treated as zero (no retention) and the file will written in non-WORM mode.
User Action: Correct the host JCL to write a valid expiration date.
DLm573E
Error while validating directory 'directory': <error message>
Description: During the directory validation process a problem was discovered.
System Action: The specified directory cannot be used for the intended purposes by
the virtual tape application.
User Action: Verify the existence and properties of the directory. If this problem
persists, contact EMC Support for assistance.
DLm580E
Error getting <volser> file status; <error message>
Description: During closing of a virtual tape file, an error occurred reading the file's
current status information.
System Action: Processing continues. There may be problems in accessing this file
later.
User Action: The error message portion of this message identifies the reason for the
error. Correct the reason if possible. If the problem recurs, contact EMC Support for
assistance.
DLm581E
Device <devicename> Error setting volser file status to <status>; <error message>
Description: During closing of a virtual tape file, an error occurred while setting the
file's final status information.
System Action: Processing continues. There may be problems in accessing this file
later.
User Action: The error message portion of this message identifies the reason for the
error. Correct the reason if possible. If the problem recurs, contact EMC Support for
assistance.
DLm582I
Device <devicename> Volume <volser> made/left read-only
Description: This message is displayed when an output virtual tape volume written to
a WORM filesystem is unloaded and the volume has been made a read-only volume.
System Action: The virtual tape volume is now in read-only (WORM) mode.
User Action: None.
DLm590E
Device <devicename> Unable to calculate retention time for nD/M/Y (out of range?)
Description: While closing a volume that has no valid HDR1 expiration date, written to
a WORM filesystem, the virtual tape application was unable to calculate a valid
retention period based on the configured default retention period.
System Action: Processing continues. The virtual tape application regards the
volume's expiration date to be zero (no retention). In this case, the file will be written
in non-WORM mode because of this error.
User Action: If the volume was to have been written in WORM mode, either correct the
HDR1 expiration date, or specify a valid default retention period value. If this problem
persists, contact EMC Support for assistance.
DLm591E
Device <devicename> Unable to set access time: <error message>
Description: While closing a volume written to a WORM filesystem, the virtual tape
application was unable to set the retention period in the file's "last access time".
System Action: Processing continues. The virtual tape application will attempt to write
the file in WORM mode anyway. If successful, the file will be locked with a permanent
retention period.
User Action: Refer to the `error message' portion of this message to determine the
cause of the problem. If this problem persists, contact EMC Support for assistance.
DLm594W
Device <devicename> Volume <volser> configured FLR but no .FLR file found in
<pathname>
Description: The specified virtual tape drive is configured for EMC FLR support, but the
target directory does not contain a file named .FLR.
System Action: Processing continues. The virtual tape volume just written is not set to
a WORM state.
User Action: Be sure that the correct tape library is configured and the correct external
filesystem is mounted for this device. If you wish tapes to be locked with FLR, you
must create a file named .FLR in each FLR tape library directory.
DLm595W
Device <devicename> configured SnapLock and .SNAPLOCK found but <pathname> is
not a SnapLock directory
Description: The specified virtual tape drive and tape library directory are configured
for Network Appliance SnapLock support, but the virtual tape application has
determined that the target directory is not a SnapLock volume, because the virtual
tape file just closed did not stay Read-Only.
System Action: Processing continues. The virtual tape volume just written is not
protected from further modification.
User Action: Be sure that the correct tape library is configured and the correct external
filesystem is mounted for this device.
DLm596W
Device <devicename> configured SnapLock but no .SNAPLOCK file found in
<pathname>
Description: The specified virtual tape drive is configured for Network Appliance
SnapLock support, but the target directory does not contain a file called .SNAPLOCK.
System Action: Processing continues. The virtual tape volume just written is not
SnapLock'ed.
User Action: Be sure that the correct tape library is configured and the correct external
filesystem is mounted for this device. If you wish tapes to be SnapLock'ed, you must
create a file called .SNAPLOCK in each SnapLock directory.
DLm597W
Device <devicename> Volume <volser> configured FLR and .FLR found but <pathname> is
not an FLR directory
Description: The specified virtual tape drive and tape library directory are configured
for FLR support, but the DLm application has determined that the target directory is
not an FLR filesystem, because the virtual tape file just closed did not stay Read-Only.
System Action: Processing continues. The virtual tape volume just written is not
protected from further modification.
User Action: Be sure that the correct tape library is configured and the correct external
filesystem is mounted for this device.
DLm607E
Device <devicename>, Volume <volser>: error while setting scratch state
Description: An error occurred while trying to scratch or unscratch a virtual tape file.
System Action: The virtual tape application returns an error status to the current Host
I/O request.
User Action: Examine any preceding related messages, if any, for additional error
information, and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm612E
Device <devicename>, Volume <volser>: <message>
Description: The virtual tape application experienced an internal error, and will output
a detailed error message.
System Action: The virtual tape application returns an error status to the current Host
I/O request.
User Action: Examine any preceding related messages, if any, for additional error
information, and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm614E
Device <devicename>, Volume <volser>: could not get hint for block: nnnn
Description: The virtual tape application was unexpectedly unable to find an entry in
an index of block IDs while performing a LOCATE.
System Action: The virtual tape application returns an error status to the Host's
LOCATE request.
User Action: Examine any preceding related messages, if any, for additional error
information, and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm631E
Device <devicename>, Volume <volser>: could not find block nnnn
Description: The virtual tape application was unable to locate a block specified in a
LOCATE request.
System Action: The virtual tape application returns an error status to the Host's
LOCATE request.
User Action: Examine any preceding related messages, if any, for additional error
information, and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm636I
Database timeout set to N seconds
Description: Normal response to an operator 'SET DBTIMEOUT=N' command.
DLm637W
FIND command not supported for PATH-TYPE paths; skipping.
Description: The FIND command does not currently support this PATH-TYPE.
System Action: The FIND command does not query paths of the specified type.
User Action: None.
DLm660I
Device <devicename>, Volume <volser>: For Unisys only, trying again as SCRTCH
Description: The Host requested mounting of volume <volser>, but the volume does
not exist. For Unisys devices only, the virtual tape application will now perform a
SCRTCH mount request.
System Action: The virtual tape application attempts to mount a scratch volume.
User Action: None.
DLm671E
Device <devicename>, Volume <volser>: error while closing tape
Description: An error occurred while unmounting a virtual tape.
System Action: The virtual tape application returns an error status to the current Host
I/O request.
User Action: Examine any preceding related messages, if any, for additional error
information, and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm674E
Device <devicename>, Volume <volser>: Bad path specified: full path(pathname)
Description: An internal error occurred while the virtual tape application was
attempting to construct a path name.
System Action: The virtual tape application returns an error status to the current Host
I/O request.
User Action: Examine any preceding related messages, if any, for additional error
information, and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm676E
Device <devicename>, Volume <volser>: internal I/O error
Description: The virtual tape application experienced an internal I/O error.
System Action: The virtual tape application returns an error status to the current Host
I/O request.
User Action: Examine any preceding related messages, if any, for additional error
information, and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm677E
Device <devicename>, Volume <volser>: error while renaming tape to 'xxxxxx'
Description: An error occurred while changing a tape's volser.
System Action: The virtual tape application returns an error status to the current Host
I/O request.
User Action: Examine any preceding related messages, if any, for additional error
information, and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm678E
Device <devicename>, Encryption/decryption failed
Description: An error occurred while encrypting or decrypting data.
System Action: The virtual tape application returns an error status to the current Host
I/O request.
User Action: Examine any preceding related messages, if any, for additional error
information, and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm679E
Cannot set FIPS mode for encryption
Description: The initialization of FIPS-mode-certified encryption failed.
DLm680E
Device <devicename>, Volume <volser>: internal I/O error while (un)reserving volser
'xxxxxx'
Description: An error occurred while performing a distributed lock or unlock on a
virtual tape.
System Action: The virtual tape application returns an error status to the current Host
I/O request.
User Action: Examine any preceding related messages, if any, for additional error
information, and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm681E
Device <devicename> <path-type> path 'path' specified, but no valid <path-type>
license file exists.
Description: A Centera or HCAP path was encountered, but there is no license for that
feature.
System Action: The virtual tape application will not accept mount requests on this
path.
User Action: If the virtual tape application should be licensed for this feature, contact
EMC Support for assistance.
DLm682E
Device <devicename> unable to initialize VirtualFile path 'path'
Description: An error occurred while determining the Centera or HCAP path.
System Action: The virtual tape application will not accept mount requests using the
indicated path.
User Action: Ensure that the indicated path is correctly configured. If the problem
persists, contact EMC Support for assistance.
DLm683W
Nothing to recover for tape <volser>; cleaning up.
Description: A previous I/O failure caused recovery of a partially-written tape to be
attempted, but no recovery was possible.
System Action: The virtual tape application cleans up the remnants of the
unrecoverable tape.
User Action: None.
DLm684E
Device <devicename>, Volume <volser>: could not validate SL tape
Description: There was a problem in the format of the tape headers in a standard
labeled tape.
System Action: The virtual tape application returns an error status to the current Host
I/O request.
User Action: Examine any preceding related messages, if any, for additional error
information, and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm685E
unable to initialize path 'pathname': error message
Description: An error occurred while setting the specified path.
System Action: The path is not changed.
User Action: Examine any preceding related messages, if any, for additional error
information, and correct the problem. If the problem recurs, contact EMC Support for
assistance.
DLm686I
Device <devicename> Distributed Lock Mgr informational message <message>
Description: An error occurred while setting the specified path.
System Action: None.
User Action: Examine message, contact EMC Support for assistance.
DLm687I
Enhanced FS move volume method is: <method>
Description: The enhanced FS will use the displayed method when moving a volume.
System Action: None.
User Action: None.
DLm688I
Enhanced FS move for volumes in <FLR/GR> tape libraries: <enabled/disabled>
Description: The enhanced FS move feature will be disabled for the file system type if
selected as disabled or will use the efsmove method chosen for all file systems
when selected as enabled
System Action: None.
User Action: None.
DLm701E
Device <devicename> Data Exchange Feature not licensed, mount 'volser' ignored
Description: Mounting of a flat file (data exchange) volser was requested, but this
controller is not licensed for flat file support.
System Action: The mount request is ignored.
User Action: Only flat files can start with the volser prefix "BFL". If you want to use the
flat file / data exchange feature, you must obtain a license for this feature. Contact
EMC Support for assistance.
DLm704E
Device <devicename> Error deleting unused flat volume <volser>: error message
Description: The specified volume was created in response to a flat tape mount
request. Because it was unloaded without ever having been written to, the virtual tape
application tried to delete it. An I/O error occurred during the attempt to delete.
System Action: The volume may or may not have been deleted from the tape library.
User Action: The 'error message' portion of this message describes the error that
occurred. Correct the error.
DLm711I
Device <devicename> Unused flat volume <volser> deleted
Description: The specified volume was created in response to a flat tape mount
request, but it was unloaded without ever being written to.
System Action: The volume is deleted from the virtual tape library.
User Action: None.
DLm714E
Device <devicename> too many trailer labels!
Description: The virtual tape application received too many labels to store (more than
legally allowed for standard label processing) while processing the trailer labels for a
standard labeled flat file.
System Action: The Host write is canceled with a unit check.
User Action: Correct the condition that is causing too many labels to be written.
DLm715E
Device <devicename> data in trailer labels!
Description: The virtual tape application received a non-label data record while
processing the trailer labels for a standard labeled flat file.
System Action: The Host write is canceled with a unit check.
User Action: Correct the condition that is causing the invalid label or data to be written
within the trailer labels.
DLm720E
Device <devicename> command in flat file
Description: The virtual tape application received a tape positioning command from
the Host while positioned within the data area of a flat file.
System Action: The Host command is canceled with a unit check.
User Action: Spacing commands are not allowed within flat files; correct the condition
that is causing the spacing within the file.
DLm724E
Device <devicename> read backwards/previous in flat file
Description: The virtual tape application received a Read Backwards or Read Previous
command from the Host while within the data area of a flat file.
System Action: The Host command is canceled with a unit check.
User Action: Reading backwards is not allowed in a flat file; correct the condition that
is causing the backwards reading.
DLm766E
Device <devicename> file 'filename' already exists [as scratch]
Description: The Host wrote a HDR1 label to a flat file volume, and the virtual tape
application attempted to change the volume's filename from VOLSER.FLAT to
VOLSER.DATASETNAME.FLAT (where DATASETNAME is the dataset name from the
HDR1 label), but the file VOLSER.DATASETNAME.FLAT already exists in the tape library.
System Action: The Host write is canceled with a unit check.
User Action: Either delete or rename the existing file in the tape library before writing a
flat file with the same name, or use a different dataset name in the JCL for the new
output file.
DLm767E
Device <devicename> error renaming volume <volser> (oldfilename) to newfilename;
<error message>
Description: The Host wrote a HDR1 label to a flat file volume, and the virtual tape
application attempted to change the volume's filename from VOLSER.FLAT to
VOLSER.DATASETNAME.FLAT (where DATASETNAME is the dataset name from the
HDR1 label), but an error occurred during the renaming.
System Action: The Host write is canceled with a unit check.
User Action: Refer to the 'error message' portion of this message to determine the
reason for the error.
DLm770E
Cannot set RSA mode for encryption
Description: The initialization of RSA mode encryption failed.
DLm771E
Cannot get RSA key for decryption
Description: The request for an RSA decryption key failed.
System Action: The Host read is canceled with a unit check.
User Action: Confirm that the proper keys are installed in the RSA key manager, and
that the key manager is accessible from the controller, and that the access certificates
are valid.
DLm772E
Cannot get RSA key for encryption
Description: The request for an RSA encryption key failed.
System Action: The Host write is canceled with a unit check.
User Action: Confirm that the proper keys are installed in the RSA key manager, and
that the key manager is accessible from the controller, and that the access certificates
are valid.
DLm773E
Cannot use KEY= with RSA encryption
Description: Cannot use non-RSA along with RSA encryption.
System Action: The KEY= directive is rejected.
User Action: Note that only RSA keys can be configured when the RSA key manager is
in use.
DLm774I
KEYCLASS set to [class|NONE] for device <devicename>
Description: Key class 'class' will be used for encryption on device <devicename>, or if
'NONE' is specified, no encryption will be done on device <devicename>
System Action: The specified encryption key class (or none, for 'NONE') will be used
for any blocks written to the specified device.
User Action: None.
DLm775E
Cannot encrypt a tape with more than one key on device <devicename>
Description: Two different keys were attempted to be used for encryption on device
<devicename>
System Action: The Host write is canceled with a unit check.
User Action: Use the key that was previously used to encrypt data for this tape.
DLm776E
Cannot stop RSA key module
Description: The attempt to stop the RSA key module failed.
System Action: None.
User Action: Contact EMC Support for assistance.
DLm777E
RSA encryption is not available
Description: RSA encryption is either not licensed, not configured, or had an error
during initialization.
System Action: Check the logs for encryption initialization errors.
User Action: Depending on the cause of the error, either obtain a license for RSA
encryption, configure RSA encryption properly, or if there is an initialization error,
contact EMC Support for assistance.
DLm778I
Reusing encryption key for device <devicename>
Description: The tape includes a previously encrypted data set, and another data set
is being added, so the previous key will be used for this new data set.
System Action: The previous key is used for the new data set.
User Action: None
DLm779I
Not encrypting on device <devicename>
Description: The tape has prior unencrypted data set(s), so this new appended data
System Action: set will not be encrypted.The new data set is written unencrypted.
User Action: None
DLm780E
Restarting RSA peer process
Description: The RSA peer process has exited or become inactive, and needs to be
restarted.
System Action: The RSA peer process is restarted.
User Action: None
DLm781W
Device <devicename> is open as a read only tape
Description: The volume on the physical tape drive is mounted in read-only mode.
System Action: The tape is mounted in read-only mode.
User Action: In order to write new volumes, make sure the tape is correctly mounted
and is write-enabled.
DLm782E
Command <command> not supported on Physical Tape Device <devicename>
Description: The requested (rewind, unload, unready, ready) command is not
supported on real physical tape devices.
System Action: The command is ignored.
User Action: Operator intervention is required to issue this command at the physical
tape device.
DLm783W
Device <devicename> tape door is open
Description: The physical tape drive door is open.
DLm785W
Device <devicename> Read Buffer too small
Description: The data block read from the physical tape is larger than the maximum
supported by the virtual tape application.
System Action: An error status (equipment check) is returned to the host.
User Action: The tape is not compatible with the virtual tape application because of
the large block(s) it contains.
DLm786E
Device <device name> Failed to Open <device path>
Description: The physical tape drive is not accessible.
System Action: The virtual tape application will not communicate with this tape
device.
User Action: The tape most likely requires manual intervention.
DLm787E
Device <devicename> Unable to set Compression ON/OFF errno <error message>
Description: The physical tape drive did not accept the compression command.
System Action: Data written to this tape device will not be compressed.
User Action: Contact EMC Support for assistance.
DLm788E
Device <devicename> SCSI block #nnn too large (xxxxxx) to handle <operation>
(max=yyyyyy)
Description: The virtual tape application has received a tape block from the host with
a size ('xxxxxx') that is larger than the maximum tape blocksize ('yyyyyy') that can be
presented to the physical tape drive.
System Action: An I/O error is returned to the Host.
User Action: Correct the host application to send a blocksize that can be handled by
the tape drive.
DLm789I
Device <device name> does not support the SCSI <cmd> command
Description: The physical tape drive does not support the specified command.
System Action: The virtual tape application will continue, but the specified command
cannot be performed.
User Action: Determine that the attached device is a supported device type.
DLm790I
ST driver version info: <description>
Description: This message displays the version number of the st (SCSI tape) driver.
System Action: None.
User Action: None.
DLm791I
BTISMC driver version info: <description>
Description: This message displays the version number of the btismc (SCSI Media
Changer) driver.
System Action: None.
User Action: None.
DLm795I
Device <devicename> ready
Description: This message displays when a physical tape drive assigned to a virtual
tape device transitions from not ready to ready.
System Action: A "Ready" interrupt is sent to the host.
User Action: None.
DLm796I
Device <devicename> offline and not ready
Description: This message displays when a physical tape drive assigned to a virtual
tape device transitions from ready to not ready.
System Action: None. The drive will appear not ready to the host.
User Action: None.
DLm797E
Device <devicename> can not <command> during tape activity
Description: This message displays when an operator requests a tape (unload) while
physical tape drive activity is in progress.
System Action: None.
User Action: Retry the command when tape activity has completed.
DLm801I
Trace buffers saved to disk
Description: Normal response to the 'Save Trace' command.
System Action: All trace buffers currently held in memory have been written to disk.
User Action: None.
DLm804I
Writing corefile to 'filename.gz' ...
Description: Normal response to the 'SAVE COREFILE' command.
System Action: A diagnostic corefile of the virtual tape application will be saved to the
specified file.
User Action: None.
DLm805I
corefile 'filename.gz' saved to disk
Description: Normal response to the 'SAVE COREFILE' command.
System Action: A diagnostic corefile of the virtual tape application has been saved to
the specified file.
User Action: None.
DLm810E
Command failed: command: <error message>
Description: The virtual tape application received an error while trying to execute the
specified command in an external shell.
System Action: The system continues running without executing the specified external
command.
User Action: Contact EMC Support for assistance.
DLm812E
<command> feature is not licensed
Description: The specified command requires a feature that is not licensed for use on
this controller.
System Action: The command is ignored.
User Action: Contact EMC Support for more information on enabling the licensed
feature.
DLm813E
Command <command> is not permitted
Description: The specified command is not permitted by the virtual tape application
configuration.
System Action: The command is ignored.
User Action: Refer to configuration documentation for instructions about how to
activate this command.
DLm814E
Parameter #n 'keyword=value' is not a valid VOL= or DEV= parameter
Description: Syntax error on an operator command.
System Action: The command is ignored.
User Action: Use the 'Help' command to see the proper command syntax.
DLm815E
Parameter n 'value' is not a valid VOLSER or synonym
DLm816E
No free device available to mount volume <volser>
Description: The operator 'Load' command specified any drive ('*'), but there was no
free drive.
System Action: The command is ignored.
User Action: Wait for a drive to be free, then reenter the command.
DLm817E
Parameter n 'keyword=value' is not a valid parameter
Description: Syntax error on an operator command.
System Action: The command is ignored.
User Action: Use the 'Help' command to see the proper command syntax.
DLm818E
Invalid device name 'value' specified (too long)
Description: The <devicename> specified in an operator command is invalid.
System Action: The command is ignored.
User Action: Use the 'Help' command to see the proper command syntax.
DLm819E
Unknown device name 'value' specified
Description: The <devicename> specified in an operator command is invalid.
System Action: The command is ignored.
User Action: Use the 'Help' command to see the proper command syntax.
DLm820E
No devicenames match 'devicenames'
DLm821I
MediumSense23 set to ON/OFF for device <devicename>
Description: By default, a value of 0x24 (enhanced cartridge) is returned to a host
media sense CCW. In very rare situations a host application might have a problem with
this value. (SPXTAPE is one known program with this issue.) In this case, a
configuration option can be used to return a 0x23 value (non-enhanced cartridge) in
the media sense data.
System Action: None.
User Action: The SET MEDIUMSENSE23=YES/NO command can be used to change this
value if required. Contact EMC Support for more assistance with this option.
DLm822I
Guaranteed Replication refresh on Sync set ON/OFF
Description: Guaranteed Replication can be configured to perform a replication
refresh at every tape sync point as well as at close time. This message displays the
current setting of that option.
System Action: If ON, Guaranteed Replication (if enabled and writing to a GR-enabled
filesystem) will perform a refresh every time the virtual tape file is sync'ed to disk.
User Action: None.
DLm825E
Volume <volser> is currently mounted on <devicename>, LOAD Command ignored
Description: The operator 'Load' command specified a drive that currently has a
virtual volume loaded.
System Action: The command is ignored.
User Action: Wait for the specified drive to be free, or choose a different drive.
DLm826W
Device <devicename> is already Ready/NotReady, READY/UNREADY command ignored
DLm828E
Nothing is currently mounted on <devicename>, command <command> ignored
Description: The operator Unload, Rewind, Ready, or Unready command specified a
drive that does not currently have a tape loaded.
System Action: The command is ignored.
User Action: Specify the correct drive in the Unload, Rewind, Ready, or Unready
command.
DLm829E
Device <devicename> is Ready, UNLOAD/REWIND/SET PATH command ignored
Description: The operator Unload or Rewind or Set Path command specified a drive
that is in the Ready state.
System Action: The command is ignored.
User Action: If you want to manually unload or rewind or change the path of a device
you must make in UNREADY first.
DLm830I
Device <devicename> made Ready/Unready
Description: The operator Ready or Unready command completed successfully.
System Action: The specified drive is now in the designated state.
User Action: None.
DLm831E
Invalid <parameter> value specified
Description: Syntax error on an operator command.
System Action: The command is ignored.
User Action: Use the 'Help' command to see the proper command syntax.
DLm832E
Invalid <parameter> value specified
Description: Syntax error on an operator command. Cannot set the same SCSI path to
all devices
System Action: The command is ignored.
User Action: Use the 'Help' command to see the proper command syntax.
DLm834I
Device <devicename> tracelevel changed from n to n
Description: Normal response to an operator 'Set Trace ... DEV=' command.
System Action: The specified trace level was changed.
User Action: None.
DLm836I
ALL tracelevels set to n
Description: Normal response to an operator 'Set Trace ... ALL' command.
System Action: The specified trace level was changed.
User Action: None.
DLm839E
unable to assess space for <path> (nnn)
Description: The virtual tape application was unable to obtain status information
about the specified tape library subdirectory, in response to the "Query Space"
command.
System Action: This tape library subdirectory is skipped in the "Query Space" output.
User Action: Make sure that a valid tape library directory is specified in the
configuration file for this device, that the directory is currently mounted and
accessible, and that all subdirectories within the tape library are mounted and
accessible. If the problem persists, contact EMC Support for assistance.
DLm840I
Read-back write verification set to ON/DATA/OFF
DLm841I
System tracelevel is currently set to n
Description: The tracelevel is displayed in response to the Query All command.
System Action: None.
User Action: None.
DLm842I
System debuglevel is currently set to n
Description: The debuglevel is displayed in response to the Query All command.
System Action: None.
User Action: None.
DLm843I
Filesystem stall detection threshold set to nnn minutes
Description: By default, a filesystem that has had uncompleted I/O pending for more
than 5 minutes is considered "stalled". The time period for which a filesystem is
considered stalled is configurable with the "SET StalledFilesystemThreshold=nnn
command, or in the configuration file with the "StalledFilesystemThreshold nnn"
option.
System Action: A stalled filesystems will be skipped when searching for a virtual tape
during a mount request. When the stalled I/O completes, the filesystem will once
again be used during mounts.
User Action: The default value of 5 minutes should be more than enough time to
detect a stalled filesystem. Contact EMC Support before changing this value.
DLm844I
Device <devicename> OSADDR set to 'XXXX'
Description: The OSADDR value for this device has been changed. The OSADDR value
is used with the VSE BTIMOUNT program to identify the name by which VSE knows a
virtual device.
System Action: The new OSADDR value will be used to find a virtual device when
BTIMOUNT requests a mount on a specific drive by name, and the application will
report the OSADDR value to BTIMOUNT when it completes a mount on "ANY" drive.
User Action: None.
DLm845I
Device <devicename> GROUP set to 'n'
Description: The GROUP value for this device has been changed.The GROUP value is
used with the VSE BTIMOUNT program to identify drives that belong to the same VSE
group as the control drive.
System Action: The new GROUP value will be used to find a virtual device when
BTIMOUNT requests a mount on "ANY" drive.
User Action: None.
DLm846I
AWS maps usage default value set to OFF
Description: An AWS map will not be written to an AWS file.
System Action: None.
User Action: None.
DLm847I
Checking of stored CRC values is ON/OFF
Description: When this option is ON, the CRC value stored for each tape block will be
confirmed when the file is read. When this option is OFF, the stored CRC value will not
be confirmed when the file is read.
System Action: None.
User Action: None.
DLm848I
Device <devicename> maximum volume size changed from <oldsize> to <newsize>
Description: The operator SET SIZE= command was accepted for the specified device.
System Action: The maximum volume size was changed for the specified device. The
SIZE change takes effect immediately.
User Action: None.
DLm849I
Storing of CRC values is ON/OFF
Description: When this option is ON, the CRC value is stored for each data block
written to the file. When this option is OFF, the CRC value for each data block will not
be written to the file.
System Action: None.
User Action: None.
DLm850I
Device <devicename> Label default changed from 'x' to 'x'
Description: The operator SET LABEL= command was accepted.
System Action: The default label value was changed for the specified device.
User Action: None.
DLm851I
ProtectVOL1 set ON/OFF
Description: By default, the virtual tape application prevents overwriting of VOL1
labels with data (ProtectVOL1=ON). The ProtectVOL1 feature can be disabled by
entering the command "SET ProtectVOL1=OFF"; when off, it can be re-enabled with
"SET ProtectVOL1=ON". The current ProtectVOL1 setting can be determined by
entering the "QUERY ALL" command.
System Action: When the ProtectVOL1 feature is enabled, any attempt by the host to a
VOL1 label with data is rejected with a unit check, with command reject sense.
User Action: None. It is recommended that the ProtectVOL1 feature be left enabled to
protect against accidental corruption of tape volumes by errant mainframe software.
DLm852I
Full-erase set ON
Description: The virtual tape application has been configured to perform a more
extensive erasure of data when a erasing of a virtual tape volume is requested. Most
tape managers expect to find the complete original header label set on every
scratched tape, but under some circumstances (for example, on a Unisys system), the
full label set is not desirable.
System Action: By default, when erasing a virtual tape volume the VOL1 label, all
HDRn labels, and one tapemark are retained. When the full erase option is set, only
the VOL1 and two tapemarks are retained.
User Action: None.
DLm853I
Pending Mount Fairness (PMFAIR) set to <nnn>
Description: The PMFAIR option allows the virtual tape application to be configured to
delay read and write I/Os while a tape mount operation is in progress. This can speed
up tape mounts on a heavily loaded system, at a slight expense to overall throughput
during tape mount operations. This option is off by default.
System Action: Every read and write I/O will be delayed by <nnn> milliseconds while a
tape mount is in progress.
User Action: None.
DLm854W
Requested path already assigned to device <devicename>
Description: The device path requested is already assigned to this device.
System Action: The path is unchanged from the previous value.
User Action: This message should have been preceded by one or more messages that
explained the problem. Refer to these messages, correct the problem(s), and then SET
PATH= to the desired path.
DLm855E
SCSI Tape Device <device path> does not exist
Description: The device path requested does not exist.
DLm856I
nn scratch synonyms: volser,volser,...
Description: This message displays any scratch synonyms that are defined in the
configuration file.
System Action: None.
User Action: None.
DLm857E
Error Invalid Path
Description: The Operator selected a path that requires a feature that is not licensed
for use on this virtual tape application.
System Action: The path is unchanged from the previous value.
User Action: Contact EMC Support for more information on enabling the licensed
feature.
DLm858I
Device <devicename> Data path deferred change from 'oldpath' to 'newpath'
Description: The operator SET PATH= command was accepted, but the specified
device currently has a volume mounted.
System Action: The new data path will take effect immediately after the current
volume is unmounted.
User Action: None.
DLm859I
Device <devicename> Data path changed from 'oldpath' to 'newpath'
Description: The operator SET PATH= command was accepted.
System Action: The new data path will take effect immediately on the specified virtual
tape drive.
DLm860E
PATH= is no longer supported; use DEV= to specify the tape library
Description: The operator INITIALIZE command specified the obsolete
PATH=parameter. Older versions of the virtual tape application supported a choice
between using PATH= or DEV= to designate the tape library where the volumes would
be initialized. The PATH= parameter is no longer supported, and DEV= is required.
System Action: The INITIALIZE command is ignored.
User Action: Do not specify PATH=, but use the required DEV= parameter on the
INITIALIZE command. See HELP INITIALIZE for more information.
DLm861E
Tape library path not changed
Description: The SET PATH command has failed.
System Action: The path is unchanged from the previous value.
User Action: This message should have been preceded by one or more messages that
explained the problem. Refer to these messages, correct the problem(s), and then SET
PATH= to the desired path.
DLm862E
Invalid volser <volser> for volume initialization
Description: The INITIALIZE command specified a volume serial number of 'SCRTCH' or
'PRIVAT', or beginning with 'BFL'. BFLxxx volsers are reserved for Data Exchange
("flat") volumes, which cannot be pre-initialized. Scratch volumes should be
initialized with the actual volsers desired, not by using the word 'SCRTCH' or 'PRIVAT'.
System Action: The INITIALIZE command is ignored.
User Action: Specify a valid volser that does not start with the prefix 'BFL' or 'SCRTCH'
or 'PRIVAT'.
DLm863E
SCSI Tape path already in use
Description: The SET PATH command has failed.
DLm864E
You can only create <nnn> volumes starting from <volser>
Description: The INITIALIZE command COUNT= parameter was too big for the specified
starting volser.
System Action: The INITIALIZE command is rejected.
User Action: Use the HELP INIT command for more information about using the
INITIALIZE command. Be sure that the specified COUNT value would not cause the
numeric portion of the volser to overflow or the first two characters of the volser to
change.
DLm865E
File '<filename>' [non-]scratch volume already exists
Description: During processing of an INITIALIZE command, the specified volume was
found to already exist in the tape library, as either a scratch or a non-scratch volume.
System Action: The new scratch volume is not created, and the original volume is
unchanged.
User Action: Do not attempt to create new scratch volumes in the range of existing
volumes.
DLm866E
File/Directory '<filename>' open failed, err=<nnn>: <error message>
Description: An I/O error occurred while attempting to create a new scratch volume.
System Action: The specified new scratch volume has not been created.
User Action: Refer to the `error message' portion of this message for an explanation of
the error. Correct the error and try initializing the volume(s) again.
DLm867E
Error writing to <filename>: <error message>
Description: An I/O error occurred while attempting to create a new scratch volume.
System Action: The specified new scratch volume has not been created.
User Action: Refer to the `error message' portion of this message for an explanation of
the error. Correct the error and try initializing the volume(s) again.
DLm868E
Too many errors have occurred, terminating
Description: Multiple errors have occurred during processing of the operator
INITIALIZE command.
System Action: One or more new scratch volumes may have been created before the
maximum number of errors occurred.
User Action: Review the messages prior to this one to determine the nature of the
errors, and correct the errors and/or re-enter the correct INITIALIZE command.
DLm869I
nn Standard/ANSI-labeled volumes initialized
Description: The virtual tape application has completed an INITIALIZE command.
System Action: The specified number of new scratch volumes have been created.
User Action: None.
DLm870E
Device <devicename> Initializations not allowed in <tapelib>
Description: The tape library type assigned to this device does not support tape
initialization. Volumes can only be initialized in tape libraries on direct-access
filesystems.
System Action: The INITIALIZE command is ignored.
User Action: Specify a DEV=device that has a tape library defined on a valid
direct-access filesystem.
DLm871I
AttentionCount set to <value>
Description: The configurable ATTENTIONCOUNT parameter has been set as shown.
System Action: The ATTENTIONCOUNT parameter defines how many times the virtual
tape application should resend an asynchronous "Ready" interrupt should it be
rejected by the channel or Host. The default number of retries is 45.
DLm872E
Invalid SNn= value <value> (incorrect length)
Description: The operator SET command contained an incorrect serial number. The
new serial number must be exactly twelve characters long.
System Action: The SET command is ignored.
User Action: Specify a valid value in the SET command. Use the 'Help' command to
see the proper command syntax.
DLm873I
Attention set to <value>
Description: The configurable ATTENTION parameter has been set as shown.
System Action: The ATTENTION parameter defines to which channel path(s) the virtual
tape application should send a "Ready" interrupt when a virtual tape drive comes
ready. The possible values are:
PATHGROUP - the interrupt is sent to every channel path which currently has a
pathgroup ID (PGID) set, but only once per unique PGID (i.e. once per LPAR). This
is the default action. A PGID is typically set by a Host to a value unique to every
LPAR when a path is VARY'ed online.
REQUESTER - the interrupt is sent only on the channel path from which the Load
Display mount request was received.
ASSIGNED - the interrupt is sent to every channel path which has an Assignment
in effect. An Assignment is typically made when a Host VARYs a drive online.
ALL - the interrupt is sent to every channel path established for this device;
NONE - no interrupt is sent to any Host when a drive comes ready;
User Action: None. Changing this setting from the default value may cause problems
with lost Ready interrupts. Contact EMC Support before changing this value.
DLm874E
Setting <parameter> requires a DEVICE= parameter too
Description: The operator SET command was entered without specifying a specific
device to be set.
DLm875I
Device <devicename> VOL= prefix changed from 'xx' to 'yy'
Description: The operator SET VOL= command was accepted.
System Action: The new volume serial prefix value takes effect immediately on the
specified virtual tape drive.
User Action: None.
DLm876I
Unknown volumes will be treated as Scratch requests
Description: Normally, a request for a non-existent volume results in message
DLm454E and the drive remains Not Ready. However, this controller has been
configured to treat mount requests for non-existent volumes as if the request were for
a scratch volume. This option only applies for devices connected to a Unisys
mainframe.
System Action: The virtual tape application will proceed as if a SCRTCH volume was
requested when a non-existent volume is requested, but only if the device is
connected to a Unisys mainframe at the time.
User Action: None.
DLm877I
Support for VSE Host Utilities disallowed/allowed
Description: This virtual tape system was configured or SET to support the supplied
VSE Host Utilities. This option should only be set if the supplied VSE utilities will be
used; the default mode is to disable this support.
System Action: If the message says 'allowed', the supplied VSE Utilities will be
supported by this virtual tape system. If the message says 'disallowed', the supplied
VSE Utility programs will fail with command-reject I/O errors.
User Action: If you want to use the supplied VSE Utilities, enable this option;
otherwise, leave this feature off by default.
DLm878I
<debugging feature enabled / disabled / not enabled: message>
Description: A special debugging feature was enabled or disabled through
configuration or with the SET command, or the SET command was rejected due to an
error.
System Action: The effect depends on the feature.
User Action: Special debugging features should only be enabled under direction of
EMC Support.
DLm879I
[Device <devicename> / ALL devices / TAPELIB path] quiesced/unquiesced
Description: The QUIESCE or UNQUIESCE command was entered.
System Action: A quiesced device is in a state where it will not accept any new tape
mounts until it is explicitly unquiesced (or until the virtual tape application is
restarted). If a drive has a volume mounted at the time it is quiesced, it will continue
to function completely normally; it will not accept another mount once the current
volume is unloaded. A quiesced tape library is in a state where it will not be available
for any new tape mounts until it is explicitly unquiesced (or until the virtual tape
application is restarted).
User Action: None.
DLm880I
GroupAccess set to 'R'
Description: By default, virtual tape files are only accessible by the 'vtape' user. This
message signifies that this controller is currently configured to allow other members
of the 'vtape' user group to have Read access to the virtual tape files created by this
node.
System Action: All tapes created while this option is set will have group accessibility.
User Action: Reconfigure this controller if you do not wish other members of the
'vtape' group to have access to virtual tape files. Files that were created while this
option was set will continue to be accessible by all members of the 'vtape' group
unless the file permissions are manually changed by the administrator.
DLm881I
OtherAccess set to 'R'
Description: By default, virtual tape files are only accessible by the 'vtape' user. This
message signifies that this controller is currently configured to allow any user to have
Read access to the virtual tape files created by this node.
System Action: All tapes created while this option is set will have global accessibility.
User Action: Reconfigure this controller if you do not wish everyone to have access to
virtual tape files. Files that were created while this option was set will continue to be
accessible by anyone unless the file permissions are manually changed by the
administrator.
DLm882I
Disk usage warning percent changed from nn% to nn%
Description: The operator SET WARNING= command was accepted.
System Action: The new disk usage warning value takes effect immediately.
User Action: None.
DLm883I
/var usage warning percent changed from nn% to nn%
Description: The operator SET VARWARNING= command was accepted. The
VarWarning value is the percentage of usage of the /var filesystem at which point the
system will begin warning that /var space utilization is high.
System Action: The new disk usage warning value takes effect immediately.
User Action: None.
DLm884I
Disk space RECOVERAMT changed from nn% to nn%
Description: The operator SET RECOVERAMT= command was accepted.
System Action: The new disk space recovery amount takes effect immediately.
User Action: None.
DLm885E
EXIT[!] and RESTART[!] are no longer supported.
Description: These commands are no longer supported.
System Action: The command is ignored.
User Action: To start/stop the VT service, use the command 'vtd' at an operating
system prompt.
DLm886I
Disk space RECOVER percent changed to nn%
Description: The operator SET RECOVER= command was accepted.
System Action: The new disk space recovery threshold takes effect immediately.
User Action: None.
DLm887I
Channel adapter <n> serial number override set to <xxxxxxxxxxxx>
Description: The operator SET SNn= command was accepted.
System Action: The hardware serial number reported by the system to the Host for
channel adapter <n> has been set to the specified override value. If <xxxxxxxxxxxx> is
blank, the override has been removed and the controller will report the actual
hardware serial number once again.
User Action: None. Use the SET SNn= command to remove the override.
DLm888W
Warning: New serial number contains lower case letters!
Description: The operator SET SNn= command was accepted, but the serial number
specified contained one or more lower case alphabetic characters.
System Action: The specified serial number is accepted, and will be reported to the
Host EXACTLY as you specified.
User Action: None, unless you really meant to type uppercase letters in the serial
number. In that case, enter the command again with the proper value.
DLm889E
Encryption key n is not available
Description: The specified encryption key is not installed on this system.
System Action: The ENCRYPTKEY value is not changed from the previous setting.
User Action: Specify a valid, installed key in the SET ENCRYPTKEY command.
DLm890E
Help has no additional information for 'something'
Description: The virtual tape application command 'HELP something' was entered, but
'something' is not a valid virtual tape application command or message number.
System Action: The command is ignored.
User Action: Use the 'Help' command alone to see a summary of the virtual tape
application commands available.
DLm891E
Invalid command syntax
Description: The preceding operator command was invalid.
System Action: The command is ignored.
User Action: Use the 'Help' command to see the proper command syntax.
DLm892I
Write Sync set to <nnnnnn> bytes
Description: The virtual tape application has been configured to sync (flush) data
written by the host to disk storage every <nnnnnn> bytes. This message is displayed
whenever the option is changed, and in response to the QUERY ALL command.
System Action: The virtual tape application will flush the data to disk storage every
<nnnnnn> bytes (in addition to any syncs requested by the host). No extra syncs will be
performed the <nnnnnn> value is 0.
User Action: For best performance, this option should be left at the default value.
DLm893E
<feature> feature not yet supported
Description: The preceding operator command used a virtual tape application feature
that is not supported.
System Action: The command is ignored.
User Action: Use the 'Help' command to see the proper command syntax.
DLm894I
PenaltyUp/PenaltyDown value changed from <nn> to <nn>
Description: The operator SET PENALTYUP= or PENALTYDOWN= command was
accepted. The PenaltyUp value is used to decrease the chance that a filesystem will be
selected for the next scratch mount; it is applied every time a filesystem is selected
for a scratch mount. PenaltyDown is used to reduce the penalty every time a
filesystem is NOT selected for a scratch mount.
System Action: The new penalty value takes effect immediately.
User Action: None.
DLm895E
CLASS/DIR parameter is only valid on an EFS system
Description: The operator INITIALIZE command specified a CLASS or DIR parameter
but this system is not configured for Enhanced File System (EFS). CLASS and DIR are
only valid on EFS systems.
System Action: The INITIALIZE command is rejected.
User Action: Enter the INITIALIZE command without a CLASS and/or DIR parameter.
DLm896I
/var usage debugging limit changed from <nn> to <nn>
Description: The operator SET VARDEBUGLIMIT= command was accepted. The
VarDebugLimit is the number of bytes remaining on the /var filesystem at which point
the system will automatically turn off any debugging mode that generates console
messages which go to /var.
System Action: The new threshold takes effect immediately.
User Action: None.
DLm897E
Unexpected keyword parameter n 'keyword=value'
Description: Syntax error on an operator 'Load' command.
System Action: The command is ignored.
User Action: Use the 'Help' command to see the proper command syntax.
DLm898E
Unknown parameter n 'something'
Description: Syntax error on an operator command.
System Action: The command is ignored.
User Action: Use the 'Help' command to see the proper command syntax.
DLm899I
<Thread> has been in state: <thread state> for <time> seconds
Description: The specified task has been in the specified state an unexpectedly long
time. This most likely means that the task is "stuck" on some operation.
System Action: When the task is no longer in this state, message DLm900I will be
displayed.
User Action: If these messages occur frequently, or the task does not transition back
to normal, contact EMC Support for assistance.
DLm900I
<Thread> transitioned state
Description: The specified task was previously reported to be in a single state for an
unusually long time (see DLm899I). This message is displayed when the task is no
longer in that state.
System Action: None.
User Action: None.
DLm901E
Error reading Keyboard Data: <error message>
Description: An I/O error has occurred while reading a command from the keyboard.
DLm902E
Zero Bytes read from Keyboard
Description: An I/O error has occurred while reading a command from the keyboard.
System Action: The virtual tape application terminates.
User Action: Contact EMC Support for assistance.
DLm908E
Error formatting message for SNMP trap: error message
Description: An error has occurred while formatting a message before evaluation by
the SNMP agent.
System Action: The message will be sent to the SNMP agent as is, but might not be
perfectly formatted.
User Action: Contact EMC Support for assistance.
DLm910W
Device <devicename> <deliberate error message>
Description: This message immediately precedes a deliberate error performed by the
virtual tape application, caused by setting a debugging mode for testing purposes.
System Action: A deliberate error of some kind will follow this message.
User Action: None. Don't be surprised by the error that follows. If you get this message
unexpectedly, contact EMC Support for assistance.
DLm911W
Device <devicename> <deliberate error message>
Description: This message immediately precedes a deliberate error performed by the
virtual tape application, caused by setting a debugging mode for testing purposes.
System Action: A deliberate error of some kind will follow this message.
User Action: None. Don't be surprised by the error that follows. If you get this message
unexpectedly, contact EMC Support for assistance.
DLm912W
Device <devicename> <deliberate error message>
Description: This message immediately precedes a deliberate error performed by the
virtual tape application, caused by setting a debugging mode for testing purposes.
System Action: A deliberate error of some kind will follow this message.
User Action: None. Don't be surprised by the error that follows. If you get this message
unexpectedly, contact EMC Support for assistance.
DLm920E
Device <devicename> volume <volser> overwriting of VOL1 label blocked
Description: The virtual tape application prevented overwriting of this tape's VOL1
label with data, because the ProtectVOL1 feature is currently enabled.
System Action: The host write command is rejected with a unit check, with command
reject sense.
User Action: The ProtectVOL1 feature can be disabled by entering the command "SET
ProtectVOL1=OFF"; when off, it can be re-enabled with"SET ProtectVOL1=ON".
DLm921I
Set ProtectVol1=OFF to enable VOL1 overwrites
Description: This message follows DLm920E as a reminder that the ProtectVOL1
feature can be turned off if overwriting a VOL1 label with data is desired.
System Action: None.
User Action: The ProtectVOL1 feature can be disabled by entering the command "SET
ProtectVOL1=OFF"; when off, it can be re-enabled with "SET ProtectVOL1=ON".
DLm930I
Device <devicename> in contingent allegiance to <pathinfo> for <time> seconds
Description: A "contingent allegiance" is established between a device and the host
from the time any unit check is presented to the host until the host performs a sense
or other I/O operation to this device, or a selective reset or a system reset to this
device, on the same channel path. Until the allegiance is cleared, this device will
remain busy and will be unavailable for I/O on all other channel paths. This
informational message will be displayed if a device remains in this type of contingent
busy condition for an inordinate amount of time.
System Action: Until the host clears the contingent allegiance on the specified path,
no I/O can be performed on this device.
User Action: If these messages occur frequently, or the drive does not transition back
to normal, contact EMC Support for assistance.
DLm940I
Device <devicename> Volume <volser> accommodated old-style AMDD DSS block
#nnnnnn
Description: Earlier virtual tape application releases could write incorrect metadata in
a virtual tape block under certain specific rare conditions. Subsequent reading of such
a block would result in a DLm341E CRC error message and return an error to the host.
Later releases, including this one, automatically recover from this metadata error
without returning an I/O error to the host. This message is displayed strictly for
informational purposes.
System Action: None.
User Action: None.
DLm950I
Message from Host
Description: A Host program has sent this message to be displayed on the virtual tape
application console.
System Action: None.
User Action: None.
DLm951I
Message from another program
Description: An external program has sent this message to be displayed on the virtual
tape application console.
System Action: None.
User Action: None.
DLm952E
Unable to get hostname: <error message>
Description: The application was unable to get the hostname of the system.
System Action: The DLm application terminates.
User Action: Verify that the hostname of the system is set correctly. Contact EMC
Support for assistance.
DLm953I
Locking with .lk lock files turned ON/OFF
Description: By default, .lk lock files are used to lock virtual tape files against
concurrent usage by any other node. The application can be configured to not use .lk
lock files at any time.
System Action: If OFF, no .lk lock files will be used to lock virtual tape files. If Virtuent
is configured to not use NLM locking for NFS filesystems (see message DLm957I, or
Virtuent is configured to use NLM locking but the tape library filesystem is mounted
with NLM file locking disabled (-o nolock), there will be NO locking of the virtual tape
files while they are in use, and corruption may occur if another system uses the same
files at the same time.
User Action: Turning off the .lk lock files feature is NOT recommended. Contact EMC
Support for more information before turning off .lk lock file locking.
DLm957I
Locking with NLM lock manager turned ON/OFF
Description: By default, virtual tape files on Celerra NFS filesystems are locked against
concurrent usage by other nodes by using the Network Lock Manager (NLM) protocol
(and .lk lock files for all other filesystems). The application can be configured to not
use NLM and to instead use .lk lock files for virtual tapes on all types of filesystems.
System Action: If NLM locking is turned OFF, all locking of virtual tape files is
performed with .lk lock files. If NLM locking is turned ON, files on Celerra NFS
filesystems are locked with NLM, and with .lk files on all other types of filesystems.
User Action: Contact EMC Support for more information before changing file locking.
DLm963I
Locking of Celerra files with .lk lock files turned ON/OFF
Description: By default, .lk lock files are used to lock virtual tape files against
concurrent usage by any other node. The application can be configured to not use .lk
lock files for files that reside on Celerra filesystems.
System Action: If OFF, no .lk lock files will be used to lock virtual tape files that reside
on Celerra filesystems. If Virtuent is configured to not use NLM locking for Celerra
filesystems (see message DLm957I) or Virtuent is configured to use NLM locking but
the Celerra filesystem is mounted with NLM file locking disabled (-o nolock), there will
be NO locking of the virtual tape files while they are in use, and corruption may occur
if another system uses the same files at the same time.
User Action: Turning off the .lk lock files feature for Celerra filesystems is NOT
recommended. Contact EMC Support for more information before turning off .lk lock
file locking for Celerra filesystems.
DLm970I
FTIDC Parameter Set ON/OFF
Description: The controller has been configured for FTIDC.
System Action: When set ON, the system will not check if a different VOL1 label
volume serial number is being written on writes.
User Action: None.
DLm971E
Error closing input/output fifo: <filename>
Description: The virtual tape application received an error while closing the specified
file. This error can only happen during program termination.
System Action: Shutdown continues.
User Action: If this problem recurs, contact EMC Support for assistance.
DLm972E
Error deleting input/output fifo: <filename>
Description: The virtual tape application received an error while closing the specified
file. This error can only happen during program termination.
System Action: Shutdown continues.
User Action: If this problem recurs, contact EMC Support for assistance.
DLm975I
Diagnostic data written to file '<file>' (<num> bytes)
Description: The diagnostic data was written to <file>
System Action: None.
User Action: None.
DLm976E
Error writing diagnostic data dump file '<file>': open error <error detail>
Description: The diagnostic data could not be written to <file>.
System Action: None.
User Action: If this problem recurs, contact EMC Support for assistance.
DLm979E
Error writing diagnostic data dump file '<file>': open error <error detail>
Description: The diagnostic data could not be written to <file>.
System Action: None.
User Action: If this problem recurs, contact EMC Support for assistance.
DLm980E
Program Check error in thread nnnn (processname), state=XXXXXXXX
Description: An internal program error has occurred.
System Action: The virtual tape application attempts to shut down all virtual devices.
All devices are taken offline to the Host, and the virtual tape application terminates.
User Action: Contact EMC Support for assistance.
DLm981E
Program Check type 'error type'
Description: An internal program error has occurred.
System Action: The virtual tape application will terminate.
User Action: Contact EMC Support for assistance.
DLm990I
Shutting down this application...
Description: The virtual tape application is terminating.
System Action: The virtual tape application terminates.
User Action: None.
DLm991E
Error shutting down device <devicename>
Description: An error occurred while attempting to shut down a virtual device.
System Action: Shutdown continues.
User Action: Contact EMC Support for assistance.
DLm992W
<n> [RUN processes running | volumes mounted]; use vtd force to shutdown
Description: The 'vtd stop' command was entered while one or more virtual tape
drives had a volume mounted, and/or one or more RUN processes were running.
System Action: The 'vtd stop' command is ignored.
User Action: Before shutting down, wait for all Host applications to finish and unload
their tapes, and for all userscripts being executed by RUN commands to complete. If
for some reason the Host cannot unload all of the virtual tape devices, manually
unload all virtual tape volumes with the virtual tape application 'UNLOAD' command.
If, for some other reason, the 'UNLOAD' command cannot unload all the virtual tape
devices, or userscripts being executed with the RUN command will not terminate, the
'vtd force' command will force a shutdown even while tapes are mounted or
userscripts are running.
DLm994E
Required service <service name> failed, unrecoverable <error detail>
Description: A required system service has failed and is unrecoverable.
System Action: None.
User Action: Determine why the service has failed and correct it. For more assistance,
contact EMC Support.
DLm995E
SCSI Error Detected
Description: A SCSI Error has been reported in the /var/log/messages file.
System Action: None.
User Action: Determine why the SCSI Error occurred and correct it. For more
assistance, contact EMC Support.
DLm996E
NFS Server Timeout Detected
Description: An NFS server timeout has been reported in the /var/log/messages file.
System Action: None.
User Action: Determine why the NFS server timeout occurred and correct it. For more
assistance, contact EMC Support.
DLm997E
NMI Detected
Description: A NMI has been reported in the /var/log/messages file.
System Action: None.
User Action: Determine why the NMI occurred and correct it.For more assistance,
contact EMC Support.
DLm999E
Terminating app
Description: The application is terminating because of some kind of fatal startup
error.
System Action: The application terminates.
User Action: Review any preceding message(s) to determine the cause of the problem.
For more assistance, contact EMC Support.
Mgmt001E
ACP1 is not directly accessible from the base Celerra primary
Control Station.
Mgmt002E
ACP2 is not directly accessible from the base Celerra primary
Control Station.
EMCvts messages
EMCvts is the script that starts the DLm application. The following messages may be
displayed by EMCvts while starting the DLm application.
The script has determined that the firmware on the channel adapter card (xxxx) is
actually newer than the firmware file found on the system disk (yyyy). The adapter
firmware not be changed.
The script has determined that the firmware on the channel adapter card (xxxx)
should be updated to a newer version found on the system disk (yyyy), and is doing
so.
The script has determined that there is no need to update the firmware on the channel
adapter card.
Note: The Help command does not support z/OS system messages.
DLMCMD messages
The following messages can be returned by the DLMCMD program running on the
mainframe.
DLC010I
I/O ERROR ON CTRL DEVICE: CSW=XXXX SENSE=XX
An I/O error occurred on the DLMCMD control tape. See the CSW and SENSE
information and any additional messages on the z/OS and controller consoles to
resolve the problem.
DLC040I
CONTROL PATH FAILED TO OPEN
DLMCMD was unable to open the DLMCTRL control tape. Check the JCL and any
additional messages on the joblog to resolve the problem.
DLC050I
LOG FILE FAILED TO OPEN
DLMCMD was unable to open the DLMLOG log file. Check the JCL and any additional
messages on the joblog to resolve the problem.
DLC060I
COMMAND FILE FAILED TO OPEN
DLMCMD was unable to open the input DLMCMD file. Check the JCL and any
additional messages on the joblog to resolve the problem.
DLC070I
ENTER COMMAND
The PARM=WTOR parameter told DLMCMD to read input from the console. Type a
command to send to the controller, or END to terminate DLMCMD.
DLMHOST messages
The following messages may be issued by the z/OS started task DLMHOST:
DLH000I
COMMANDS ARE:
STARTLOG,N=nodename/ALL
STOPLOG,N=nodename/ALL
STARTCMD,N=nodename/ALL
STOPCMD,N=nodename/ALL
N=nodename/ALL,C=command
HELP
STATUS
DLH001I
jobname ENTER COMMAND, EOJ, OR ? FOR HELP
If the WTOR option is used, this is issued as the outstanding WTOR that the operator
can reply to.
DLH002I
jobname USE MODIFY TO ENTER COMMAND, EOJ OR ? FOR HELP
If the NOWTOR option is specified, this message indicates to the operator that the
MODIFY command is available to issue requests.
DLH003I
ENDING BY OPERATOR REQUEST
DLH010I
I/O ERROR ON DEVICE XXXX: CSW=XXXX SENSE=XX
An error occurred on one of the control paths. Appropriate CSW and sense data are
provided. The control path will be marked as inactive.
DLH030I
CONFIG FILE FAILED TO OPEN
DLH035I
CONFIG FILE HAS NO ENTRIES
An end of file was detected on the configuration file without any entries being
processed.
DLH040I
CONFIG FILE INVALID RECFM
DLH050I
LOG FILE FAILED TO OPEN
DLH055I
INPUT COMMAND FILE FAILED TO OPEN -IGNORING DOCMDS PARM
If the DOCMDS parameter is used, the DLMCMD DD card is missing or file failed to
open.
DLH060I
CANNOT START - PROGRAM ALREADY ACTIVE
Only one copy of DLMHOST is allowed to run at a time. This can be overridden by
specifying parameter NOENQ
DLH150I
INVALID DEV SPECIFIED
DLH160I
DEVICE NOT FOUND DURING UCBLOOK
The DEV= parameter is specified, but the device does not exist in the current
configuration.
DLH170I
ERROR DURING UCB CAPTURE/UNCAPTURE
DLH180I
DRIVE xxxx IS ALREADY ALLOCATED or BOXED
DLH181I
DRIVE xxxx HAS NO OPERATIONAL PATHS
DLH182I
WARNING – DRIVE xxxxx IS ONLINE. SHOULD BE OFFLINE WHEN USING DEV=
The control drive being used should be an offline device. Results are unpredictable if
an online device is used.
DLH190I
DEBCHK FAILED
An error was detected while creating the device control blocks to access the device.
DLH200I
NODENAME NOT FOUND IN CONFIG TABLE
The nodename specified in a command/modify request does not exist in the config
table. Use the STATUS command to list the available nodenames.
DLH210I
INVALID DEVICE xxxx IN CONFIG TABLE
DLH220I
NODENAME NOT SPECIFIED IN COMMAND
A command was entered, and did not contain a nodename as the target of the
command
DLH230I
NO COMMAND FOUND IN RESPONSE
DLH240I
NODENAME CMDDEV LOGDEV CONSNAME
This will be followed by one line showing the status for each node, path and console
assignment.
◆ NODENAME is the name assigned in the config table.
◆ CMDDEV shows the device (if any) assigned as the command
◆ path. A y/n indicates if it is currently active.
◆ LOGDEV shows the device (if any) assigned as the log path. A
◆ y/n indicates if it is currently active.
◆ CONSNAME shows the console name (if any) assigned to receive
DLH250I
NODE nodename PATH xxxx INACTIVE
DLH260I
PROCESSING COMMAND: command line
The DOCMDS parameter was used. This lists each command processed from the
DLMCMD file as it is being processed.
DLMLIB message
The following message can be returned by the DLMLIB program running on the
mainframe.
DLL100I
INVALID VOLSER xxxxxx SPECIFIED
An invalid volser was specified in the input file. Correct the input and rerun.
DLMSCR messages
The following messages can be returned by the DLMSCR program running on the
mainframe.
DLS010I
I/O ERROR ON CTRL DEVICE: CSW=XXXX SENSE=XX
The control tape that sends scratch requests to the controller had an I/O error. Check
to make sure the controller is still running. If this is the case use the CSW and SENSE
provided to correct the problem.
DLS012I
UNEXPECTED HEADER IN SCRATCH REPORT
While processing the scratch report DLMSCR found a header it not expecting. First
make sure that the TYPE parameter is correct for the scratch report you are running. If
so make sure the scratch report is of the correct format.
DLS020I
NO VALID SCRATCH REQUESTS PROCESSED
DLMSCR processed the entire scratch report and found no valid scratch requests. First
check the PREFIX and PREFIXLN parameters to make sure they correctly match the tape
prefixes used on the VTE controller. If they are correct make sure that the scratch
report contains tapes with those prefixes.
DLS030I
INPUT SCRATCH REPORT FAILED TO OPEN
The DLMSCR input scratch report failed to open. Check the DD statement for the
DLMSCR input file and make sure it refers to a valid scratch report file.
DLS031I
INPUT SCRATCH REPORT NOT RECFM=F OR FB
The scratch report, which is created by the customer's TMS, must have a LRECL of 133
and a RECFM of F or FB.
DLS040I
CONTROL PATH FAILED TO OPEN
The DLMSCR control tape failed to open. Make sure the controller is up and running
and the unit address used for the DLMSCR control tape is a valid controller device and
has been varied online to the mainframe.
DLS050I
LOG FILE FAILED TO OPEN
DLMSCR maintains a log file with all the error and informational messages from any
DLMSCR runs. Check the mainframe job log to determine why it did not open properly.
DLS060I
SORTIN FILE FALED TO OPEN
DLMSCR requires a sortin file when processing a Tivoli Storage Manager (TSM) report.
DLS070I
INPUT FILE IS NOT A NEW SCRATCH REPORT
DLMSCR requires the date on the Scratch Report that is created by the customer's TMS
to be today's date. This is to prevent the inadvertent use of an old scratch report. Run
a new scratch report.
DLS080I
This is a request to free space from scratch tapes. Reply YES to
continue
DLMSCR requests operator intervention before it frees space from scratched tapes.
This is because after space is freed the data on scratched tape cannot be retrieved.
DLS080I
Did not receive a response of yes, scratched tapes will not be
erased.
DLS081I
FREExxxxx NOT ALLOWED WITH TYPE RMMDV
DLS100I
NO INPUT PARAMETERS FOUND
DLMSCR requires at least the TYPE= parameter be configured. Check the format of
your input parameters.
DLS110I
NO type FOUND IN INPUT PARAMETERS
DLS111I
UNKNOWN type FOUND IN INPUT PARMS
DLMSCR has found an incorrect TYPE= parameter. Check your input parameters.
DLS120I
Freespace not confirmed - terminating
DLS130I
PREFIX LENGTH INVALID
The default for the PREFIXLN is 2. In most cases the customer using 2 for their prefix
length. If the tape library resides on Centera a prefix length of 1 is common. In that
case PREFIXLN=1 should be coded. Check your input parameters.
DLS140I
SORT FAILED
The internal sort performed on a Tivoli Storage Manager (TSM) report failed. See the
preceding console messages for the reason.
DLS150I
INVALID DEV SPECIFIED
The parameter specified in the DEV= field is < 3 or >4 characters, or contains
non-hexadecimal characters
DLS160I
DEVICE NOT FOUND DURING UCBLOOK
The device specified on the DEV= parameter was not found in the active
configuration. Correct the parameter and retry.
DLS170I
ERROR DURING UCB CAPTURE/UNCAPTURE
DLS180I
DRIVE IS ALREADY ALLOCATED or BOXED
The device specified on the DEV= parameter is either already in use or is boxed and
cannot be used. Select a different drive and retry the job.
DLS181I
DRIVE HAS NO ONLINE PATHS
The device specified on the DEV= parameter has no online paths available. Select a
different drive and retry the job.
DLS190I
DEBCHK FAILED
An internal DEBCHK macro returned a non-zero return code. Contact EMC Customer
Support.
DLMVER messages
DLV010I
UTILITY VERSIONS (<z/os release level>):
This message is written to the file pointed to by the DLMLOG DD card, or to the
operator if the WTO parm is used. The execution environment’s z/os release level is
displayed within parentheses. The release levels of the other DLm utilities follow the
DLV010I header line.
DLV050I
LOG FILE FAILED TO OPEN
The file that the DLMLOG DD card points to failed to open, or no DLMLOG DD card was
present. Check the JOBLOG and JCL for the reason, and resubmit the job. If no logfile is
required, use parm=’WTO’ to send the result to the operator instead of the logfile.
Healthcheck messages
This section lists the healthcheck messages generated on the DLm system.
DLmT00E
ACP Failed to Respond to System Health Check Request.
DLmT01E
ACP is operating in degraded mode. Unknown error.
DLmT02E
FLR File System Status Check Failed.
DLmT03E
SSH Keys Check Failed.
DLmT04E
NFS Mounts Status Check Failed.
DLmT05E
DLm ACP Required Services Status Check Failed.
DLmT06E
GR Status Check on Celerra Failed.
DLmT07E
VNX Capacity Check Failed.
DLmT10E
VTE Failed to Respond to System Health Check Request.
DLmT11E
VTE is operating in degraded mode. Unknown error.
DLmT12E
DLm VTE Required Services Status Check Failed.
DLmT13E
DLm VTE Required Drives Status Check Failed.
DLmT14E
GR Status Check on VTE Failed.
DLmT15E
Data Mover Connection Check Failed.
DLmT20E
One GB Management Switch is not Responsive.
DLmT21E
One GB Management Switch Status Check Failed.
DLmT22E
All One-GbE Management Switche(s) are not Responsive.
DLmT23E
One-GbE Management Switch Connection Check Failed.
DLmT30E
Ten GB Data Switch is not Responsive.
DLmT31E
Ten GB Data Switch Status Check Failed.
DLmT32E
All Ten-GbE Data Switche(s) are not Responsive.
DLmT33E
Ten_GbE Data Switch Connection Check Failed.
DLmT40E
Data Domain System is not Responsive.
DLmT41E
Data Domain System Status Check Failed.
DLmT42E
All Data Domain System(s) are not Responsive.
DLmT43E
DD Management Path Connection Check Failed.
DLmT44E
DD Data Path Connection Check Failed.
DLmT45E
DD Capacity Check Failed.
DLmT50E
Celerra System is not Responsive.
DLmT51E
Celerra System Status Check Failed.
DLmT52E
All VNX system(s) are not Responsive.
DLmT53E
VNX System Connection Check Failed.
DLmT98E
Unexpected Error.
I V
indicators VTE
FICON 26 configuring virtual device 79
controls and indicators 20
power down 64
L
Library utility, awsprint 106
Z
z/OS
M
compaction of the virtual tape data 123
message
configuring the devices 116
class 192
Load display message 176
DLm system 193
Missing Interrupt Handler 122
DLMCMD 366
operator command 122
DLMLIB 371
utilities 124
DLMSCR 371
EMC DLm 192
EMCvts 364
format 192
Format Control Byte 176
number 192
z/OS system 366
P
password
system 55
power down
ACP 68
VTE 64
Powerlink website 13
T
Tape
direct 99
export command 150
export/import utilities 102