Adic Server Manuel d'utilisateur

The ADICDistributed AML ServerDAS V3.10E Interfacing Guide

viii Contents 601626-Bdas_force . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7d

4-58 DAS ACI Functions 601626-BIf the eject area is full the system stops the eject procedure. Depending on the DAS_EJECTAREAFULL environment variable

aci_ejectclean 4-5921 Dec 2001 • EBADCLIENT• ERETRYL• EINUSE• ECANCELED• EDASINT• ENOMATCH• ETIMEOUT• ESWITCHINPROG• ENOPOOL• EAREAFULL• EHICAPINUSE•

4-60 DAS ACI Functions 601626-BFigure 4-48 Example of the aci_ejectclean Functionaci_emailThe aci_email function sends email messages. See Figure 4-49

aci_flip 4-6121 Dec 2001 Only supported by the Scalar DLC software.Return Values• 0: The call was successful.• -1: The call failed.The external varia

4-62 DAS ACI Functions 601626-BReturn Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the foll

aci_flip 4-6321 Dec 2001 • EBARCODE• EAREAFULLSee Figure 4-51 for an example of the aci_flip function.Figure 4-51 Example of the aci_flip Function/*

4-64 DAS ACI Functions 601626-Baci_forceThe aci_force function dismounts any cartridge from a specific drive. See Figure 4-52.Figure 4-52 aci_force Fu

aci_force 4-6521 Dec 2001 • EBADCLIENT• ENOTMOUNTED• ECANCELED• EDASINT• ENOMATCH• ETIMEOUT• ESWITCHINPROG• EHICAPINUSE• ECOORDINATE• EBARCODE• EINVA

4-66 DAS ACI Functions 601626-Baci_foreignThe aci_foreign function catalogs a foreign volume. SeeFigure 4-54.Figure 4-54 aci_foreign Function CallWhen

aci_foreign 4-6721 Dec 2001 This version does not have a command to display occupied symbolic volsers. Please note this assignment; the symbolic vols

Contents ix21 Dec 2001 Error Recovery Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3Te

4-68 DAS ACI Functions 601626-BFigure 4-55 Example of the aci_foreign Function.aci_getvolsertodriveThe aci_getvolsertodrive function gets the configur

aci_getvolsertodrive 4-6921 Dec 2001 Figure 4-57 aci_voltodrive_entry StructureSee Table 4-26 for a description of the parameters for the aci_getvols

4-70 DAS ACI Functions 601626-BFigure 4-58 Example of the aci_getvolertodrive Functionaci_getVolserToSideThe aci_getvolsertoside function returns the

aci_getVolserToSide 4-7121 Dec 2001 Figure 4-60 Structure of Type aci_sideinfoThe define ‘ACI_SIDE_NUMBER’ parameter is set, in aci.h, to 2. See Tabl

4-72 DAS ACI Functions 601626-BFigure 4-61 Example of the aci_getvolsertoside Functionaci_initThe aci_init function initializes the AML for client use

aci_init 4-7321 Dec 2001 Return Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the following

4-74 DAS ACI Functions 601626-Baci_initializeThe aci_initialize function initializes ACI library for client use. See Figure 4-64.Figure 4-64 aci_initi

aci_insert 4-7521 Dec 2001 aci_insertThe aci_insert function inserts volumes into the AML. See Figure 4-66.Figure 4-66 aci_insert Function CallThis f

4-76 DAS ACI Functions 601626-BUse the insert2 function instead of this command. This function experiences difficulties with large I/O units with long

aci_insert2 4-7721 Dec 2001 • EBARCODE• EAREAFULLRefer to Figure 4-67 on page 4-77 for an example of the aci_insert function.Figure 4-67 Example of t

xContents 601626-B

4-78 DAS ACI Functions 601626-B• Volsers which already have a entry in the AMU database, will be moved to this position.• Volsers which have no entry

aci_insert2 4-7921 Dec 2001 Return Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the follow

4-80 DAS ACI Functions 601626-B• EDATABASE• ENOTSUPPHCMD• EAREAEMPTY• ENOPOOL• EBARCODE• EAREAFULLSee Figure 4-70 for an example of the aci_insert2 fu

aci_inventory 4-8121 Dec 2001 aci_inventoryThe aci_inventory function performs a physical inventory of the AML. See Figure 4-71.Figure 4-71 aci_inven

4-82 DAS ACI Functions 601626-B• EHICAPINUSE• ECOORDINATE• EBARCODESee Figure 4-72 for an example of the aci_inventory function.Figure 4-72 Example of

aci_killamu 4-8321 Dec 2001 Return Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the follow

4-84 DAS ACI Functions 601626-Baci_listThe aci_list function lists outstanding requests for a client. See Figure 4-75.Figure 4-75 aci_list Function Ca

aci_list 4-8521 Dec 2001 See Table 4-31 for an explanation of the req_types.Table 4-30 Parameters for the aci_list Function CallParameter Description

4-86 DAS ACI Functions 601626-BReturn Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the foll

aci_list2 4-8721 Dec 2001 aci_list2The aci_list2 function lists executing requests for a client. See Figure 4-78.Figure 4-78 aci_list2 Function CallL

Figures Figure 2-1 Logical Relationship Between AML Components . . . . . . . . . . . . . . .2-3Figure 4-1 aci_barcode Function Call . . . . . . . . .

4-88 DAS ACI Functions 601626-BSee Table 4-33 for an explanation of the req_types.Table 4-32 Parameters for the aci_list2 Function CallParameter Descr

aci_list_foreign 4-8921 Dec 2001 Return Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the f

4-90 DAS ACI Functions 601626-BFigure 4-81 Example of the Returned StructureRefer to Table 4-34 for a description of the parameters for the aci_list_f

aci_mount 4-9121 Dec 2001 aci_mountThe aci_mount function mounts a volume in a drive. See Figure 4-82Figure 4-82 aci_mount Function CallMount the vol

4-92 DAS ACI Functions 601626-B• EDRVOCCUPIED• EPROBVOL• EAMU• EAMUCOMM• EROBOTCOMM• EDASINT• EDEVEMPTY• ENOTAUTH• EUPELSE• EBADCLIENT• ERETRYL• EINUS

aci_partial_inventory 4-9321 Dec 2001 Figure 4-83 Example of the aci_mount Functionaci_partial_inventoryThe aci_partial_inventory function inventorie

4-94 DAS ACI Functions 601626-BThe aci_partial_inventory function is intended for testing and startup. An error function will be displayed in the AMU

aci_partial_inventory 4-9521 Dec 2001 Return Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of

4-96 DAS ACI Functions 601626-Baci_perrorThe aci_perror function writes DAS error text to standard error. See Figure 4-86.Figure 4-86 aci_perror Funct

aci_qversion 4-9721 Dec 2001 aci_qversionThe aci_qversion function queries the version string of ACI and DAS component. See Figure 4-88.Figure 4-88 a

x Figures 601626-BFigure 4-22 aci_drivestatus4 Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-29Figure 4-23 Returned Stat

4-98 DAS ACI Functions 601626-BFigure 4-89 Example of the aci_qversion Functionaci_qvolsrangeThe aci_qvolsrange queries the list of available volsers.

aci_qvolsrange 4-9921 Dec 2001 Figure 4-91 Amount of Listed VolsersSee Figure 4-92 for the aci_volserinfo function structure.Figure 4-92 Structure fo

4-100 DAS ACI Functions 601626-BIf the startvolser and endvolser parameters are set to the NULL string ("" or ’\0’), a search will start at

aci_qvolsrange 4-10121 Dec 2001 Return Values• 0: The call was successful.• 1: More data is available.• -1: The call failed.The external variable d_e

4-102 DAS ACI Functions 601626-BFigure 4-93 Example of the aci_qvolsrange Function/* Query volser range */int rc = 0;char szBeginVolser[ ACI_VOLSER_L

aci_register 4-10321 Dec 2001 aci_registerThe aci_register function registers a client. See Figure 4-94.Figure 4-94 aci_register Function CallClients

4-104 DAS ACI Functions 601626-BReturn Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the fol

aci_register 4-10521 Dec 2001 Figure 4-95 Example of the aci_register Function/* Modify existing client configuration */int rc =0;char *client = &quo

4-106 DAS ACI Functions 601626-Baci_robhomeThe aci_robhome function sets the robot (accessor in Scalar 1000) in the AML to off-line and moves it to th

aci_robstat 4-10721 Dec 2001 • EHICAPINUSE• ECOORDINATE• EDATABASE• ENOTSUPPHCMDSee Figure 4-97 for an example of the aci_robhome function.Figure 4-9

Figures xi21 Dec 2001 Figure 4-55 Example of the aci_foreign Function. . . . . . . . . . . . . . . . . . . . . . . . . . 4-68Figure 4-56 aci_getvolse

4-108 DAS ACI Functions 601626-BReturn Values• 0: The call was successful• -1: The call failedThe external variable d_errno is set to one of the follo

aci_scratch_get 4-10921 Dec 2001 Figure 4-99 Example of the aci_robstat Functionaci_scratch_getThe aci_scratch_get function gets a scratch volume. Se

4-110 DAS ACI Functions 601626-BReturn Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the fol

aci_scratch_info 4-11121 Dec 2001 Figure 4-101 Example of the aci_scratch_get Functionaci_scratch_infoThe aci_scratch_info function gets information

4-112 DAS ACI Functions 601626-BReturn Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the fol

aci_scratch_info 4-11321 Dec 2001 Figure 4-103 Example of the aci_scratch_info Function/* List scratch pool information */int rc;char *pszPoolName =

4-114 DAS ACI Functions 601626-Baci_scratch_set The aci_scratch_set function sets volume status to scratch. See Figure 4-104.Figure 4-104 aci_scratch_

aci_scratch_set 4-11521 Dec 2001 The command will be rejected with the message EOTHERPOOL if the medium already exists in another scratch pool.For ad

4-116 DAS ACI Functions 601626-Baci_scratch_unsetThe aci_scratch_unset function resets the scratch status of a volume. See Figure 4-106.Figure 4-106 a

aci_scratch_unset 4-11721 Dec 2001 Return Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the

xii Figures 601626-BFigure 4-88 aci_qversion Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-97Figure 4-89 Example

4-118 DAS ACI Functions 601626-Baci_shutdownThe aci_shutdown function shuts down the DAS software. See Figure 4-108.Figure 4-108 aci_shutdown Function

aci_snmp 4-11921 Dec 2001 Figure 4-109 Example of the aci_shutdown Functionaci_snmpThe aci_snmp function sends SNMP messages. See Figure 4-110.Figure

4-120 DAS ACI Functions 601626-BThe external variable d_errno is set to one of the following DAS error codes:• ERPC• EINVALID• ETIMEOUT• ESWITCHINPROG

aci_switch 4-12121 Dec 2001 Return Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the follow

4-122 DAS ACI Functions 601626-Baci_unloadThe aci_unload function presses one or more buttons on a drive in the AML. See Figure 4-113.Figure 4-113 aci

aci_view 4-12321 Dec 2001 aci_viewThe aci_view function is used to view a database entry for a volume. See Figure 4-114.Figure 4-114 aci_view Functio

4-124 DAS ACI Functions 601626-BSee Table 4-53 for an explanation of the table types.Table 4-52 Parameters for the aci_view Function CallParameter Des

aci_view 4-12521 Dec 2001 See Table 4-54 for an explanation of the table attributes.Return Values• 0: The call was successful.• -1: The call failed.T

4-126 DAS ACI Functions 601626-BFigure 4-116 Example of the aci_view Functionaci_volser_inventoryThe aci_volser_inventory function inventories the vol

aci_volser_inventory 4-12721 Dec 2001 Return Values• 0: The call was successful• -1: The call failedThe external variable d_errno is set to one of th

Figures xiii21 Dec 2001 Figure 5-1 Example of a Generic aci_async_add() Function . . . . . . . . . . . . . . . . 5-5Figure 5-2 aci_async_add Functio

4-128 DAS ACI Functions 601626-Baci_volseraccessThe aci_volseraccess function sets ownership of a volser or range of volsers. See Figure 4-118.Figure

aci_volserstatus 4-12921 Dec 2001 • EUPELSE• ERPC• EINVALID• ENOVOLUME• EDASINT• EBADCLIENT• ENOTAUTH• ETIMEOUT• ESWITCHINPROG• EUPOWNaci_volserstatu

4-130 DAS ACI Functions 601626-BFigure 4-120 aci_volser_entry StructureSee Table 4-57 for a description of the parameters for the aci_volserstatus fun

5DAS ACI 3.0 Asynchronous Support LayerOverview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5-2 Safety601626-Baci_eject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Overview 5-321 Dec 2001 5-OverviewAsynchronous Support Layer library works as a filter between existing ACI libraries (version 3 or later) and the cl

5-4 DAS ACI 3.0 Asynchronous Support Layer 601626-B• eject: eject/elect complete volsers• allocv: allocate volser• allocd: allocate drive• script: run

aci_async_add() 5-521 Dec 2001 aci_async_add - adds an entry in the shared memory areaaci_async_create - creates and initializes the shared memory

5-6 DAS ACI 3.0 Asynchronous Support Layer 601626-Bdas_mountThe aci_async_add function with the das_mount parameter mounts a volume in a drive. See Fi

aci_async_add() 5-721 Dec 2001 das_dismountThe aci_async_add function with the das_dismount parameter dismounts a volume. See Figure 5-4.Figure 5-4 a

xiv Figures 601626-B

5-8 DAS ACI 3.0 Asynchronous Support Layer 601626-Bdas_insertThe aci_async_add function with the das_insert parameter inserts volumes into the AML. Se

aci_async_add() 5-921 Dec 2001 Use the insert2 function instead of this command. This function experiences difficulties with large I/O units with lon

5-10 DAS ACI 3.0 Asynchronous Support Layer 601626-BThe database entry for the volume is not deleted, and the position in the AML that the volume occu

aci_async_add() 5-1121 Dec 2001 space is needed in the AML. If the volume is re-inserted into the AML, it is stored in the next available position, a

5-12 DAS ACI 3.0 Asynchronous Support Layer 601626-BFigure 5-9 Example of an aci_async_add Function. . ./* * sadmin sample application, dasadmin.c fi

aci_async_create() 5-1321 Dec 2001 aci_async_create()The aci_async_create function creates a shared memory array of the entry_num size, that will hol

5-14 DAS ACI 3.0 Asynchronous Support Layer 601626-BFigure 5-11 Example if the aci_async_create Functionaci_async_find()The aci_async_find function lo

aci_async_find() 5-1521 Dec 2001 Return ValuesThe call was successful if a pointer to the found value is returned.The call failed if zero is returned

5-16 DAS ACI 3.0 Asynchronous Support Layer 601626-Baci_async_free()The aci_async_free function clears the async_table entry. See Figure 5-14.Figure 5

Macros 5-1721 Dec 2001 All the parameters must comply with the rules for aci_mount function call.The local variables int res must be defined before u

Tables Table 2-1 Routines Available with Basic Service Access . . . . . . . . . . . . . . . . . . 2-5Table 2-2 Routines Available with Complete Servi

5-18 DAS ACI 3.0 Asynchronous Support Layer 601626-BFigure 5-17 aci_force Asynchronous ACI CallAll the parameters must comply with the rules for the a

Macros 5-1921 Dec 2001 aci_ejectThe aci_eject function ejects a range of volumes from the AML. See Figure 5-19.Figure 5-19 aci_eject Asynchronous Fun

5-20 DAS ACI 3.0 Asynchronous Support Layer 601626-BReturn ValuesThe d_errno and d_text globals are copied to the d_errno and d_text fields of the sha

Response Technique 5-2121 Dec 2001 Response TechniqueThis section describes the most desirable response processing technique.SetupThe following code

5-22 DAS ACI 3.0 Asynchronous Support Layer 601626-BSignal Handler RoutineThe following code processes the result of child process work. At the point

Data structures 5-2321 Dec 2001 Data structuresThis section provides and overview of the data structures used in asynchronous ACI data interchange. T

5-24 DAS ACI 3.0 Asynchronous Support Layer 601626-BFigure 5-23 Common Structure for aci_async_entrystruct _aci_async_entry { pid_t pid;

Parameter Data (Parms Structure) 5-2521 Dec 2001 Parameter Data (Parms Structure)This union contains several structures that hold the data required f

5-26 DAS ACI 3.0 Asynchronous Support Layer 601626-BResponse Data (Structure)This union contains several structures where the asynchronous call result

Response Data (Structure) 5-2721 Dec 2001 st_insert_responseThis structure is supported by ACI_INSERT macro, described above. If you do not use macro

ADIC CORPORATE • 11431 WILLOWS ROAD, NE • REDMOND, WASHINGTON, USA • 1-800-336-1233ADIC • 8560 UPLAND DRIVE • PARKER, COLORADO, USA • 1-800-827-3822AD

xvi Tables 601626-BTable 4-19 Parameters for the aci_eject2_complete Function Call. . . . . . . . . . . 4-52Table 4-20 Parameters for the aci_eject3_c

5-28 DAS ACI 3.0 Asynchronous Support Layer 601626-B

AApplication NotesOverview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

A-2 Application Notes601626-B

Overview A-321 Dec 2001 A-OverviewThis section contains information on error recovery procedures and explanations of terms used throughout this docum

A-4 Application Notes 601626-B6 EPROBVOL The AMS returned a error code from robot control or information about an unrecoverable situation in the AML.

Error Recovery Procedures A-521 Dec 2001 14 EBADHOST DAS was unable to resolve the IP-name to an address, or the address is invalid. Check the TCP/IP

A-6 Application Notes 601626-B22 ERERTRYL The maximum number of automatic retries for recovering has been exceeded.There is a problem in the AMS.Check

Error Recovery Procedures A-721 Dec 2001 26 ENOTFOUND Problem with parameters in the command. Check the command and confirm the parameters with the A

A-8 Application Notes 601626-B35 ESWITCHINPROG The commands can not be executed. DAS and AMS are being switched to the other AMU. Wait until the switc

Terms A-921 Dec 2001 TermsThis section contains explanations of terms used throughout this document.45 EUPOWN The Client tried to allocate volsers th

Tables xvii21 Dec 2001 Table 4-52 Parameters for the aci_view Function Call . . . . . . . . . . . . . . . . . . . 4-124Table 4-53 Table Types. . . .

A-10 Application Notes 601626-BAPI Application Program InterfaceA program residing on the client’s platform used to interpret the client’s requests an

Terms A-1121 Dec 2001 Drive A device used to read and write data on a medium.eject The physical action of removing a medium from an archive. For a ro

A-12 Application Notes 601626-BNetwork The physical and logical connection of computers and peripheral devices that allows communication and data shar

Terms A-1321 Dec 2001 Volser, VSN Vo lume Serial NumberAn up to sixteen-digit alphanumeric designation. It identifies one medium (cartridge, optical

A-14 Application Notes 601626-B

Index- A -ACI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4ACI (AML Client Interface) . . . . . . . . . . . . . .

in-2 Index 601626-Badd volume to scratch pool . . . . . . . . . . . . . .2-7cancel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Index in-321 Dec 2001 Drive status . . . . . . . . . . . . . . . . . . . . . .4-5, 4-9, 4-21ACI client . . . . . . . . . . . . . . . . . . . . . . .

in-4 Index 601626-BScratch unset . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-116Set scratch . . . . . . . . . . . . . . . . . . . . .

xviii Tables 601626-B

1IntroductionOverview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-2 Introduction601626-B

Overview 1-321 Dec 2001 1-OverviewThis guide contains information and instructions necessary to program an application for using the ADIC AML via the

1-4 Introduction 601626-BAssociated DocumentsYou may wish to reference the following documents:• 601324-A DAS V3.1 Release Guide• 601625-A DAS V3.1 Ad

Assistance 1-521 Dec 2001 AssistanceIf problems cannot be solved with the aid of this document or if recommended training is desired, contact the ADI

1-6 Introduction 601626-B

2DAS ACIOverview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3DA

iii21 Dec 2001

2-2 DAS ACI601626-B

Overview 2-321 Dec 2001 2-OverviewThis section contains an overview of the DAS/2 software and information on AML Client Interface (ACI) services.DAS/

2-4 DAS ACI 601626-BThe DAS server component is an OS/2 program that runs within the AMU controller personal computer (PC). It converts DAS client req

ACI Services 2-521 Dec 2001 ACI Routines - Basic Services Table 2-1 lists the routines that are available to an ACI client with basic service access

2-6 DAS ACI 601626-Baci_eject2 Eject media from AML, and keep database entry for future insert requests. aci_ejectclean Eject clean media from AML, an

ACI Services 2-721 Dec 2001 Media Types The DAS ACI supports a variety of media types. The media type is passed as a parameter to all ACI functions t

2-8 DAS ACI 601626-BDAS Error CodesThe DAS ACI functions return either a successful or failed return code. In case of failure, a DAS error code d_errn

3SafetyOverview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3Haz

3-2 Safety601626-B

Overview 3-321 Dec 2001 3-OverviewKnowledge and observance of these instructions is imperative for the safe operation of the ADIC Storage Systems AML

iv [Chapter Name]601626-B

3-4 Safety 601626-BSpecially emphasized paragraphs in this guide warn of danger or draw attention to important information. These paragraphs and their

Validity 3-521 Dec 2001 ValidityThese instruction are valid for ADIC Storage Systems AML systems.Supplementary safety provisions for any components u

3-6 Safety 601626-B

4DAS ACI FunctionsOverview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-2 DAS ACI Functions601626-Baci_drivestatus2_one . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-321 Dec 2001Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-76aci_ins

4-4 DAS ACI Functions601626-BReturn Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Overview 4-521 Dec 2001 4-OverviewAll ACI function calls and ACI structures are defined in the aci.h header file. ACI functions return 0 or -1 for su

4-6 DAS ACI Functions 601626-BThe Scalar 1000 does not support the aci_barcode command (barcode on Scalar 1000 will never read on mount and eject).Use

aci_cancel 4-721 Dec 2001 Figure 4-2 Example of the aci_barcode Functionaci_cancelThe aci_cancel function cancels a specific DAS request. See Figure

Contents 1IntroductionOverview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-8 DAS ACI Functions 601626-BThe cancel request cancels the command in the DAS server and the AML. If the request is being acted upon in the AML, DAS

aci_cleandrive 4-921 Dec 2001 aci_cleandriveThe aci_cleandrive function mounts a cleaning cartridge to a specific drive. See Figure 4-5.Figure 4-5 ac

4-10 DAS ACI Functions 601626-B• ERERTRYL• EINUSE• ECANCELLED• EDASINT• ECLEANING• ETIMEOUT• ESWITCHINPROG• EHICAPINUSE• EBARCODE• EINVALIDDEV• ENOROB

aci_clientaccess 4-1121 Dec 2001 aci_clientaccessThe aci_clientaccess function modifies the access lists of a client. See Figure 4-6.Figure 4-6 aci_c

4-12 DAS ACI Functions 601626-BThe changes will be lost when the DAS software is shut down. Only use this command if, at the time, you do not have acc

aci_clientaccess 4-1321 Dec 2001 Figure 4-7 Example of the aci_clientaccess Function/* Add a volser range to a clients access list */int rc = 0;enum

4-14 DAS ACI Functions 601626-Baci_clientstatusThe aci_clientstatus function queries client access list configuration. See Figure 4-8.Figure 4-8 aci_c

aci_clientstatus 4-1521 Dec 2001 Return Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the f

4-16 DAS ACI Functions 601626-BFigure 4-10 Example of the aci_clientstatus Functionaci_dismountThe aci_dismount function dismounts a volume. SeeFigure

aci_dismount 4-1721 Dec 2001 Return Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the follo

iv Contents 601626-BMedia Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7

4-18 DAS ACI Functions 601626-BFigure 4-12 Example of the aci_dismount Functionaci_driveaccessThe aci_driveaccess function modifies allocation status

aci_driveaccess 4-1921 Dec 2001 The drive can only be put in the DOWN status by ACI_DRIVE_FDOWN if the drive is occupied.A drive may only be availabl

4-20 DAS ACI Functions 601626-BReturn ValuesThe aci_driveaccess returns the following values:• 0: The call was successful.• -1: The call failed.The ex

aci_drivestatus 4-2121 Dec 2001 aci_drivestatusThe aci_drivestatus function queries status of up to 15 drives. See Figure 4-15.Figure 4-15 aci_drives

4-22 DAS ACI Functions 601626-BReturn Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the foll

aci_drivestatus2 4-2321 Dec 2001 Figure 4-18 Returned StatusSee Table 4-8 for a description of the parameters for the aci_drivestatus2 function cal

4-24 DAS ACI Functions 601626-BThe maximum number of drives displayed is 250.aci_drive_entry returned information about the status of the drivesdrive_

aci_drivestatus2 4-2521 Dec 2001 Return Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the f

4-26 DAS ACI Functions 601626-BFigure 4-19 Example of the aci_drivestatus2 Functionaci_drivestatus3The aci_drivestatus3 function queries the physical

aci_drivestatus3 4-2721 Dec 2001 Figure 4-20 aci_drivestatus3 Function CallReturn the status of drives which are set to UP for the client with the na

Contents v21 Dec 2001 Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-

4-28 DAS ACI Functions 601626-Baci_drive_entry returned information about the status of the drivesdrive_name name of the drive (name used in DAS and A

aci_drivestatus4 4-2921 Dec 2001 Return Values• 0: The call was successful• -1: The call has failedThe external variable d_errno is set to one of the

4-30 DAS ACI Functions 601626-BFigure 4-23 Returned StatusThe variable ACI_SERIAL_NUMBER_LEN is equal to 51.See Table 4-10 for an explanation of the

aci_drivestatus4 4-3121 Dec 2001 Return Values• 0: The call was successful• -1: The call has failedThe external variable d_errno is set to one of the

4-32 DAS ACI Functions 601626-B•ERPC• EINVALID• ETIMEOUT• ESWITCHINPROGRESS• EBADCLIENT• ENOTSUPPHCMDaci_drivestatus_oneThe aci_drivestatus_one functi

aci_drivestatus_one 4-3321 Dec 2001 See Table 4-11 for an explanation of the parameters used for the aci_drivestatus_one function.Return Values• 0:

4-34 DAS ACI Functions 601626-B•ERPC• EINVALID• ETIMEOUT• ESWITCHINPROGRESS• EBADCLIENT• ENOTSUPPHCMDaci_drivestatus2_oneThe aci_drivestatus2_one func

aci_drivestatus2_one 4-3521 Dec 2001 See Table 4-12 for an explanation of the parameters used for the aci_drivestatus2_one function.Return Values• 0:

4-36 DAS ACI Functions 601626-B•ERPC• EINVALID• ETIMEOUT• ESWITCHINPROGRESS• EBADCLIENT• ENOTSUPPHCMDaci_drivestatus3_oneThe aci_drivestatus3_one func

aci_drivestatus3_one 4-3721 Dec 2001 See Table 4-13 for an explanation of the parameters used for the aci_drivestatus3_one function.Return Values•

vi Contents 601626-Baci_getVolserToSide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7

4-38 DAS ACI Functions 601626-B•ERPC• EINVALID• ETIMEOUT• ESWITCHINPROGRESS• EBADCLIENT• ENOTSUPPHCMDaci_eif_confThe aci_eif_conf function queries sta

aci_eject 4-3921 Dec 2001 Return Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the followin

4-40 DAS ACI Functions 601626-BEject the volumes in volser_range to the eject_area. The media type of the volumes must match that of the eject_area. S

aci_eject 4-4121 Dec 2001 • ENOVOLUME• EPROBVOL• EAMU• EAMUCOMM• EROBOTCOMM• EDASINT• ENOAREA• ENOTAUTH• EBADCLIENT• ERETRYL• EINUSE• ECANCELED• EDAS

4-42 DAS ACI Functions 601626-Baci_eject2The aci_eject2 function ejects a range of volumes from the AML. See Figure 4-34.Figure 4-34 aci_eject2 Functi

aci_eject2 4-4321 Dec 2001 If the eject area is full, the system stops the eject procedure. Depending on the DAS_EJECTAREAFULL environment variable o

4-44 DAS ACI Functions 601626-B• ENOTAUTH• EBADCLIENT• ERETRYL• EINUSE• ECANCELED• EDASINT• ENOMATCH• ETIMEOUT• ESWITCHINPROG• EHICAPINUSE• ECOORDINAT

aci_eject2 4-4521 Dec 2001 Figure 4-36 Example of the aci_eject2 Function/* Eject volume but reserve archive location */int rc, i, pnActualCount;char

4-46 DAS ACI Functions 601626-Baci_eject3The aci_eject3 function ejects a range of volumes from the AML. See Figure 4-37.Figure 4-37 aci_eject3 Functi

aci_eject3 4-4721 Dec 2001 If the eject area is full, the system stops the eject procedure. Depending on the DAS_EJECTAREAFULL environment variable o

Contents vii21 Dec 2001 aci_scratch_info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4-48 DAS ACI Functions 601626-B• ENOAREA• ENOTAUTH• EBADCLIENT• ERETRYL• EINUSE• ECANCELED• ENOMATCH• ETIMEOUT• ESWITCHINPROG• EHICAPINUSE• ECOORDINAT

aci_eject_ complete 4-4921 Dec 2001 aci_eject_ completeThe aci_eject_complete function ejects volumes and removes the database entries. See Figure 4-

4-50 DAS ACI Functions 601626-BReturn Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of the foll

aci_eject2_complete 4-5121 Dec 2001 Figure 4-40 Example of the aci_eject_complete Functionaci_eject2_completeThe aci_eject2_complete function ejects

4-52 DAS ACI Functions 601626-BSee Table 4-19 for a description of the parameters for the aci_eject2_complete function call.If the eject area is full

aci_eject2_complete 4-5321 Dec 2001 Return Values• 0: The call was successful.• -1: The call failed.The external variable d_errno is set to one of th

4-54 DAS ACI Functions 601626-BFigure 4-43 Example of the aci_eject2_complete Functionaci_eject3_completeThe aci_eject3_complete function ejects a ran

aci_eject3_complete 4-5521 Dec 2001 The volser_range field has a maximum size of 512 bytes.See Figure 4-45 for the structure of the aci_ei_info funct

4-56 DAS ACI Functions 601626-BThe attribute of the coordinate will be set to empty in the AMU database. The volser will be set to 0000000000000000, b

aci_ejectclean 4-5721 Dec 2001 aci_ejectcleanThe aci_ejectclean function ejects all exhausted cleaning cartridges from one Cleanpool. See Figure 4-46