Bull DPS 7000 User Manual

File and volume management cartridge tape library unix server
Hide thumbs Also See for DPS 7000:
Table of Contents

Advertisement

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

Advertisement

Table of Contents
loading

Summary of Contents for Bull DPS 7000

  • Page 1 File and Volume Management Bull DPS 7000 User’s Guide Cartridge Tape Library UNIX Server 47 A2 63UU Rev05...
  • Page 2 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. Bull HN Information Systems Inc. CEDOC Publication Order Entry Atelier de reprographie FAX: (800) 611-6030 357, Avenue Patton BP 20845...
  • Page 3 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.
  • Page 4 ESTRELLA running the ACSLS) 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.
  • Page 5 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.
  • Page 6: Table Of Contents

    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 47 A2 63UU Rev05...
  • Page 7 Cartridge Tape Library UNIX Server User’s Guide 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...................
  • Page 8 5.3.4 How to Prepare a Large Number of Volumes..........5-8 DPS 7000 Response to Preparing a Work Volume ............5-9 What Happens When a Job Assigns / Deassigns a Standard Volume......5-10 Use of a Non-Standard Volume ..................5-11 Use of Work Volumes ....................5-12 What Happens When a Job Assigns a Work Volume...........
  • Page 9 Cartridge Tape Library UNIX Server User’s Guide 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 LIBRARY Commands ....................
  • Page 10 8.2.4 GCOS 7 Environment Errors ................8-3 8.2.5 Device Status Resynchronization Errors ............8-4 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 ..................
  • Page 11 Cartridge Tape Library UNIX Server User’s Guide 10.5 TU04..........................10-3 10.5.1 TU04 <clx version> CLX WAITING FOR LSM TO BE ONLINE....10-3 10.6 TU05..........................10-4 10.6.1 TU05 <clx version> LSMs ARE ONLINE............10-4 10.6.2 TU05 <clx version> LSM <acs> <lsm> STATE: OFFLINE......10-4 10.6.3 TU05 <clx version>...
  • Page 12 10.17.3 TU17 <clx version> VERIFY JOB <ron> WHICH USES <volume> .... 10-14 10.18 TU18..........................10-14 10.18.1 TU18 <clx version> H_CLX CANNOT ACCESS THE SHARABLE MODULE: H_CTLIB ...................... 10-14 10.19 TU20..........................10-15 10.19.1 TU20 <clx version> CLX TABLE OF MESSAGES OVERFLOW ....10-15 10.20 TU21..........................
  • Page 13 Cartridge Tape Library UNIX Server User’s Guide 10.28 TU31..........................10-25 10.28.1 TU31 <clx version> CLX ATTEMPTS TO UNLOCK <volume> ....10-25 10.29 TU32..........................10-25 10.29.1 TU32 <clx version> CLX ATTEMPTS TO CANCEL MOUNT REQUEST OF <volume> ON <device> ................. 10-25 10.29.2 TU32 <clx version>...
  • Page 14 10.36 TU39..........................10-35 10.36.1 TU39 <clx version> DVMGT OUTSTANDING REQUEST ......10-35 10.37 TU50..........................10-35 10.37.1 TU50 <clx version> CLX INITIALIZATION FAILED: < ERRNB = error_number, return-code >........... 10-35 10.37.2 TU50 <clx version> CLX CONFIGURATION FILE ERROR: < ERRNB = error_number, return-code >........... 10-36 10.37.3 TU50 <clx version>...
  • Page 15 Cartridge Tape Library UNIX Server User’s Guide 10.37.22 TU50 <clx version> CLX CONFIGURATION FILE ERROR: INVALID VSN MODEL <vsn>..............10-46 10.37.23 TU50 <clx version> CLX CONFIGURATION FILE ERROR: INVALID LOG OPTION <param> ..............10-46 10.37.24 TU50 < version> CLX CONFIGURATION FILE ERROR: NO VALUE FOR MAXTOACSLM - DEFAULT VALUE IS ASSUMED..
  • Page 16 10.46 TU59..........................10-60 10.46.1 TU59 <clx version> ACSLM CANNOT FIND CARTRIDGE <volume> - AN AUDIT IS REQUIRED................10-60 10.47 TU60..........................10-60 10.47.1 TU60 <clx version> DISPLAY_CLX COMMAND REJECTED: <device> NOT IN LIBRARY................. 10-60 10.47.2 TU60 <clx version> DISPLAY_CLX COMMAND REJECTED: CLX NOT RUNNING..................
  • Page 17 Cartridge Tape Library UNIX Server User’s Guide 10.52 TU66..........................10-68 10.52.1 TU66 <clx version> VOLUME <volume> NOT IN LIBRARY: OPERATOR INTERVENTION REQUIRED..........10-68 10.52.2 TU66 <clx version> WORK VOLUME <volume> WRITE PROTECTED: EJECTION REQUIRED ................10-69 10.52.3 TU66 <clx version> VOLUME <volume> SCRATCH NO WORK: EJECTION OR PREPARE_TAPE REQUIRED...........
  • Page 18 10.54 TU71..........................10-79 10.54.1 TU71 <clx version> <command> ACCEPTED - REQUEST NUMBER: < request identifier> ..................10-79 10.54.2 TU71 <clx version> <command> <command state>........10-81 10.54.3 TU71 <clx version> ACS= <ACS identifier> -<state>- FREECELLS= <free cells number> REQ.C/P: AU= <au_c> / <au_p> MO= <mo_c>...
  • Page 19 Cartridge Tape Library UNIX Server User’s Guide 10.54.23 TU71 <clx_version> REMOVE <volume identifier> FROM CAP <CAP identifier> IF NO ERROR FOLLOWS ..........10-95 10.54.24 TU71 <clx version> REQ= <request identifier> <status> <command>..10-95 10.54.25 TU71 <clx version> REQUEST NUMBER <request identifier> CANCELLED ....................
  • Page 20 10.55.14 TU72 <clx version> ERRONEOUS POOL IDENTIFIER AT POSITION <position in the list> ................... 10-112 10.55.15 TU72 <clx version> ERRONEOUS PORT IDENTIFIER AT POSITION <position in the list> ................... 10-112 10.55.16 TU72 <clx version> ERRONEOUS REQUEST IDENTIFIER AT POSITION <position in the list>..............10-113 10.55.17 TU72 <clx version>...
  • Page 21 QUERY_CARTRIDGE_LIBRARY (QLIB)............A-20 A.2.10 SET_CAP_ATTRIBUTES (SETCAP) ............A-27 A.2.11 SET_CLEAN_ATTRIBUTE (SETCLN) ............A-28 A.2.12 SET_SCRATCH_ATTRIBUTE (SETSCR) ............A-30 CLX UTILITIES......................A-31 A.3.1 GET_CLX_FILE (GTCLXF) ................A-31 A.3.2 EXEC_CLX_VOLRPT (VOLRPT)..............A-32 What to Supply to Bull in Case of a Problem..........B-1 Subfiles Delivered in CLX.SLLIB..............C-1 47 A2 63UU Rev05...
  • Page 22 Other GCOS 7 Messages ................D-1 DW Messages ........................ D-1 DV Messages ......................... D-2 Avail Message ........................ D-2 Utilities Message ......................D-3 The PREPARE_TAPESET Utility..............E-1 Introduction........................E-1 GCL Syntax ........................E-2 JCL Syntax ........................E-7 Glossary ....................... g-1 Index ........................i-1 47 A2 63UU Rev05...
  • Page 23 Cartridge Tape Library UNIX Server User’s Guide xxii 47 A2 63UU Rev05...
  • Page 24 Table of Graphics Figures 1-1. Hardware Components of the Cartridge Tape Library System........1-2 1-2. Data Path and Control Path in the Cartridge Tape Library System ........ 1-6 1-3. PowderHorn Library Storage Module Wall Divisions ............1-8 1-4. GCOS 7 and the ACSLS (DPX/20 or ESTRELLA) Software Components for the native DPS7000 ......................
  • Page 25 Cartridge Tape Library UNIX Server User’s Guide xxiv 47 A2 63UU Rev05...
  • Page 26: Overview

    1. Overview The Cartridge Tape Library (CTL) is an automated storage and retrieval system for magnetic tape cartridges that are in libraries connected to a DPS 7000 via a UNIX server. Libraries handled by the CTL system include: • StorageTek ACS 4400, •...
  • Page 27: Hardware Components Of The Cartridge Tape Library System

    Cartridge Tape Library UNIX Server User’s Guide DPS 7000 DPS 7000 DPX/20-ACSLS WSP-SCSI LIBRARY SERVER Control Unit LIBRARY STORAGE Library MODULE Management Unit Cartridge Library Drive Control Cabinet Unit Cartridge Access Ports Figure 1-1. Hardware Components of the Cartridge Tape Library System...
  • Page 28: The Control Path Components

    Overview The Control Path Components The Control Path allows the DPS 7000 to pass commands to the library robot(s). It is composed of the following components (shown in Figure 1-2): • One or several Library Storage Modules (LSM), also called storage silos. Each LSM contains a robot, storage cells and connections for cartridge drives.
  • Page 29 Cartridge Tape Library UNIX Server User’s Guide Library control commands are passed to the library robots as follows: Mount and dismount messages are issued on the DPS 7000 operator console when cartridges need to be mounted/dismounted to run applications or commands (i.e.
  • Page 30: The Data Path Components

    PowderHorn LSM can contain from one to four cartridge drive cabinets, that is, from two to sixteen transports. In TimberWolf cartridge tape libraries, the DPS 7000 is connected to the CUs via a WSP/SCSI interface, which controls the data flow; the FAC and GPA components are not needed.
  • Page 31: Data Path And Control Path In The Cartridge Tape Library System

    Cartridge Tape Library UNIX Server User’s Guide DPS 7000 Ethernet PSI-S TCP/IP Control Data DPX/20 Path Path UNIX Library ACSLS Server FIPS 60 Control RS 423 Unit (CU) Library Management Unit (LMU) Library Storage Module (LSM) GPA = General Purpose Adapter...
  • Page 32: The Cartridge Tape Libraries

    With the TimberWolf Cartridge Tape Library, only 36-track (CTS 4890 or CTS 9490) drives using 36-track tapes can be connected. Any cartridge tape library can be shared statically by several DPS 7000 systems in a multi-host environment. 1.3.1 StorageTek Cartridge Tape Library The StorageTek Cartridge Tape Library (or CTL) is offered in different models.
  • Page 33: Powderhorn Library Storage Module Wall Divisions

    CTS 4890 controller(s) and drive(s) The TimberWolf CTL enables 36-track, mono-transport CTS 4890 drives (also known as Twin Peaks drives) to be used with the DPS 7000, at low cost, without the need of a GPA/FAC to perform the PSI/FIPS conversion. Instead, data conversion is performed via the WSP/SCSI interface, which connects Control Unit(s) to the DPS 7000.
  • Page 34 Library capacity can vary from 326 cartridges with standard door to 494 cartridges with expansion door, per LSM, to a maximum of 1916 cartriges with 6 LSMs. The CTS 9490 Units are connected directly to the DPS 7000 system throught SCSI interface driven by WSP controller.
  • Page 35: The Library Server

    ESCALA or ESTRELLA UNIX server that is used as a cartridge tape library server. ACSLS interfaces with the Library Management Unit (LMU) to control the library robot. Components of ACSLS (as well as relevant software components on the DPS 7000) are shown in Figure 1-4. GCOS 7 DPS 7000 Operator...
  • Page 36: Dps7000-Xta

    Overview GCOS7 DPS7000-XTA User Application Operator assign dvc=CT/LIB Commands deassign Dclx, volrpt … Access Method IO Supervisor Control path SCSI DPX/20 or ESTRELLA ESCALA or ESTRELLA Control Unit SSI for GCOS-1 SSI for GCOS-n ACSLS ACSEL Library ACSSA ACSLM XTA case Figure 1-5 GCOS 7 and the ACSLS (ESCALA or ESTRELLA) Software Components for DPS7000-XTA...
  • Page 37 CSI (Client System Interface), which is the interface between the ACS Library Manager (ACSLM; see 3 below) and the SSI of the DPS 7000. CSI presents a control path format to client applications independent of the host and network.
  • Page 38 ACSLS must be backed up periodically to empty the database journals. Refer to "ACSSA Utilities" in Chapter 6 for more information. A single ACSLS may simultaneously serve the native DPS 7000 systems running Native case SSI on (one of their) OPEN7 subsystem(s)
  • Page 39: The Host System

    DPS 7000/MTxx • DPS 7000/TAxx • DPS 7000/8xx • DPS 7000-XTA When DPS 7000 applications use a cartridge tape library, the following components must be operational on the DPS 7000: • XTA case INTEROP7 • Native case OPEN7 on other native DPS 7000 systems •...
  • Page 40: Gcos 7 And The Clx Software

    GCOS 7 and the CLX Software Whenever a user program or a GCOS 7 utility program references a volume in the cartridge library, the following DPS 7000 actions are performed: • GCOS 7 assigns the files and volumes required for execution of the program.
  • Page 41 Cartridge Tape Library UNIX Server User’s Guide • abort jobs and commands by performing a ’CANCEL REQUEST’ command for mount/dismount requests which cannot be processed automatically (for example, when the protect selector is in the wrong position on the tape), •...
  • Page 42: Configurations Supported

    Examples of basic configurations are given. 1.6.1 ACS Mono-LSM Configuration The basic configuration supported is an ACS mono-LSM system: ACSLS DPS 7000 SERVER WSP SCSI Figure 1-6. ACS Mono-LSM Configuration Another Control Unit (CU) is necessary in a configuration containing 3 or 4 cartridge drive cabinets.
  • Page 43: Mono-Acs Multi-Lsm Configuration

    LCUs) linked together through Pass-Thru Ports (PTPs), where silos are controlled by the same LMU and the same library server. Each silo can contain its own group of cartridge transports. ACSLS DPS 7000 SERVER WSP SCSI not recommended Figure 1-7.
  • Page 44: Mono-Acs Multi-Host Configuration

    WSP SCSI WSP SCSI Figure 1-8. Mono-ACS Multi-Host Configuration DPS 7000 systems can share Control Units (CUs). Static sharing of cartridges and transports is supported. This is described in more detail in Chapter 7, "Static Sharing." 47 A2 63UU Rev05...
  • Page 45 Cartridge Tape Library UNIX Server User’s Guide 1-20 47 A2 63UU Rev05...
  • Page 46: Setting Up Your Ctl On The Dps 7000

    2. Setting Up Your CTL on the DPS 7000 Prerequisites ISI7 (Interoperability Standard Installation on GCOS7) must be used to install CLX on GCOS7 as well as other interoperability components. Native case Before you can set up your CTL, the following software components must be present or installed : •...
  • Page 47: Installation Of Clx

    - Interoperability Software Installation 7 - Administrator’s Guide. (56UU) XTA case - Interoperability 7 software – user’s Guide (91 US) The installation of CLX on the DPS 7000 requires the following three phases: Installation of CLX on GCOS 7, Installation/configuration of SSI...
  • Page 48: Installation/Configuration Of Ssi

    Setting Up Your CTL on the DPS 7000 • Native case creates the file OPEN7.CLX which is changed into an OPEN7 file by the script OPEN7_INIT_CLX. The job INSTALL_CLX is stored in the CLX.SLLIB library. 2.2.2 Installation/Configuration of SSI Native case This is performed by the script OPEN7_INIT_CLX.
  • Page 49: Installation Procedure

    Cartridge Tape Library UNIX Server User’s Guide Installation Procedure See ISI7 manual 47A2 56UU. Native case XTA case See INTEROP7 manual 47 A2 91 US 2.3.1 Installation Procedure of CLX 2.3.1.1 Prerequisites CLX is installed only if the corresponding MI is validated. These following media must be installed: Native case - the ID143 CLX tape installation through the INSTAL ISI7command.
  • Page 50 Setting Up Your CTL on the DPS 7000 2.3.1.3 Automatic Actions to Reach LOADED State If you run the INSTAL_PRODUCTS command when CLX is already present, ISI 7 proceeds as follows. It: • Native case stops the CLX daemon, •...
  • Page 51: Configuration Parameters

    Cartridge Tape Library UNIX Server User’s Guide - the OPEN7 version is stored in the file: /install/ident/open7/vers -To read these files, log in to OPEN7 as the root user and use a UNIX print command. XAMPLE more /install/ident/clx/vers 2.3.1.7 CLX Configuration File Parameters on Native DPS7000 Load parameters Disk volume name for CLX, for example: CLX_VOLUME...
  • Page 52: Installation Procedure Of Clx For Dps 7000-Xta

    Setting Up Your CTL on the DPS 7000 2.3.2 Installation procedure of CLX for DPS 7000-XTA 2.3.2.1 CLX on GCOS7 installation - SI7 tool installation This is the very first step of the installation procedure to be carried out. It consists in downloading the SI7 tool from the INTEROP7 MEDIAS.
  • Page 53 Cartridge Tape Library UNIX Server User’s Guide Connect as IOF SYSADMIN S: MWINLIB BIN INTEROP_STD.BINLIB S: SI7 ID143:CT/LIB; >>>16:21 SI7 >>>>>>>> WARNING <<<<<<<< NEW Filter Visibility! Filter Now mandatory! NOW, Choose your products from the list below! toggle product name choice site_version status...
  • Page 54 Setting Up Your CTL on the DPS 7000 - Configuration set up This is the third step of the installation. The SI7 CONFIG_PRODUCTS (CONFPROD) command allows you to describe a configuration file for all the products the ISI7 media deliver. This has to be done once, at the installation time, then this configuration will be re-used each time a product will be updated or re-installed.
  • Page 55 Cartridge Tape Library UNIX Server User’s Guide This is the fourth and final step of the installation. Running the INSTAL_PRODUCTS command triggers the automatic installation and configuration of the previously selected products. C: instal -------------------------------------------------------------------------- INSTAL_PRODUCTS (+) -->: Instal. of Iterop. Soft. products CONFIG_FILE + Configuration file: CLX_CONFIG Start from beginning or current state...
  • Page 56 Setting Up Your CTL on the DPS 7000 The LOG installation is: <<<10:25 -->10.19 X780 INSTAL USER=GCOS7 CLASS=P SPR=7 STATION=DPS7 -->10.19 X780 STARTED INSTAL GCOS7 P --> SI7:INIT : rename LOG to LOG_OLD in INTEROP_STD.SLLIB --> SI7:INIT : writing in INTEROP_STD.SLLIB..LOG file -->...
  • Page 57 Cartridge Tape Library UNIX Server User’s Guide 2.3.2.2 CLX on W2000 installation Use the ID143_CD media and use the start\settings\control Panel and add/remove program to start INTEROP7 installation The automatic instalshield starts. You must verify if the CLX options are selected The clx_ssi.tar components are loaded on <INTEROPDIRECTORY>\CLX\web 2-12...
  • Page 58 Setting Up Your CTL on the DPS 7000 2.3.2.3 CLX on remote ACSLS installation Remote components can be downloaded on the ACSLS server : with a web browser or with FTP - with a web BROWSER Start on the ACSLS server the Netscape browser and type http:/<XTA_ip_name>...
  • Page 59 Cartridge Tape Library UNIX Server User’s Guide Click on the Download field, the following screen is displayed: 2-14 47 A2 63UU Rev05...
  • Page 60 Setting Up Your CTL on the DPS 7000 Then click on the CLX info field: with FTP : On the local XTA server type the following commands: $ ftp <ACSLS_ip_name> ftp> cd /tmp ftp> bin ftp> put <INTEROP_DIRECTORY>\CLX\web\clx_ssi.tar ftp> quit...
  • Page 61 Cartridge Tape Library UNIX Server User’s Guide CLX installation on your system is being started ----------------------------------------------- --> GCOS name of the XTA server (4 chars) ? : BC06 (type the DSA name of the GCOS7 which is on XTA platform) -->...
  • Page 62: Configuration

    Setting Up Your CTL on the DPS 7000 Configuration You must configure: • UNIX library server ACSLS on ESCALA or ESTRELLA, • GCOS 7: − CLX on GCOS 7, − GCOS 7 system, • SSI: − on OPEN7, Native case −...
  • Page 63: Unix Library Server Configuration

    The permission bits on the /export/home/ACSSS/.rhosts must be – r w – r - - r - -. If they need to be changed, enter on UNIX library server: chmod 644 /export/home/ACSSS/.rhosts This enables you to transfer files from the UNIX server to the DPS 7000, using the GET_CLX_FILE command. 2.4.2 System Configuration All devices attached to the library must be declared in the system resource table.
  • Page 64: Clx Configuration On Gcos 7

    Setting Up Your CTL on the DPS 7000 Save the modified subfile so it can be restored in case of any re-installation of CLX. 2.4.2.2 Configuration of the System Startup CLX can be activated by the command START_CLX (SCLX), submitted by the GCOS 7 operator.
  • Page 65 The default value is set if this keyword is not specified in the CLX_CONFIG file. CLX displays an error and stops if an incorrect value is specified. This parameter should not be modified by the operator unless requested by Bull support.
  • Page 66 The default value is set if this keyword is not specified in the CLX_CONFIG file. CLX displays an error and stops if an incorrect value is specified. This parameter should not be modified by the operator unless requested by Bull support.
  • Page 67 Cartridge Tape Library UNIX Server User’s Guide This parameter should not be modified by the operator unless requested by Bull support. Definition: delay between "get response" requests. These TORPREAD requests are used by CLX to receive messages coming from the library server.
  • Page 68 Setting Up Your CTL on the DPS 7000 POOLID_18T Definition: scratch pool identifier for 18-track cartridges. Value: numeric value from 0 to 65534. Default: This parameter specifies the scratch pool where 18-track work volumes are to be taken from. The specified scratch pool must have been nested in the ACSLS by the "DEFINE POOL"...
  • Page 69 Definition: gives the drive identifier of the device CTnn. CTnn is the DPS 7000 device name. The drive identifier stands for the library server identifier of the drive, it is the physical address of the transport as defined by the hardware configuration.
  • Page 70 Setting Up Your CTL on the DPS 7000 Up to 40 VSN ranges can be specified. A VSN (Volume Serial Number) range is a volume name of 1 to 6 characters. The characters may be replaced by asterisks (*) or periods (.). An asterisk or period designates any alphanumeric character. In addition, asterisks or periods at the end of the name can signify a space ( ).
  • Page 71 Cartridge Tape Library UNIX Server User’s Guide This parameter is optional. If the WORK_PROTECT option is selected in the CLX configuration file, Work volumes in write protect state are registered in the CLX.SLLIBWORK_PROTECTED file else, the logging is not performed. If the SCRATCH_NWORK option is selected in the configuration file, SCRATCH volume without the WORK attribute are registered in the CLX.SLLIBSCRATCH_NONWORK file else, the logging is not performed.
  • Page 72: Clx Configuration Timers

    Default: 50001 This parameter is necessary if CLX is to run on a DPS 7000-XTA if its default value is not convenient (for example if several SSI instances must run to serve several DPS 7000, each on a different port). A wrong SSIPORT value may lead to CLX initialization failure.
  • Page 73 Cartridge Tape Library UNIX Server User’s Guide The following are configuration examples: 1: One silo with 4 transports. XAMPLE Content of CLX TOACSLM = 180000 configuration file: TOSSI = 180000 TOLSM = 180000 TORPRQ = 120000 TORPREAD = 3000 MAXTOACSLM =300 POOLID_18T = 3 POOLID_36T = 6 MAXTOSSI = 100...
  • Page 74 Setting Up Your CTL on the DPS 7000 2: One ACS4400 silo with 4 transports. XAMPLE Content of CLX POOLID_18T =10 configuration file: POOLID_36T =15 MAXTOSSI = 0 LSMID = 0,0 CT15 = 0,0,10,0 CT16 = 0,0,10,1 CT17 = 0,0,10,2...
  • Page 75: Ssi Configuration Under Open7

    Cartridge Tape Library UNIX Server User’s Guide 2.4.4 SSI Configuration under OPEN7 The SSI is automatically configured on OPEN7 during the installation of CLX, however this configuration can be modified later by the System Administrator. 2.4.4.1 Description of the Configuration Parameters Definition: This is the UNIX server name.
  • Page 76 Setting Up Your CTL on the DPS 7000 2.4.4.2 Configuration at Installation When SSI is being installed you are prompted to enter information regarding SSI on OPEN7. The configuration parameters are initialized as follows: Name of the UNIX server [default value: svrx] ? CSI_HOSTNAME is initialized with this UNIX server name.
  • Page 77: Ssi Configuration On Unix Library Server For Dps 7000-Xta

    Cartridge Tape Library UNIX Server User’s Guide 2.4.5 SSI Configuration on UNIX library server for DPS 7000-XTA When SSI is being installed you are prompted to enter information regarding SSI on OPEN7. The configuration parameters are initialized as follows: Name of the XTA server This name is used to install each ssi daemon for each GCOS7 in a different directory.
  • Page 78: Errors In Mount Processing

    Setting Up Your CTL on the DPS 7000 Errors in Mount Processing 2.5.1 Volumes Not in the Library This incident happens when a mount request is issued for a volume not located in the library. If the option NO_AUTOCR = VOL_ABS is selected in the CLX configuration,...
  • Page 79: Write Protected Work Volumes

    Cartridge Tape Library UNIX Server User’s Guide If the option is selected, jobs can stay waiting forever if the other job never dismounts the volume (for example step without UNLOAD option, such as LSV command). No specific processing allows to limit the time a job waits for a volume but the command CANCEL_REQUEST.
  • Page 80: Clx Log Files

    Setting Up Your CTL on the DPS 7000 This incident may happen for example if non-work volumes have been inserted in the library by the ENTER_VOLUMES SCRATCH command (this command is described later in this section). It may also happen if a set scratch ACSSA command was performed for a non-work cartridge.
  • Page 81: Volume Access Rights

    Cartridge Tape Library UNIX Server User’s Guide 2.5.6 Volume Access Rights GCOS 7 does not keep in its database the list and location of cartridge volumes contained in the library, this is done by the library server. The library volumes authorized to GCOS 7 users can be specified in the CLX configuration file.
  • Page 82: Mixed Media / Mixed Format Support

    CT/LIB/M5 : CTS 4780 • CT/LIB/36T : CTS 9490 or CTS 4490 or CTS 4890 When a single type of device attached to the library is connected to a DPS 7000, the device class CT/LIB can be used. 2.5.7.1 Recording Format of Devices CTS 4780 : They write (or prepare) standard tapes using 18-track format.
  • Page 83 Cartridge Tape Library UNIX Server User’s Guide 2.5.7.3 Error Cases 36-track standard length tapes mounted on CTS 4780 They can only be prepared, and then become 18-track cartridges. To write on them, volume preparation must be performed first. Volume preparation must be performed using PREPARE_TAPESET (PREPARE_TAPE cannot be used).
  • Page 84: Starting The Software

    TNS and OPEN7 if they are not active, • • SSI for DPS 7000-XTA SSI on OPEN7 on native DPS 7000 • CLX. If you happen to start these components in the wrong order, warning messages may be displayed on the operator console until all the components are started.
  • Page 85: Starting Open7

    -/port number to be used by SSI package (found after SSIPORT=). Any other valid method may be used to modify G_CLX_SSI global variable value for easier use of SSI and ACS commands on GCOS7 DPS 7000-XTA. The command DISPLAY_SSI (or DSSI) allows the GCOS7 operator (or any other interactive user) to know whether the SSI is operational.
  • Page 86: Starting Clx

    Starting the Software Native case - OPEN7 XTA case - ACSLS server is (re)started. This option must be specified during SSI configuration. starts the following process on the local system: ssi: storage START_SSI (SSSI) server interface manager The ssi process manages the communication with the library server, via the CSI of ACSLS.
  • Page 87: Clx Initialization

    Cartridge Tape Library UNIX Server User’s Guide 3.1.5 CLX Initialization The following example illustrates the CLX initialization sequence: S: START_CLX 14.47 X1987 IN CLX USER=OPERATOR CLASS=P SPR=6 STATION=BCA9 14.47 X1987 STARTED CLX OPERATOR P JB08 X1987.1 STEP H_CLX XPR=8 PGID=19 TU01 V3.0 CLX INITIALIZATION IN PROGRESS TU02 V3.0 CLX WAITING FOR ACSLM TO BE RUNNING TU09 V3.0 ACSLM IS RUNNING...
  • Page 88 Section 9, "CLX Error Conditions and Messages". The user identifier value supplied by the CLX for the interface with ACSLS is the DPS 7000 local system name. When CLX starts, it asks ACSLS to release all locks set for this user identifier.
  • Page 89: Configuring Automatic Restarts

    Cartridge Tape Library UNIX Server User’s Guide Configuring Automatic Restarts The step H_CLX can detect errors, such as: • a UNIX server failure, • an ACSLM or ACSLS failure, • an SSI failure, • a telecommunication failure, • a system error. When errors are detected, the step H_CLX aborts, setting a severity and a status value.
  • Page 90: Messages Issued At Isl System Load

    Starting the Software Messages Issued at ISL System Load At ISL system load, the Device Manager may issue the message: DV17 <<device>> PREMOUNTED <volume> followed by: DW10 <<device>> DISMOUNT < volume> <type> This sequence occurs because the initial AVRs detect the presence of cartridges that have not been unloaded during the previous GCOS 7 session.
  • Page 91 Cartridge Tape Library UNIX Server User’s Guide 47 A2 63UU Rev05...
  • Page 92: How To Enter A Cartridge

    4. How to Enter a Cartridge Labeling the Cartridges For the robot, the library cartridges must have an OCR/bar code optical label which contains the VOLSER of the volume. CUSTOMER LABEL EXTENDED MEDIA LABEL VOLSER LABEL Figure 4-1. Cartridge Labels 47 A2 63UU Rev05...
  • Page 93 Cartridge Tape Library UNIX Server User’s Guide For GCOS 7, library cartridges must have a magnetic label. This label is registered in the first block of the tape and contains the VOLSER of the volume. The extended media label is used for extended length (ECCST) media, i.e., 3490E cartridges.
  • Page 94: Label Consistency

    How to Enter a Cartridge Label Consistency Before using a cartridge for data storage, you must ensure that the VOLSER on the optical label is identical to the VOLSER recorded on the magnetic label volume. A cartridge without magnetic label or a cartridge with a non-standard magnetic label is considered by GCOS 7 as non-standard cartridge.
  • Page 95: Write Protection

    Cartridge Tape Library UNIX Server User’s Guide Write Protection To protect a cartridge against unwanted write operation, either use the File Protect Selector switch of the cartridge or use "electronic" write protection (ACS Virtual Thumbwheel) through JCL/GCL assign parameters (NVOLWR). When accessing cartridges (whether writing is permitted or not), you must ensure the compatibility between: •...
  • Page 96: Entering Cartridges Into The Library

    How to Enter a Cartridge Entering Cartridges into the Library Cartridges can be entered manually or automatically. Before being entered, all cartridges must have an optical label attached. 4.4.1 Automatic Entry Cartridges are entered through the Cartridge Access Port(s). If a CAP is set in automatic mode, it is unlocked, allowing an operator to enter cartridges at any time.
  • Page 97 Cartridge Tape Library UNIX Server User’s Guide 47 A2 63UU Rev05...
  • Page 98: Operating Your Ctl

    5. Operating Your CTL This section describes how to operate your Cartridge Tape Library (CTL) and shows what happens during normal operation. Cleaning Cartridges The cartridge cleaning operation is performed automatically if specified so at ACSLS installation (AUTOCLEAN set to TRUE in the ACSLS file .acsss_env). If not, the operator must mount cleaning cartridges using the ACSSA commands "mount"...
  • Page 99: User Application Information

    Cartridge Tape Library UNIX Server User’s Guide User Application Information 5.2.1 Referring to Cartridge Library Volumes When you declare a cartridge tape library in the site configuration, ensure that the references to cartridge volumes clearly indicate the complete device class (device type and device attribute).
  • Page 100: Mounting Library Volumes

    Operating Your CTL The assigning of the type "any media" is not supported for library cartridge volumes. An "MD=*, DVC=CT/LIB" type reference causes a step abort and the following message in the JOR: DV51.ANY MEDIA OPTION NOT ALLOWED FOR CT/LIB When working with filesets (INSET/OUTSET), specify the REQDEV parameter.
  • Page 101 Cartridge Tape Library UNIX Server User’s Guide 5.2.3.2 Dismounting at End of a Job The end of a job forces the dismounting of all volumes that were used by the job and that have remained premounted. 5.2.3.3 Dismounting After an IOF Command Starting with GCOS 7 TS7458 Dismounting of library volumes can also be managed using a new system configuration option in the FILEOPT command (parameter CTUNLOAD=YES),...
  • Page 102: End, Abend, And Endvol Parameters

    Operating Your CTL 5.2.4 END, ABEND, and ENDVOL Parameters When dismounting has not been forced (see the preceding subsection, "Dismounting Library Volumes"), the END, ABEND, and ENDVOL parameters remain unchanged and operate as defined for non-CTL tapes and manual transports. In particular: •...
  • Page 103 Cartridge Tape Library UNIX Server User’s Guide Cartridges containing compacted data must be read via any type of controller equipped with IDRC. IDRC has the following software visibility: • a specific device attribute: CT/LIB/M5/C to create a compacted 18-track formatted file or CT/LIB/36T/C to create a compacted 36-track formatted file. The attribute "C"...
  • Page 104: Volume Preparation

    Operating Your CTL Volume Preparation 5.3.1 How to Prepare a New Volume Use the PREPARE_TAPESET (PRPTPST) or PREPARE_TAPE (PRPTP) utility to change non-standard volumes to standard volumes. With PREPARE_TAPESET, the INFILE parameter specifies the file to be used as input. You can specify a member in a SL library or a UFAS sequential file. You can also use the "::TN"...
  • Page 105: Re-Establishing Consistency Of Labels

    Cartridge Tape Library UNIX Server User’s Guide XAMPLE A non-standard volume.(36-track formatted) PREPARE_TAPESET INFILE=UTIL.MJ.SLLIB..EX3 DVC=CT/LIB/36T$NSTD WORK or with the JCL: TAPEPREP INFILE=UTIL.MJ.SLLIB..EX2 DEVCLASS=CT/LIB/36T$NSTD WORK where members of library UTIL.MJ.SLLIB are to be used as input. 5.3.3 Re-establishing Consistency of Labels The PREPARE_TAPESET utility is also used to reestablish consistency between the magnetic label and the OCR/bar code optical label.
  • Page 106: Dps 7000 Response To Preparing A Work Volume

    Operating Your CTL DPS 7000 Response to Preparing a Work Volume The WORK attribute is conferred by the PREPARE_TAPESET (GCL), TAPEPREP (JCL), PREPARE_TAPE (GCL), VOLPREP (JCL) utilities, with the parameter WORK. For example, to prepare a 36-track formatted work volume: $JOB PREPARE;...
  • Page 107: What Happens When A Job Assigns / Deassigns A Standard Volume

    Cartridge Tape Library UNIX Server User’s Guide What Happens When a Job Assigns / Deassigns a Standard Volume Mount/dismount requests are processed as in the following example: 14. 04 X1849 IN FILESAVE USER=OPERATOR CLASS=P SPR=6 STATION=BCA9 14. 04 X1849 STARTED FILESAVE OPERATOR P 14.
  • Page 108: Use Of A Non-Standard Volume

    Operating Your CTL Use of a Non-Standard Volume Using a non-standard volume has not been restricted to PREPARE_TAPESET since GCOS 7 TS7458. When a job assigns a non-standard volume, the user must specify the volume by the optical label of the cartridge. Once the requested cartridge is mounted by CLX, the job automatically restarts without any operator intervention.
  • Page 109: Use Of Work Volumes

    Cartridge Tape Library UNIX Server User’s Guide Use of Work Volumes If your site operations involve the use of work volumes, you must respect the following rules: the scratch pool (POOLID_18T and POOLID_36T) specified in the CLX configuration must have been defined in the ACSLS by using the ACSSA command "define pool."...
  • Page 110 Operating Your CTL XAMPLE ACSSA>query pool 1 12-21-93 13:44:22 Pool Status Identifier Volume Count Low Water Mark High Water Mark Attributes ACSSA> query scratch 1 12-21-93 13:45:41 Scratch Status Scratch Pool Identifier Home Location Status 001860 0, 0, 1,35, 1 home 001861 0, 0, 2, 1, 0...
  • Page 111: What Happens When A Job Assigns A Work Volume

    Cartridge Tape Library UNIX Server User’s Guide What Happens When a Job Assigns a Work Volume When a job requests a work volume mount, this leads to a mount message in which the keyword WORK replaces the name of the volume. XAMPLE 13.56 X1846 STARTED FILSAVE OPERATOR P JB08 X1846.1 STEP H_UTILITY XPR=8 PGID=27...
  • Page 112: Operator Commands

    6. Operator Commands Command Summary The following types of commands are needed in performing Cartridge Tape Library operations. (Commands of each type are listed below the table. Utilities are listed in "CLX Utilities" and "ACSSA Utilities" later in this chapter.) Type of Where To Enter Purpose of...
  • Page 113: Summary Of Clx Commands

    Cartridge Tape Library UNIX Server User’s Guide 6.1.1 Summary of CLX Commands These CLX commands are available to the System Operator via an IOF terminal (GCOS 7): • XTA case SET_CLX_SSI sets G_CLX_SSI global variable addressing SSI package (This commande is automatically made by the START_CLX command) •...
  • Page 114 Operator Commands • query displays status information about the ACS, CAP, cleaning cartridges, library drives, the ACSLS, LSMs, ports, requests, scratch pools, or tape cartridges, as shown below: query volume gives the ACSLM status of volumes. query drive gives the ACSLM status of drives. query mount gives the drives available for mounting.
  • Page 115: Summary Of Clx Library Commands

    Cartridge Tape Library UNIX Server User’s Guide 6.1.3 Summary of CLX Library Commands XTA case The command SET_CLX_SSI (or SCLXSSI) sets global variable G_CLX_SSI = <ssi-host-name>/>ssi-port> according to what is found in CLX.SLLIB..CLX_CONFIG (or any other user-specified library member) for SSIHOST= … & SSIPORT= … (see 2.6.3 CLX configuration on GCOS7). The use of this command, or any other way to give a valid value to G_CLX_SSI global variable, avoids to specify SERVER=<ssi-host- name>/>ssi-port>...
  • Page 116: Summary Of Relevant Directives

    Operator Commands 6.1.4 Summary of Relevant Directives The following directives related to cartridge tape libraries are available to the System Operator connected to an IOF terminal (GCOS 7): • DC CT/LIB gives the device status known to the Device Manager device of all devices (18-track and 36-track) connected to the library •...
  • Page 117: Operability Considerations

    Cartridge Tape Library UNIX Server User’s Guide Operability Considerations When an application assigns a file on a cartridge tape library (by using the device class CT/LIB/M5 or CT/LIB/36T), the operator visibility of the cartridge tape operations is as follows: • the Device Manager issues the message MOUNT when a cartridge must be mounted.
  • Page 118: Clx Commands

    Operator Commands CLX Commands The CLX commands control CLX automatic mounting/dismounting operations and display useful information concerning the tape cartridge library. The CLX commands are delivered in the CLX.BIN library. This library must be declared in your search path using the MWINLIB BIN, CLX.BIN command. Helps are installed in the SITE.HELP.
  • Page 119: Addressing Ssi For A Dps 7000-Xta

    Cartridge Tape Library UNIX Server User’s Guide 6.3.1 Addressing SSI for a DPS 7000-XTA This command gives the G_CLX_SSI global variable according to SSIHOST and SSIPORT values found in CLX.SLLIB..CLX_CONFIG (or in any user-specified library member). The use of this command avoids the specification of SERVER=<ssi-host-name>/<ssi-port>...
  • Page 120: Starting Clx (Sclx)

    Operator Commands 6.3.3 Starting CLX (SCLX) This command activates the CLX service. It can be abbreviated to SCLX: START_CLX LIBRARY = <library name> SUBFILE = <subfile name> LIBRARY = name of the GCOS 7 source library containing the CLX configuration file. The default value is CLX.SLLIB.
  • Page 121: Displaying Devices (Dclx)

    Cartridge Tape Library UNIX Server User’s Guide 6.3.4 Displaying Devices (DCLX) This command displays the status of a device or group of devices integrated within the cartridge tape library: DISPLAY_CLX [DEVICE = <device> ] DCLX [DEVICE = <device> ] where, is the name of the device (ex CT15).
  • Page 122 Operator Commands TU15 <clx version> <device> <dvchar> POOLID = <poolid> <driveid> STATUS: Format 3: <acsls_command> <volume> FOR <ron> PENDING XAMPLE TU15 V3.0 CT17 POOLID = (0,0,1,2) STATUS: MOUNT 001864 FOR X1981 PENDING Format 4: TU15 <clx version> <device> <dvchar> POOLID = <poolid> <driveid> STATUS: <acsls_command>...
  • Page 123 Cartridge Tape Library UNIX Server User’s Guide XAMPLE The first DCLX command is performed on a system with 4 drives and 2 volumes mounted. CT15 and CT16 are 18-track devices (CT/LIB/M5). The pool identifier 3 is associated to CT/LIB/M5 devices (18-track formatted WORK volumes). CT17 and CT18 are 36-track devices (CT/LIB/36T).
  • Page 124 Operator Commands JB08 X1887.1 STEP H_UTILITY XPR=8 PGID=22 S: DCLX CT17 15.38 TU15 V3.0 CT17 POOLID = 6 (0,0,1,2) STATUS : 001863 MOUNTED FOR X1887 TU14 V3.0 CLX_DISPLAY COMMAND COMPLETED * DW10 CT17 DISMOUNT 001863 S 15.39 X1887.1 COMPLETED FILSAVE OPERATOR P S: DCLX CT17 15.39 TU15 V3.0 CT17 POOLID =...
  • Page 125: Displaying The Ssi Status (Dssi)

    Cartridge Tape Library UNIX Server User’s Guide 14.47 TU60 V3.0 CLX_DISPLAY COMMAND REJECTED : CLX NOT RUNNING S: DCLX CT15 14.48 TU60 V3.0 CLX_DISPLAY COMMAND REJECTED : CLX NOT RUNNING TU06 V3.0 CLX IS CLEANING LOCKS ON VOLUMES SET BY PREVIOUS CLX SESSION TU03 V3.0 CLX IS RUNNING TU26 V3.0 NOW MOUNT &...
  • Page 126: Starting / Stopping The Clx Trace (Mdclx)

    Operator Commands 6.3.6 Starting / Stopping the CLX Trace (MDCLX) This command turns the CLX trace on or off. When the CLX trace is active, all messages exchanged between the CLX and the ACSLS are displayed on the operator terminal from which CLX was started. The trace displays requests sent to the ACSLS by CLX, it also displays the acknowledgments and responses returned by the ACSLS.
  • Page 127 Cartridge Tape Library UNIX Server User’s Guide Format 2: other requests --- SEQ_NO=<sequence number> REQ_TYPE = ACK REQID=<request identifier> Parameters are displayed in the format <keyword> = <value>. Keywords and their values depend on the request. They are described in the Common Library Services User’s Guide.
  • Page 128 Operator Commands UNLOCK VOLUME SEQ_NO= 80 LOCKID=12136 VOLID=001863 COUNT= 1 STATUS= 0 UNLOCK VOLUME SEQ_NO= 80 REP_TYPE=FINAL STATUS= 0 COUNT= 1 VOLID=001863 STATUS_2= 0 TYPE=17 IDENT= UNLOCK DRIVE SEQ_NO= 81 LOCKID=12136 DRIVEID=0012 COUNT= 1 STATUS= 0 UNLOCK DRIVE SEQ_NO= 81 REP_TYPE=FINAL STATUS= 0 COUNT= 1 DRIVEID=0,0,1,2 STATUS_2= 0 TYPE=17 IDENT= --- SEQ_NO= 81 REP_TYPE=ACK REQID= 9006 The GCOS 7 mount request causes the following ACSLS requests:...
  • Page 129 Cartridge Tape Library UNIX Server User’s Guide MOUNT SCRATCH SEQ_NO= 73 REP_TYPE=FINAL STATUS= 0 VOLID=001860 POOL= 1 DRIVEID=0,0,1,2 TU11 V3.0 CT17 IN LIBRARY : 001860 MOUNTED * FP01 CT X1862.1 TAG 001860 FOR EFN T * DW10 CT17 DISMOUNT 001860 S DISMOUNT SEQ_NO= 74 LOCKID=11992 VOLID=001860 DRIVEID=0,0,1,2 FORCE=0 STATUS= 0 14.34 X1862.1 COMPLETED FILSAVE OPERATOR P --- SEQ_NO= 74 REP_TYPE=ACK REQID= 8994...
  • Page 130: Terminating Clx (Tclx)

    Operator Commands XAMPLE The following example shows traces of a <query server> requests while CLX is processing a mount operation and then, a dismount operation. S: MDCLX TRACE -> MOUNT SEQ_NO= 21 LOCKID=12986 VOLID=001862 DRIVEID=0,0,1,1 READONLY=0 STATUS= 0 -> --- SEQ_NO= 21 REP_TYPE=ACK REQID= 1769 ->...
  • Page 131 Cartridge Tape Library UNIX Server User’s Guide Case 1: the STRONG option is not specified If there are no mount/dismount operations in progress and no cartridge is mounted, CLX accepts the request and ignores incoming mount requests. If mount/dismount operations are in progress or cartridges are mounted, CLX rejects the request and issues the message: TU61 <clx version>...
  • Page 132 Operator Commands 6.3.7.1 TERMINATE_CLX Case 1: TERMINATE_CLX is entered while no drives are mounted. The CLX displays the following messages and then stops: TU07 <clx version> CLX SHUTDOWN IN PROGRESS TU08 <clx version> CLX IMMEDIATE SHUTDOWN CLX ignores next mount/dismount messages issued by the Device Manager. XAMPLE S: START_CLX 14.49 X1870 IN CLX USER=OPERATOR CLASS=P SPR=6 STATION=BCA9...
  • Page 133 Cartridge Tape Library UNIX Server User’s Guide TU02 V3.0 CLX WAITING FOR ACSLM TO BE RUNNING TU09 V3.0 ACSLM IS RUNNING TU06 V3.0 CLX RECOVERY IN PROGRESS S: TCLX 14.49 TU61 V3.0 CLX_TERMINATE COMMAND REJECTED : CLX NOT RUNNING TU06 V3.0 CLX IS CLEANING LOCKS ON VOLUMES SET BY PREVIOUS CLX SESSION TU03 V3.0 CLX IS RUNNING TU26 V3.0 NOW MOUNT &...
  • Page 134 Operator Commands S stands for Standard, W stands for WORK, U stands for unknown volume, E stands for scratch non WORK volume, P stands for scratch write protected by file selector scratch volume, N stands for non-standard. That gives the following list of messages: MOUNT <dev><vol>...
  • Page 135: Terminating Ssi (Tssi)

    Cartridge Tape Library UNIX Server User’s Guide XAMPLE 15.46 CT17 MOUNT 001864 LIB FOR X1990 * 15.46 CT15 MOUNT 001863 LIB FOR X1991 S: TCLX 15.46 TU61 V3.0 TERMINATE_CLX REQUEST REJECTED : DEVICES IN USE The first TCLX is rejected because cartridges are mounted. S: TCLX STRONG 15.46 TU14 CLX COMMAND IN PROGRESS TU08 V3.0 CLX IMMEDIATE SHUTDOWN...
  • Page 136 You can either terminate CLX before terminating SSI or keep CLX running. However, terminating SSI can cause a termination of CLX (refer to the chapter, "Setting Up Your CTL on the DPS 7000"). XAMPLE S: DSSI 15.09 X320 IN CLX_SSI USER=OPERATOR CLASS=P SPR=6 STATION=BCA9...
  • Page 137: Resetting Clx Tables

    Cartridge Tape Library UNIX Server User’s Guide • if SSI is restarted before the maximum number of repetitions is reached, the repeated requests will be processed; if SSI is not restarted, the step H_CLX terminates (severity 4, status 24000) and the job CLX terminates unless the JCL supplied at the CLX installation has been modified by the System Administrator, •...
  • Page 138 Operator Commands The following message is displayed on the operator screen: TU60 <clx version> RESET_CLX COMMAND REJECTED: CLX NOT RUNNING The specified drive does not exist in the configuration file. The following message is displayed on the operator screen: TU60 <clx version> RESET_CLX COMMAND REJECTED : <device name> NOT IN LIBRARY XAMPLES S: DCLX...
  • Page 139: Clx Utilities

    /export/home/ACSSS/.rhosts must be -rw-r--r- These conditions must have been fulfilled at the installation of CLX (refer to the chapter "Setting Up Your CTL on the DPS 7000"). If these conditions are not satisfied, the message PERMISSION DENIED is issued.
  • Page 140 Operator Commands XAMPLE VOLRPT RPTFILE=1 SERVER=’wolf’ Messages displayed on the screen: S:EXEC_CLX_VOLRPT ’wolf’ RPTFILE=1; 10.24 X399 IN CLX_STAT USER=OPERATOR CLASS=P SPR=6 STATION=BCA9 10.24 X399 STARTED CLX_STAT OPERATOR P JB08 X399.1 STEP H_CLX_CMDSTAT XPR=8 PGID=24 TU70 V3.0 THE RESULT OF VOLRPT IS ON THE UNIX SERVER IN THE FILE /export/home/ACSSS/log/volrpt.log =>...
  • Page 141: File Transfer ( Get_Clx_File - Gtclxf)

    The system network name (with ssi) is declared in the /export/home/ACSSS/.rhosts file in the library server (refer to installation). This condition must have been fulfilled at the installation of CLX (refer to Chapter 2, "Setting Up Your CTL on the DPS 7000"). 6-30 47 A2 63UU Rev05...
  • Page 142: Acssa Commands

    Operator Commands XAMPLE The content of the /export/home/ACSSS/log/volrpt.log file of the library server <wolf> is transferred into the subfile es_volrpt_wolf in the GCOS 7 library lciu.cmd.sllib. Command: GTCLXF GCOS_LIB= lciu.cmd.sllib GCOS_SUBFILE=es_volrpt_wolf REMOTE_FILE= ’/export/home/ACSSS/log/volrpt.log’ SERVER=’wolf’ Messages displayed on the screen: S:GET_CLX_FILE lciu.cmd.sllib es_volrpt_wolf ’/export/home/ACSSS/log/volrpt.log’...
  • Page 143 Cartridge Tape Library UNIX Server User’s Guide • eject = ejects one or more cartridges from the ACS. • enter = enters one or more cartridges into the ACS by using a CAP. • idle = stops the ACSLM request processing. •...
  • Page 144: Audit

    Operator Commands 6.5.1 Audit Syntax: aud[it] * |cap_id type [identifier ...] The possible audit requests are: audit * |cap_id ser[ver] audit * |cap_id ac[s] acs_id ... audit * |cap_id ls[m] lsm_id ... audit * |cap_id pa[nel] panel_id ... audit * |cap_id su[bpanel] subpanel_id ... The audit request performs a physical inventory of the entire library, or of one or more specified ACSs, LSMs, LSM panels, or LSM subpanels.
  • Page 145: Clear

    Cartridge Tape Library UNIX Server User’s Guide The canceled request may continue to run while it releases allocated resources. Activity is terminated before the next LMU command is issued. Current LMU commands are processed to completion. No attempt is made to undo any activity that was completed before the cancel request was received by the ACSLM.
  • Page 146: Define

    Operator Commands Upon receipt of a clear request, the ACSLM verifies that each identifier exists in the database, and is currently locked or has a lock pending. When the clear completes successfully, a response message is displayed in the Command Area for each identifier specified. In each message, the status indicates that either the locks were cleared, or the resource was not locked.
  • Page 147: Delete

    Cartridge Tape Library UNIX Server User’s Guide 6.5.5 Delete Syntax: del[ete] poo[l] pool-id ... |al[l] The delete request deletes one or more empty scratch pools. The pool_id is a number that uniquely identifies a group of scratch volumes. From one to 21 pool_ids can be specified in a request. The format of pool_id is: pool_id numeric(1-65534) A pool_id of 0 (the common scratch pool) is invalid for this request: the...
  • Page 148: Eject

    Operator Commands Upon receipt of a dismount request, the ACSLM verifies the drive_id and vol_id in the database, and the LSM robot does the following: Moves to the specified drive Dismounts the tape cartridge from the drive Returns the tape cartridge to an available storage cell in the library Once the dismount is completed, the database is updated with the new location of the cartridge, and a success message is displayed in the Command Area.
  • Page 149: Enter

    Cartridge Tape Library UNIX Server User’s Guide volrange_id identifies a set of tape cartridges; two vol_ids separated by a dash. Only the right-most numeric portions of the vol_ids is acted on; all other characters must be identical. The second vol_id must be greater than the first.
  • Page 150: Idle

    Operator Commands 6.5.9 Idle Syntax: i[dle] [f[orce]] The idle request is used to place the Library Server in a quiescent state prior to maintenance activity or Library Server termination. The Library Server will remain in that state until it receives a start request. The ACSLM can be in one of the four following states: run, idle, idle-pending, or recovery.
  • Page 151: Lock

    Cartridge Tape Library UNIX Server User’s Guide 6.5.10 Lock Syntax: loc[k] type identifier ... [wait] The possible lock requests are: loc[k] vo[lume] vol_id ... [wait] loc[k] dr[ive] drive_id ... [wait] The lock request places a lock on tape volumes or library drives. Only one type can be specified in a lock request.
  • Page 152: Logoff

    Operator Commands 6.5.11 Logoff Syntax: Log[off] logoff is used to exit from the current Command Processor. The logoff command has no options. If the logoff is successful, the Command Processor from which the request was entered is terminated. If the logoff is unsuccessful, an undesired event occurred. 6.5.12 Mount Syntax:...
  • Page 153: Query

    Cartridge Tape Library UNIX Server User’s Guide All of the following conditions must be met for a successful mount: • Both the cartridge and the drive must be in the same ACS • The library drive must be online to ACSLM control and available •...
  • Page 154 Operator Commands Displays the drives available for mounting one or more m[ount] specific tape cartridge(s); requires a vol_id. Displays the drives available for mounting one or more m[ount] scratch tape cartridge(s); requires a pool_id. If a specific media type is designated, only that media type is used in determining compatible drives.
  • Page 155: Set

    Cartridge Tape Library UNIX Server User’s Guide A cap_id containing asterisks is not allowed. The system displays as many responses as needed to provide all the requested information. For example, the command, query request all, will result in a display consisting of one response for each request being processed. 6.5.14 Syntax: set type [of[f]] [*] identifier [...] [identifier ...]...
  • Page 156: Show

    Operator Commands acs(0), lsm(0-23), panel(0-19), drive(0-3) drive_id numeric(0-32767) lock_id numeric(0-65534) pool_id six-character cartridge identifier; can be any vol_id combination of numbers (0-9), letters (A-Z), and spaces ( ); IDs with embedded spaces must be enclosed in single (’ ’) or double ("") quotes. identifies a set of tape cartridges;...
  • Page 157: Start

    Cartridge Tape Library UNIX Server User’s Guide 6.5.16 Start Syntax: st[art] The start request places the ACSLM in the run state, enabling processing of Library Server requests. The start command has no options. If the start is successful, the ACSLM becomes ready to receive requests. If the start is unsuccessful, the ACSLM does not become ready to receive requests.
  • Page 158: Vary

    Operator Commands six-character cartridge identifier; can be any vol_id combination of numbers (0-9), letters (A-Z), and spaces ( ). IDs with embedded spaces must be enclosed in single quotes (’ ’) or double quotes (""). The all option can be specified to remove all locks for the specified type. Upon receipt of an unlock request, the ACSLM verifies that each identifier exists in the database, and that the resource is locked.
  • Page 159: Venter

    Cartridge Tape Library UNIX Server User’s Guide The device ID for the ACS acs_id The device ID for the LSM lsm_id The device ID for the CAP cap_id The device ID for the drive drive_id The device ID for the port port_id The state can be of[fline], on[line], or dia[gnostic].
  • Page 160 Operator Commands six-character cartridge identifier; can be any vol_id combination of numbers (0-9), letters (A-Z), and spaces ( ). IDs with embedded spaces must be enclosed in single quotes (’ ’) or double quotes (""). Upon receiving an venter request, the CAP is unlocked, and an unsolicited message is displayed instructing you to place the cartridges in the CAP.
  • Page 161: Library Commands

    Cartridge Tape Library UNIX Server User’s Guide LIBRARY Commands CLX library commands are used to send a subset of ACSSA commands from a GCOS 7 terminal to the library server. (Certain ACSSA commands such as DISMOUNT, MOUNT, IDLE, VARY, and START are not delivered in the current release of CLX library commands.) All CLX library commands are accessible through IOF connected under project OPERATOR.
  • Page 162: Audit_Cartridge_Library (Abbr. Audlib)

    Operator Commands It is not recommended to kill the job CLXACSSA. Also, it is not recommended to abort the step IOF using the break key (or $*$BRK). Breaking the command or canceling the job does not cancel the current request if it has already been transmitted to the Library server.
  • Page 163 Cartridge Tape Library UNIX Server User’s Guide Parameters: OBJECT = designates the type of the device for the inventory. Possible values: ACS abbrev. AC , LSM abbrev. LS , PANEL abbrev. PA , SUBPANEL abbrev. SU . ACSID = identifier of the Automatic Cartridge Subsystem to be audited.
  • Page 164 Operator Commands XTA case SERVER = specifies the SSI host name and the SSI port when G_CLX_SSI global variable value (default value) is not set (see SET_CLX_SSI) Comments: This command can be used to resolve inconsistencies between the Library Server Database and the physical content of the library.
  • Page 165 Cartridge Tape Library UNIX Server User’s Guide Inventory of the panel (0,0,10) using the CAP (0,0,1) for ejection of cartridges. In this case, one unlabelled cartridge is found in the panel. S: AUDLIB PA PAID=(0,0,10) CAPID=(0,0,1) The following messages are displayed: TU71 V3.0 AUDIT PANEL ACCEPTED - REQUEST NUMBER : 12 TU71 V3.0 AUDIT PANEL- AUDIT ACTIVITY TU71 V3.0 AUDIT PANEL- UNREADABLE LABEL - VOL =...
  • Page 166: Cancel_Lib_Request (Abbr. Clibr)

    Operator Commands CANCEL_LIB_REQUEST (abbr. CLIBR) This command: Terminates a current or pending library request. Syntax: { CANCEL_LIB_REQUEST } { CLIBR } REQID = <requid> [SERVER=<ssi-host-name>/<ssi-port>] XTA case Parameters: REQID = request identifier of the request to be canceled. The request identifier may be obtained by the QLIB REQUEST command.
  • Page 167: Define_Scratch_Pool (Abbr. Dfpool)

    Cartridge Tape Library UNIX Server User’s Guide The following messages are displayed: TU71 V3.0 QUERY REQUEST ACCEPTED - REQUEST NUMBER : 14 TU71 V3.0 REQ=2145 PENDING QUERY TU71 V3.0 REQ=2144 CURRENT AUDIT TU71 V3.0 REQ=2141 CURRENT EJECT TU71 V3.0 REQ=2143 CURRENT ENTER TU71 V3.0 QUERY REQUEST COMPLETED S: CLIBR 2143 The following messages are displayed:...
  • Page 168 Operator Commands Parameters: POOL_LIST = List of up to ten pool identifiers specifying pools to create or modify. Each pool identifier identifies uniquely a group of scratch (WORK) volumes. It is a 5 decimal digits. Valid values: 0 to 65534. 0 designates the common scratch pool which already exists.
  • Page 169 Cartridge Tape Library UNIX Server User’s Guide Comments: By default, the common scratch pool low water mark is 0 and its high water mark is 2147483647 (2 -1). Before using this command, It is recommended to use the QLIB command to know whether the pool exists.
  • Page 170 Operator Commands The following messages are displayed: TU71 V3.0 DEFINE POOL ACCEPTED - REQUEST NUMBER : 19 TU71 V3.0 POOL=456 -LOW WATER MARK -LWM=0 HWM=9 TU71 V3.0 DEFINE POOL COMPLETED modifies (or creates) 3 scratch pools setting the low water mark to 0 and the high water mark to 100 and no overflow option.
  • Page 171: Delete_Scratch_Pool (Abbr. Dlpool)

    DPS 7000-XTA, when G_CLX_SSI global variable value (default value) is not set (see SET_CLX_SSI); not needed on DPS 7000 non-XTA for which SSI runs on local OPEN7. Comments: Only empty pools can be deleted. The common pool (pool 0) cannot be deleted.
  • Page 172 Operator Commands XAMPLES Deletion of 2 empty scratch pools. S: DLPOOL (600,609) The following messages are displayed: TU71 V3.0 DELETE POOL ACCEPTED - REQUEST NUMBER : 21 TU71 V3.0 POOL=600 POOL DELETED TU71 V3.0 POOL=609 POOL DELETED TU71 V3.0 DELETE POOL COMPLETED Attempt to delete a not empty pool.
  • Page 173: Eject_Lib_Volumes (Abbr. Eject_Volumes, Ejvol)

    Cartridge Tape Library UNIX Server User’s Guide 6.6.4 EJECT_LIB_VOLUMES (abbr. EJECT_VOLUMES, EJVOL) This command: Ejects one or several cartridges from the cartridge library. The volume serial number (volser- OCR labels - external labels) of the cartridges to be ejected are supplied in one of the following way: •...
  • Page 174 Operator Commands Parameters: CAPID = identifier of the CAP (Cartridge Access Port) used to eject the cartridges. It is of the following format : (acs,lsm,cap "dec2, dec2, dec2"). If a character * is specified in the acs field, the highest priority available CAP in the ACS containing a cartridge designated for ejection is selected.
  • Page 175 Cartridge Tape Library UNIX Server User’s Guide XTA case SERVER = specifies the SSI host name and the SSI port when G_CLX_SSI global variable value (default value) is not set (see SET_CLX_SSI). Comments: There is no limit for the list of volumes specified in a subfile. If the number of cartridges is greater than the capacity of the CAP, several operator operations are required to complete the ejection.
  • Page 176 Operator Commands Ejection through the highest priority available CAP of all cartridges whose volser is in the range 001860 001869 (in this example 10 cartridges are ejected at the most). EJVOL VOLRNG = (001860 001869) The following messages are displayed: TU71 V3.0 EJECT VOLUMES ACCEPTED - REQUEST NUMBER : 24 TU71 V3.0 REMOVE CARTRIDGES FROM CAP * IF NO ERROR FOLLOWS After removing cartridges from the CAP.
  • Page 177 Cartridge Tape Library UNIX Server User’s Guide Cartridges are ejected by sets of 42, Therefore when the operator is required by the LMU panel to remove cartridges, it may happen that the CAP is not full. This does not mean that the ejection is completed, another message can appear on the GCOS 7 terminal and on the LMU panel which requires the operator to remove more cartridges.
  • Page 178: Enter_Lib_Volumes (Abbr. Enter_Volumes, Envol)

    Operator Commands 6.6.5 ENTER_LIB_VOLUMES (abbr. ENTER_VOLUMES, ENVOL) This command: Inserts one or more cartridges in the cartridge library through a CAP (Cartridge Access Port) and optionally includes them in a scratch pool (pool of WORK volumes). Syntax: { ENTER_LIB_VOLUMES } { ENTER_VOLUMES } { ENVOL } { CAPID }...
  • Page 179 Cartridge Tape Library UNIX Server User’s Guide POOLID = specifies the scratch pool into which the cartridges must be placed. Must contain a numeric value from 0 to 65534. It must be specified when SCRATCH is set to 1 otherwise it must be left blank. Cartridges to be entered will be selected as WORK volumes for the local DPS7 only if the POOLID value specified in this command and the POOLID value in...
  • Page 180 If the SCRATCH keyword is set to 1, volumes are placed in the scratch pool selected in the POOLID keyword. If volumes are bound to be selected as WORK volumes for the local DPS 7000, you must specify in the POOLID keyword the value which has been specified either in POOLID_18T or in POOLID_36T keyword in the CLX configuration.
  • Page 181 Cartridge Tape Library UNIX Server User’s Guide The ENTER_VOLUMES SCRATCH command does not check that the inserted tapes are not write-protected. The protection is detected when the cartridge is selected for a MOUNT WORK request. Refer to "Errors in Mount Processing" in Chapter 2 for more details.
  • Page 182: Enter_Unlab_Volumes (Abbr. Enuvol)

    Operator Commands 6.6.6 ENTER_UNLAB_VOLUMES (abbr. ENUVOL) This command: Inserts one or several tape cartridges with missing or unreadable OCR labels into the cartridge library through a CAP (Cartridge Access Port). Syntax: { ENTER_UNLAB_VOLUMES } { ENUVOL } { CAPID } } = <capid>...
  • Page 183 CAP. If WORK volumes are inserted, they must be prepared again as WORK to become eligible for being used as WORK volumes by the local DPS 7000. Several ENTER_UNLAB_VOLUMES commands can be requested at a time by different operators on condition that they specify different CAPs.
  • Page 184: Extract_Clx_Error (Abbr. Exterr)

    Operator Commands After placing one unlabeled cartridge in the unlocked CAP: TU71 V3.0 ENTER UNLAB VOLUMES- VOLUME NOT FOUND - VOL= VOL002 TU71 V3.0 VOLUME VOL001 ENTERED TU71 V3.0 ENTER UNLAB VOLUMES PARTIALLY PROCESSED 6.6.7 EXTRACT_CLX_ERROR (abbr. EXTERR) This command: Retrieves from the CLX logs the list of volumes for which a specific incident has happened since the last EXTRACT_CLX_ERROR operation, stores volsers of these volumes into the specified output library subfile and deletes references of...
  • Page 185 Cartridge Tape Library UNIX Server User’s Guide LIB = output source library. The library must be cataloged. SUBFILE = output subfile. REPLACE = specifies what to do if the output subfile already exists. if set to 1, the current content of the subfile is overwritten.
  • Page 186 Operator Commands XAMPLES Stores labels of work-protected volumes in the subfile EXTRACT.SLLIB..VOLWP S: EXTERR ERR=WP LIB=EXTRACT.SLLIB SF=VOLWP The following messages are displayed: TU71 V3.0 NUMBER OF VOLSERS EXTRACTED FROM THE CLX LOG = 3 TU71 V3.0 EXTRACT_CLX_ERROR COMPLETED stores the labels of scratch non-work volumes in the subfile EXTRACT.SLLIB..VOLSNW S: EXTERR ERR=SNW LIB=EXTRACT.SLLIB SF=VOLSNW The following messages are displayed:...
  • Page 187: Query_Cartridge_Library (Abbr. Qlib)

    Cartridge Tape Library UNIX Server User’s Guide 6.6.8 QUERY_CARTRIDGE_LIBRARY (abbr. QLIB) This command: Displays information about an ACS, one or several silo(s), one or several CAP(s), cleaning cartridge(s), library drive(s), the Library Server, LSM(s), port(s), library request(s), scratch cartridge(s), scratch pool(s), or tape cartridge(s). Syntax: { QUERY_CARTRIDGE_LIBRARY } { QLIB }...
  • Page 188 Operator Commands Input Parameters: OBJECT = designates the type of the device to get information about. Possible values: ACS (abbrev. AC). CAP: Cartridge Access Cap. CLEAN (abbrev. CLN ): cleaning cartridges. DRIVE (abbrev. DR): transports. LOCK_DRIVE (abbrev. LCKD): lock(s) on drives. LOCK_VOLUME (abbrev.
  • Page 189 Cartridge Tape Library UNIX Server User’s Guide VOLUME_LIST = list of up to ten volume serial numbers (volsers). It can be supplied if the specified object type is one among the following list: VOLUME, CLEAN, LOCK_VOLUME, MOUNT. DRIVEID = identifier of a drive attached to the cartridge library. It can be supplied if the specified object type is DRIVE or LOCK_DRIVE.
  • Page 190 Operator Commands XTA case SERVER = specifies the SSI host name and the SSI port when G_CLX_SSI global variable value (default value) is not set (see SET_CLX_SSI) Outputs: The returned information depends on the selected object type. 47 A2 63UU Rev05 6-79...
  • Page 191 Cartridge Tape Library UNIX Server User’s Guide Object type label returned information ordered as mentioned in this list label ACS identifier ACS current state FREECELLS number of free cells REQ. C/P number of current / number of pending AUDIT request number of current / number of pending MOUNT requests number of current / number of pending DISMOUNT requests number of current / number of pending ENTER requests...
  • Page 192 Operator Commands Object type label returned information ordered as mentioned in this list label library drive (transport) identifier LOCK_DRIVE current activity state of the drive or status error. lock identifier associated with the drive LCK-DURATION amount of time, in seconds, that the lock has been active LCK-PENDING number of lock requests that are waiting for the drive.
  • Page 193 Cartridge Tape Library UNIX Server User’s Guide Object type label returned information ordered as mentioned in this list label next message(s): drive identifier one per drive ordered by activity state of the drive or status error. proximity to the volumr current state of the drive the volume identifier in the library drive.
  • Page 194 Operator Commands Object type label returned information ordered as mentioned in this list label SERVER SERVER current state of the Library Server service. FREECELLS number of unused cells in the LSM REQ. C/P number of current / number of pending AUDIT requests number of current / number of pending MOUNT requests number of current / number of pending DISMOUNT requests...
  • Page 195 Cartridge Tape Library UNIX Server User’s Guide The following messages are displayed: TU71 V3.0 QUERY CAP ACCEPTED - REQUEST NUMBER : 31 TU71 V3.0 CAP=0 ,0 ,0 ENTER ACTIVITY - PR=5 SZ=40 MANU - ONLINE - TU71 V3.0 CAP=0 ,0 ,1 EJECT ACTIVITY - PR=4 SZ=40 MANU - ONLINE - TU71 V3.0 CAP=0 ,0 ,2 CAP AVAILABLE - PR=4 SZ=1 AUTO - ONLINE -...
  • Page 196 Operator Commands Query lock information about volumes S: QLIB LCKV The following messages are displayed: TU71 V3.0 QUERY LOCK DRIVE ACCEPTED - REQUEST NUMBER : 35 TU71 V3.0 VOL=001700 VOLUME IN USE LCK=31047 LCK-DURATION= 180 LCK-PENDING=0 USR=acsss....TU71 V3.0 VOL=001701 VOLUME IN USE LCK=31047 LCK-DURATION= 180 LCK-PENDING=0 USR=acsss....
  • Page 197 Cartridge Tape Library UNIX Server User’s Guide Query information about available drives for mounting scratch tapes. In this example, the number of scratch volumes in the specified pool is smaller than the low water mark value assigned to the pool. S: QLIB MOUNT_SCRATCH POOLLS=112 The following messages are displayed: TU71 V3.0 QUERY MOUNT_SCRATCH ACCEPTED - REQUEST NUMBER : 38...
  • Page 198 Operator Commands OVERFLOW TU71 V3.0 QUERY POOL COMPLETED 12. Query all ports. S: QLIB PORT The following messages are displayed: TU71 V3.0 QUERY PORT ACCEPTED - REQUEST NUMBER : 41 TU71 V3.0 PORT=0 ,0 - ONLINE - TU71 V3.0 QUERY PORT COMPLETED 13.
  • Page 199 Cartridge Tape Library UNIX Server User’s Guide 16. Query information about scratch volumes. A single pool is specified. No volume is found S: QLIB SC POOLLS=(99) The following messages are displayed: TU71 V3.0 QUERY SCRATCH ACCEPTED - REQUEST NUMBER : 45 TU71 V3.0 POOL(S) NOT FOUND OR EMPTY TU71 V3.0 QUERY SCRATCH COMPLETED 17.
  • Page 200: Set_Cap_Attributes (Abbr. Setcap)

    Operator Commands 6.6.9 SET_CAP_ATTRIBUTES (abbr. SETCAP) This command: Modifies the mode and (or) the priority for the specified Cartridge Access Port. Syntax: { SET_CAP_ATTRIBUTES } { SETCAP } { CAPID } } = <capid> { CAP [ MODE = { A | M } ] [ {PRIORITY } } = <priority>...
  • Page 201 Cartridge Tape Library UNIX Server User’s Guide Comments: The CAP priority is a value that is used for selecting CAPs automatically. It is used when the character * is specified for the CAPID for a command, then the highest priority CAP is selected. The higher the priority value is, the more priority the CAP is.
  • Page 202: Set_Clean_Attribute (Abbr. Setcln)

    Operator Commands 6.6.10 SET_CLEAN_ATTRIBUTE (abbr. SETCLN) This command: Sets or resets the cleaning attribute for one or more tape cartridge(s) (volumes). Syntax: { SET_CLEAN_ATTRIBUTE } { SETCLN } { VOLUME_LIST } } = (char6 [,char6 [...]]) { VOLLS [ ON = { 1 | 0 } ] [ { MAXUSE_NB } } = dec5 ]...
  • Page 203 Cartridge Tape Library UNIX Server User’s Guide Comments: The result of this command is identical to the result of the ACSSA SET CLEAN command entered from the library server window. Refer to the ACSLS System Administrator’s Guide for more details about this command. This command can be used if CLX has been activated at least once since the last GCOS 7 system restart.
  • Page 204: Set_Scratch_Attribute (Abbr. Setscr)

    Operator Commands 6.6.11 SET_SCRATCH_ATTRIBUTE (abbr. SETSCR) This command: Sets or resets the scratch attribute for one of more tape cartridge(s) (volumes). Syntax: { SET_SCRATCH_ATTRIBUTE } { SETSCR } { VOLUME_LIST } } = <volume list> { VOLLS [ ON = { 1|0 } ] [ POOLID = <poolid>...
  • Page 205 Cartridge Tape Library UNIX Server User’s Guide A scratch volume is eligible to be used for a MOUNT WORK request issued by a DPS7 if this volume is attached to a pool selected in the CLX configuration of this DPS7 (refer to the POOLID_18T and POOLID_36T keywords) . The scratch attribute must be set for WORK volumes only.
  • Page 206 Operator Commands The following messages are displayed: TU71 V3.0 SET SCRATCH ACCEPTED - REQUEST NUMBER : 55 TU71 V3.0 VOL=001701 SCRATCH ATTRIB RESET TU71 V3.0 SET SCRATCH COMPLETED 47 A2 63UU Rev05 6-95...
  • Page 207: Acssa Utilities

    (for more information, see "CLX Utilities" earlier in this chapter): volrpt: ACSLS volume report (same utility as for the UNIX terminal). get_clx_file: transfer of ACSLS file to GCOS7, also transfer of OPEN7 file to GCOS 7 for DPS 7000 non-XTA. 6-96 47 A2 63UU Rev05...
  • Page 208: Determining The Status Of A Device

    Operator Commands Determining the Status of a Device 6.8.1 How to Get a Device Current Status The directive DC CT/LIB or DC CTnn displays the status of library devices, as they are known to the device manager. The directive DC CT/LIB/M5 displays the status of the 18-track library devices. The directive DC CT/LIB/36T displays the status of the 36-track library devices.
  • Page 209: Device Isolation

    Cartridge Tape Library UNIX Server User’s Guide 6.8.2 Device Isolation If a cartridge is mounted on a device, the isolation command MDHW CTnn OUT forces the dismounting of the cartridge. The system does not wait for the end of the dismount operation to isolate the device.
  • Page 210: Halting The Library Server (Acsls)

    Operator Commands Halting the Library Server (ACSLS) The ACSLS can be stopped with the command "kill.acsss". This command is available to the acsss user connected to the UNIX server from a UNIX terminal. If the ACSLS is terminated while CLX is running, the CLX suspends the automatic processing of mount/dismount operations and stops unless the ACSLS is restarted within a certain interval of time: •...
  • Page 211 Cartridge Tape Library UNIX Server User’s Guide 6-100 47 A2 63UU Rev05...
  • Page 212: Static Sharing

    The library can be shared between DPS 7000 systems and non-DPS 7000 systems if each system uses its own set of transports at a given time. 47 A2 63UU Rev05...
  • Page 213: Example Of Static Sharing

    Cartridge Tape Library UNIX Server User’s Guide DPS A Drive CT01 TCA1 TCA2 DPS B Drive CT02 Figure 7-1. Example of Static Sharing The following are examples of assigning transports: XAMPLE To switch a transport from DPS A to DPS B, the sequence of operations is: •...
  • Page 214: Sharing Of Cartridge Volumes

    Static Sharing If the isolation operation and dismount have not finished on DPS A, your jobs on DPS B that reference the transport can abort or be blocked. Mount and dismount operations lock and unlock the transport. 7.1.2 Sharing of Cartridge Volumes Cartridge volumes can be accessed by all systems attached to the library.
  • Page 215 Cartridge Tape Library UNIX Server User’s Guide 47 A2 63UU Rev05...
  • Page 216: Clx Error Conditions

    8. CLX Error Conditions Introduction This section describes the CLX error conditions and gives the error messages relevant to each error condition. The error conditions are grouped by types of errors, such as ’Initialization Errors’. This section also contains examples of JCL and screen output for specific error conditions.
  • Page 217: Errors During Initialization

    Cartridge Tape Library UNIX Server User’s Guide Errors During Initialization 8.2.1 Installation Errors • The Marketing Identifier is not installed. TU00 <clx version> CLX FACILITY IS NOT AVAILABLE ON YOUR SITE • CLX.SYSTEM not installed or not loaded (it should be loaded automatically by the JCL starting CLX).
  • Page 218: Error In Clx Job Submission

    CLX Error Conditions • CLX ignores the dismounting requested by device manager and put the new (repeated) mount messages in its queue. • To recover, you must cancel the request by using the CANCEL_REQUEST command and hold the device by using the MDHW command until you modify the CLX configuration and restart CLX.
  • Page 219: Device Status Resynchronization Errors

    Cartridge Tape Library UNIX Server User’s Guide 8.2.4.3 Error at creation of the CLX command TU53 <clx version> CLX OPERATOR COMMAND CANNOT BE CREATED : <return-code> 8.2.5 Device Status Resynchronization Errors Refer to "CLX Resynchronization and Recovery" in Chapter 9. 47 A2 63UU Rev05...
  • Page 220: Errors During Operation

    CLX Error Conditions Errors During Operation 8.3.1 GCOS 7 Environment Errors 8.3.1.1 Abnormal response from the ACSLS TU64 <clx version> ACSLM OR CLX INTERNAL ERROR 8.3.1.2 Abnormal behavior of CLX TU65 <clx version> EMERGENCY SHUTDOWN : CLX ERROR < proc_name, ERRNB = error_number, return-code>.
  • Page 221: Server Or Telecommunication Failure

    Cartridge Tape Library UNIX Server User’s Guide 8.3.3 Server or Telecommunication Failure If the link with the ACSLS is broken or there is no response from the library server, the step H_CLX stops filtering the messages issued by the Device Manager, waits for a given time, and then aborts if the link is not re-established.
  • Page 222: Errors During Preparation Of Work Volumes

    CLX Error Conditions 8.3.4 Errors During Preparation of WORK Volumes The following error and warning messages can occur when preparing WORK cartridges: Case 1: A work volume is prepared whereas the scratch pool selected in the CLX configuration file is not defined on the ACSLS. The following message is issued: TU58 <clx version>...
  • Page 223 Cartridge Tape Library UNIX Server User’s Guide CT15 = 0,0,1,0 CT16 = 0,0,1,1 CT17 = 0,0,1,2 CT18 = 0,0,1,3 VSN = 00182* VSN = 00183* VSN = 00184* VSN = 00186* VSN = 00187* VSN = 00188* VSN = 007518 VSN = 007519 S: SCLX TU01 V3.0 CLX INITIALIZATION IN PROGRESS...
  • Page 224: Volume Mounting Errors

    CLX Error Conditions The following message is issued: TU13 <clx version> NUMBER OF CARTRIDGES IN SCRATCH POOL <dvchar> POOLID = <poolid> AT HIGH WATER MARK This message is a warning message. 8.3.5 Volume Mounting Errors CLX or ACSLS can detect errors during the mounting of a volume. CLX sends messages to the operator and, when the error cannot be solved automatically, CLX issues a CANCEL REQUEST.
  • Page 225 Cartridge Tape Library UNIX Server User’s Guide For the status marked with a (2), all requests waiting for the failed drive or the failed cartridge are rejected, i.e. CLX removes the requests from its queue and issues a message for each of them: TU37 <clx version>...
  • Page 226 CLX Error Conditions 8.3.5.2 A work volume is requested whereas the scratch pool is empty. This case may happen in the following situations: the scratch pool, specified in CLX configuration, is empty and the option overflow was not specified for the scratch pool, the option overflow is specified, the scratch pool declared in the CLX and the common pool are empty.
  • Page 227 Cartridge Tape Library UNIX Server User’s Guide You must define the pool by using the ACSSA command "define pool" and then introduce cartridges in this pool using PREPARE_TAPESET utility. XAMPLE Content of CLX.SLLIB..CLX_CONFIG TOSSI = 180000 TOACSLM = 180000 TOLSM = 180000 TORPRQ =120000 TORPREAD = 5000 POOLID_18T = 5...
  • Page 228 If the device is not used by another system, you must suppress the lock by using the ACSSA command "clean lock". 8.3.5.6 The volume is not authorized to the DPS 7000 applications. TU32 <clx version> CLX ATTEMPTS TO CANCEL MOUNT REQUEST OF <volume> ON <device>: ILLEGAL ACCESS TO VOLUME If the volume must be authorized, modify CLX configuration file, stop and restart CLX.
  • Page 229 Cartridge Tape Library UNIX Server User’s Guide 8.3.5.7 The device is not declared in the CLX configuration file. TU37 <clx version> CLX REJECTS REQUEST ’MOUNT <volume> ON <device>’: UNKNOWN DEVICE If the device must be authorized, modify CLX configuration file, stop and restart CLX.
  • Page 230 CLX Error Conditions XAMPLE The write protection selector of the volume does not match with the protection requested. CLX generates a CANCEL_REQUEST (CR). 11.30 X1406 IN FILSAVE USER=CLX CLASS=P SPR=6 STATION=BCA9 11.30 X1406 STARTED FILSAVE CLX P * 11.30 CT16 MOUNT 001878 LIB FOR X1406 JB08 X1406.1 STEP H_UTILITY XPR=8 PGID=24 * DW07 CT16 SWITCH 001878 FOR X1406 TO PERMIT TU30 V3.0 DVMGT REQUEST REJECTED :...
  • Page 231 Cartridge Tape Library UNIX Server User’s Guide others. Depending on the status value, one of the following messages is also issued: STATUS_DRIVE_OFFLINE TU34 <clx version> CLX ATTEMPTS TO TAKE <device> OUT OF CONFIGURATION CLX rejects all other pending requests waiting for the device. TU37 <clx version>...
  • Page 232: Work Volume Dismounting Errors

    CLX Error Conditions 8.3.6 Work Volume Dismounting Errors All errors mentioned in the previous section are valid for this section. If CLX does not succeed in setting the scratch attribute to the volume, the following message is issued: TU58 <clx version> UNSUCCESSFUL REQUEST ’SET SCRATCH <volume>’ POOLID = <poolid>...
  • Page 233: Errors Produced By System Limits

    Cartridge Tape Library UNIX Server User’s Guide modify the low water mark attribute for the pool by using the ACSSA command DEFINE POOL. XAMPLE If a cartridge has a WORK attribute, but does not have the scratch attribute, or if it has the scratch attribute but does not belong to the scratch pool selected in the CLX configuration, the cartridge will never be selected as a scratch volume by the ACSLS for the local GCOS 7.
  • Page 234: How To Detect And Recover From Failures

    9. How to Detect and Recover from Failures GCOS 7 Crash To have an automatic restart of CLX service after a crash, include the SCLX command in the system startup. In this case, you must also specify at CLX installation the automatic startup of SSI at OPEN7 startup. Some messages can appear if CLX is started before SSI.
  • Page 235 Cartridge Tape Library UNIX Server User’s Guide Severity and status are set when the step aborts. INCIDENT SEVERITY STATUS Recoverable System or CLX Internal error Conflict with another CLX or another CLC 21000 Unrecoverable System or CLX internal error. 22000 Error in the CLX configuration file No response from the Library Server 23000...
  • Page 236: Cancel_Job Clx

    How to Detect and Recover from Failures You may choose to: User Action: • have the failure fixed, wait for the automatic startup of CLX or restart CLX if it has stopped, • terminate CLX if it is running, using the TCLX command. Then, according to the incident, use the manual mode or the semi-automatic mode.
  • Page 237: Acsls Not Operational

    Cartridge Tape Library UNIX Server User’s Guide ACSLS Not Operational The ACSLS is not operational in the following cases: it has not been started on the ESCALA or ESTRELLA server it is in the idle state due to an ACSSA "idle" command one of its processes is in bad condition CLX watches the server state by using the request "query server."...
  • Page 238 The following sequence of operations can be performed: • if there is a core file in the /export/home/ACSSS directory, save it on a tape (this will help your Bull support with the analysis of the incident) • try to stop the ACSLS and restart it: −...
  • Page 239 Cartridge Tape Library UNIX Server User’s Guide If the problem still persists, try to: • run an ACSLS configuration: • login acsss (enter the correct password) • kill.acsss • cd config • acsss_config etc...(Refer to the STK ACSLS Installation Guide) •...
  • Page 240: Communication Link Failure (Ssi - Tns - Open7 - Hsl)

    How to Detect and Recover from Failures Communication Link Failure (SSI - TNS - OPEN7 - HSL) CLX detects the failure during a mount/dismount operation or in the process of System watching the availability of the ACSLM. If CLX detects the failure on the process Behavior: of sending a request to the server, it displays the message: TU54 <clx version>...
  • Page 241 Cartridge Tape Library UNIX Server User’s Guide If the cause of the failure does not appear in the log file, try to detect the component which fails by doing what follows: a. SSI failure Use the GCL command DSSI to find out if SSI is running. If it is not running, start it using the command SSSI.
  • Page 242 If the failure persists, log on to the ssi system, save the file into another file (cp /clx/[<GCOS_NAME>]*event*.lo <new file name>, print it and give the listing to your Bull support. Use the semi-automatic mode (refer to "Operation in Degraded Mode" later in this chapter) and contact your Bull support. 47 A2 63UU Rev05...
  • Page 243: Robot Failure

    Cartridge Tape Library UNIX Server User’s Guide Robot Failure CLX detects the failure of a mount or dismount operation. It suspends the System automatic processing of the mounting/dismounting operations until all LSMs are Behavior: operational. The messages TU04 and TU25 are issued: TU04 <clx version>...
  • Page 244: Cicc Or Psi Failure

    How to Detect and Recover from Failures CICC or PSI Failure If the CICC or PSI fails, GCOS 7 tries to recover. If the recovery procedure fails, the path is isolated. Note that: • if there is only one path, the applications are aborted, •...
  • Page 245: Transport Or Cartridge Failure

    Cartridge Tape Library UNIX Server User’s Guide Transport or Cartridge Failure If an I/O error occurs, the GCOS 7 access method attempts a recovery. If the System recovery fails and the job is repeatable, the job is restarted; otherwise, it is aborted Behavior: and the operator will have to restart it.
  • Page 246: Operation In Degraded Mode

    You must terminate CLX. If the robot is online, place it offline by using the LSM panel. • When you see a MOUNT and DISMOUNT message on the DPS 7000 Main terminal, you have to search for the cartridge within the LSM and mount it on or dismount it from the designated transport.
  • Page 247: Semi-Automatic Mode

    Cartridge Tape Library UNIX Server User’s Guide 9.9.1.1 Use of Work Volumes You need to keep a list of scratch volumes either by using the volume report utility or by using the ACSSA command "query scratch." Select a volume on the basis of the volume scratch list.
  • Page 248 The lock identifiers selected are identical for the device and the volume. The owner of the locks is the local DPS 7000 host name. The current locked resources, their lock identifiers and the owner identifier can be displayed through the ACSSA command "query lock."...
  • Page 249 36-track volumes. E-tapes can only belong to 36-track scratch pool, they cannot be used on 18-track device. 9.9.2.1 Library connected to and used by only one DPS 7000 The following are examples of GCOS 7 messages and associated ACSSA commands that the operator must enter: Mounting a standard volume hh.mm CTnn MOUNT <volume>...
  • Page 250 If volumes are shared between different systems, use the lock mechanism to protect against conflicts. If the library is shared between DPS 7000 systems, conflicts on devices must be managed by the MDHW command as in automatic mode (refer to Chapter 7, "Static Sharing").
  • Page 251 Cartridge Tape Library UNIX Server User’s Guide Use of Lock Mechanism Locks on devices Before mounting volumes in a device, lock the device using the ACSSA command "lock drive." You can choose between the two following methods: Method No. 1: Lock all devices used by your local system and keep the locks until the automatic mode is restarted on this system.
  • Page 252: Device Status Inconsistency Between Clx Tables, Gcos 7, And Acsls

    If you use ACSSA commands to lock volumes of devices, locks are taken for the acsss user and not for the DPS 7000 system. As a consequence these locks will not be released when CLX restarts. Therefore, do not forget to release all locks before restarting the automatic processing.
  • Page 253 Cartridge Tape Library UNIX Server User’s Guide Operator The operator must put the drive of the library for which the problem occured in the Action following state: • no cartridge mounted • drive not locked If a volume was mounted in the drive, the operator must unlock this volume. It may be possible to dismount the cartridge using the dismount command of the ACSLS command processor (cmd_proc) on the UNIX library server, otherwise manual intervention may be necessary.
  • Page 254 How to Detect and Recover from Failures On the UNIX library server: $ cmd_proc -l ----------------------------------ACSLS 5.1.1---------------------------------- (c) Copyright (1988-1995) Storage Technology Corporation All Rights Reserved This material is confidential and proprietary to StorageTek and may be licensed only under a valid StorageTek license. Do not copy or distribute unless authorized in writing by StorageTek.
  • Page 255 Cartridge Tape Library UNIX Server User’s Guide Unlock: Unlock completed, Success. ACSSA> unlock Type(drive/volume): vol Volume identifier(volume label): 001870 Volume identifier(volume label): Unlock: volume 001870 unlocked Unlock: Unlock completed, Success. Unlock: Changed lock identifier from 27283 to 0. ACSSA> q lock dr al 03-28-97 14:39:11 Lock Status Identifier...
  • Page 256: Clx Resynchronization And Recovery

    How to Detect and Recover from Failures 9.10 CLX Resynchronization and Recovery The resynchronization occurs in the following cases: • restart of the step H_CLX, • restart of ACSLM: after a failure, when the library server answers the CLX requests again. •...
  • Page 257 Cartridge Tape Library UNIX Server User’s Guide XAMPLE Devices CT16 (0,0,1,1) and CT17 (0,0,1,2) are put out of the GCOS 7 configuration because they are seen offline by the ACSLS. Please note the messages TU23, TU21 and TU34. S: DC CT/LIB 10.36 CT18 HELD...
  • Page 258 How to Detect and Recover from Failures XAMPLE Volumes 001863 and 001864 are dismounted from the drives CT17(0,0,1,2) and CT16 (0,0,1,1) respectively, because they are considered by ACSLS to be mounted on devices which are seen as STANDBY by GCOS 7. In the ACSLS database, before the resynchronization, the drive CT17 is locked by the local CLX and there is no lock on drive CT16.
  • Page 259 Cartridge Tape Library UNIX Server User’s Guide TU02 V3.0 CLX WAITING FOR ACSLM TO BE RUNNING TU09 V3.0 ACSLM IS RUNNING TU06 V3.0 CLX RECOVERY IN PROGRESS TU23 V3.0 DVMGT STATUS OF CT16 : STANDBY TU21 V3.0 ACSLM STATUS OF CT16 (0,0,1,1): 001864 MOUNTED TU33 V3.0 CLX ATTEMPTS TO DISMOUNT 001864 ON CT16 TU23 V3.0 DVMGT STATUS OF CT17 : STANDBY TU21 V3.0 ACSLM STATUS OF CT17 (0,0,1,2): 001863 MOUNTED...
  • Page 260 How to Detect and Recover from Failures It is followed by one of the following messages: TU35 <clx version> CLX REPEATS REQUEST ‘dismount <volume> ON <device> (<driveid>)’ TU33 <clx version> CLX ATTEMPTS TO DISMOUNT <volume> ON <device> BY FORCE TU34 <clx version> CLX ATTEMPTS TO TAKE <device> OUT OF CONFIGURATION 47 A2 63UU Rev05 9-27...
  • Page 261 Cartridge Tape Library UNIX Server User’s Guide 9-28 47 A2 63UU Rev05...
  • Page 262: Clx Operator Messages

    Description: Marketing Identifier necessary to run CLX is not installed. System Reaction: CLX is terminated (step aborted severity 4). User Action: Contact the Bull supplier. 10.1.2 TU00 <clx version> CLX CONFLICT WITH ANOTHER CARTRIDGE LIBRARY COMPONENT (CLX OR CLC) Description: Another CLX job or a CLC job is already active.
  • Page 263: Tu01

    Cartridge Tape Library UNIX Server User’s Guide User Action: If necessary, stops the CLX job. If no CLX job is running, restarts GCOS 7. Wait for the step termination. If it has been launched by an IOF, the IOF user has to launch any other step except H_CLX_ECMDACSSA (launch an LSF command on any file for example), or to terminate his IOF.
  • Page 264: Tu03 Clx Is Running

    CLX Operator Messages 10.4 TU03 10.4.1 TU03 <clx version> CLX IS RUNNING Description: This appears at the end of the initialization stage when CLX becomes operational. It follows the message TU06 and is followed by the message TU26. System Reaction: Normal situation after a SCLX command.
  • Page 265: Tu05 Lsms Are Online

    Cartridge Tape Library UNIX Server User’s Guide 10.6 TU05 10.6.1 TU05 <clx version> LSMs ARE ONLINE Description: It appears after a failure on one or several LSMs. All LSMs are operational again. System Reaction: CLX will enter the resynchronization stage. A message TU06 should follow. User Action: Wait for the next TU messages.
  • Page 266: Tu05 Lsms State: Diagnostic

    CLX Operator Messages System Reaction: CLX suspends the automatic mounting/dismounting operations. CLX checks the LSMs states periodically until the failure is fixed. The interval of time between 2 checks is specified in the TOLSM value in the CLX configuration. User Action: Try to put the LSMs online either by entering the ACSSA command "vary lsm on"...
  • Page 267: Tu06 Clx Recovery In Progress

    Cartridge Tape Library UNIX Server User’s Guide 10.7 TU06 10.7.1 TU06 <clx version> CLX RECOVERY IN PROGRESS Description: CLX is entering a resynchronization stage. System Reaction: This message appears either after an SCLX command, or after a failure with the library server or after a failure with the LSM(s).
  • Page 268: Tu07 Clx Shutdown In Progress

    CLX Operator Messages 10.8 TU07 10.8.1 TU07 <clx version> CLX SHUTDOWN IN PROGRESS Description: CLX is starting the process of normal termination following a TCLX command. System Reaction: CLX goes on processing mount/dismount operations in progress. However CLX processes neither new mount/dismount requests nor queued mount/dismount requests.
  • Page 269: Tu09

    Cartridge Tape Library UNIX Server User’s Guide 10.10 TU09 10.10.1 TU09 <clx version> ACSLM IS RUNNING Description: The library server is operational. This message appears after a SCLX command or after a server failure. System Reaction: CLX is about to perform a resynchronization. User Action: Wait for next messages until a TU26 message says that mount/dismount requests are processed automatically.
  • Page 270: Tu09 Acslm State: Idle Pending

    CLX Operator Messages 10.10.3 TU09 <clx version> ACSLM STATE: IDLE PENDING Description: The ACSLM is in the process of going idle. System Reaction: Same as above. User Action: Enter the ACSSA "start" command from the DPX/20 or ESTRELLA terminal. If the failure persists, refer to "ACSLS Not Operational"...
  • Page 271: Tu12

    Cartridge Tape Library UNIX Server User’s Guide 10.12 TU12 10.12.1 TU12 <clx version> <device> IN LIBRARY: <volume> DISMOUNTED Description: The cartridge <volume> has just been dismounted from the drive <device>. System Reaction: The dismount request has been processed successfully. User Action: None.
  • Page 272: Tu13 Number Of Cartridges In Scratch Pool (Poolid = ) At High Water Mark

    CLX Operator Messages 10.13.2 TU13 <clx version> NUMBER OF CARTRIDGES IN SCRATCH POOL <dvchar> (POOLID = <poolid>) AT HIGH WATER MARK Description: This message warns that the number of cartridges in the scratch pool has reached the maximum number (high water mark) specified when the pool was defined. This message can appear after mounting a WORK volume or dismounting a WORK volume.
  • Page 273: Tu15

    Cartridge Tape Library UNIX Server User’s Guide User Action: Wait for the next message. Check that the other messages appear on the terminal of the operator who started CLX. If CLX starts with the system startup, the messages appear on the main operator terminal. 10.15 TU15 All TU15 messages display the results of a DCLX command.
  • Page 274: Tu17

    CLX Operator Messages 10.17 TU17 10.17.1 TU17 <clx version> VERIFY DEVICE <device> STATUS Description: This message follows a TU16 message. CLX has sent the mount request to the library server but it does not receive a response. System Reaction: This message is repeated every three DW11 MOUNT messages. If the failure persists, CLX inquires about the ACSLM state.
  • Page 275: Tu17 Verify Job Which Uses

    Cartridge Tape Library UNIX Server User’s Guide 10.17.3 TU17 <clx version> VERIFY JOB <ron> WHICH USES <volume> Description: This message follows the TU16 message. The mount request cannot be satisfied because the volume is being used by the job whose ron is specified in the message. System Reaction: Repeat this message every three DW11 MOUNT requests.
  • Page 276: Tu20

    CLX Operator Messages 10.19 TU20 10.19.1 TU20 <clx version> CLX TABLE OF MESSAGES OVERFLOW Description: The maximum number of queued plus current MOUNT requests has just been reached. System Reaction: CLX keeps running but ignores new MOUNT request until there is space in its table again.
  • Page 277: Tu21 Acslm Status Of ()

    Cartridge Tape Library UNIX Server User’s Guide 10.20.2 TU21 <clx version> ACSLM STATUS OF <device>(<driveid>): AVAILABLE Description: There is a conflict between the device state as seen by the GCOS 7 Device Manager, and the device state as seen by the library server. From the GCOS 7 point of view, the device is in the READY state, whilst from the library server point of view the device is free.
  • Page 278: Tu21 Acslm Status Of (): Locked By Host System

    CLX Operator Messages System Reaction: In the first case, CLX dismounts the volume from the device. User Action: Use ACSSA commands to investigate. 10.20.5 TU21 <clx version> ACSLM STATUS OF <device>(<driveid>): LOCKED BY HOST SYSTEM <system> Description: This message gives the device state from the library server. This message is issued during a resynchronization when the following inconsistency is detected between the device state, as seen by the GCOS 7 Device Manager, and the device state as seen by the library server.
  • Page 279: Tu23

    Cartridge Tape Library UNIX Server User’s Guide 10.21.2 TU22 <clx version> ACSLM STATUS OF <volume>: MOUNTED ON <driveid> - AN AUDIT IS REQUIRED Description: A dismounting operation fails. The status returned by the library server is MISPLACED_TAPE. The library server notices that the volume in the device is different from the one it expected, according to its data base.
  • Page 280: Tu23 Dvmgt Status Of : Standby

    CLX Operator Messages 10.22.2 TU23 <clx version> DVMGT STATUS OF <device>: STANDBY. Description: This message is issued during a resynchronization for information when CLX notices one of the following situations: Case 1: To GCOS 7, the device is in the STANDBY state but to the library server, the device is locked by another system.
  • Page 281 Cartridge Tape Library UNIX Server User’s Guide Case 2: To GCOS 7, the device is in the READY state but to the library server no volume is mounted onto the device. Case 3: To GCOS 7, the device is in the READY state but to the library server a different volume is mounted onto the device, or Case 4: To GCOS 7, the device is in the READY state but to the library server the volume...
  • Page 282: Tu23 Dvmgt Status Of : Mounted

    CLX Operator Messages 10.22.4 TU23 <clx version> DVMGT STATUS OF <device>: <volume> MOUNTED Description: Issued for information. CLX is processing a DISMOUNT request where the optical label and magnetic label are different. The message TU27 is also issued. Refer to the message TU27.
  • Page 283: Tu26

    Cartridge Tape Library UNIX Server User’s Guide User Action: Verify the LSMs state by using the ACSSA command "query lsm", and try to put the LSMs online, either by entering the ACSSA command "vary lsm online" at the UNIX terminal or from the LSM panel. You can also use the manual mode. If you succeed in putting the LSMs online, CLX performs a resynchronization before resuming the mount/dismount processing.
  • Page 284: Tu30

    CLX Operator Messages System Reaction: CLX dismounts the volume using the optical label. User Action: Eject the volume and change the optical label or change the magnetic label by using PREPARE_TAPESET. Refer to "Re-establishing Consistency of Labels" in Chapter 5. 10.27 TU30 10.27.1 TU30 <clx version>...
  • Page 285 Display the status of the device by the command DC CT/LIB and by the ACSSA command "query drive." Obtain the contents of the error log for peripheral devices (PRLOG) and deliver this information to the Bull support. Case 2: The request must be processed manually.
  • Page 286: Tu31

    CLX Operator Messages 10.28 TU31 10.28.1 TU31 <clx version> CLX ATTEMPTS TO UNLOCK <volume> Description: This message can be issued during a resynchronization. A volume is mounted on a device and is locked by another system whereas the device is locked by the local system.
  • Page 287: Tu32 Clx Attempts To Cancel Mount Request Of On : Illegal Access To Volume

    Cartridge Tape Library UNIX Server User’s Guide 10.29.2 TU32 <clx version> CLX ATTEMPTS TO CANCEL MOUNT REQUEST OF <volume> ON <device>: ILLEGAL ACCESS TO VOLUME Description: There is an attempt to mount a volume not authorized to the local system. System Reaction: The mount request is canceled.
  • Page 288: Tu33 Clx Attempts To Dismount

    • the device is locked by another system, • the device is without volume for the library server but READY for the DPS 7000, • the volume cannot be dismounted (reason=ACS FULL). 47 A2 63UU Rev05 10-27...
  • Page 289: Tu35

    Cartridge Tape Library UNIX Server User’s Guide Case 2: The message is issued while the automatic processing is running if: • the device is offline, • the volume cannot dismounted (reason=ACS FULL). System Reaction: The device is put out of the configuration. It will never be selected. The command MDHW CTnn IN is ineffective.
  • Page 290: Acslm_Command_Code> On ()

    CLX Operator Messages 10.32.2 TU35 <clx version> CLX REPEATS REQUEST "<acslm_command_code> <device> (<driveid>)" Description: The server does not answer the request. This message can be issued for the following requests: QUERY DRIVE, QUERY LOCK DRIVE, LOCK DRIVE, UNLOCK DRIVE. System Reaction: Same as the first TU35 message.
  • Page 291: Tu35 Clx Waiting For Response To Request " ()

    Cartridge Tape Library UNIX Server User’s Guide 10.32.5 TU35 <clx version> CLX WAITING FOR RESPONSE TO REQUEST "<acslm_command_code> <device> (<driveid>)" Description: The server has acknowledged the request but has not sent any response. This message can be issued for the following requests: QUERY DRIVE, QUERY LOCK DRIVE, LOCK DRIVE, UNLOCK DRIVE.
  • Page 292: Tu36

    The following cases are examples. Case 1: To the DPS 7000, the device is in none of the following states: READY - HELD - STANDBY. A message TU36 DVMGT STATUS OF <device>: UNSTABLE STATE has just been issued for the same device.
  • Page 293: Tu37

    Cartridge Tape Library UNIX Server User’s Guide 10.34 TU37 10.34.1 TU37 <clx version> CLX REJECTS REQUEST "MOUNT <volume> ON <device>": DEVICE HELD Description: CLX does not process the request because the device is in a held state. This can happen if a device is held after the Device Manager sent the mount request. System Reaction: CLX drops the request.
  • Page 294: Tu37 Clx Rejects Request "Mount On ": Unknown Device

    CLX Operator Messages System Reaction: Case 1: CLX cancels the request for which the library server gave the abnormal status, then it drops the request for which the message is issued. If the mount request is repeated, CLX will try to process it. Case 2: No other mount requests should be issued for the device.
  • Page 295: Tu37 Clx Rejects Request "Dismount On ": Device Available

    Cartridge Tape Library UNIX Server User’s Guide 10.34.4 TU37 <clx version> CLX REJECTS REQUEST "DISMOUNT <volume> ON <device>": DEVICE AVAILABLE Description: The dismount request cannot be completed since no volume is mounted on the device. System Reaction: CLX drops the dismount request. User Action: None.
  • Page 296: Tu39

    A message including the error number and the system returned code is stored in the JOR of the CLX job. CLX aborts (severity 4). User Action: Save the message and the JOR, then call your Bull Support. 47 A2 63UU Rev05 10-35...
  • Page 297: Tu50 Clx Configuration File Error

    Cartridge Tape Library UNIX Server User’s Guide 10.37.2 TU50 <clx version> CLX CONFIGURATION FILE ERROR: < ERRNB = error_number, return-code > Description: CLX cannot read the configuration file. System Reaction: The error number and the system return code are dumped in the JOR of CLX. CLX aborts (severity 4).
  • Page 298: Tu50 Clx Configuration File Error: Invalid To < Value

    CLX Operator Messages User Action: If necessary, rectify the CLX configuration file, then stop and restart CLX. The <volume range> value must be of 1 to 6 characters. The characters can be replaced by asterisks (*) or periods (.). For a complete description of the allowed values, refer to "CLX Configuration on GCOS 7"...
  • Page 299: Tu50 Clx Configuration File Error: No Value For To - Default Value Is Assumed

    Cartridge Tape Library UNIX Server User’s Guide 10.37.6 TU50 <clx version> CLX CONFIGURATION FILE ERROR: NO VALUE FOR TO<xxx> - DEFAULT VALUE IS ASSUMED Description: The TO<xxx> parameter in the CLX configuration file is not declared. TO<xxx> can be: • TOSSI •...
  • Page 300: Tu50 Clx Configuration File Error - Wrong Drive_Id:

    CLX Operator Messages 10.37.8 TU50 <clx version> CLX CONFIGURATION FILE ERROR - WRONG DRIVE_ID: <driveid> Description: The driveid specified for a CTnn parameter is not correct. System Reaction: CLX stops (severity 4). User Action: Rectify the configuration file and restart CLX: the drive identifier must be composed of 4 numbers separated by a comma: <acs-number>...
  • Page 301: Tu50 Clx Configuration File Error

    Cartridge Tape Library UNIX Server User’s Guide For a complete description of the configuration parameters, refer to "CLX Configuration on GCOS 7" in Chapter 2. 10.37.10 TU50 <clx version> CLX CONFIGURATION FILE ERROR: NO DEVICE DEFINED Description: There is no correct device in the CLX configuration file. This may be the consequence of the combination of the following errors: •...
  • Page 302: Tu50 Clx Configuration File Error - Duplicate Drive_Id:

    CLX Operator Messages 10.37.11 TU50 <clx version> CLX CONFIGURATION FILE ERROR - DUPLICATE DRIVE_ID: <driveid> Description: The same drive identifier value is declared for at least two different CTnn parameters. System Reaction: CLX stops (severity 4). User Action: Rectify the configuration file, then restart CLX. 10.37.12 TU50 <clx version>...
  • Page 303: Tu50 Clx Configuration File Error - File Not Found

    Cartridge Tape Library UNIX Server User’s Guide User Action: Rectify the configuration file, then restart CLX. Use ACSSA commands "query lsm all" and "query drive all" to check the configuration of your library. If you need to know the driveid related to each device (CTnn), contact the person responsible for the data path(s).
  • Page 304: Tu50 Clx Configuration File Error - Invalid Poolid:

    CLX Operator Messages Use the ACSSA command "query lsm all" to know the configuration of your library. For a complete description of the configuration parameters, refer to "CLX Configuration on GCOS 7" in Chapter 2. 10.37.16 TU50 <clx version> CLX CONFIGURATION FILE ERROR - INVALID POOLID: <poolid>...
  • Page 305 Cartridge Tape Library UNIX Server User’s Guide • MAXTOACSLM • POOLID_18T • POOLID_36T • • NO_AUTOCR <value> stands for the first 11 characters of the incorrect keyword. System Reaction: The keyword is ignored. User Action: If necessary, rectify the keyword, and stop and restart CLX. For a complete description of the configuration parameters, refer to "CLX Configuration on GCOS 7"...
  • Page 306: Tu50 Clx Configuration File Error - Duplicate Vsn Modele:

    CLX Operator Messages System Reaction: The device is ignored. CLX stops (severity 4) if there is no valid device in the CLX configuration file. User Action: You should either put the missing device(s) out of configuration or rectify the configuration file, then stop and restart CLX, otherwise CLX will reject MOUNT messages from which the Device Manager selects the device.
  • Page 307: Tu50 Clx Configuration File Error: Invalid Vsn Model

    Cartridge Tape Library UNIX Server User’s Guide 10.37.22 TU50 <clx version> CLX CONFIGURATION FILE ERROR: INVALID VSN MODEL <vsn> Description: A VSN value containing more than 6 characters has been supplied in the CLX configuration file. Only the first 6 characters are displayed in the message. System Reaction: CLX aborts (severity 4, status 22000).
  • Page 308: Tu50 Keyword Poolid No More Supported - Use Poolid_18T And (Or) Poolid_36T

    CLX Operator Messages User Action: If you want to modify the default value, update the CLX configuration file stop and restart CLX to take into account the specified value. Otherwise, ignore the message. 10.37.25 TU50 <clx version> KEYWORD POOLID NO MORE SUPPORTED - USE POOLID_18T AND (OR) POOLID_36T Description: The POOLID keyword is found in the CLX configuration file.
  • Page 309: Tu51

    Cartridge Tape Library UNIX Server User’s Guide 10.38 TU51 10.38.1 TU51 <clx version> DOF7-PO SESSION CANNOT BE OPENED Description: Problem during the opening of the DOF 7-PO session that ensures the interface between the Device Manager and CLX. This prevents CLX from getting the DW messages.
  • Page 310: Tu52

    <error_proc_name , ERRNB = error_number, ABORT OF CLX > The step H_CLX stops with severity 4. The job CLX stops unless the JCL supplied for CLX installation has been modified by the System Administrator. User Action: Contact your Bull Support. 47 A2 63UU Rev05 10-49...
  • Page 311: Tu53

    The system or CLX error is dumped in the JOR of CLX: <H_CLX_EMNPHS <ERROR NUMBER xx > : <return-code> CLX stops (severity 4). User Action: Depends on the return-code value: ILLSEM: Contact your Bull support. DUPNAME: Contact your System administrator. NOINIT: Restart CLX later. TABOV, OPQOVLD Contact your System administrator, check the system’s...
  • Page 312: Tu54

    CLX Operator Messages 10.41 TU54 10.41.1 TU54 <clx version> CLX CANNOT SEND REQUEST TO ACSLS (VERIFY THAT COMMUNICATION LINK ARE ACTIVE) Description: CLX cannot send the current request to the library server. A component of the link is not operational: •...
  • Page 313: Tu55

    10.42.2 TU55 <clx version> HSL IS NOT ACTIVE Description: CLX cannot process mount/dismount request because HSL is not running on the DPS 7000. This message is obsolete. System Reaction: The step H_CLX stops with severity 4 status 22000, the job CLX stops unless the JCL has been modified by the System Administrator.
  • Page 314: Tu55 Socket Server Is Not Active

    10.42.3 TU55 <clx version> SOCKET SERVER IS NOT ACTIVE Description: CLX cannot process mount/dismount request because the socket server is not running on the DPS 7000. This message is obsolete. System Reaction: The step H_CLX aborts with severity 4 status 22000, the job CLX stops unless the JCL has been modified by the System Administrator.
  • Page 315: Tu56

    Cartridge Tape Library UNIX Server User’s Guide 10.43 TU56 10.43.1 TU56 <clx version> CLX INTERNAL ERROR: TABLE OF RESOURCE <table> OVERFLOW Description: The limit of a CLX table has been reached. The table can be TRSV (table of volumes) or TRSA (table of devices). This can happen when a new MOUNT message is issued, or when a MOUNT message is de-queued because waiting resources are available.
  • Page 316 CLX Operator Messages Statuses for the MOUNT request: NOT IN SAME ACS: CLX attempts to cancel the mount request. AUDIT IN PROGRESS: CLX waits and sends the request to the library server again as long as this status is returned. UNREADABLE LABEL: CLX attempts to cancel the mount request.
  • Page 317 Cartridge Tape Library UNIX Server User’s Guide Statuses for the DISMOUNT request: ACS FULL: CLX attempts to put the drive out of configuration. DRIVE AVAILABLE: Means <no volume mounted on the device>. The status is ignored by CLX. DRIVE IN USE Means <wrong lock identifier supplied by CLX>...
  • Page 318 LSM NOT IN LIBRARY DRIVE NOT IN LIBRARY LOCKID NOT FOUND User Action: Only if the failure persists. Depending on the status value, examine the configuration, hold the device, use the semi-automatic mode or contact you Bull support. 47 A2 63UU Rev05 10-57...
  • Page 319: Tu58

    3. It is restarted automatically. User Action: Depending on the situation, if the failure persists put the device out of configuration (command MDHW), cancel the job, use the semi-automatic mode or contact your Bull support. 10-58 47 A2 63UU Rev05...
  • Page 320: Tu58 Unsuccessful Request " ":

    User Action: If the failure persists, according to the acslm_command_code value, modify the configuration, or define the scratch pool, or add scratch volume, or use the semi- automatic mode, or contact your Bull support. 10.45.3 TU58 UNSUCCESSFUL REQUEST "<acslm_command_code>": acslm_response_status...
  • Page 321: Tu59

    Cartridge Tape Library UNIX Server User’s Guide 10.46 TU59 10.46.1 TU59 <clx version> ACSLM CANNOT FIND CARTRIDGE <volume> - AN AUDIT IS REQUIRED Description: Inconsistency between the request and the content of the library server data base. System Reaction: Depends on the request: The status MISPLACED TAPE was returned by the ACSLS for a MOUNT request: CLX attempts to cancel the mount request.
  • Page 322: Clx Not Running

    CLX Operator Messages 10.47.2 TU60 <clx version> DISPLAY_CLX COMMAND REJECTED: CLX NOT RUNNING Description: The command DISPLAY_CLX cannot be satisfied because CLX is not operational: either CLX is terminating or it is waiting for the ACSLS/ACLSM to be running. System Reaction: Ignores the command.
  • Page 323: Devices In Use

    Cartridge Tape Library UNIX Server User’s Guide System Reaction: The command is ignored. User Action: Use the GCL commands. 10.48.3 TU61 <clx version> TERMINATE_CLX REJECTED: DEVICES IN USE Description: The TCLX command is rejected before cartridges are mounted. System Reaction: The command is ignored.
  • Page 324: Tu62 Timeout On Acslm Request " ()": Not Acknowledged

    CLX Operator Messages This happens while CLX is operational. The message TU26 V3.0 NOW MOUNT & DISMOUNT REQUESTS ARE PROCESSED AUTOMATICALLY has been issued: After trying three times the request, CLX sends a query server request to know the ACSLM state. If the ACSLM is not operational, refer to "ACSLS Not Operational"...
  • Page 325: Tu62 Timeout On Acslm Request: No Response To " On ()

    Cartridge Tape Library UNIX Server User’s Guide 10.49.4 TU62 <clx version> TIMEOUT ON ACSLM REQUEST: NO RESPONSE TO "<acslm_command_code> <volume> ON <device> (<driveid>)" Description: When CLX sends a request to the library server, it triggers a timer for the value specified in the TORPRQ parameter of the CLX configuration.
  • Page 326: Tu62 Timeout On Acslm Request: No Response To "

    CLX Operator Messages System Reaction: Identical to the first message TU62. User Action: Wait for following messages. 10.49.7 TU62 <clx version> TIMEOUT ON ACSLM REQUEST: NO RESPONSE TO "<acslm_command_code>" Description: Identical to the previous message except that the <acslm_command_code> can be: QUERY SERVER, QUERY LSM, QUERY LOCK VOLUME (ALL).
  • Page 327: Tu64 Acslm Error: Status = Available With Mounted

    Cartridge Tape Library UNIX Server User’s Guide (Remember that CLX sends a mount scratch request to get a work volume mounted). User Action: If the request was a SET SCRATCH, the operator should verify that the pool declared in the CLX configuration file exists by using the ACSSA command "query pool."...
  • Page 328: Tu65

    A history about the failure is stored in CLX JOR. The step H_CLX aborts with severity 3. It is automatically restarted. User Action: Keep the JOR and give it to your Bull support. 10.51.2 TU65 <clx version> CLX EMERGENCY SHUTDOWN: SSI FAILURE Description: CLX has tried TOMAXSSI times to get responses from the library server for a request.
  • Page 329: Tu65 Clx Emergency Shutdown: Acslm Down

    Cartridge Tape Library UNIX Server User’s Guide 10.51.3 TU65 <clx version> CLX EMERGENCY SHUTDOWN: ACSLM DOWN Description: CLX detects a failure with the ACSLM. At least one of the components, the ACSLS or the ACSLM, is not operational. This may happen in the following situations: CLX has sent a command "query server"...
  • Page 330: Tu66 Work Volume Write Protected

    CLX Operator Messages 10.52.2 TU66 <clx version> WORK VOLUME <volume> WRITE PROTECTED: EJECTION REQUIRED A mount message has been issued for a work volume. The selected volume is protected by the protect switch. User Action: Get the volume serial number by using the EXTRACT_CLX_ERROR, then eject the cartridge by using the CLX command EJECT_VOLUMES.
  • Page 331: Tu66 Volume Error On Opening Clx Log File

    Cartridge Tape Library UNIX Server User’s Guide If you cannot find the reason for the problem, give Bull support the following components: • PRLOGC or the hard copy of the main console, • JCL of the job CLX (CLX.SLLIB..CLX), •...
  • Page 332: Tu66 Error On Closing Clx Log File

    CLX Operator Messages 10.52.7 TU66 <clx version> ERROR ON CLOSING CLX LOG FILE <rc> A Mount Work message is being processed. CLX has just detected that the selected volume is not a work volume, or the volume is a work volume in a write protect mode.
  • Page 333: Tu70 Ssi Is Stopped

    Cartridge Tape Library UNIX Server User’s Guide 10.53.2 TU70 <clx version> SSI IS STOPPED Description: This message is displayed in response to a TSSI command successfully completed. System Reaction: The communication between CLX and the library server is down. No command can be supplied to the server.
  • Page 334: Tu70 You Are Not Allowed To Run Clx Product

    System Reaction: The command is aborted, CLX cannot be running. User Action: Contact Bull support center. 10.53.6 TU70 <clx version> SSI IS NO MORE RUNNING Description: This message is displayed in response to a DSSI command when the SSI process is not running.
  • Page 335: Tu70 Error On Submitting Unix Command Return Code =

    XTA case Check the following on UNIX library server: . exec tcp service is available, . network name of the DPS 7000-XTA is known in /etc/hosts or in your DNS server, and check the following on the DPS 7000-XTA: . INTEROP7_BASIC active, 10.53.9...
  • Page 336: Tu70 Ssi Cannot Be Stopped

    XTA case check the following on UNIX library server: . exec tcp service is available, . network name of the DPS 7000-XTA is known in /etc/hosts or on your DNS server, and check the following on the DPS 7000-XTA: . INTEROP7_BASIC active, 10.53.10 TU70 <clx version>...
  • Page 337: Tu70 Ssi Cannot Be Started

    Cartridge Tape Library UNIX Server User’s Guide 10.53.11 TU70 <clx version> SSI CANNOT BE STARTED Description: This message is displayed when the SSI command is submitted but the SSI process is not running. System Reaction: None. User Action: If the ssi system is still running, check if the SSI process is running. If so, terminate SSI (TSSI) and restart it using the SSSI command.
  • Page 338: Tu70 The File Transfer Of From

    CLX Operator Messages 10.53.13 TU70 <clx version> THE FILE TRANSFER OF <unix file> FROM “SSI SYSTEM” TO GCOS 7 IS COMPLETED <unix file> name of UNIX file to transfer Description: This message is displayed in response to a GTCLXF command requesting transfer that is successfully completed from the ssi system System Reaction: None.
  • Page 339: The Unix Server In The File /Export/Home/Acsss/Log/Volrpt.log Launch Get_Clx_File To Transfer It On Gcos 7

    Cartridge Tape Library UNIX Server User’s Guide System Reaction: None, the command is terminated. User Action: Either the file does not exists, or CLX user is not created or access rights are not correct. • on UNIX server, check the name of the file to transfer, •...
  • Page 340: Tu71

    CLX Operator Messages 10.53.17 TU70 <clx version> THE VOLUME REPORT HAS FAILED, UNIX FAILURE MESSAGE IS BEFORE THIS MESSAGE Description: This message is displayed in response to a VOLRPT command abnormally terminated. Usually a UNIX error message (unknown host,...) is displayed before this message...
  • Page 341 Cartridge Tape Library UNIX Server User’s Guide Command values: • AUDIT ACS • AUDIT PANEL • AUDIT SERVER • AUDIT SUBPANEL • CANCEL LIB REQUEST • DEFINE POOL • DELETE POOL • EJECT LIB VOLUMES • ENTER LIB VOLUMES • ENTER UNLAB VOLUMES •...
  • Page 342: Tu71

    CLX Operator Messages 10.54.2 TU71 <clx version> <command> <command state> Description: This message is displayed when the processing of the ACSSA command is completed. It gives the result of the command. <command> : identifier of the ACSSA command Command values: •...
  • Page 343: Tu71 Acs= -- Freecells= Req.c/P: Au= / Mo= / Di= / En= / Ej= /

    Cartridge Tape Library UNIX Server User’s Guide System Reaction: None User Action: None. 10.54.3 TU71 <clx version> ACS= <ACS identifier> -<state>- FREECELLS= <free cells number> REQ.C/P: AU= <au_c> / <au_p> MO= <mo_c> / <mo_p> DI= <di_c> / <di_p> EN= <en_c> / <en_p> EJ= <ej_c> / <ej_p> Description: This message is displayed in response to a QUERY_CARTRIDGE_LIBRARY (ACS) command successfully completed.
  • Page 344: Tu71 Cap= -Pr= Sz= -

    CLX Operator Messages <di_p>: number of pending DISMOUNT command <en_c>: number of current ENTER command <en_p>: number of pending ENTER command <ej_c>: number of current EJECT command <ej_p>: number of pending EJECT command System Reaction: The command is successfully completed. 10.54.4 TU71 <clx version>...
  • Page 345: Tu71 Cap= [Prty= ] [Mode: ]

    Cartridge Tape Library UNIX Server User’s Guide State values: • IN DIAGnostic • OFFLINE • OFFline PENDing • ONLINE • RECOVERY System Reaction: The command is successfully completed. 10.54.5 TU71 <clx version> CAP= <CAP identifier> <status> [PRTY= <priority>] [MODE: <mode>] Description: This message is displayed in response to a SET_CAP_ATTRIBUTES command successfully completed.
  • Page 346: Tu71 Dr= -- Type= [Vol= ]

    CLX Operator Messages 10.54.6 TU71 <clx version> DR= <drive identifier> <status> -<state>- TYPE=<drive_type> [VOL= <volume identifier>] Description: This message is displayed in response to a QUERY_CARTRIDGE_LIBRARY (DRIVE), QUERY_CARTRIDGE_LIBRARY (MOUNT) or QUERY_CARTRIDGE_LIBRARY (MOUNT_SCRATCH) command successfully completed. Parameters Description: <drive identifier>: identifier of the drive <status>...
  • Page 347: Tu71 Dr= -Lck= Lck-Duration= Lck-Pending= Usr=

    Cartridge Tape Library UNIX Server User’s Guide 10.54.7 TU71 <clx version> DR= <drive identifier> <status> -LCK= <lock identifier> LCK-DURATION= <lock duration> LCK-PENDING= <lock_pending number> USR= <user identifier> Description: This message is displayed in response to a QUERY_CARTRIDGE_LIBRARY (LOCK_DRIVE) command that is successfully completed. Parameters Description: <drive identifier>: drive identifier <status>: status of the drive...
  • Page 348: Tu71 Lsm=--- Freecells= Req.c/P: Au=/ Mo=/ Di=/ En=/ Ej=/

    CLX Operator Messages Status values: • ACS NOT IN LIBRARY • DATABASE ERROR • INVALID ACS • INVALID LSM • LSM NOT IN LIBRARY • PROCESS FAILURE System Reaction: The command is successfully completed. 10.54.9 TU71 <clx version> LSM=<LSM identifier>-<state>-<status>- FREECELLS=<free cells number>...
  • Page 349: Tu71 No Locked Drive

    Cartridge Tape Library UNIX Server User’s Guide MO = MOUNT VOLUME command DI = DISMOUNT VOLUME command EN = ENTER_LIB_VOLUMES or ENTER_UNLAB_VOLUMES command EJ = EJECT_LIB_VOLUMES command <au_c>: number of current AUDIT commands <au_p>: number of pending AUDIT commands <mo_c>: number of current MOUNT commands <mo_p>: number of current MOUNT commands <di_c>: number of current DISMOUNT commands <di_p>: number of pending DISMOUNT commands...
  • Page 350: Tu71 No Locked Volume

    CLX Operator Messages 10.54.11 TU71 <clx version> NO LOCKED VOLUME Description: This message is displayed in response to a QUERY_CARTRIDGE_LIBRARY (LOCK_VOLUME) command if there is no locked volume in the cartridges library. System Reaction: The command is successfully completed. 10.54.12 TU71 <clx version> NUMBER OF VOLSERS EXTRACTED FROM CLX LOG = <number of volsers>...
  • Page 351: Tu71 Number Of Volumes Not Ejected

    Cartridge Tape Library UNIX Server User’s Guide 10.54.14 TU71 <clx version> NUMBER OF VOLUMES NOT EJECTED <number of volumes> Description: This message is displayed in response to an EJECT_LIB_VOLUMES command to indicate the number of volumes not ejected. <number of volumes> number of volumes not ejected (if not in library or in use) System Reaction: The command is completed.
  • Page 352: Tu71 Pool= - -Lwm= Hwm= []

    CLX Operator Messages System Reaction: The command is still running. User Action: Place labeled cartridge in CAP. 10.54.17 TU71 <clx version> POOL= <scratch pool identifier> - <status> -LWM= <low water mark> HWM= <high water mark> [<attribute>] Description: This message is displayed in response to a DEFINE_SCRATCH_POOL command successfully completed.
  • Page 353: Tu71 Pool= < Scratch Pool Identifier>

    Cartridge Tape Library UNIX Server User’s Guide 10.54.18 TU71 <clx version> POOL= < scratch pool identifier> <status> Description: This message is displayed in response to a QUERY_CARTRIDGE_LIBRARY (MOUNT_SCRATCH), DEFINE_SCRATCH_POOL or a DELETE_SCRATCH_POOL command successfully completed. <scratch pool identifier > identifier of the pool <status>...
  • Page 354: Tu71 Pool= Vol= -Media_Type= Cell=

    CLX Operator Messages <count>: number of scratch volume <low water mark>: Point at which warning message are sent as the scratch pool becomes depleted <high water mark>: point at which warning message are sent as volumes are added to the scratch pool <attribute>: attribute of the pool Attribute value: OVERFLOW...
  • Page 355: Tu71 Pool(S) Not Found Or Empty

    Cartridge Tape Library UNIX Server User’s Guide Media_type values: • 3480 • 3490E <cell identifier> identifier of the cell format : ACS,LSM,panel,row,column if volume in home position System Reaction: The command is successfully completed. 10.54.21 TU71 <clx_version> POOL(S) NOT FOUND OR EMPTY Description: This message is displayed in response to a QUERY_CARTRIDGE_LIBRARY (SCRATCH) if the specified scratch pool is unknown or empty.
  • Page 356: Tu71 Remove From Cap If No Error Follows

    CLX Operator Messages State values: • OFFLINE • ONLINE System Reaction: The command is successfully completed. 10.54.23 TU71 <clx_version> REMOVE <volume identifier> FROM CAP <CAP identifier> IF NO ERROR FOLLOWS Description: This message is displayed in response to EJECT_LIB_VOLUMES in order to inform the operator to remove cartridges from the specified CAP if no error is detected on the server.
  • Page 357: Tu71 Request Number

    Cartridge Tape Library UNIX Server User’s Guide Command values: • AUDIT ACS • AUDIT PANEL • AUDIT SERVER • AUDIT SUBPANEL • CANCEL LIB REQUEST • DEFINE POOL • DELETE POOL • EJECT LIB VOLUMES • ENTER LIB VOLUMES • ENTER UNLAB VOLUMES •...
  • Page 358: Tu71 Server -- Freecells= Req.c/P: Au= / Mo= / Di= / En= / Ej= /

    CLX Operator Messages 10.54.26 TU71 <clx version> SERVER -<state>- FREECELLS= <free cells number> REQ.C/P: AU= <au_c> / <au_p> MO= <mo_c> / <mo_p> DI= <di_c> / <di_p> EN= <en_c> / <en_p> EJ= <ej_c> / <ej_p> Description: This message is displayed in response to a QUERY_CARTRIDGE_LIBRARY (SERVER) command successfully completed.
  • Page 359: Tu71 Vol=

    Cartridge Tape Library UNIX Server User’s Guide 10.54.27 TU71 <clx version> VOL= <volume identifier> <status> Description: This message is displayed in response to the: EJECT_LIB_VOLUMES ENTER_LIB_VOLUMES ENTER_UNLAB_VOLUMES QUERY_CARTRIDGE_LIBRARY(CLEAN) QUERY_CARTRIDGE_LIBRARY(LOCK_VOLUME) QUERY_CARTRIDGE_LIBRARY(VOLUME) or QUERY_CARTRIDGE_LIBRARY (MOUNT) commands successfully completed. Parameters Description: <volume identifier> volume serial number <status>: status of the volume Status values: •...
  • Page 360: Tu71 Vol= -Media_Type= Cell= Max Use= Cur Use=

    CLX Operator Messages 10.54.28 TU71 <clx version> VOL= <volume identifier> <status> -MEDIA_TYPE= <media_type> CELL= <cell identifier> MAX USE= <max usage number> CUR USE= <current usage number> Description: This message is displayed in response to a QUERY_CARTRIDGE_LIBRARY (CLEAN) command successfully completed. Parameters Description: <volume identifier>...
  • Page 361: Tu71 Vol= -Media_Type= Loc=

    Cartridge Tape Library UNIX Server User’s Guide Status values: • INVALID VOLUME • PROCESS FAILURE • VOLUME AVAILABLE • VOLUME IN USE • VOLUME NOT IN LIBRARY <lock identifier>: identifier of the lock <lock duration>: duration of the lock in seconds <lock_pending number>: number of lock pending <user identifier>: identifier of the user associated to the lock System Reaction: The command is successfully completed.
  • Page 362: Tu71 Vol= []

    CLX Operator Messages 10.54.31 TU71 <clx version> VOL= <volume identifier> <status> <result> [<max usage number>] Description: This message is displayed in response to a SET_CLEAN_ATTRIBUTE command successfully completed. Parameters Description: <volume identifier> volume serial number <status>: status of the volume Status values: •...
  • Page 363: Tu71 Vol= Ejected From Cap

    Cartridge Tape Library UNIX Server User’s Guide Status values: • INCORRECT ATTRIBUTE • INVALID POOL • VOLUME IN USE • VOLUME NOT IN LIBRARY <result>: result of the command Result values: SCRATCH ATTRIBute RESET <pool identifier>: identifier of the scratch pool System Reaction: The command is completed.
  • Page 364: Tu72

    CLX Operator Messages 10.55 TU72 10.55.1 TU72 <clx version> <command> <status> [- <object> = <object identifier>] Description: This message is displayed when a given ACSSA command concerning a given object is abnormally terminated. <command>: identifier of the ACSSA command Command values: •...
  • Page 365 Cartridge Tape Library UNIX Server User’s Guide Status values: • ACS FULL • ACS NOT IN LIBRARY • ACS OFFLINE • AUDIT ACTIVITY • AUDIT FAILED • AUDIT IN PROGRESS • CANCELLED • CAP IN USE OR AUTOmatic • CAP NOT IN LIBRARY •...
  • Page 366 CLX Operator Messages • LOCKID NOT FOUND • LSM NOT IN LIBRARY • LSM OFFLINE • MESSAGE NOT FOUND • MESSAGE TOO LARGE • MESSAGE TOO SMALL • MISPLACED TAPE • MULTI ACS AUDIT • NOT IN SAME ACS • POOL NOT EMPTY •...
  • Page 367: Tu72 - Subcommand:

    Cartridge Tape Library UNIX Server User’s Guide User Action: None, the reason for the termination is displayed in the status message. If other status, contact your Bull Support Center. 10.55.2 TU72 <clx version> <command> - SUBCOMMAND: <subcommand> <return code> Description: The function requested is abnormally terminated;...
  • Page 368 SET SCRATCH <return code> return code of the command User Action: Using an ACSSA command, try to identify the reason for the abort, modify the command and restart it; otherwise contact your Bull Support Center. 47 A2 63UU Rev05 10-107...
  • Page 369: Tu72 Abnormal Message Catalog

    A history about the failure is stored in CLX JOR. The step H_CLX_ECMDACSSA aborts with severity 4. It is automatically restarted. User Action: Keep the JOR and give it to your Bull Support Center. 10.55.4 TU72 <clx version> ACSLS ERROR N.<error_number> Description: Serious abnormal behavior of ACSLS <error_number>...
  • Page 370: Tu72 Check That Ssi/System Is Active

    The command is abnormally terminated. No library command can be activated. It may be displayed by any command. User Action: Contact your Bull Support Center. 10.55.8 TU72 <clx version> CLX HAS NOT BEEN ACTIVATED Description: The requested command cannot be submitted because internal structure of CLX are not initialized, CLX has not been activated.
  • Page 371: Tu72 Erroneous Cap Identifier At Position

    10.55.10 TU72 <clx version> ERRONEOUS CATALOGED MESSAGE, KEY=<key> Description: Serious abnormal behavior of CLXACSSA. <key> identifies the key of the erroneous message. System Reaction: The command is abnormally terminated. User Action: Keep the JOR and give it to your Bull Support Center. 10-110 47 A2 63UU Rev05...
  • Page 372: Tu72 Erroneous Drive Identifier At Position

    CLX Operator Messages 10.55.11 TU72 <clx version> ERRONEOUS DRIVE IDENTIFIER AT POSITION <position in the list> Description: An erroneous drive identifier has been introduced in the list of drive. It may be displayed by the commands QUERY_CARTRIDGE_LIBRARY (DRIVE) and QUERY_CARTRIDGE_LIBRARY (LOCK_DRIVE). <position in the list>...
  • Page 373: Tu72 Erroneous Panel Identifier At Position

    Cartridge Tape Library UNIX Server User’s Guide 10.55.13 TU72 <clx version> ERRONEOUS PANEL IDENTIFIER AT POSITION <position in the list> Description: An erroneous panel identifier has been introduced in the list of panel. It may be displayed by the command AUDIT_CARTRIDGE_LIBRARY (PANEL). <position in the list>...
  • Page 374: Tu72 Erroneous Request Identifier At Position

    CLX Operator Messages System Reaction: The command is abnormally terminated. User Action: Modify or delete the erroneous port identifier and restart the command. 10.55.16 TU72 <clx version> ERRONEOUS REQUEST IDENTIFIER AT POSITION <position in the list> Description: An erroneous request identifier has been introduced in the list of request. It may be displayed by the command QUERY_CARTRIDGE_LIBRARY (REQUEST).
  • Page 375: Tu72 Erroneous Volume Serial Number At Position

    A mismatching between HPL and GCL procedures is detected. No library commands are available. It may be displayed by any command <GCL version>: GCL version used <HPL version>: HPL version used System Reaction: The command is abnormally terminated. User Action: Contact your Bull Support Center. 10-114 47 A2 63UU Rev05...
  • Page 376: Tu72 Error At Library Assignment: 10-115

    CLX Operator Messages 10.55.20 TU72 <clx version> ERROR AT LIBRARY ASSIGNMENT: <return code> Description: Assignment to the CLX.SLLIB library is refused. It may be displayed by the command EXTRACT_CLX_ERROR. <return code>: reason for the error System Reaction: The command is abnormally terminated. User Action: Check the access to the library CLX.SLLIB, and restart the command if the CLX.SLLIB library is free.
  • Page 377: Tu72 Error During Locking

    Cartridge Tape Library UNIX Server User’s Guide System Reaction: The command is abnormally terminated. User Action: Check the CLX.SLLIB library and subfile access, restart the command when they are free. 10.55.23 TU72 <clx version> ERROR DURING LOCKING <file name> <return code> Description: An error occurs during locking the specified file.
  • Page 378: Tu72 Error During Unlocking

    <return code>: gives the reason for the error System Reaction: The command is abnormally terminated. User Action: Check the file access, unlock the file if it is locked, and contact your Bull Support Center. 10.55.26 TU72 <clx version> ERROR DURING UPDATING <subfile name> <return code>...
  • Page 379: Tu72 Error While Reading The File

    Cartridge Tape Library UNIX Server User’s Guide An error occurs during reading the specified log subfile. The LOG file is not modified. It may be displayed by the command EXTRACT_CLX_ERROR. <subfile name>: name of the subfile < return code >: gives the reason for the error System Reaction: The command is abnormally terminated.
  • Page 380: Tu72 Error While Writing In The Subfile

    <error_number>: identifies the error inside the procedure H_CLX_ECMDACSSA. System Reaction: The command is abnormally terminated. User Action: Keep the JOR and give it to your Bull Support Center. 10.55.31 TU72 <clx version> LOOK AT LMU OR SERVER TO KNOW IF ACTION IS REQUIRED Description: This message happens when the library server did no answered to a command sent by GCOS.
  • Page 381: Tu72 No Response From The Library Server

    Cartridge Tape Library UNIX Server User’s Guide System Reaction: The command is still running. User Action: Check on the server console if an operator action is requested (i.e.: remove cartridge from CAP,...) and performed the action. If the server is not running, restart the server cancel the command (CLIBR); and restart the command.
  • Page 382: Tu72 No Volume To Extract

    This message occurs when an unknown error message is received from the library server. It may be displayed by any command. System Reaction: The command is abnormally terminated. User Action: Save log file, clxacssa message, and contact your Bull Support Center. 47 A2 63UU Rev05 10-121...
  • Page 383: Tu72 Subfile Already Exists

    Cartridge Tape Library UNIX Server User’s Guide 10.55.37 TU72 <clx version> SUBFILE <subfile name> ALREADY EXISTS Description: This message occurs when an EXTRACT_CLX_ERROR command is requested using an output file already created with REPLACE=0. It may be displayed by the command EXTRACT_CLX_ERROR. <subfile name>: name of the subfile to create System Reaction: The command is abnormally terminated.
  • Page 384: Tu72 Too Long Record

    CLX Operator Messages 10.55.39 TU72 <clx version> TOO LONG RECORD <record> ... IN SUBFILE <subfile- name> (MAX LENGTH=6) Description: An error occurs during getting the specified subfile. It may be displayed by commands EJECT_LIB_VOLUMES <record>: the first six characters of the erroneous record. <subfile name>: name of the file to get.
  • Page 385: Tu72 Unknown Subfile:

    Cartridge Tape Library UNIX Server User’s Guide 10.55.41 TU72 <clx version> UNKNOWN SUBFILE: <subfile name> Description: The specified subfile does not exist. It may be displayed by the commands EJECT_LIB_VOLUMES and EXTRACT_CLX_ERROR. <subfile name>: name of the file specified in the command System Reaction: The command is abnormally terminated.
  • Page 386: Tu72 Wrong Volume Id In Subfile At Line Number

    CLX Operator Messages 10.55.43 TU72 <clx version> WRONG VOLUME ID IN SUBFILE AT LINE NUMBER <line number> Description: This message is displayed when a wrong volume serial number has been introduced in the list of volume to eject. It may be displayed by the command EJECT_LIB_VOLUMES from a subfile enclosing a list of volume serial numbers.
  • Page 387 Cartridge Tape Library UNIX Server User’s Guide 10-126 47 A2 63UU Rev05...
  • Page 388: Return Status Information

    11. Return Status Information 11.1 Status code descriptions The following is a description of all <status> values that can appear in the messages described in Chapter 10. The list is alphabetized in order to help the reader find a particular status value. Please note that some of the requests (such as DISMOUNT, MOUNT, IDLE, VARY, and START) mentioned in this section are not delivered in the current release of CLX library commands.
  • Page 389 Cartridge Tape Library UNIX Server User’s Guide ACS_OFFLINE This is an unsolicited message which is sent when the ACS is varied offline. This unsolicited message is specific to IDLE and VARY request functions. AUDIT_ACTIVITY Whenever an AUDIT request function returns an intermediate response, an eject_enter response is returned to the request originator with this message_status value filled in and the audit_int_status field filled in with the appropriate status.
  • Page 390 Return Status Information CANCELLED A request was CANCELLED by the CANCEL request procedure. The current process is halted. On an ENTER request, the continuous mode of operation terminates when a CANCEL request is received. If a CANCEL request is issued against a pending ENTER request, that request is aborted.
  • Page 391 Cartridge Tape Library UNIX Server User’s Guide CAP_IN_USE OR AUTO On an AUDIT operation, ANY_CAP was specified in cap_id and the LSM specified in cap_id had no CAPs with a non-zero priority. On an AUDIT operation, ANY_ACS or ANY_LSM was specified in cap_id and the acs_id specified had no CAPs with a non-zero priority.
  • Page 392 Return Status Information CAP_OFFLINE The request cannot be completed because a specified component is contained in an offline or offline-pending CAP or the specified CAP is in an OFFLINE or OFFLINE-PENDING state. On a SET_CAP request, if the CAP state is STATE_DIAGNOSTIC, a SET_CAP request from the CSI cannot alter the enter processing mode of the CAP.
  • Page 393 Cartridge Tape Library UNIX Server User’s Guide COUNT_TOO_SMALL The count field in the message_header is less than the smallest count expected for this particular request. No acknowledge response is returned. This status is common to all library commands. DATABASE_ERROR The ACSLS detected a database consistency error while processing a request. This status is common to all library commands.
  • Page 394 Return Status Information On a MOUNT request, when a mount request attempts to mount a locked library drive without including the lock identifier of that library drive, the request is rejected. On a MOUNT_SCRATCH request, if the specified drive is locked with a lock_id different from the one specified in the MOUNT_SCRATCH request, the MOUNT_SCRATCH request is rejected.
  • Page 395 Cartridge Tape Library UNIX Server User’s Guide EJECT_ACTIVITY On a QUERY request, cartridges are being ejected from the LSM. On a QUERY request, cartridges are being ejected from the CAP. This return status is specific to QUERY request functions. ENTER_ACTIVITY On a QUERY request, cartridges are being entered into the LSM.
  • Page 396 Return Status Information On a SET_CAP request, if the CAP priority is not set to a value within the range of NO_PRIORITY and MAX_ PRIORITY, the request is rejected. No attributes are set. On a SET_CAP request, if CAP mode is not MODE_SAME, MODE_AUTOMATIC, or MODE_MANUAL, the request is rejected.
  • Page 397 Cartridge Tape Library UNIX Server User’s Guide On an ENTER request, if ALL_CAP is specified in cap_id with ANY_ACS or ANY_LSM is also specified, the request is rejected. On an ENTER request, if ALL_CAP is specified in cap_id and CONTINUOUS is not specified in extended_options the request is rejected.
  • Page 398 Return Status Information INVALID_LSM The Ism_id specified in the request is syntactically incorrect. On a VARY request function, ANY_LSM is specified in the CAP identifier. This status is common to all library commands. INVALID_MEDIA_TYPE This status code is returned by the MOUNT_SCRATCH request when a media type that is unknown to the system is given in the request, and is returned by the QUERY_MOUNT_SCRATCH request when ANY_MEDIA_TYPE or a media type that is unknown to the system is given in the request.
  • Page 399 Cartridge Tape Library UNIX Server User’s Guide INVALID_PANEL The panel_id specified in the request is syntactically incorrect. This status is common to all library commands. INVALID_POOL pool_id of SAME_POOL was specified in the DEFINE_POOL request. pool_id of COMMON_POOL or SAME_POOL was specified to the DELETE_POOL request.
  • Page 400 Return Status Information INVALID_ROW The ROW value in a subpanel_id or a panel_id specified in the request is out of range. It must be between MIN_ROW and MAX_ROW. This status is common to all library commands. INVALID_VOLUME The vol_id specified in the request is syntactically incorrect. On a venter request, if the request contains invalid volume identifiers, the tape cartridges that would have otherwise been assigned these labels remain in the CAP and are not entered into the ACS library.
  • Page 401 Cartridge Tape Library UNIX Server User’s Guide More than one library failure may cause eject or enter processing to terminate. All library failures encountered are reported in the event log, but only one failure is returned in the message status. On a VARY request, if a library failure occurs while a VARY OFFLINE request is trying to vary specified devices offline, the devices’...
  • Page 402 Return Status Information LSM_OFFLINE The request cannot be completed because a specified component is contained in an offline or offline-pending LSM, or the specified LSM is in an OFFLINE or OFFLINE-PENDING state. This status is common to all library commands. MESSAGE_NOT_FOUND The message_id specified in the request is valid, but not found to be associated with a current or pending request in the ACSLM.
  • Page 403 Cartridge Tape Library UNIX Server User’s Guide On a MOUNT request, using the volume identifier of the request, the ACSLM locates the tape cartridge in the ACS library. The ACSLM compares the external tape cartridge label of the tape cartridge found in the library with the volume identifier of the request.
  • Page 404 Return Status Information On a SET_SCRATCH request, if, after the set_scratch request has been processed, the number of scratch volumes in the specified pool is greater than or equal to the high_water_mark specified by the define_pool request. This return status is specific to DEFINE_POOL, MOUNT_SCRATCH, QUERY and SET_SCRATCH request functions.
  • Page 405 Cartridge Tape Library UNIX Server User’s Guide PORT_NOT_IN_LIBRARY The port_id specified in the request is syntactically valid, but is not in the current configuration. This status is common to all library commands. PROCESS_FAILURE The ACSLM was not able to spawn the request or the ACSLM received a process failure from a spawned process.
  • Page 406 Return Status Information On a VENTER request, if the request contains fewer volume identifiers than there are unreadable cartridges in the CAP, the unreadable tape cartridges that cannot be assigned labels remain in the CAP and are not entered into the ACS library. This component status is set for each volume not found.
  • Page 407 Cartridge Tape Library UNIX Server User’s Guide VOLUME_AVAILABLE On a QUERY_LOCK request, the specified volume is not locked. On CLEAR_LOCK and UNLOCK requests, an attempt was made to release the lock on a vol_id which was not locked. This return status is specific to CLEAR_LOCK, QUERY and UNLOCK request functions.
  • Page 408 Return Status Information VOLUME_IN_TRANSIT On a QUERY request, a specified tape cartridge is in transit (in-between a home location and a tape drive (or pass-thru port)). This return status is specific to QUERY request functions. VOLUME_IN_USE If an EJECT request attempts to eject a locked tape cartridge without including the lock identifier of that tape cartridge, the cartridge is not ejected.
  • Page 409 Cartridge Tape Library UNIX Server User’s Guide VOLUME_NOT_IN_LIBRARY The vol_id specified in the request is syntactically valid, but is not found in the database. During an ENTER operation, if the list of volume identifiers contains one or more duplicates, the first instance of the volume identifier causes the ACSLM to eject the tape cartridge with that volume identifier from the ACS library.
  • Page 410: Syntax Of Commands

    CLX COMMANDS For details on CLX commands, see "CLX Commands" in Chapter 6. A.1.1 SET_CLX_SSI (SCLXSSI) (new command for XTA) Function: Address UNIX library server for a DPS 7000-XTA. This command is automatically started bye the START_SSI COMMAND. Abbreviation: SCLXSSI...
  • Page 411: A.1.2 Start_Ssi (Sssi)

    SERVER=…. Default value: the value of G_CLX_SSI global variable, generally set by a previous SET_CLX_SSI (SCLXSSI) command. Comment: On a native DPS 7000 , OPEN7 must be active. On a DPS 7000-XTA, G_CLX_SSI global variable must have a valid value or SERVER=… must be given.
  • Page 412: Terminate_Ssi (Tssi

    SSI is terminated (refer to TERMINATE_CLX). SSI process is terminated automatically if OPEN7 is stopped. On a native DPS 7000, OPEN7 must be active. On a DPS 7000-XTA, G_CLX_SSI global variable must have a valid value or SERVER=… must be given.
  • Page 413: Display_Ssi (Dssi

    SERVER=…. Default value: the value of G_CLX_SSI global variable, generally set by a previous SET_CLX_SSI (SCLXSSI) command. Comment: On a native DPS 7000, OPEN7 must be active. On a DPS 7000-XTA, G_CLX_SSI global variable must have a valid value or SERVER=… must be given.
  • Page 414: Terminate_Clx (Tclx

    Syntax of Commands A.1.6 TERMINATE_CLX (TCLX) Function: Deactivates the CLX service on GCOS 7. Abbreviation: TCLX Syntax: TERMINATE_CLX [STRONG] [DUMP] TERMINATE_CLX STRONG = 0 | 1 DUMP = 0 | 1 Parameters: STRONG = 1 CLX is deactivated immediately, 0 CLX is deactivated after the mount/dismount requests in progress are completed.
  • Page 415: Modify_Clx (Mdclx

    Cartridge Tape Library UNIX Server User’s Guide A.1.8 MODIFY_CLX (MDCLX) Function: Activates or stops the CLX trace. CLX keeps the trace of the messages exchanged between the CLX and the ACSLS. The trace is displayed on the main console. It is also stored in SYS.LOGC and can be displayed by the job prlogc (sys.hsllib).
  • Page 416: Library Commands

    Syntax of Commands LIBRARY COMMANDS These commands can be used if CLX has been activated at least once since the last GCOS 7 system restart. They can be used if CLX is stopped. For details, see "Library Commands" in Chapter 6. A.2.1 AUDIT_CARTRIDGE_LIBRARY (AUDLIB) Function:...
  • Page 417 Cartridge Tape Library UNIX Server User’s Guide Parameters: OBJECT = designates the type of the device for the inventory. Possible values : ACS abbrev. AC , LSM abbrev. LS , PANEL abbrev. PA , SUBPANEL abbrev. SU . ACSID = identifier of the Automatic Cartridge Subsystem to be audited.
  • Page 418: Cancel_Lib_Request (Clibr

    Syntax of Commands A.2.2 CANCEL_LIB_REQUEST (CLIBR) Function: Terminates a current or pending library request. Abbreviation: CLIBR Syntax: CANCEL_LIB_REQUEST REQID = <Reqid> XTA case [SERVER=<ssi-host-name>/<ssi-port>] Parameters: REQID = request identifier of the request to be canceled. The request identifier may be obtained by the QLIB REQUEST command, it is a 5 decimal digits.
  • Page 419: Define_Scratch_Pool (Dfpool

    Cartridge Tape Library UNIX Server User’s Guide A.2.3 DEFINE_SCRATCH_POOL (DFPOOL) Function: Creates or modifies scratch pool(s). Abbreviation: DFPOOL Syntax: DEFINE_SCRATCH_POOL { POOL_LIST } } = <poollist> { POOLLS [ { LOW_MARK } } = <low_mark> ] [ { LWM [ { HIGH_MARK } } = <high_mark>...
  • Page 420 Syntax of Commands OVERFLOW = It specifies the overflow attribute for the specified scratch pool(s). If it is set to 1, scratch volumes are selected from the common scratch pool (pool 0) if mount scratch (MOUNT WORK) requests cannot be satisfied with a volume from the pool(s). Default value 1.
  • Page 421: Delete_Scratch_Pool (Dlpool

    Cartridge Tape Library UNIX Server User’s Guide A.2.4 DELETE_SCRATCH_POOL (DLPOOL) Function: Deletes empty scratch pool(s). Abbreviation: DLPOOL Syntax: DELETE_SCRATCH_POOL { POOL_LIST } } = <poollist> { POOLLS [SERVER=<ssi-host-name>/<ssi-port>] XTA case Parameters: POOL_LIST = List of up to ten pool identifiers specifying empty pools to delete.
  • Page 422: Eject_Lib_Volumes (Eject_Volumes, Ejvol

    Syntax of Commands A.2.5 EJECT_LIB_VOLUMES (EJECT_VOLUMES, EJVOL) Function: Ejects one or several cartridges from the cartridge library. The volume serial numbers (volsers - OCR labels - external labels) of the cartridges to be ejected are supplied in one of the following ways: −...
  • Page 423 Cartridge Tape Library UNIX Server User’s Guide Parameters: CAPID = identifier of the CAP (Cartridge Access Port) used to eject the cartridges. It is of the following format : (acs,lsm,cap). If a character * is specified in the acs field, the highest priority available CAP in the ACS containing a cartridge designated for ejection is selected.
  • Page 424: Enter_Lib_Volumes (Enter_Volumes, Envol

    Syntax of Commands Comments: The operator must remove the cartridges when the message TU71 REMOVE CARTRIDGES FROM CAP... is sent ejection is completed when the message TU71 EJECT VOLUMES COMPLETED is issued. ACSSA equivalent: EJECT command. Availability: SYSADMIN, OPERATOR. A.2.6 ENTER_LIB_VOLUMES (ENTER_VOLUMES, ENVOL) Function: Inserts one or more cartridges in the cartridge library...
  • Page 425 Cartridge Tape Library UNIX Server User’s Guide Parameters: CAPID = identifier of the CAP used to insert the cartridges. It is of the following format : (acs,lsm,cap). If a character * is specified in the acs field, the highest priority available CAP in the ACS containing a cartridge designated for ejection is selected.
  • Page 426: Enter_Unlab_Volumes (Enuvol

    Syntax of Commands Comments: The selected CAP must be in manual enter mode. You can check and modify the CAP mode by using the SETCAP command. Upon receiving an ENTER_LIB_VOLUMES command, the specified CAP is unlocked and a message is displayed instructing you to place the cartridges in the CAP.
  • Page 427 CAP. Insert the cartridge with missing or unreadable OCR labels in the CAP. If WORK volumes are inserted, they must be prepared again as WORK to become eligible for being used as WORK volumes by the local DPS 7000. ACSSA equivalent: VENTER command. Availability:...
  • Page 428: Extract_Clx_Error, (Exterr

    Syntax of Commands A.2.8 EXTRACT_CLX_ERROR, (EXTERR) Function : Retrieves from the CLX logs the list of volumes for which a specific incident has happened since the last EXTRACT_ CLX_ERROR operation, stores volsers of these volumes into the specified output library subfile and deletes references of them in the CLX logs.
  • Page 429: Query_Cartridge_Library (Qlib

    Cartridge Tape Library UNIX Server User’s Guide XTA CASE SERVER=…. Default value: the value of G_CLX_SSI global variable, generally set by a previous SET_CLX_SSI (SCLXSSI) command. Comments: Erroneous volumes are detected and registered in the CLX logs this command does not involve the library server.
  • Page 430 Syntax of Commands { [ ACSID = <acsid> { [ LOCKID = <lockid> ] } { [ { MEDIA_TYPE } { [ { } =<media_type> ] } { [ { MEDIA XTA case [SERVER=<ssi-host-name>/<ssi-port>] 47 A2 63UU Rev05 A-21...
  • Page 431 Cartridge Tape Library UNIX Server User’s Guide Input Parameters: OBJECT = designates the type of the device to get information about. Possible values : ACS (abbrev. AC) . CAP : Cartridge Access Cap CLEAN (abbrev. CLN ) : cleaning cartridges DRIVE (abbrev.
  • Page 432 Syntax of Commands If no object identifier is supplied , all objects of the specified type are displayed. VOLUME_LIST = list of up to ten volume serial numbers (volsers). It can be supplied if the specified object type is one among the following list: VOLUME, CLEAN, LOCK_ VOLUME, MOUNT.
  • Page 433 Cartridge Tape Library UNIX Server User’s Guide Outputs parameters: The returned information depends on the selected object type. Object type Label Sub- Returned information ordered label as mentioned in this list ACS identifier ACS current state FREECELLS number of free cells REQ.
  • Page 434 Syntax of Commands Object type Label Sub- Returned information ordered label as mentioned in this list LOCK_VOLUM volume identifier current activity state of the volume or status error lock identifier associated with the volume LCK- amount of time, in seconds, that the lock has been DURATION active LCK-...
  • Page 435 Cartridge Tape Library UNIX Server User’s Guide Object type Label Sub- Returned information ordered label as mentioned in this list next message(s): drive identifier one per drive ordered by proximity to the volume activity state of the drive or status error current state of the drive the volume identifier in the library drive.
  • Page 436: Set_Cap_Attributes (Setcap

    SERVER=…. Default value: the value of G_CLX_SSI global variable, generally set by a previous SET_CLX_SSI (SCLXSSI) command. This parameter is not needed on a DPS 7000 non-XTA, and must be specified on a DPS 7000-XTA if G_CLX_SSI global variable value is not valid.
  • Page 437: Set_Clean_Attribute (Setcln

    Cartridge Tape Library UNIX Server User’s Guide XTA CASE SERVER=…. Default value: the value of G_CLX_SSI global variable, generally set by a previous SET_CLX_SSI (SCLXSSI) command. Comments: The higher the priority value is, the more priority the CAP is. A CAP with priority of 0 is never selected unless specified in the command.
  • Page 438 Syntax of Commands Parameters : VOLUME_LIST = a list of up to 10 volume serial numbers specifying a list of volumes. ON = If set to 1, the cleaning attribute is set for the volume(s), then a value must be supplied for MAXUSE_NB.
  • Page 439: Set_Scratch_Attribute (Setscr

    Cartridge Tape Library UNIX Server User’s Guide A.2.12 SET_SCRATCH_ATTRIBUTE (SETSCR) Function: Sets or resets the scratch attribute for one of more tape cartridge(s) (volumes). Abbreviation: SETSCR Syntax: SET_SCRATCH_ATTRIBUTE { VOLUME_LIST } } = <volume list> { VOLLS [ ON = { 0 | 1 } ] POOLID = <poolid>...
  • Page 440: Clx Utilities

    GCOS_LIB = <gcos 7-library-name> GCOS_SUBFILE = <gcos 7-subfile-name> Parameters SERVER = UNIX server name which contains the file to be transferred to a DPS 7000 non-XTA. It is exclusive with the parameter OPEN7. XTA CASE SERVER=…. Default value: the value of G_CLX_SSI global variable, generally set by a previous SET_CLX_SSI (SCLXSSI) command.
  • Page 441: Exec_Clx_Volrpt (Volrpt

    Cartridge Tape Library UNIX Server User’s Guide A.3.2 EXEC_CLX_VOLRPT (VOLRPT) Function: Activates the volume report utility on the ESCALA or ESTRELLA library server. Abbreviation: VOLRPT Syntax: VOLRPT SERVER = <ESCALA or ESTRELLA server name> RPTFILE = 1 | 0 OPTIONS = <options value> [SERVER=<ssi-host-name>/<ssi-port>] Parameters: SERVER = UNIX server name on which the report is...
  • Page 442: What To Supply To Bull In Case Of A Problem

    B. What to Supply to Bull in Case of a Problem What you need to supply to your Bull support center in the event of a failure will depend on the nature of the failure. In general, it is better to supply too much information than too little.
  • Page 443 • the DVMGT journal segment 0.0.D.B. • your CLX configuration file • subfiles delivered by Bull in CLX.SLLIB and CLX.JCLLIB. • OPEN7 / HSL / TNS failure Supply JOR and DUMPs of OPEN7, HSL and TNS. • INTEROP7_BASIC failure on a DPS7000-XTA Supply the INTEROP7 log files in <V7000 directory>\interop7\<GCOS7_NAME>\STD\log...
  • Page 444: Subfiles Delivered In Clx.sllib

    C. Subfiles Delivered in CLX.SLLIB This JCL is delivered in the subfile CLX of the library CLX.SLLIB: JCL monitoring the step H_CLX $JOB CLX,HOLDOUT,JOR=NORMAL; $COMM ’CONFIG-FILE , DEBUG, LM-LIB, TRACE-JOR, LIBRARY,LOAD-SM ’ ; VALUES CLX_CONFIG, NIL, CLX.LMLIB,NTRACE,CLX.SLLIB,LOAD; JUMP &6; LOAD: SYSMAINT COMFILE=*IN;...
  • Page 445 # and moved into the CLX.SLLIB..CLX_CONFIG member. -Parameters followed by "*" must be adapted to the configuration site. -Others parameters must not be modified unless requested by Bull support. # TOSSI = MUST NOT BE MODIFIED # TOACSLM = MUST NOT BE MODIFIED...
  • Page 446 Subfiles Delivered in CLX.SLLIB formatted scratch volumes. # NO_AUTOCR "*": [VOL_ABS] [VOL_BUSY] no automatic cancel request (step abort) if volume absent or busy. - Delete the line if auto cancel request is required. # LOG "*" [WORK_PROTECT] [SCRATCH_NWORK] : logging of VSN requested for WORK_PROTECT and/or SCRATCH_NWORK volume.
  • Page 447 Cartridge Tape Library UNIX Server User’s Guide 47 A2 63UU Rev05...
  • Page 448: Other Gcos 7 Messages

    D. Other GCOS 7 Messages DW Messages CLX automates error handling procedures for the library cartridge transports. To simplify message filtering, the DW message code has been created and is used for the messages: DW06 SWITCH TO WRITE PROTECT DW07 SWITCH TO WRITE PERMIT (DW11 does not appear on the server) DW11 MOUNT DW12 RECOVER...
  • Page 449: Dv Messages

    Cartridge Tape Library UNIX Server User’s Guide Note that S is used in messages for a standard 36-track cartridge, even if the cartridge has been mounted on an 18-track device. The DW10 message is non-repetitive. DV Messages The following messages are the DV messages for the cartridge library: Reference to a non-standard volume, prior to GCOS 7 TS7458 DV50.ASSIGN NSTD VOLUME NOT ALLOWED FOR CT/LIB Reference of type MD=* DVC=CT/LIB/36T:...
  • Page 450: Utilities Message

    Other GCOS 7 Messages Utilities Message An attempt to use PREPARE_TAPE (PRPTP) with a modified volume name results in a step abort (Severity 3) and the following message: MEDIA NAME MODIFICATION NOT AUTHORIZED FOR CT/LIB This happens when the user has specified a different VSN from the old VSN for a library volume and did not use PREPARE_TAPESET (refer to "Label Consistency"...
  • Page 451 Cartridge Tape Library UNIX Server User’s Guide 47 A2 63UU Rev05...
  • Page 452: The Prepare_Tapeset Utility

    E. The PREPARE_TAPESET Utility Introduction PREPARE_TAPESET prepares one or several tapes in one session using the parameters submitted: • in a pre-prepared input file containing the details of the tapes to be prepared and optionally completed with the command parameters, •...
  • Page 453: Gcl Syntax

    Cartridge Tape Library UNIX Server User’s Guide GCL Syntax { PREPARE_TAPESET } { PRPTPST INFILE = { <input_file_description> | ::TN } DVC = device-class [ NEWLABEL = { $NATIVE | $NONE } ] [ DENSITY = { S35 | S75 } ] [ NBDRIVE = { 1 | * | n } ] [ ADJUST = { 0 | bool } ] [ RENAME = { 0 | bool } ]...
  • Page 454 The PREPARE_TAPESET Utility NEWLABEL The new label for the tape. Default: $NATIVE. ($NONE is not allowed for a cartridge library.) NEWNAME this parameter does not appear in the menu and is specified as an entry in the input file or in interactive mode.
  • Page 455 Cartridge Tape Library UNIX Server User’s Guide FORCE reserved for SYSADMIN. If 1, catalogued files in the volume are deleted but the catalog is left unmodified. No confirmation is requested from the operator. Default: 0 CTLACC reserved for SYSADMIN. Defines the security for the volume: ASIS (default for a standard volume): the security is left unchanged...
  • Page 456 The PREPARE_TAPESET Utility Parameters are entered in the file through either the Line Editor or FSE. There is no limit to the size of the records. The input file contains the descriptions of the tapes to be prepared. Each description may contain one or more lines. If a single description contains more than one line, each line must be terminated with a hyphen "-"...
  • Page 457 Cartridge Tape Library UNIX Server User’s Guide Tapes ct1 and ct2 will be processed normally. Tape ct3 (explicitly) has a $NATIVE label. Tape ct4 will be ignored since $NONE is not applicable. Tape ct5 will be processed normally: any valid files will be cleared (BYPASS is set).
  • Page 458: Jcl Syntax

    The PREPARE_TAPESET Utility JCL Syntax TAPEPREP INFILE = <input_file_description> [ DEVCLASS = device-class ] { NATIVE } ] [ OLDLABEL = { NSTD { NONE { NATIVE } ] [ NEWLABEL = { { NONE { S35 } ] [ DENSITY = { { S75 } ] [ NBDRIVE = { integer-1 } ] [ ADJUST = { 0 | 1 } ]...
  • Page 459 Cartridge Tape Library UNIX Server User’s Guide 47 A2 63UU Rev05...
  • Page 460: Glossary

    Glossary Symbol 4400 ACS Storage Technology Corporation Cartridge Tape Library with a capacity of approximately 6000 cartridges. ACS (Automated Cartridge System) Cartridge Tape Library subsystem composed of a Library Management Unit (LMU) and at least one Library Storage Module (LSM) connected to the LMU. ACS ID A unique identifier for an ACS.
  • Page 461 Cartridge Tape Library UNIX Server User’s Guide ACSLS Database Backup Database checkpoint (a snapshot of the data) and optimization for the ACSLS database system. The database backup is used at the database recovery to recover from a disk failure. It is created by the bdb.acsss utility.
  • Page 462 Tape Library IBM/VM server. CLX (Cartridge Library Client Through UNIX Server) The job, executing on the DPS 7000, that assures the interface between GCOS 7 and the Cartridge Tape Library UNIX server. This component is termed the Client System Component (CSC) by Storage Tek.
  • Page 463 It sends messages to the system operator when a manual operation is necessary. Device Name DPS 7000 identifier for the device. Example: CT01 to CT09. Dismount (Cartridge) The action of removing an unloaded cartridge from a cartridge transport and placing it in its storage cell.
  • Page 464 High Speed Link shared memory between GCOS 7 and OPEN7. Software Component allowing communication between GCOS 7 and OPEN7 . INTEROP7_BASIC GCOS7 and Windows2000 software packages replacing OPEN7 on DPS 7000-XTA, for communication on sockets. It provides also tools for INTEROP7 management. Inches per second.
  • Page 465 Cartridge Tape Library UNIX Server User’s Guide Label, Optical A synonym for OCR label. A six character alphanumeric label (which may consist of uppercase letters A -Z and numerals 0-9, hyphens, underscores, and blanks) attached to the side of the cartridge case, which contains the VOLSER of the cartridge both in human-readable form and in OCR/bar code.
  • Page 466 Optical Character Recognition Label. The spine of a cartridge contains an OCR/bar code label listing the volser (volume serial number). See also "Label, Optical." OPEN7 UNIX subsystem on DPS 7000 non-XTA (does not exist on DPS 7000-XTA).. Operator, Library The person responsible for mounting and dismounting cartridges manually on the transports of the cartridge tape library.
  • Page 467 Cartridge Tape Library UNIX Server User’s Guide Pass-Thru Port (PTP) In a multiple-LSM configuration, the assigned transport may not be attached to the LSM where the cartridge is stored. The PTP is a mechanism that allows cartridge transfers from one LSM to the next.
  • Page 468 SCSI Small Computer System Interface. With the TimberWolf cartridge tape library, a SCSI interface and a Wide SCSI Processor (WSP) assure the conversion of data between a DPS 7000 and a control unit (CU) serving the cartridge library drives. Semi-Automatic Mode In this mode, cartridges are mounted/dismounted by the robot, directed by ACSSA commands submitted by the library operator from the DPX/20 server console.
  • Page 469 Cartridge Tape Library UNIX Server User’s Guide U - W Unload (Cartridge) The cartridge transport rewinds the cartridge, replaces the end of the tape in the cartridge case, and puts the cartridge into a position where either manual or automated (robot) dismounting is authorized.
  • Page 470: Index

    Device class - CT/LIB 6-6 ACSSA commands 1-12, 6-1, 6-2, 6-31, 6-97 Directives 6-1, 6-5, 6-97 ACSSA utilities 6-1, 6-96 Dismounting volumes 5-3 DPS 7000/2xx/3xx 1-14 DPS 7000/4xx 1-14 DPS 7000/5xx/7xx 1-14 DPX/20 UNIX server 1-3 Cartridge Drive (CD) 1-2...
  • Page 471 Cartridge Tape Library UNIX Server User’s Guide IDRC data compaction 5-5 SCSI interface 1-5 Improved Data Recording Capability 5-5 Sharing volumes 7-3 Installation procedure of CLX 3.2 2-4 Silo (Library Storage Module) 1-14 Installation, CTL 2-5 Startup system configuration, CLX 2-19 Status codes 11-1 StorageTek 1-1 System startup configuration, CLX 2-19...
  • Page 472 ADRESSE / ADDRESS : _______________________________________ _______________________________________ Remettez cet imprimé à un responsable Bull S.A. ou envoyez-le directement à : Please give this technical publications remarks form to your Bull S.A. representative or mail to: Bull S.A. Bull HN Information Systems Inc. CEDOC...

This manual is also suitable for:

Dps 7000-xta

Table of Contents