Bull DPS 7000 User manual

File and Volume Management
Bull DPS 7000
User’s Guide
Cartridge Tape Library UNIX Server
47 A2 63UU Rev05

47 A2 63UU Rev05
File and Volume Management
Bull DPS 7000
User’s Guide
Cartridge Tape Library UNIX Server
Subject: Cartridge Tape Library (CTL) UNIX server is an automated
storage and retrieval system for magnetic tape cartridges.
Special Instructions: This Revision 05 cancels and replaces Revision 04.
Software Supported: GCOS 7 HPS/EXMS Releases V7, V8, V9 and V10
Software/Hardware required: OPEN7 on native DPS7000, V7000 on DPS7000-XTA
Date: August 2001
Bull S.A.
CEDOC
Atelier de reprographie
357, Avenue Patton BP 20845
49008 ANGERS Cedex 01
FRANCE
Bull HN Information Systems Inc.
Publication Order Entry
FAX: [phone]
MA30/415
300 Concord Rd.
Billerica, MA 01821
U.S.A.

47 A2 63UU Rev05
Copyright © Bull S.A., 1994, 1996, 1998, 1999, 2001
Bull acknowledges the rights of proprietors of trademarks mentioned herein.
Your suggestions and criticisms concerning the form, contents and presentation of this manual are invited.
A form is provided at the end of this manual for this purpose.
No part of this publication may be reproduced, stored in a retrieval system or transmitted in any form or by any
means, electronic, mechanical or otherwise without the prior written permission of the publisher.
Bull disclaims the implied warranties of merchantability and fitness for a particular purpose and makes no
express warranties except as may be stated in its written agreement with and for its customer. In no event is Bull
liable to anyone for any indirect, special, or consequential damages.
The information and specifications in this document are subject to change without notice.
Consult your Bull Marketing Representative for product or service availability.

47 A2 63UU Rev05 iii
Preface
The Cartridge Tape Library UNIX Server User’s Guide provides necessary
information to DPS 7000 users using cartridge tape libraries connected to the
DPS 7000 through a UNIXserver. It describes the hardware and software
components of the Cartridge Tape Library (CTL), including the Library Storage
Module (LSM),ACS Library Manager (LM), the library server (DPX/20 or
ESTRELLA running theACSLS) and the CLX (DPS 7000 software responsible for
the interface with the library server). It gives information on how to install and
configure the CLX on the DPS 7000. It gives advice on efficient use of the library,
and the correct responses to error conditions and messages.
This document is available for native DPS7000 (ARTEMIS,AURIGA, VEGA)
and for the new DPS7000-XTA architecture. The new specifications for the
XTA DPS7000 architecture are mention by “XTA case” notes.
The Cartridge Tape Library UNIX Server User’s Guide is intended for developers,
operators, software support personnel, and System Administrators using the
Cartridge Tape Library connected to the DPS 7000 through a UNIX server. It is
assumed that the reader has knowledge of the ACSLS library server and GCOS 7.
Section 1 provides an overview of the Cartridge Tape Library
service.
Section 2 explains how to set up the cartridge tape library. It
provides information about installation, configuration
of the CLX, ACSLS and GCOS 7 configuration.
Section 3 describes how to start the software including
initializing and starting up theACSLS and CLX.
Section 4 describes how to label the cartridges and how to enter
cartridges in the library.
Section 5 describes operation procedures for the CTL.
Section 6 describes the CLX commands available to an operator
through an IOF terminal.
Section 7 provides information on sharing the library among
several systems.
Scope and
Objectives
XTA case
Intended
Readers
Structure

Cartridge Tape Library UNIX Server User’s Guide
iv 47 A2 63UU Rev05
Section 8 discusses error conditions, including system reaction
and recommended user action, and lists the messages
associated with these errors.
Section 9 discusses error detection and recovery.
Section 10 describes the operator messages.
Section 11 provides information about Return status.
This document is completed by five appendices, a glossary and an index.
Appendix A presents CLX command syntax. Appendix B describes what to supply
to Bull in problem situations. Appendix C describes the CLX.SLLIB library
content. Appendix D lists the GCOS 7 messages not already described. Appendix E
discusses the PREPARE_TAPESET utility.
Bull Documents
CNS7 A2 NGL Reference Manual.......................................................... 39 A2 32DN
CNS7 System Generation CNS A1......................................................... 39 A2 40DM
DNS System Generation DNS C1.......................................................... 39 A2 84DM
DNS V4 System Generation................................................................... 39 A2 22DN
Data Management Utilities User’s Guide............................................... 47 A2 26UF
Full Screen Editor User’s Guide............................................................. 47 A2 06UP
GCOS 7 System Installation Configuration and Updating Guide V8......47 A2 19US
GCOS 7 System Installation Configuration and Updating Guide V9......47 A2 23US
JCL User’s Guide.................................................................................... 47 A2 12UJ
Library Maintenance Reference Manual................................................ 47 A2 01UP
Library Maintenance User’s Guide ........................................................ 47 A2 02UP
Console Messages Directory................................................................. 47 A2 61UU
System Operator’s Guide V8and V9 ....................................................... 47 A2 53US
Text Editor User’s Guide......................................................................... 47 A2 05UP
Operator’s Guide CTS, ACS, TCU......................................................... 77 A1 92UU
UFT User’s Guide................................................................................... 47 A2 13UC
Interoperability Software Installation 7 Administrator’s Guide............. 47 A2 56UU
Interop7 users Guide ...........................................................................47 A2 91 US
StorageTek 4400Automated Cartridge System Documents
ACSLS AIX6000 Configuration Guide
ACSLS AIX6000 Library Control System Installation Guide
ACSLS System Administrator’s Guide
ACSLS Programmer’s Guide
These documents are delivered with the DPX/20 or ESTRELLAserver and the
ACSLS software package.
Bibliography
XTA case

47 A2 63UU Rev05 v
Table of Contents
1. Overview ....................................................................................................... 1-1
1.1 The Control Path Components........................................................................................1-3
1.2 The Data Path Components............................................................................................1-5
1.3 The Cartridge Tape Libraries..........................................................................................1-7
1.3.1 StorageTek Cartridge Tape Library.................................................................1-7
1.4 The Library Server.........................................................................................................1-10
1.5 The Host System...........................................................................................................1-14
1.5.1 GCOS 7 and the CLX Software.....................................................................1-15
1.6 Configurations Supported .............................................................................................1-17
1.6.1 ACS Mono-LSM Configuration ......................................................................1-17
1.6.2 Mono-ACS Multi-LSM Configuration..............................................................1-18
1.6.3 Mono-ACS Multi-Host Configuration..............................................................1-19
2. Setting Up Your CTL on the DPS 7000........................................................ 2-1
2.1 Prerequisites ...................................................................................................................2-1
2.2 Installation of CLX...........................................................................................................2-2
2.2.1 Installation of CLX on GCOS 7........................................................................2-2
2.2.2 Installation/Configuration of SSI ......................................................................2-3
2.3 Installation Procedure .....................................................................................................2-4
2.3.1 Installation Procedure of CLX..........................................................................2-4
2.3.2 Installation procedure of CLX for DPS 7000-XTA ...........................................2-7
2.4 Configuration.................................................................................................................2-17
2.4.1 UNIX Library Server Configuration................................................................2-18
2.4.2 System Configuration ....................................................................................2-18
2.4.3 CLX Configuration on GCOS 7......................................................................2-19
2.4.4 SSI Configuration under OPEN7...................................................................2-30
2.4.5 SSI Configuration on UNIX library server for DPS 7000-XTA.......................2-32

Cartridge Tape Library UNIX Server User’s Guide
vi 47 A2 63UU Rev05
2.5 Errors in Mount Processing...........................................................................................2-33
2.5.1 Volumes Not in the Library ............................................................................2-33
2.5.2 Volumes in Busy State...................................................................................2-33
2.5.3 Write Protected Work Volumes......................................................................2-34
2.5.4 Scratch Non-Work Volumes ..........................................................................2-34
2.5.5 CLX Log Files ................................................................................................2-35
2.5.6 Volume Access Rights...................................................................................2-36
2.5.7 Mixed Media / Mixed Format Support............................................................2-37
3. Starting the Software ................................................................................... 3-1
3.1 Starting The CLX Service................................................................................................3-1
3.1.1 ACSLS Initialization and Startup......................................................................3-1
3.1.2 Starting OPEN7 ...............................................................................................3-2
3.1.3 Starting SSI......................................................................................................3-2
3.1.4 Starting CLX.....................................................................................................3-3
3.1.5 CLX Initialization..............................................................................................3-4
3.2 Configuring Automatic Restarts ......................................................................................3-6
3.3 Messages Issued at ISL System Load............................................................................3-7
4. How to Enter a Cartridge ............................................................................. 4-1
4.1 Labeling the Cartridges...................................................................................................4-1
4.2 Label Consistency...........................................................................................................4-3
4.3 Write Protection...............................................................................................................4-4
4.4 Entering Cartridges into the Library ................................................................................4-5
4.4.1 Automatic Entry................................................................................................4-5
4.4.2 Manual Entry....................................................................................................4-5
5. Operating Your CTL...................................................................................... 5-1
5.1 Cleaning Cartridges.........................................................................................................5-1
5.2 User Application Information...........................................................................................5-2
5.2.1 Referring to Cartridge Library Volumes...........................................................5-2
5.2.2 Mounting Library Volumes...............................................................................5-3
5.2.3 Dismounting Library Volumes..........................................................................5-3
5.2.4 END, ABEND, and ENDVOL Parameters .......................................................5-5
5.2.5 Data Compaction.............................................................................................5-5
5.3 Volume Preparation.........................................................................................................5-7
5.3.1 How to Prepare a New Volume .......................................................................5-7
5.3.2 How to Prepare a Work Volume......................................................................5-7
5.3.3 Re-establishing Consistency of Labels............................................................5-8

47 A2 63UU Rev05 vii
5.3.4 How to Prepare a Large Number of Volumes..................................................5-8
5.4 DPS 7000 Response to Preparing a Work Volume........................................................5-9
5.5 What Happens When a Job Assigns / Deassigns a Standard Volume.........................5-10
5.6 Use of a Non-Standard Volume....................................................................................5-11
5.7 Use of Work Volumes ...................................................................................................5-12
5.8 What Happens When a Job Assigns a Work Volume...................................................5-14
5.9 Canceling a Request During Mounting.........................................................................5-14
6. Operator Commands.................................................................................... 6-1
6.1 Command Summary .......................................................................................................6-1
6.1.1 Summary of CLX Commands..........................................................................6-2
6.1.2 Summary of ACSSA Commands.....................................................................6-2
6.1.3 Summary of CLX Library Commands..............................................................6-4
6.1.4 Summary of Relevant Directives .....................................................................6-5
6.2 Operability Considerations..............................................................................................6-6
6.3 CLX Commands..............................................................................................................6-7
6.3.1 Addressing SSI for a DPS 7000-XTA..............................................................6-8
6.3.2 Starting SSI (SSSI)..........................................................................................6-8
6.3.3 Starting CLX (SCLX)........................................................................................6-9
6.3.4 Displaying Devices (DCLX) ...........................................................................6-10
6.3.5 Displaying the SSI Status (DSSI) ..................................................................6-14
6.3.6 Starting / Stopping the CLX Trace (MDCLX).................................................6-15
6.3.7 Terminating CLX (TCLX)...............................................................................6-19
6.3.8 Terminating SSI (TSSI)..................................................................................6-24
6.3.9 Resetting CLX Tables....................................................................................6-26
6.4 CLX Utilities...................................................................................................................6-28
6.4.1 Volume Report Utility (EXEC_CLX_VOLRPT - VOLRPT).............................6-28
6.4.2 File Transfer ( GET_CLX_FILE - GTCLXF)...................................................6-30
6.5 ACSSA Commands.......................................................................................................6-31
6.5.1 Audit...............................................................................................................6-33
6.5.2 Cancel............................................................................................................6-33
6.5.3 Clear ..............................................................................................................6-34
6.5.4 Define.............................................................................................................6-35
6.5.5 Delete.............................................................................................................6-36
6.5.6 Dismount........................................................................................................6-36
6.5.7 Eject...............................................................................................................6-37
6.5.8 Enter ..............................................................................................................6-38
6.5.9 Idle .................................................................................................................6-39
6.5.10 Lock ...............................................................................................................6-40

Cartridge Tape Library UNIX Server User’s Guide
viii 47 A2 63UU Rev05
6.5.11 Logoff.............................................................................................................6-41
6.5.12 Mount.............................................................................................................6-41
6.5.13 Query .............................................................................................................6-42
6.5.14 Set..................................................................................................................6-44
6.5.15 Show..............................................................................................................6-45
6.5.16 Start ...............................................................................................................6-46
6.5.17 Unlock............................................................................................................6-46
6.5.18 Vary................................................................................................................6-47
6.5.19 Venter ............................................................................................................6-48
6.6 LIBRARY Commands ...................................................................................................6-50
6.6.1 AUDIT_CARTRIDGE_LIBRARY (abbr. AUDLIB)..........................................6-51
CANCEL_LIB_REQUEST (abbr. CLIBR) .....................................................................6-55
6.6.2 DEFINE_SCRATCH_POOL (abbr. DFPOOL)...............................................6-56
6.6.3 DELETE_SCRATCH_POOL (abbr. DLPOOL)..............................................6-60
6.6.4 EJECT_LIB_VOLUMES (abbr. EJECT_VOLUMES, EJVOL).......................6-62
6.6.5 ENTER_LIB_VOLUMES (abbr. ENTER_VOLUMES, ENVOL).....................6-67
6.6.6 ENTER_UNLAB_VOLUMES (abbr. ENUVOL) .............................................6-71
6.6.7 EXTRACT_CLX_ERROR (abbr. EXTERR)...................................................6-73
6.6.8 QUERY_CARTRIDGE_LIBRARY (abbr. QLIB) ............................................6-76
6.6.9 SET_CAP_ATTRIBUTES (abbr. SETCAP)...................................................6-89
6.6.10 SET_CLEAN_ATTRIBUTE (abbr. SETCLN).................................................6-91
6.6.11 SET_SCRATCH_ATTRIBUTE (abbr. SETSCR)...........................................6-93
6.7 ACSSA Utilities..............................................................................................................6-96
6.8 Determining the Status of a Device...............................................................................6-97
6.8.1 How to Get a Device Current Status..............................................................6-97
6.8.2 Device Isolation..............................................................................................6-98
6.8.3 Reintroducing a Device..................................................................................6-98
6.9 Halting the Library Server (ACSLS)..............................................................................6-99
7. Static Sharing............................................................................................... 7-1
7.1 Sharing the Library Among Several Systems.................................................................7-1
7.1.1 Sharing of Cartridge Transports ......................................................................7-1
7.1.2 Sharing of Cartridge Volumes..........................................................................7-3
8. CLX Error Conditions................................................................................... 8-1
8.1 Introduction......................................................................................................................8-1
8.2 Errors During Initialization...............................................................................................8-2
8.2.1 Installation Errors.............................................................................................8-2
8.2.2 CLX Configuration Errors.................................................................................8-2
8.2.3 Error in CLX Job Submission...........................................................................8-3

47 A2 63UU Rev05 ix
8.2.4 GCOS 7 Environment Errors...........................................................................8-3
8.2.5 Device Status Resynchronization Errors.........................................................8-4
8.3 Errors During Operation..................................................................................................8-5
8.3.1 GCOS 7 Environment Errors...........................................................................8-5
8.3.2 Robot (LSM) Errors..........................................................................................8-5
8.3.3 Server or Telecommunication Failure..............................................................8-6
8.3.4 Errors During Preparation of WORK Volumes ................................................8-7
8.3.5 Volume Mounting Errors..................................................................................8-9
8.3.6 Work Volume Dismounting Errors .................................................................8-17
8.3.7 Volume Mounting/Dismounting Warning Messages......................................8-17
8.3.8 Errors Produced by System Limits ................................................................8-18
9. How to Detect and Recover from Failures ................................................. 9-1
9.1 GCOS 7 Crash................................................................................................................9-1
9.2 CLX Abort........................................................................................................................9-1
9.3 CANCEL_JOB CLX.........................................................................................................9-3
9.4 ACSLS Not Operational..................................................................................................9-4
9.5 Communication Link Failure (SSI - TNS - OPEN7 - HSL)..............................................9-7
9.6 Robot Failure.................................................................................................................9-10
9.7 CICC or PSI Failure.......................................................................................................9-11
9.8 Transport or Cartridge Failure.......................................................................................9-12
9.9 Operation In Degraded Mode........................................................................................9-13
9.9.1 Manual Mode.................................................................................................9-13
9.9.2 Semi-Automatic Mode ...................................................................................9-14
9.1.3 Device Status Inconsistency Between CLX Tables, GCOS 7, and ACSLS..9-19
9.10 CLX Resynchronization and Recovery .........................................................................9-23
10. CLX Operator Messages............................................................................ 10-1
10.1 TU00..............................................................................................................................10-1
10.1.1 TU00 <clx version> CLX FACILITY IS NOT AVAILABLE ON YOUR SITE ..10-1
10.1.2 TU00 <clx version> CLX CONFLICT WITH ANOTHER CARTRIDGE
LIBRARY COMPONENT (CLX OR CLC)......................................................10-1
10.2 TU01..............................................................................................................................10-2
10.2.1 TU01 <clx version> CLX INITIALIZATION IN PROGRESS..........................10-2
10.3 TU02..............................................................................................................................10-2
10.3.1 TU02 <clx version> CLX WAITING FOR ACSLM TO BE RUNNING ...........10-2
10.4 TU03..............................................................................................................................10-3
10.4.1 TU03 <clx version> CLX IS RUNNING..........................................................10-3