The information contained in this document is subject to change without notice.
This document contains proprietary information which is protected by copyright. All rights are
reserved. No part of this document may be photocopied, reproduced, or translated to another
language without prior written consent of ADIC.
ADIC shall not be liable for errors contained herein or for incidental or consequential damages
(including lost profits) in connection with the furnishing, performance or use of this material
whether based on warranty, contract, or other legal theory.
All trademarks within this document are the property of their respective owners.
All rights reserved. No part of this document may be copied or reproduced in any form or by any
means, without prior written permission of ADIC Europe, ZAC des Basses Auges, 1 rue Alfred de
Vigny, 78112 Fourqueux, FRANCE.
ADIC Europe assumes no responsibility for any errors that may appear in this document, and
retains the right to make changes to these specifications and descriptions at any time, without
notice.
This publication may describe designs for which patents are pending, or have been granted. By
publishing this information, ADIC Europe conveys no license under any patent or any other right.
ADIC Europe makes no representation or warranty with respect to the contents of this document
and specifically disclaims any implied warranties of merchantability or fitness for any particular
purpose. Further, ADIC Europe reserves the right to revise or change this publication without
obligation on the part of ADIC Europe to notify any person or organization of such revision of
change.
Every effort has been made to acknowledge trademarks and their owners. Trademarked names are
used solely for identification or exemplary purposes, any omission is unintentional.
ADIC and ADIC Europe are trademarks of Advanced Digital Information Corporation.
ADICADIC EuropeADIC Germany Beteiligungs GmbH, KG
Tel.: +1 303-705-3900 ZAC des Basses AugesEschenstraße 3
Fax: +1-303-792-24651, rue Alfred de VignyD-89558 Böhmenkirch, Germany
ATAC: 1-800-827-382278112 Fourqueux, FranceTel:+00.800.9999.3822
www.adic.comTel.: +33.1.3087.5300
Fax: +33.1.3087.5301
Document number: 6-00345-01
Published: 26 Jul 2002Printed in the USA
ADIC CORPORATE • 11431 WILLOWS ROAD, NE • REDMOND, WASHINGTON, USA • 1-800-336-1233
ADIC • 8560 UPLAND DRIVE• ENGLEWOOD, COLORADO, USA • 1-800-827-3822
ADIC • 10 BROWN ROAD • ITHACA, NEW YORK, USA • 1-607-266-4000
This document contains the information and instructions necessary to set up and operate the
Distributed AML Server (DAS) software for version 3.0 and higher. The topics discussed in this
chapter are:
•Overview
•Intended Audience
•Organization
•Associated Documents
•Explanation of Symbols and Notes
•Assistance
Intended Audience
This guide is intended for use by system programmers and administrators working with the DAS
software.
1-
Organization
This publication contains the following chapters:
Chapter 1Introduction - Notes on the use of the manual
Chapter 2Description - Overview of the functions on the DAS
Chapter 3Safety - Information on the safe operation of the DAS
Chapter 4Installation and Configuration - Explanation of the tasks necessary for
installation and configuration
Chapter 5DAS Commands - Alphabetic list of all administrator commands
Chapter 6Messages - List of all messages and the relevant actions necessary
Chapter 7Utilities - Description of further utilities for working with the DAS
Chapter 8Communication Applications - Description of the communication
applications.
Chapter 9DAS ACI Firewall - Description of the configuration of the DAS ACI
firewall software.
Appendix AApplication Notes - Information on the installation of certain
applications
Index
Accociated Documents
You may wish to reference the following documents:
26 Jul 2002
Overview1-3
Release Version 3.12
•DAS V3.12 Release Notes
•DAS V3.12 Interfacing Guide
Explanation of Symbols and Notations
The following four types of notation identify important information or instructions by using
distinctive font styles.
Terms appearing on the AMU graphical user interface
Special Term, e.g., Manage Users
Operating element/key on the operating panel or the keyboard of the
AMU software.
Command line appearing in the operating system input window, e.g.,
[C:\]cd SDLC
Directory structure e.g., C:\SDLC
Assistance
If problems cannot be solved with the use of this document or if recommended training is
desired, contact the ADIC Technical Assistance Center (ATAC).
Toll free phone (North America)1.800.827.3822
Toll free phone (Western Europe & Japan)00.800.9999.3822
The following sections provide an introduction to the DAS environment, structure,
administrative commands, and functions. Refer to
Figure 2-1 .
2-
Figure 2-1UNIX and MVS with Shared AML
The DAS software is a client/server software product designed to provide shared access to an
ADIC AML system by up to 50 separate clients. This means that the clients can run on entirely
separate platforms while using various media in the AML system. The DAS software makes it
possible for backup, document management or HSM applications to have direct access to the
media in the ADIC AML systems.
DAS Working Environment
The AML system is controlled by the AML Management Unit (control path). The data from the
applications is sent directly to the drives independently of this (data path). The DAS software
supports a wide variety of UNIX systems, and also the BS2000 and Windows NT. Connection
to other operating systems such as MVS, VM or Tandem is made across another interface of the
AMU.
Structure of the DAS Software
The DAS software comprise two main components:
26 Jul 2002
Overview2-3
Release Version 3.12
•Server function
•ACI function (AML client interface)
DAS Client
The client software consists of a library of functions and an administration program (dasadmin).
The software is available for various platforms. A new client simply requires the standard
TCP/IP functions with ONC RPC (Remote Procedure Calls) support and an ANSI C compiler.
The applications access the open interface (ACI). See
Figure 2-2 .
Figure 2-2DAS Structure
Each client can be assigned specific access privileges to the AML.
•Functions (basic functions, extended or all functions)
•Drives
•Volsers (Volume Serial Number)
•Ranges of the I/O units
•Scratch pools
DAS Server
The server software is installed on the AMU, which is a computer running OS/2. See Figure 23 .
2-4Description
6-00345-01
Release Version 3.12
Figure 2-3Modules in the DAS
The DAS server software is divided into three parts:
•RPC server
•DAS manager
•Request Manager.
The RPC server is responsible for communicating with the clients on the TCP/IP network and
converts the requests and responses into the appropriate format.
The DAS manager controls access privileges and priorities and sends the authorized requests to
the Request Manager.
The Request Manager sets up the AMU commands and sends these commands to the AML
Management Software (AMU).
The dasdata.ini file is used to save information about drive allocation, volser allocation and
foreign assignment.
Command Processing
The following is a simplified representation of one possible sequence of commands:
•The application reserves a drive in the DAS for a mount.
•The application requests a medium from a daemon for this mount.
•The daemon generates the mount request for the medium and sends it together with
drive, media type and volser through the ACI to the DAS.
•DAS generates a mount command for the AMU.
•The AMU acknowledges the procedure to the DAS on conclusion of the process.
•DAS passes the response on to the calling daemon.
•The application writes data to, or reads data from, the medium.
•The application requests the daemon to unload the drive if this is successful.
•The daemon sends the unload command to the drive, and the dismount command to the
DAS through the ACI.
26 Jul 2002
Structure of the DAS Software2-5
Release Version 3.12
•DAS executes the command through the AMU and sends an acknowledgment to the
daemon.
DAS Commands
DAS administrator commands can be divided into four areas:
•Media management
•DAS management
•Client management
•Scratch pool management
Media Management
•Mount and dismount
•Change sides on the optical disk in the drive
•Insert and eject
•Inventory
•View the available media
•View the media status
•Catalog or remove foreign media
•Clean the drive
•Insert and eject the cleaning cartridge
DAS Management
•Delete command
•View outstanding commands
•Activate and deactivate barcode reading for mount, move and eject from DAS
•Shut down DAS
•Shut down AMU
Client Management
•Reserve/release a drive for a client
•Reserve/release a volser for a client
•Modify access privileges for client
•Modify execution parameters
Scratch Pool Management
•Add volser to the scratch pool
•Remove volser from the scratch pool
2-6Description
6-00345-01
Release Version 3.12
•Get volser from the scratch pool
•View scratch pool information
DAS Functions
The DAS Software passes on all permitted Distributed AML client requests to the AML
Management Software and facilitates AML system administration by means of the dasadmin
program and the configuration file config. In detail, the following individual operations are
executed on DAS:
•Communication with the ACI
•Communication with the AMU
•Configuration Management
•Client Authorization
•Command verification
•Error handling
•Mount and dismount media in the AML
•Work with foreign media
•Insert media in the AML
•Eject media from the AML
•HICAP support
•Scratch pool management
•Support of the dual AMU
•Services for drive cleaning
Communication with the ACI
The AML Client and the DAS software communicate using ONC RPC. Data is interpreted
identically on all platforms through XDR data conversion protocol.
There may be a delay between the command being sent to the AML system and full
acknowledgment (from a few seconds to a few minutes if the drives are busy at the time or if the
AMU command queue is full). For this reason, the RPC calls are setup so that the DAS calls the
relevant client back when the command has been completed. The RPC request is organized by
the TCP/IP Portmapper.
Communication with ACI Client
Communication with the ACI is implemented using the OS/2 Event mechanism. Compliance
with the response time following a command call is monitored by a timer. A command is timed
out or repeated if the command is not executed within the prescribed time.
26 Jul 2002
DAS Functions2-7
Release Version 3.12
The client is notified immediately when a command has been successfully completed. A
decision is made whether it is worth repeating the command or an appropriate error message
should be sent to the client, if an error occurs. The client will be notified if DAS error handling
is unsuccessful. An exception is made for an inventory command which requires a large amount
of time. This command will always be acknowledged immediately and the client will receive no
further feedback following a positive or negative conclusion.
Configuration Management
ADIC AML systems can be configured with a wide variety of storage systems, drives and I/O
units. This information is stored in the AMU in a configuration file (Refer to the AMU Reference Manual).
The DAS software can access the AMU configuration data to get media and system information.
In addition to this configuration data which is loaded from the file config when the program is
started, DAS requires further parameters of its own. These parameters are:
•Parameters for each client
♠Operating parameters
♠Access privileges for
♦drives
♦volser
♦I/O units
♦scratch pool
•Assignment of drives to volsers
•DAS Server statement
Client Authorization
Each client that has access to the DAS software must be authorized for the command.
Authorization is implemented by:
•Comparison of the client name with the sender's TCP/IP address (assignment in the
config file is by TCP/IP address or host name)
•Granting access privileges (complete or restricted)
•Assignment of privileges for devices (drives, volsers, I/O units, scratch pools)
WARNING The potential to limit access to media, drives and I/O units allows secure use
of different applications on one AML system.
Command Verification
Client requests are checked for:
•Command format and command syntax
•Parameter validity (drive, volser, I/O range etc.)
2-8Description
6-00345-01
Release Version 3.12
Error Handling
All client requests are buffered in DAS so that in the event of a communication error, the
command can be resumed without loss of data, therefore avoiding unnecessary error handling
measures. As soon as a client request is received by the DAS software:
•Command buffered (in RAM; this information is lost if there is a mains outage)
•Command to the dual AMU relayed to the dual DAS (if dual AMU is installed)
•Receipt confirmation sent to the client
•Command written to the AMU log file
•Command passed on to the AMU
•Response from AMU awaited for the preset time
•Client informed about the request status
The status of the drives and the cataloged foreign media are stored in the system file dasdata.ini.
Mount and Dismount Media in the AML
Mount and dismount are the basic AML functions for selecting the media from the archive using
volsers, inserting the medium in the drives and returning it to the archive after use.
Working with Foreign Media
There is no need to mount media which are to be inserted in a drive in the AML only once and
for a short time; instead such media can be introduced directly from the I/O unit into the drive
as foreign media even without a barcode label. This means that media which already have an
existing volser in the archive can be handled.
The areas in the I/O used for foreign media unit must be defined in the AMU configuration.
A symbolic volser can be assigned a coordinate using the catf command (Refer to the AMU
Reference Manual); this can then be used to perform a mount. See
Figure 2-4Assignment of Symbolic Volsers for Foreign Media
Figure 2-4 .
Inserting Media in the AML
The insert function through the I/O unit of the AML system can be used if new media is required
in the AML (scratch media or for replacing seldom-used media). The DAS server allows clients
with full access privileges (administrator) to insert media.
26 Jul 2002
DAS Functions2-9
Release Version 3.12
Ejecting Media from the AML
The eject function can be used through the I/O unit of the AML system to eject media which is
no longer needed or not needed at present. The slot in the archive is retained for the volser if
ejection is temporary, otherwise “Null volser” is entered and the slot becomes available for other
volsers.
Scratch Pool Administration
DAS supports the creation of scratch pools to administrate media which are released for
rewriting. The administrator can use the scratch pools to assign the media to be used to the
individual applications. DAS supports:
•The addition of volsers to a scratch pool
•The removal of volsers from the scratch pool
•Mounting a scratch medium from a scratch pool
•The output of the volser for the next available scratch medium
•The output of information to the scratch pool
HICAP Application
The large I/O unit of the AML/J system is known as HICAP (High Capacity). This I/O unit has
the unusual feature that the archive is open while media are added and the robotic controller in
the archive is shut down for safety reasons.
The request to open the HICAP is sent from the AMU to the DAS software. DAS reacts to this
as follows:
•All new commands from clients which require the robotic controller are rejected with
the EHICAPINUSE message.
•Commands remain in the queue; the timer sets longer time-outs for these commands.
The commands from the queue are processed when the AML/J system is available. The clients
are not informed of this new status.
Dual AMU Support
Important components can be implemented redundantly to give increased protection against
breakdown of the total ADIC AML system. Including a second PC (dual AMU) brings the dual
function of the DAS into operation. See
Figure 2-5 .
2-10Description
6-00345-01
Release Version 3.12
Figure 2-5Structure of Dual AMU Support
At run time, only one AMU and one DAS are active, while the second AMU is passive. The
active server is detected automatically and the DAS command is sent to that server.
The dasdata.ini is updated automatically on the passive DAS. In case of a switch, the passive
DAS has all actual information about the drive allocation, volser allocation and foreign
assignment. If the passive DAS is down, no updates are made between the dasdata.ini files. If
the ACI cannot find the active DAS, the ACI sends the command to the passive DAS and the
passive DAS sends the command to the passive AMU. This only works if the AMU routing is
working.
The passive AMU can be switched to active by using the switch command. The switch
command can be executed as normal or with the force option. Force means an immediate switch
through the passive server without first synchronizing the AMU database with the previously
active AMU.
The DAS software refuses new client commands by means of ESWITCHINPROG during the
switching process. All commands copied to the previously passive server are checked or
executed, and the clients are sent relevant acknowledgment following successful switching.
Knowledge and observance of these instructions is imperative for the safe operation of the
ADIC AML systems.
Avoid danger when maintaining and operating the machine by behaving in a safety-conscious
manner and acting judiciously.
NOTEIn addition to the safety instructions in this guide, local and professional safety
rules apply.
Hazard Alert Messages
ADIC classifies hazards in several categories. Table 3-1 shows the relationship of the symbols,
signal words, actual hazards, and possible consequences.
Table 3-1Hazard Alert Messagess
SymbolDamage toSignal WordDefinitionConsequence
Persons
Danger
Warning
Caution
Imminent
hazardous situation
Potential hazardous
situation
Less hazardous
situation
Death or serious
injury
Possible death or
serious injury
Possible minor or
moderate injury
3-
Persons
PersonsCaution
MaterialAttention
MaterialStatic Sensitive
NoteTips for operators
26 Jul 2002
Imminent
hazardous electrical
situation
Less hazardous
situation
Potential damaging
situation
Potential electronic
damaging situation
Important or useful
information
Death or serious
injury
Possible minor or
moderate injury
Possible damage
to the product or
environment
Possible damage
to the product
No hazardous or
damaging
consequences
No hazardous or
damaging
consequences
Overview3-3
Release Version 3.12
Validation
These instruction are valid for ADIC AML systems.
Supplementary safety provisions for any components used on the machine are not invalidated
by these instructions.
NOTEAny other manufacturer’s documentation forms part of the AML
•Install the DAS software on the AMU PC (OS/2 operating system)
•Configure the server software
•Install the ACI software on a UNIX computer and on Windows NT
•Setting up the working environment for the ACI
Installing the DAS Software
The DAS software for OS/2 is supplied on a diskette with an install program dasinst.cmd, an
install file and the decompression program. The DAS software for OS/2 also contains the ACI
for OS/2 software together with the server and the administrator program dasadmin. ADIC
recommends the use of the install program for the installation, but a manual install is also
possible.
Installation Using Dasinst.cmd
4-
Step 1If the DAS is running (window DAS/2 in the list task): Stop DAS with
C:> \das\bin\dasadmin shut now.
Step 2Insert the diskette containing the DAS software in the floppy drive of the AMU PC and
start the install program.
Step 3Select the install option.
1
2DAS Software Update from DAS 3.x to 3.x
3DAS Software Update from DAS 1.30x to 3.x
4DAS Software Update from DAS 1.20x to 3.0
5Deinstallation of the last update
6Deinstallation of complete DAS
7End
Step 4Follow the steps of the install program.
Choose option Y, if you have a DUAL-AMU. More parameter for DUALDAS will be
requested afterwards.
NOTEThe following step is for DUALDAS only.
New Installation of DAS Server Software
(Installation without backup of an older Version)
26 Jul 2002
Overview4-3
Release Version 3.12
Step 5Enter the TCP/IP name of the DUAL-AMU. (for the environment variable
DAS_PARTNER).
Enter the TCP/IP address in the form xxx.xxx.xxx.xxx. (assignment host name and IP
address will be written in the file hosts)
Step 6Copy all the client software into the c:\das\aci directory and follow the
instructions.
Step 7Remove the diskette from the drive
Installation Without the Install Program
You can skip this section if you have used the install program with success
Step 1Backup any DAS software (if present), and delete all files from the c:\das directory.
Step 2Create the directory on your hard disk if it does not exist.
md das
Step 3Change to the directory.
cd das
Step 4Insert the diskette containing the DAS software in the floppy drive of the AMU PC and
copy the DAS software into the DAS directory.
C\DAS:> copy a:\*.zip
Step 5Remove the diskette from the drive.
Step 6Unzip the DAS software.
C\DAS:> a:\unzip *.zip
Step 7Copy all the tar files from the second and third floppy to the c:\das\aci directory.
Step 8After installation is complete, the manual update of the config.sys file is necessary
Refer to Editing the Config.sys File.
Configuring the Server Software
The following sections provide information on editing the server software.
Editing the Config.sys File
ADIC recommends that the following amendments be made in the config.sys file so that the
administrator functions can be accessed on the OS/2 computer. The Libpath and the variables
DAS_SERVER, DAS_CLIENT and DAS_PARTNER will be written by the installation
program.
4-4Installation and Configuration
6-00345-01
Release Version 3.12
Step 1Open the config.sys file in the editor.
C\:> epm c:\config.sys
Step 2Append or add the following lines in config.sys.
LIBPATH=...C:\DAS\BIN;
SET DAS_SERVER=AMUA,AMUB
SET DAS_PARTNER=AMUB
SET DAS_CLIENT=AMUADMIN
SET DAS_EJECTAREAFULL=1
Refer to Installation and Configuration.
Step 3Save config.sys.
Step 4Restart the OS/2 computer to activate the changes to the configuration.
NOTEThis restart is only necessary after a new installation.
Editing the Startup.cmd File
ADIC recommends that the following amendments be made in the startup.cmd file so that the
DAS software is started automatically on the OS/2 computer during startup.
Step 1Open the startup.cmd file in the editor.
C\:> epm c:\startup.cmd
Step 2Append or add the following lines in startup.cmd.
call tcpstart
das\tools\os2sleep 20
CD \AMU
call AmuStart
cd \das
tools\os2sleep 20
call DasStart
cd bin
start DAS/2 AmuClient
exit
Step 3Save startup.cmd.
NOTEThis sample file for the startup.cmd is installed under
c:\das\tools\startup.smp. An explanation of the individual points in
the startup.cmd file can be found in the AMU Reference Manual
Editing the Config File
The config file contains all settings for access privileges, drive assignment and command
options. A sample of this file is stored as c:\das\etc\config.smp during installation.
26 Jul 2002
Configuring the Server Software4-5
Release Version 3.12
Step 1For manual and first time installation, copy the config.smp sample file to config.
C\:> copy \das\etc\config.smp das\etc\config
Step 2Open the config file in the editor.
C\:> epm \das\etc\config.
Step 3Append or add to config the required information.
Step 4Save config.
Configuration File
This section describes editing the config file and editing the statement structure.
Structure and Syntax of Config
Entries in the config file are structured according to the following scheme.
Statement_nameKeyword_name1 =
Keyword_parameter1,
Keyword_name2 = ...
There are three types of statements here:
•Client statement
•DriveToVol statement
•Server statement
Any line may contain a maximum of 100 characters. No special characters are permitted for
variables in the file (except for the TCP/IP host names and client names). The special characters
-, _, + and $ may be used in the TCP/IP host name and client name. The layout of the file (order
of statements, blank lines and spaces) is free, although ADIC recommends the structure of the
sample file as giving a clearer overview. Comment lines may be added if they begin with the
“#” character.
Definition of Ranges
Devices are assigned to the individual clients by the definitions in the config file. This
assignment is made in logical ranges in the AML. A logical range can be:
•a list of individual objects
•a continuous range
•an individual object
•keyword ALL
range = item |
item, item, ... |
item-item |ALL # contains all objects
4-6Installation and Configuration
6-00345-01
Release Version 3.12
Definition of Volser Ranges
The definition of the volser ranges is a special form of the definition of logical ranges. The
following rules apply for the volsers:
•A volser can have up to 16 alphanumeric characters
•Lowercase and uppercase letters (no special characters) and the numerals 0 to 9 are
valid characters.
•The number and type of characters at the beginning and end of a range definition must
match (e.g. ABC001 - ABC999, or 0001001 - 5638516, or 00aaAAa - 99zzZZZ).
•“a - Z” ranges also contain the numerals 0 to 9
Options
This section describes the avoid volume contention and dismount options.
Avoid Volume Contention Option
This option defines the error handling for a mount command on a volser which is not located at
the home position or drive on which is loaded with a cleaning cartridge.
avc:The command is immediately acknowledged negatively for a mount
command on a volser which has the attribute Mounted, Reverse_Side_Mounted, Ejected in the AMU database or if there is a
cleaning cartridge in the drive.
no_avc:For a mount command on a volser which has the attribute Mounted,
Reverse_Side_Mounted, Ejected in the AMU database or if there is a
cleaning cartridge in the drive, the command is placed in the command
queue and suspended until
♠The volser is shifted to the home position by a dismount
command.
♠DAS is terminated.
The default (no specification in the config file) is no_avc.
Dismount Option
This option defines the reaction to a mount command on a drive that is already occupied.
dismount: The command is immediately acknowledged negatively for a mount
command on a drive which has the attribute Occupied.
This requires that the client sends a dismount command.
no_dismount:The command is placed in the command queue and a dismount command
is automatically generated on this drive for a mount command on a volser
which has the attribute Occupied in the AMU database.
The default (no specification in the config file) is no_dismount.
26 Jul 2002
Configuration File4-7
Release Version 3.12
The Client Statement
A client statement is required for each client that accesses the server. The maximum possible
number of client statements is 50.
Syntax
Below the syntax of the client statement is shown.
Refer to Table 4-1 for an explanation of the keywords in the client statement
Table 4-1Client Statement
KeywordExplanation
Name of the client (the name must not be the client's TCP/IP name).
The following rules apply for the client name:
• The client name may consist of up to 64 characters
clientname
• Lowercase and uppercase letters and the numerals 0 to 9 and the special
characters -, _, + and $ are valid characters in the client name.
• The client name is case-sensitive
The client name DAS_SUPERVISOR has the special privilege of
reserving drives and undoing volsers.
The name of the relevant IP address of the client. The name must be
resolved either through the hosts file or through a domain name server.
host_name
The following rules apply for the names:
• The host name may consist of up to 64 characters.
• Lowercase and uppercase letters, the numerals 0 to 9 and up to 6 stops
are valid characters in the host name.
ip_address
The IP address of the client
The IP address has the format xxx.xxx.xxx.xxx.
Access privileges for the client.
requests
• basic: only mount and dismount commands are permitted
• extended: mount, dismount and all status commands are allowed
• complete: all commands are permitted
Flow control option, refer to Options.
options
• dismount or no_dismount: Automatic KEEP command
• avc or no_avc (avoid volume completion) wait for the KEEP command
of a volume which is already in use.
volumes
Assignment of the volser ranges available to the client
Up to 10 volser ranges can be assigned per client
Assignment of drives available to the client in a range, e.g. (DRV_VHS,
drive range
DRV_DLT, DRV_3480), or (DLT1 - DLT4) or (ALL). The name must
match that in the description field of the AMU configuration.
26 Jul 2002
Configuration File4-9
Release Version 3.12
Table 4-1Client Statement
KeywordExplanation
Assignment of ranges available to the client (Logical Range) in the I/O
insert area
range
eject area
range
scratch
pools range
unit for inserting media, e.g. (I01, I07, I66) or (I01 - I37) or (ALL). The
coordinates are assigned in the AMU configuration. It is possible to
interleave other operators or ejection fields with insertion fields.
Assignment of ranges (Logical Range) in the I/O unit available to the
client for ejecting media, e.g. (E01, E09, E99) or (E05 - E47) or (ALL).
The coordinates are assigned in AMU configuration. It is possible to
overlap with other users or other insertion fields.
Assignment of scratch pools available to the client. Scratch pool
administration is configured in AMU configuration.
Assignment can be by
• media type
• client or client group.
Different media types cannot be managed together in one scratch pool. The
following rules apply for the scratch pool names.
• The pool name may consist of up to 16+1 characters.
• Lowercase and uppercase letters (no special characters) and the numbers
0 to 9 are valid characters in the pool name.
• The keyword ALL gives access to all scratch pools.
• The keyword DEFAULT gives access to all default scratch pools.
• Default scratch pool names are formed from a combination of the word
DEFAULT and the AMU media type, e.g. DEFAULTC0
The DriveToVol Statement
The DriveToVol statement can be used for any drive in the AML system. Volser ranges are
assigned to specified drives by this statement. Media type (AMU) verification is independent of
this statement.
Syntax
Below an example of the DriveToVol statement is shown.
DriveToVol drive = drive-name, volsers
=((volumerange),(volumerange),.)
Each drive needs its own, complete statement. Drive ranges are not possible.
Table 4-2 gives an explanation of the keywords used in the DriveToVol statement.
Table 4-2Drive to Volser Range
KeywordExplanation
drive-name
volume rangeRange of volsers to be assigned to the drive
Name of the drive to which volsers are to be assigned. (Drive name
according to configuration in AMU)
4-10Installation and Configuration
6-00345-01
Release Version 3.12
The Server Statement
The server statement can be entered once in the config file. This sets optional parameters for
operating the dual DAS and for error handling. The server statement is required.
Syntax
Below an example of the server statement is shown.
See Table 4-3 for an explanation of the keywords used in the server statement.
Table 4-3Optional Parameters
Keyword Explanation
TCP/IP port address for communication between the active DAS and
dualdas_port
the passive DAS. (Default: 5000) The default value must be modified
if another application is occupying port 5000.
Number of internal iterations of the dismount command for an AMU
error of type “Cartridge not ejected from drive for.<0420>.
retry_keep
timeout_move
timeout_ei
logging_off
WARNING The dismount manager in the AMU software is equally
capable of executing this error handling. Make sure
that the command is configured so that it is not timed
out as a result of too many iterations.
Time in seconds, between the start of a mount or dismount command
and the response. If the command needs more time, the response is
ETIMEOUT. Default: 1800.
WARNING For higher values, change the timeout values for the
client. Change the environment variables on the client.
Time in seconds, between the start of a insert or eject command and
the respond. If the command need more time is the response
ETIMEOUT. Default: 1800.
WARNING For higher values, change the timeout values for the
client. Change the environment variables on the client.
Used to switch off log messages for DAS commands, use the name of
the DAS ADMIN command.
WARNING Currently, only the listd commands are supported.
Configuration File
An example below shows the combined use of all of the previously defined statements.
The settings must be compatible in order for DAS to function correctly with the AMU. The
settings in AMU with regard to the DAS software are described below. You can find precise
information on the AMU configuration in the AMU Reference Manual.
The settings are made in the Admin - Configuration... menu. See Figure 4-1 .
4-12Installation and Configuration
6-00345-01
Release Version 3.12
Figure 4-1Graphical Configuration Window
DAS is not shown as the host in AMU configuration.
Drives
Step 1Open the Drive Configuration window by double-clicking on the drive icon. Refer to
Figure 4-2 .
26 Jul 2002
DAS Configuration in AMU4-13
Release Version 3.12
Figure 4-2AMU-DAS Configuration for Drives
Step 2Modify the configuration
Step 3Finish configuration by clicking OK
I/O Unit
Step 1Open the EIF-Configuration window by double-clicking on the I/O unit icon. See
Figure 4-3 .
Figure 4-3EIF-Configuration Window
Step 2Open the relevant window by clicking on the Logical Ranges field. See Figure 4-4 .
Figure 4-4AMU-DAS Configuration for EIF Ranges
Step 3Modify the configuration.
4-14Installation and Configuration
6-00345-01
Release Version 3.12
•Add insertion ranges (Type: AMU Dynamic, Name: Ixx, where xx is 01-99)
•Add ejection ranges (Type: AMU Dynamic, Name: Exx, where xx is 01-99)
•Add foreign mount ranges (Type: Foreign)
WARNING Each name may only be defined once in the list. Ranges of type AMU Dynamic
may interleave. It is not permissible to interleave ranges of type foreign and
HACC Dynamic.
Step 4Quit the Logical Range window by clicking OK
Step 5Quit EIF-Configuration window by clicking OK
Step 6Save the changes by clicking Save
Step 7Open EIF-Configuration and Logical Ranges window once more
Step 8Modify the database with Update EIF
Scratchpools
Step 1Open Admin Scratch Pool.. from the menu. Refer to Figure 4-5
Figure 4-5Scratchpool Configuration
Installing the ACI Software
This section describes the process for installing the ACI software for a UNIX-client and for a
Windows NT client
UNIX-Client
During the DAS installation, the ACI software is copied into the c:/das/aci directory. The
desired tar file can be copied with a FTP program to the UNIX machine.
26 Jul 2002
Installing the ACI Software4-15
Release Version 3.12
Step 1Create the directory for the ACI software.
mkdir /usr/local/aci
Step 2Copy the ACI software to the directory created (ftp from the AMU) or (configuration
of the OS/2 ftp). Refer to the AMU Installation Guide.
$ cd /usr/local/aci
$ ftp amu_hostname
userid> useid
password> password
ftp> bin
ftp> get das/aci/filename
ftp> quit
Step 3Decompress the files to the /usr/local/aci directory.
tar -xvf /usr/local/aci/filename
Microsoft Windows NT Client Using RPC
Step 1Create the c:\aci directory.
Step 2Enter the ACI for and Windows NT disk in the drive a:
Step 3Unpack the file aci zip-file into the c:\aci directory.
Step 4Copy the file aci.dll, ezrpc32.dll, winrpc32.dll and dasadmin.exe into your Windows
system directory. (On Windows NT 4.0 it is the: \winnt\system32 directory).
Step 5Open Control Panel/System/Environment.
•Extend the path environment variable with ACI installation directory c:\aci.
•Define the environment variable DAS_SERVER. The value is the hostname where
DAS-server is running.
•Define the environment variable DAS_CLIENT. The value is the clientname of the NT
client which is defined in the DAS config file on the OS/2 computer.
Step 6Change to the c:\aci directory.
Step 7Install the portmapper by typing portinst. The portmapper should be set to start
automatically during the start of NT.
Step 8Remove the disk from the a: drive.
Step 9Reboot the NT machine.
4-16Installation and Configuration
6-00345-01
Release Version 3.12
Microsoft Windows NT Client Using RSH
This section describes the process for configuring DAS clients on the OS/2 PC. For further
information refer to
Windows 95/NT.
Step 1Enter the disk in the AMU-PC
Step 2Open an OS/2 window and enter.
copy a:aci.cmd c:\os2
Step 3Edit the C:\DAS\ETC\CONFIG file.
C:> epm c:\das\etc\config
Step 4Add a new client to the list of DAS clients.
WARNING For Dual AMU operations, it is recommended that both AMU client_names
client_name:alphanumeric name for authorization
ip_address / hostname: TCP/IP identification of OS/2 PC (AMU)
requests: complete
options: (avc, dismount)
volumes: up to 10 ranges of the media names
drives: alphanumeric names similar to the Description in the Graphical
Configuration DAS Client on the OS/2 PC of the DAS Interfacing guide for
Configuration DAS Client on the OS/2 PC
should be added to the configuration file.
Configuration in the AMU
Step 5Select TCP/IP and TCP/IP Configuration Icon to open the Window TCP/IP
Configuration
Step 6Configure and Start the RSH daemon on the AMU PC
Step 7Configure the Security for the RSH (Add the HOST-Name of the Windows-NT
machine to the list “HOST authorized to use RSH”)
Step 8Configure and Start a Telnet Deamon on the AMU PC (optional for VirOp
Administrator menu)
Step 9Save the CONFIG file on a floppy for print out.
Step 10 Close all applications on the AMU PC and restart the PC.
Configuration Windows for the ACI Client
Step 1Set the necessary environment variables:
26 Jul 2002
Installing the ACI Software4-17
Release Version 3.12
WARNING The following configuration is only necessary if you work with the dasadmin
command line.
See Table 4-4 for an explanation of the variables in configuring Windows for ACI.
Table 4-4Variables
VariableExplanation
DAS_SERVER
DAS_CLIENT
ACI_MEDIA_TYPEDefault media type for the commands
WARNING Start the environment variables on the startup with AUTOEXEC.BAT or your
on login script.
TCP/IP Identification of the AMU (OS/2) PC for the
commands
Name for authorization of the command related to the
configuration in file config on the AMU (OS/2) PC
Configuration of the UNIX-Client
Software
Configuration of the client is dependent on the platform used and the application which is to
access the AML system. Instructions on certain points can be found in the
For use of the ACI
•the library files must be made accessible to the system (set LIBPATH or create an
association)
•the environment variables must be set.
The two examples of environment variable configuration follow.
Applications.
Example of the C Shell
Alternatively the variables can also be entered in the .cshrc file to make the values universally
valid.
The environment variables listed must be set for each client. Refer to Table 4-5 .
Table 4-5Environment Variables for DAS
ParameterParameter TypeExplanation
DAS_SERVERrequired for ACI
DAS_CLIENTrequired for ACI
ACI_MEDIA_TYPEoptional for ACI
DAS_EJECTAREAFULL optional for DAS
DAS_PARTNER
ACI_TIMEOUT_MOVEoptional for ACI
ACI_TIMEOUT_EIoptional for ACI
required for DAS if
Dual-AMU installed
TCP/IP Identification of the AMU
(OS/2) PC for the commands
Name for authorization of the
command related to the
configuration in file config on the
AMU (OS/2) PC
Default media type for the
commands
Reaction to the AMU message
<1157>. There is no free eject
position in EIF-device.
1: message to the client (new
command to continue)
2: no message to the client
(automatic continuation once the
range has been opened and cleared)
information for the Server software,
where the Dual-DAS is installed.
Time for the ACI to wait for the
response to the commands mount
and dismount.
Default: 1800 seconds
Time for the ACI to wait for the
response to the commands insert,
insert2, eject, eject2, ejectcl.
Default: 1800 seconds
The DAS administrator can use the commands to set up and monitor the AML system. This
chapter provides full explanation of all commands in alphabetical order. A brief illustration of
the syntax can be obtained online by entering the command using the -h option
DAS Commands
DAS commands are divided into:
•Client management
•Media management
•DAS management
•Scratch management
All these commands are called with dasadmin
•from the C:\DAS\BIN directory on the OS/2 client
•from the /usr/local/aci/admin directory on the UNIX client
•from the system directory \winnt\system32
5-
Client Management Commands
This section provides a list and an explanation of the client management commands. See Table
5-1 .
Table 5-1Client Management Commands
CommandExplanation
allocdchanges drive reservation for clients
allocvreserves volsers for a client
listddisplays drive assignment for up to 16 drives
listd2displays drive assignment for up to 250 drives
listd3displays drive assignment for up to 250 drives
listd4displays drive assignment for up to 380 drives
listfdisplays information about foreign volsers
listvdisplays volser reservations
scoptemporarily modifies the working parameters
scop2temporarily modifies the working parameters
scaptemporarily modifies access privileges
showdisplays current access privileges and operating parameters
show2displays current access privileges and operating parameters
26 Jul 2002
Overview5-3
Release Version 3.12
Table 5-1Client Management Commands
CommandExplanation
typelistshows all drives or specific drives with matching media type
Media Management Commands
This section provides a list and an explanation of the media management commands. See Table
5-2 .
Table 5-2Media Management Commands
CommandExplanation
catfcatalogs foreign media
carrymove cartridge from one slot to another
cell_infodisplays information about devices and cartridges in the system
cleancleans drive
dismountremoves a cartridge from a drive and returns it to its original position
eif_confdisplays information about logical ranges in the EIF
eif_infodisplays information about logical ranges in the EIF
ejectejects cartridges from the AML (limited numbers)
eject2ejects cartridges from the AML
eject3ejects cartridges from the AML
ejectclejects cleaning cartridges from the AML
ejectcomthe specified volser will be completly moved to the EIF
flipflips the optical disk in the drive
getvolsertodrive displays the configured assignment of volsers to drives
getvoltosidedisplays information on the association of volsers to an optical disk.
insertinserts a few cartridges in the AML
insert2inserts many cartridges, including cleaning cartridges, in the AML
mountload cartridge with a volser into a drive
inventoryAMU database of the whole AML system checked and corrected
partinventoryAMU database of part of the AML system checked and corrected
qvolsrangedisplays the volser from the AMU database for a specified range
rmfremoves foreign media from the catalog
unload
viewdisplays information from the AMU database relating to a volser
view2displays current information for the specified volser range
volserinventory for inventory of a single volser
the robotic controller in the AML system operates the buttons on the
drive (e.g. unload button)
5-4DAS Commands
6-00345-01
Release Version 3.12
DAS Management Commands
This section provides a list and an explanation of the DAS management commands. See Table
5-3 .
Table 5-3DAS Management Commands
CommandExplanation
barcode
canceldeletes a command from the command queue
emailsends the message via email
killamuterminates AMU software (DAS, AMU and OS/2)
listdisplays the DAS command queue
list2provides enhanced information on executing requests
qversiondisplays the DAS and ACI version
pausedastransfers dasadmin to a passive state
pausedrivelogically sets a tape drive into "disable/enable" state
robhome makes the AML system inactive
robstatmakes the AML system active or queries status
shutdownshuts down the DAS software
snmpsends the message via SNMP
switchswitches between active and passive DAS for dual DAS
deactivates the AML barcode reader for the mount, carry and eject
commands
Scratch Management Commands
This section provides a list and an explanation of the scratch management commands. See Table
5-4 .
Table 5-4Scratch Management Commands
CommandExplanation
scr_getdisplays the next available scratch volser from the scratch pool
scr_infodisplays information relating to the scratch pool
scr_insertinserts a cartridge and adds it to the scratch pool
scr_mountplaces the next available scratch cartridge in the drive
scr_setadds cartridges in the AML system to the scratch pool
scr_set_rangeadds volser range in the AML system to the scratch pool
scr_unsetchanges cartridge status from scratch to unscratch
26 Jul 2002
DAS Commands5-5
Release Version 3.12
Command Description
Reserve Drive (allocd)
The allocd command changes the reservation status of a drive for a client.
Refer to Table 5-5 for a list and an explanation of the parameters for the allocd command.
Table 5-5Parameters for the Allocd Command
ParameterExplanation
drivedrive whose status is to be changed
new reservation status
UPnormal reservation of empty drive.
reserve a drive even if it is already reserved by
another client or occupied.
exclusive reservation, can only be undone by the
client itself or by DAS_SUPERVISOR.
remove the normal status of a reservation from
empty drive.
remove reservation even if the drive is reserved by
another client or occupied.
UP, FUP,
EXUP,
DOWN,
FDOWN
client
FUP
EXUP
DOWN
FDOWN
namechange reservation status for the client.
SHARED_ACCESS change reservation status for all clients.
This function is used in the management of drives with shared usage. Only one client can use a
drive at a time. Mount and dismount commands issued by other clients are rejected. A drive
must be released by its previous user before a client can normally use it.
NOTEThe drive can only be put in the DOWN status by FDOWN if the drive is
Also, refer to Display Drive Assignment (listd4).
The allocv command reserves the specified volser(s) for a client.
dasadmin allocv volserrange UP client
dasadmin allocv DOWN client
Refer to Table 5-6 for a list and an explanation of the parameters for the allocv command.
5-6DAS Commands
occupied.
Reserve Volsers (allocv)
6-00345-01
Release Version 3.12
Table 5-6Parameters for the Allocv Command
ParameterExplanation
volserrange range of volsers to be reserved
new reservation status
UP, DOWN
clientname of client under which the reservation is to be made
NOTEThe reserved volser can be only released by the client itself or the client
UPreserves the specified volser/volsers
DOWNremoves the reservation of all volsers for the client
DAS_SUPERVISOR.
Activate/Deactivate the Barcode Reader
(barcode)
The barcode command activates or deactivates the barcode reader of the specified robotic
controller for mount, and eject commands, but only for those commands sent by the DAS to the
AMU.
dasadmin barcode robotnumber ON|OFF
Barcode reading remains active for inventory and insertion even when barcode reading is
deactivated.
Refer to Table 5-7 for a list and an explanation of the parameters for the barcode command.
Table 5-7Parameters for the Barcode Command
ParameterExplanation
robotnumber
ON, OFF
number (R1 or R2) of the robotic controller whose barcode reader is to be
deactivated
new reader status
ONbarcode reader activated
OFFbarcode reader deactivated
Cancel Command (cancel)
The cancel command deletes commands from the DAS command queue.
dasadmin cancel request-id
dasadmin can request-id
Refer to Table 5-8 for an explanation of the parameter for the cancel command.
26 Jul 2002
DAS Commands5-7
Release Version 3.12
Table 5-8Parameter for the Cancel Command
ParameterExplanation
request-id
DAS sequence number (displayed using the list2 and list commands).
Refer to
Display All Active Commands (list2)
Move a Medium to the Slot (carry)
The carry command moves medium from one slot to another and re-assigns the medium home
position in AMU database if necessary.
dasadmin carry sourcecoor targetcoor [volser]
Refer to Table 5-9 for a list and an explanation of the parameters for the carry command.
Table 5-9Parameters for the Carry Command
ParameterExplanation
sourcecoor
targetcoor
volser
logical coordinate in the library the volser is to be moved from, e.g.
T104320908
logical coordinate in the library the volser is to be moved to, e.g.
T105010310.
the volser that should be moved. If the sourcecoor contain volser other
than specified, the command fails.
In some cases, the carry command works similar to the other media move commands. The
details are described at
Table 5-10 .
Table 5-10Details for the Carry Command
Source slot Target slotAnalogMedium home position Medium state
StorageStoragenoneChanges to target slotStored
StorageI/EnoneRemains unchangedStored
StorageDriveMountRemains unchangedMounted
I/EStorageInsertChanges to target slotStored
I/EI/EnoneRemains unchangedStored
I/EDriveMountRemains unchangedMounted
DriveStorageDismount Changes to target slotStored
DriveI/EDismount Remains unchangedStored
DriveDrivenoneRemains unchangedMounted
Also refer to Retrieve a Medium from the Drive (dismount), Eject Media (eject3), Insert Media (insert2), and Load a Medium in Drive (mount).
5-8DAS Commands
6-00345-01
Release Version 3.12
Catalog Foreign Volume (catf)
The catf command creates the association between the symbolic volser and the slot in the I/O
unit.
dasadmin catf [-t media-type] volser coordinate
Refer to Table 5-11 for a list and an explanation of the parameters for the catf command.
Table 5-11Parameters for the Catf Command
ParameterExplanation
media-typemedia type, e.g. 3590. Refer to Media Types.
volser
coordinate
Place the foreign media in the foreign range of the I/O unit. Now set up an assignment to a
symbolic volser using the dasadmin catf command (not required as a barcode on the cartridge
and may already exist as a volser in the database).
Place the cartridge in the drive using the mount command and the symbolic volser. Remove the
cartridge from the I/O unit after use and remove the symbolic volser from the catalog using the
rmf command.
symbolic volser to be assigned to the cartridge in the foreign cartridge
range in the I/O unit. A mount command is now possible for this volser.
10-digit logical coordinate in the I/O unit locating the cartridge, e.g.
E101020310.
Also refer to Remove a Foreign Medium (rmf).
WARNING This version does not have a command to display occupied symbolic volsers.
Make a careful note of this assignment; you will need the symbolic volser
again for the rmf command.
The coordinate in the I/O unit must be defined in the AMU database for the catf command
•Attribute: empty
•Type: foreign
Get Device Information (cellinfo)
The cellinfo command displays information about devices and cartridges in the system.
Refer to Table 5-12 for a list and an explanation of the parameters for the cellinfo command.
26 Jul 2002
DAS Commands5-9
Release Version 3.12
Table 5-12Parameters for the CellInfo Command
ParameterExplanation
SStorage
STtowers
SLlineardevices
Pall problemboxes
Dall drives
Device
Eall eject areas (logical ranges)
Iall insert areas (logical ranges)
Exxthe ejectarea "xx" (e.g. "E01")
Ixxthe insertarea "xx" (e.g. "I01")
STxx the tower “xx“ (e.g. “T01“)
SLxx the lineardevice “xx”
mediatypeElements media type. Refer to Media Types.
Slot attributes value:
Ooccupied ("Occupied" or "Temp Here" attribute)
Ymarked empty ("Empty" or "Initial" or "Temp Away")
attributes
Mmounted ("Mounted" or "In Jukebox")
Jejected
Uundefined
Etruly empty ("Marked empty" or "Total Ejected")
““all slots
The clean command triggers a single drive cleaning operation in the specified drive.
dasadmin clean drive
Refer to Table 5-13 for an explanation of the parameter for the clean command.
Table 5-13Parameter for the Clean Command
The AMU manages the cleaning cartridge and controls the amount of time spent by the cleaning
cartridge in the drive. The AMU clean manager must be configured already.
NOTEOnly clean the drives when they need to be cleaned. Unnecessary cleaning
Also, refer to Insert Media (insert2) and Eject Cleaning Media (ejectcl).
5-10DAS Commands
Drive Cleaning (clean)
ParameterExplanation
drivedrive to be cleaned immediately
damages the drives.
6-00345-01
Release Version 3.12
Retrieve a Medium from the Drive
(dismount)
The dismount command retrieves a medium from the drive and returns it to its original position
(home position) in the library.
The eject3 command causes the specified volser(s) to be placed in the I/O unit of the library
system.
dasadmin eject3 [-c] [-t media-type] volserrange area
dasadmin ej3 [-c] [-t media-type] volserrange area
Refer to Table 5-16 for a list and an explanation of the parameters for the eject3 command.
Table 5-16Parameters for the Eject3 Command
ParameterExplanation
-c
media-typemedia type, e.g. 3590. Refer to Media Types.
volserrange range of volsers to be ejected, e.g. 000001 - 000815 or 00001A, 00002A.
arealogical range in the I/O unit for ejection, e.g. E07
complete eject option (the volser lost its home position in the AMU
database and becomes ‘unloaded’)
The appropriate message will be displayed in the AMU log if the I/O unit is full. Ejection will
continue automatically once the I/O unit has been cleared and closed.
With the environment variable DAS_EJECTAREAFULL=1 the command will be canceled
(with the message EAREAFULL), if the eject area is full.
Eject Media (eject2)
The eject2 command causes the specified volser(s) to be placed in the I/O unit of the library
system.
dasadmin eject2 [-c] [-t media-type] volserrange area
dasadmin ej2 [-c] [-t media-type] volserrange area
NOTEThe command can only display up to 100 volsers when ejecting. Therefore, use
the eject3 command. For compatibility reasons, the eject2 command continues
to be supported.
Refer to Table 5-17 for a list and an explanation of the parameters for the eject2 command.
5-12DAS Commands
6-00345-01
Release Version 3.12
Table 5-17Parameters for the Eject2 Command
ParameterExplanation
-c
media-typemedia type, e.g. 3590. Refer to Media Types.
volserrange range of volsers to be ejected, e.g. 000001 - 000815 or 00001A, 00002A.
arealogical range in the I/O unit for ejection, e.g. E07
The appropriate message will be displayed in the AMU log if the I/O unit is full. Ejection will
continue automatically once the I/O unit has been cleared and closed.
With the environment variable DAS_EJECTAREAFULL=1 the command will be canceled
(with the message EAREAFULL), if the eject area is full.
complete eject option (the volser lost its home position in the AMU
database and becomes ‘unloaded’)
Eject Media (eject)
The eject command causes the specified volser to be placed in the I/O unit of the library system.
dasadmin eject [-c] [-t media-type] volserrange area
dasadmin ej [-c] [-t media-type] volserrange area
NOTEThe command can display only a small number of volsers when ejecting.
Therefore, use the eject3 command. For compatibility reasons, the eject
command continues to be supported.
Refer to Table 5-18 for a list and an explanation of the parameters for the eject command.
Table 5-18Parameters for the Eject Command
ParameterExplanation
-c
media-typemedia type, e.g. 3590. Refer to Media Types.
volserrange range of volsers to be ejected, e.g. 000001 - 000815 or 00001A, 00002A.
arealogical range in the I/O unit for ejection, e.g. E07
The appropriate message will be displayed in the AMU log if the I/O unit is full. Ejection will
continue automatically once the I/O unit has been cleared and closed.
With the environment variable DAS_EJECTAREAFULL=1 the command will be canceled
(with the message EAREAFULL), if the eject area is full.
complete eject option (the volser lost its home position in the AMU
database and becomes ‘unloaded’)
Eject Cleaning Media (ejectcl)
The ejectcl command causes the AMU Clean Manager to eject all used cleaning media in the
specified clean pool.
dasadmin ejectcl cleanpool area
26 Jul 2002
DAS Commands5-13
Release Version 3.12
Refer to Table 5-19 for a list and an explanation of the parameters for the ejectcl command.
Table 5-19Parameters for the Ejectcl Command
ParameterExplanation
cleanpoolname for assigning cleaning media for the Clean Manager, e.g. P04
arealogical range in the I/O unit for ejection, e.g. E07
The appropriate message will be displayed in the AMU log if the I/O unit is full. Ejection will
continue automatically once the I/O unit has been cleared and closed.
With the environment variable DAS_EJECTAREAFULL=1 the command will be canceled
(with the message EAREAFULL), if the eject area is full.
Eject Media Complete (ejectcom)
The ejectcom command places the specified volser(s) in the I/O unit of the library system and
unload them.
dasadmin ejectcom [-t media-type] volserrange area
NOTEActually, this command has the same effect as eject3 with the -c option.
Refer to Table 5-20 for a list and an explanation of the parameters for the ejectcom command.
Table 5-20Parameters for the Ejectcom Command
ParameterExplanation
media-typemedia type, e.g. 3590. Refer to Media Types.
volserrange range of volsers to be ejected, e.g. 000001 - 000815 or 00001A, 00002A.
arealogical range in the I/O unit for ejection, e.g. E07
The appropriate message will be displayed in the AMU log if the I/O unit is full. Ejection will
continue automatically once the I/O unit has been cleared and closed.
With the environment variable DAS_EJECTAREAFULL=1 the command will be canceled
(with the message EAREAFULL), if the eject area is full.
Also refer to Eject Media (eject3).
Send Email Message (email)
The email command sends email message.
dasadmin email address message
dasadmin email address @file_message
Refer to Table 5-21 for a list and an explanation of the parameters for the email command.
5-14DAS Commands
6-00345-01
Release Version 3.12
Table 5-21Parameters for the Email Command
ParameterExplanation
addressemail address the message should be sent to.
messagethe message text
the file that contains a message to sent.
file_message
Also refer to Send SNMP Message (snmp).
If the file is not in the same folder with dasadmin.exe, the filename
among with the complete path should be in double quotes.
Flip Optical Disk in the Drive (flip)
The flip command turns an optical disk over so that the reverse side can be read or written to.
dasadmin flip drive
Refer to Table 5-22 for an explanation of the parameter for the flip command.
Table 5-22Parameter for the Flip Command
ParameterExplanation
drivedrive where the disk must be flipped, e.g. Drive1
Display Volsers Assigned to Drive
(getvolsertodrive)
The getvolsertodrive command displays a list of all volsers assigned to the drive.
dasadmin getvolsertodrive [drive]
The assignment is configured in the config file. Refer to.
Refer to Table 5-23 for an explanation of the parameter for the getvolsertodrive command.
Table 5-23Parameters for the Getvolsertodrive Command
ParameterExplanation
drivedrive whose volsers are to be displayed, e.g. Drive1
Display Volsers of the Optical Disk
(getvoltoside)
The getvoltoside command displays both volsers for an optical disk.
dasadmin getvoltoside volser
Refer to Table 5-24 for an explanation of the parameter for the getvotoside command.
26 Jul 2002
DAS Commands5-15
Release Version 3.12
Table 5-24Parameters for the Getvoltoside Command
ParameterExplanation
volser
one of the volsers for the optical disk, the associated sides of which are
to be displayed, e.g. OD001A
Insert Media (insert2)
The insert2 command causes the AMU to place all media in the specified insertion range in slots
in the library. The volsers of the inserted media are displayed.
dasadmin insert2 -n area
dasadmin insert2 -c area cleanpool
Refer to Table 5-25 for a list and an explanation of the parameters for the insert2 command.
Table 5-25Parameters for the Insert2 Command
ParameterExplanation
-nnormal insertion (data media)
-cinserts cleaning media
arealogical range in the I/O unit for ejection, e.g. E07
cleanpoolname for assigning cleaning media for the Clean Manager, e.g. P04
Place the media in the I/O unit in the logical range for insertion before starting the insert
command (Refer to the AMU Reference Manual). AMU will analyses changes in the I/O unit
automatically once the I/O unit has been closed. The insert command can be used to:
•return a known volser in the AMU database to its home position, independent of the
attributes (ejected, empty, occupied, mounted) of the slot; the barcode reader
recognizes a volser which is already entered in the AMU database.
•place an unknown volser in the next free slot; this depends on the existence in the AMU
database of slots of the relevant media type having the status
Volser0000000000000000
Attributeempty
TypeAMU Dynamic
•place a medium in the problem box if it is not suitable for insertion at present
♠illegible barcode
♠AML full
♠slots in the AML already reserved for other volsers
The output of the insert2 command indicates which volser(s) were successfully inserted and
which, if any, were not.
5-16DAS Commands
6-00345-01
Release Version 3.12
Insert Media (insert)
The insert command causes theAMU to place all media in the specified insertion range at slots
in the library. The volsers of the inserted media are displayed.
dasadmin insert area
dasadmin in area
Refer to Table 5-26 for an explanation of the parameter for the insert command.
Table 5-26Parameter for the Insert Command
ParameterExplanation
arealogical range in the I/O unit for insertion, e.g. E07
Place the media in the I/O unit in the logical range for insertion before starting the insert
command (Refer to the AMU Reference Manual). AMU will analyses changes in the I/O unit
automatically once the I/O unit has been closed. The insert command can be used to:
•return a known volser in the AMU database to its home position, independent of the
attributes (ejected, empty, occupied, mounted) of the slot; the barcode reader
recognizes a volser which is already entered in the AMU database.
•place an unknown volser in the next free slot; this depends on the existence in the AMU
database of slots of the relevant media type having the status
Volser0000000000000000
Attributeempty
TypeAMU Dynamic
•place a medium in the problem box if it is not suitable for insertion at present
♠illegible barcode
♠AML full
♠slots in the AML already reserved for other volsers
NOTEUse the insert2 command instead of this command. This command experiences
difficulties with large I/O units with long volsers (16-digit) since the buffer for
displaying the inserted volser is restricted. For compatibility reasons, the insert
command continues to be supported.
Initialize Library Elements (inventory)
The inventory command causes the library system to compare all slots (towers and racks) with
the entries in the AMU database and to update the database in the event of any variances.
dasadmin inventory
26 Jul 2002
DAS Commands5-17
Release Version 3.12
If the volser found in the occupied slot has a valid home position in the AMU database, the old
home position is saved; if the volser home position is invalid or volser has no home position, the
inventory command assigns to it a new home position in a first free storage slot of the
appropriate type. The volsers with an attribute ‘ejected’ or ‘unloaded’ changes their state to
‘stored’. The volsers not found in the library after inventory changes their state to ‘offline’. The
problem box is not inventoried.
NOTEThe inventory function is intended for testing and startup. An error function
will only be displayed in the AMU log during operation which will not returned
to the calling process.
Also refer to Initialize Element Range (partinventory) and Display All Active Commands (list2).
Shut Down the AMU PC (killamu)
The killamu command is used to:
•move the robotic controllers in the AML system to their home position
•shut down all programs on the AMU PC
•shut down the OS/2 operating system
dasadmin killamu
WARNING Inform all administrators using the AML system before starting the
command. The command may cause disruption to their operation.
WARNING DAS sends a positive acknowledgment, before the process is complete. Wait at
least 5 minutes following the positive acknowledgment before switching off
the power supply. Switching off the power supply to the AMU PC too soon can
lead to loss of data.
NOTERestart the AMU kernel with START KRN/S.
Also refer to Shut Down DAS (shutdown).
Display All Active Commands (list2)
The list2 command displays all commands in the DAS command queue. The list2 command
provides enhanced information about executing requests. The commands for one client only are
shown.
dasadmin list2 client
Refer to Table 5-27 for an explanation of the parameter for the list2 command.
Table 5-27Parameters for the List2 Command
ParameterExplanation
clientclient for which the active commands are to be displayed.
dasadmin list2 CLIENT
list2 for client: CLIENT successful
client = CLIENT
The list command displays all commands in the DAS command queue. The commands for one
client only are displayed.
dasadmin list client
NOTEThis command is supported for compatibility reasons, it is limited with only a
Refer to Table 5-29 for an explanation of the parameter for the list command.
5-20DAS Commands
parameters are new in the list2 command.
Display All Active Commands (list)
small number of commands. Use the list2 command instead.
6-00345-01
Release Version 3.12
Table 5-29Parameters for the List Command
ParameterExplanation
clientclient for which the active commands are to be displayed.
dasadmin list CLIENT
list for client: CLIENT successful
client = CLIENT
request = 1
individ_no = 0
type = PINV
client = CLIENT
request = 7
individ_no = 0
type = MONT
Refer to Table 5-30 for an explanation of the return status associated with the list command.
Table 5-30Explanation of Returned Status for List Command
DisplayExplanation
clientclient for which the active commands are to be displayed.
requestsequence number of the DAS commands
individ_nonot used
MONTmount command
KEEPdismount command
INVTinsert command
MOVEeject command
type
PINVinventory command
SHUTAMU shut down (killamu)
INCLInsert Clean
EJCLEject Clean
BACOBarcode on/off
Display Drive Assignment (listd4)
The listd4 command displays the current drive assignment and status of reservations by the
clients. If the drive is not specified, all drives assigned for the client will be displayed. All drives
(maximum of 380) will be displayed if a client is not specified.
dasadmin listd4 [clientname] [-d drivename]
dasadmin ld4 [clientname] [-d drivename]
Refer to Table 5-31 for a list and an explanation of the parameters for the listd4 command.
26 Jul 2002
DAS Commands5-21
Release Version 3.12
Table 5-31Parameters for the Listd4 Command
ParameterExplanation
clientnameclient for which the reserved drives are to be displayed
Table 5-32 explanes the return status associated with the listd4 command.
Table 5-32Explanation of Returned Status for Listd4 Command
DisplayExplanation
drivedrive name in DAS (Description from the AMU configuration)
amu drivedrive number in DAS (Name from the AMUconfiguration)
streservation status of the drive
typedrive type (Type from the AMU configuration)
sysidnot used
clientclient which has reserved the drive
volservolser, if the drive is currently occupied
if a volser is displayed, and mount=1 and keep=0 then the drive is
mount
logically occupied but the mount is not physically complete
if a volser is displayed, and mount=0 and keep=0, then the drive is
logically occupied and mount is physically complete
if a volser is not displayed, and mount=0 and keep=1, then the drive is
keep
logically empty but the keep may not be physically complete
if a volser is not displayed, and mount=0 and keep=0 then the drive is
logically empty and the keep is physically complete
5-22DAS Commands
6-00345-01
Release Version 3.12
Table 5-32Explanation of Returned Status for Listd4 Command
DisplayExplanation
current cleaning activity:
cleaning
0 drive is not being cleaned
1 cleaning medium is located in the drive
clean_countnumber of mount commands until the next drive clean
serial number drive serial number
NOTEThe serial number parameter is new in the listd4 command.
Display Drive Assignment (listd3)
The listd3 command displays the current drive assignment and status of reservations by the
clients. If the drive is not specified, all drives assigned for the client will be displayed. All drives
(maximum of 250) will be displayed if a client is not specified.
dasadmin listd3 [clientname] [-d drivename]
dasadmin ld3 [clientname] [-d drivename]
NOTEUse the listd4 instead of this command. For compatibility reasons, the listd3,
listd2, and listd commands are still supported.
Refer to Table 5-33 for a list and an explanation of the parameters for the listd3 command.
Table 5-33Parameters for the Listd3 Command
ParameterExplanation
clientnameclient for which the reserved drives are to be displayed
Table 5-34 explanes the return status associated with the listd3 command.
Table 5-34Explanation of Returned Status for Listd3 Command
DisplayExplanation
drivedrive name in DAS (Description from the AMU configuration)
amu drivedrive number in DAS (Name from the AMU configuration)
streservation status of the drive
typedrive type (Type from the AMU configuration)
sysidnot used
clientclient which has reserved the drive
volservolser, if the drive is currently occupied
if a volser is displayed, and mount=1 and keep=0 then the drive is logically
mount
occupied but the mount is not physically complete
if a volser is displayed, and mount=0 and keep=0, then the drive is
logically occupied and mount is physically complete
if a volser is not displayed, and mount=0 and keep=1, then the drive is
keep
logically empty but the keep may not be physically complete
if a volser is not displayed, and mount=0 and keep=0 then the drive is
logically empty and the keep is physically complete
5-24DAS Commands
6-00345-01
Release Version 3.12
Table 5-34Explanation of Returned Status for Listd3 Command
DisplayExplanation
current cleaning activity:
cleaning
0 drive is not being cleaned
1 cleaning medium is located in the drive
clean_count number of mount commands until the next drive clean
NOTEThe mount and keep parameters are new in the listd3 command.
Display Drive Assignment (listd2)
The listd2 command displays the current drive assignment and status of reservations by the
clients. If the drive is not specified, all drives assigned for the client will be displayed. All drives
(maximum of 250) will be displayed if a client is not specified.
dasadmin listd2 [clientname] [-d drivename]
dasadmin ld2 [clientname] [-d drivename]
NOTEUse the listd4 instead of this command. For compatibility reasons, the listd3,
listd2, and listd commands are still supported.
Table 5-35 for a list and an explanation of the parameters for the listd2 command.
Table 5-35Parameters for the Listd2 Command
ParameterExplanation
clientnameclient for which the reserved drives are to be displayed
drivenamedrive that should be displayed
dasadmin listd2 Client
listd2 for client: successful
drive dlt01 amu drive: 01 st: DOWN type: E sysid: client: volser:
cleaning 0 clean_count: 0
drive: vhs01 amu drive: 02 st: DOWN type: V sysid: client:
volser: cleaning 0 clean_count: 0
Refer to Table 5-36 explanes the return status associated with the listd2 command.
Table 5-36Explanation of Returned Status for Listd2 Command
DisplayExplanation
drivedrive name in DAS (Description from the AMU configuration)
amu drivedrive number in DAS (Name from the AMU configuration)
streservation status of the drive
typedrive type (Type from the AMU configuration)
sysidnot used
26 Jul 2002
DAS Commands5-25
Release Version 3.12
Table 5-36Explanation of Returned Status for Listd2 Command
DisplayExplanation
clientclient which has reserved the drive
volservolser, if the drive is currently occupied
current cleaning activity:
cleaning
0 drive is not being cleaned
1 cleaning medium is located in the drive
clean_count number of mount commands until the next drive clean
Display Drive Assignment (listd)
The listd command displays the current drive assignment and status of reservations by the
clients. If the drive is not specified, all drives assigned for the client will be displayed. All drives
(maximum of 15) will be displayed if a client is not specified.
dasadmin listd [clientname] [-d drivename]
dasadmin ld [clientname] [-d drivename]
Refer to Table 5-37 for a list and an explanation of the parameters for the listd command.
Table 5-37Parameters for the Listd Command
ParameterExplanation
clientnameclient for which the reserved drives are to be displayed
drivenamedrive that should be displayed
listd for client: successful
drive dlt01 amu drive: 01 st: DOWN type: E sysid: client: volser:
cleaning 0 clean_count: 0
drive: vhs01 amu drive: 02 st: DOWN type: V sysid: client:
volser: cleaning 0 clean_count: 0
Table 5-38 explanes the return status associated with the listd command.
Table 5-38Explanation of Returned Status for Listd Command
DisplayExplanation
drivedrive name in DAS (Description from the AMU configuration)
amu drivedrive number in DAS (Name from the AMU configuration)
streservation status of the drive
typedrive type (Type from the AMU configuration)
sysidnot used
clientclient which has reserved the drive
volservolser, if the drive is currently occupied
5-26DAS Commands
6-00345-01
Release Version 3.12
Table 5-38Explanation of Returned Status for Listd Command
DisplayExplanation
current cleaning activity:
cleaning
0 drive is not being cleaned
1 cleaning medium is located in the drive
clean_count number of mount commands until the next drive clean
NOTEThe maximum number of drives displayed is 15.
Display Foreign Volser (listf)
The listf command displays the information about foreign volser. All foreign volsers are
displayed (up to 300) if no volser specified.
dasadmin listf [volser]
dasadmin lf [volser]
Refer to Table 5-39 for an explanation of the parameter for the listf command.
Table 5-39Parameter for the Listf Command
ParameterExplanation
volserthe foreign volser that should be displayed
dasadmin listf 000026
volser = 000026
coordinate = L801010302
media = 3480
attrib = M
Table 5-40 explanes the return status associated with the listf command.
Table 5-40Returned Status for Listf Command Explanation
DisplayExplanation
volserqueried volser (search criterion in theAMU database)
coordinate10-digit logical coordinate specifying the slot.
mediavolser media type. Refer to Media Types
26 Jul 2002
DAS Commands5-27
Release Version 3.12
Table 5-40Returned Status for Listf Command Explanation
DisplayExplanation
current status of the slot (attributes)
O occupied (slot occupied, medium is in its home position)
E ejected (slot empty, medium has been placed in the I/O unit)
M mounted (slot empty, medium has been placed in a drive)
Iinitial (attribute not used)
attrib
Jin jukebox (slot empty, optical disk has been placed in the jukebox)
R reverse mounted (slot empty, optical disk has been placed in a drive)
Y empty (slot empty, no medium defined for the slot)
U undefined (special attribute, used by HACC/MVS)
T temp here (slot occupied, medium in the problem box)
A temp away (medium temporarily not at the specified coordinates)
Display Volser Reservation (listv)
The listv command displays all reserved volsers for the client. All reserved volsers for all clients
will be displayed if no client is specified.
dasadmin listv [client]
Refer to Table 5-41 for an explanation of the parameter for the listv command.
Table 5-41Parameter for the Listv Command
ParameterExplanation
clientclient for which the reserved volsers are to be displayed
Load a Medium in Drive (mount)
The mount command places the medium with the specified volser in a drive. The drive can be
specified or will be selected by DAS such that:
•it is suitable for the media type
•it is reserved for the executing client (allocd)
•it is assigned to the volser (getvolsertodrive)
•it has the least number of uses (Use Count AMU database value).
dasadmin mount [-t media-type] volser [drive]
dasadmin mo [-t media-type] volser [drive]
Refer to Table 5-42 for a list and an explanation of the parameters for the mount command.
5-28DAS Commands
6-00345-01
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.