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.
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 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 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 ......................
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, •...
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...
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.
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.
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...
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.
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.
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...
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)
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 •...
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), •...
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.
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.
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...
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 : •...
- 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...
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.
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, •...
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...
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) -->...
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 −...
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.
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.
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...
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.
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.
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,...
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.
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.
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.
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).
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.
-/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.
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.
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.
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.
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.
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.
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.
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: •...
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.
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"...
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).
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),...
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"...
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"...
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.
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;...
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.
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.
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...
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...
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...
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.
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>...
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 •...
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.
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.
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>...
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.
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).
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.
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>...
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...
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...
/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 =>...
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...
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. •...
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.
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.
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...
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.
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.
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.
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.
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:...
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.
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 ...]...
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;...
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.
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.
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.
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.
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 =...
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.
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.
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.
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.
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.
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.
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:...
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.
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.
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.
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...
(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...
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.
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.
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: •...
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...
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: •...
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.
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.
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).
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.
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...
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.
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>...
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>...
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>...
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.
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...
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.
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) •...
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...
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>...
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, •...
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.
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.
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.
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...
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...
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.
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.
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.
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.
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"...
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).
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.
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.
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"...
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.
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.
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.
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.
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.
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.
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.
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.
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.
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...
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.
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.
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.
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.
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.
• 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...
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.
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.
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.
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.
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.
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.
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.
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...
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).
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"...
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 •...
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>...
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: •...
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>...
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).
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"...
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.
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).
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.
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.
<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...
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...
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: •...
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.
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.
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...
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...
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...
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.
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.
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.
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"...
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.
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).
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."...
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.
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"...
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.
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), •...
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.
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.
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.
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...
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>...
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.
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.
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, •...
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 •...
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: •...
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>...
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.
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...
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>...
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...
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>...
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.
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.
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>...
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...
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.
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.
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: •...
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.
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: •...
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.
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 •...
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...
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>...
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.
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...
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>...
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>...
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).
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...
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.
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.
<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>...
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.
<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.
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.
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...
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.
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.
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.
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.
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.
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...
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.
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.
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.
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).
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.
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 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.
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.
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.
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.
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:...
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.
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 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.
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.
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.
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.
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...
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...
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.
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...
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:...
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"...
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 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).
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 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...