ADIC Server User Manual

The ADIC

Distributed AML Server

DAS V3.10E

Interfacing

Guide

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.

ADIC ADIC Europe ADIC Germany Beteiligungs GmbH, KG Tel.: +1 303-705-3900 ZAC des Basses Auges Eschenstraße 3 Fax: +1-303-792-2465 1, rue Alfred de Vigny D-89558 Böhmenkirch, Germany ATAC: 1-800-827-3822 78112 Fourqueux, France Tel:+00.800.9999.3822 www.adic.com Tel.: +33.1.3087.5300

Fax: +33.1.3087.5301

Document number: 601626-B Published: 21 Dec 2001 Printed in the USA

ADIC CORPORATE • 11431 WILLOWS ROAD, NE • REDMOND, WASHINGTON, USA • 1-800-336-1233

ADIC • 8560 UPLAND DRIVE • PARKER, COLORADO, USA • 1-800-827-3822

ADIC • 10 BROWN ROAD • ITHACA, NEW YORK, USA • 1-607-266-4000

21 Dec 2001

iii

iv [Chapter Name]

601626-B

Contents

Introduction

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3

Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3

Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

Associated Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4

Explanation of Symbols and Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-4

Assistance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-5

DAS ACI

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3

DAS/2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

ACI Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-4

Client Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-4

ACI Routines - Basic Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5

ACI Routines - Complete Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-5

Media Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7

DAS Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8

Safety

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-3

Hazard Alert Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-3

Validity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5

DAS ACI Functions

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-5

aci_barcode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-5

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-6

aci_cancel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-7

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-8

aci_cleandrive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-9

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-9

aci_clientaccess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-12

aci_clientstatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-14

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-15

aci_dismount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-16

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-17

aci_driveaccess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-20

aci_drivestatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-21

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-22

aci_drivestatus2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-22

iv Contents

601626-B

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-25

aci_drivestatus3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-26

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-29

aci_drivestatus4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-29

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-31

aci_drivestatus_one . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-32

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-33

aci_drivestatus2_one . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-34

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-35

aci_drivestatus3_one . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-36

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-37

aci_eif_conf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-38

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-39

aci_eject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-39

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-40

aci_eject2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-42

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-43

aci_eject3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-47

aci_eject_ complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-49

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-50

aci_eject2_complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-51

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-53

aci_eject3_complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-54

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-56

aci_ejectclean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-57

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-58

aci_email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-60

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-61

aci_flip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-61

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-62

aci_force . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-64

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-64

aci_foreign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-66

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-67

aci_getvolsertodrive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-68

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-69

21 Dec 2001

Contents v

aci_getVolserToSide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-70

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-71

aci_init . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-72

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-73

aci_initialize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-74

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-74

aci_insert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-75

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-76

aci_insert2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-77

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-79

aci_inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-81

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-81

aci_killamu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-82

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-83

aci_list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-84

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-86

aci_list2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-87

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-89

aci_list_foreign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-89

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-90

aci_mount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-91

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-91

aci_partial_inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-93

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-95

aci_perror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-96

aci_qversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-97

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-97

aci_qvolsrange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-98

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-101

aci_register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-103

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-104

aci_robhome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-106

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-106

aci_robstat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-107

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-108

aci_scratch_get . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-109

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-110

vi Contents

601626-B

aci_scratch_info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-111

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-112

aci_scratch_set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-114

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-115

aci_scratch_unset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-116

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-117

aci_shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-118

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-118

aci_snmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-119

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-119

aci_switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-120

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-121

aci_unload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-122

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-122

aci_view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-123

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-125

aci_volser_inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-126

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-127

aci_volseraccess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-128

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-128

aci_volserstatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-129

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-130

DAS ACI 3.0 Asynchronous Support Layer

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-3

How It Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-3

Sadmin Sample Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-3

Sadmin Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-4

Contents of the Async Support Layer Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-4

aci_async_add() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5

Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-5

das_mount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-6

das_dismount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-7

21 Dec 2001

Contents vii

das_force . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-7

das_insert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-8

das_eject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-9

das_eject_complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-10

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-11

aci_async_create() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-13

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-13

aci_async_find() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-15

aci_async_free() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-16

Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16

aci_mount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17

aci_dismount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17

Return Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17

aci_force . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-17

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18

aci_insert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-18

Returned values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-18

aci_eject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-19

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19

aci_eject_complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-19

Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20

Response Technique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-21

Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-21

Signal Handler Routine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-22

Data structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-23

aci_async_entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-23

Parameter Data (Parms Structure) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-25

Response Data (Structure) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-26

st_response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-26

st_mount_parms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-26

st_insert_response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-27

Application Notes

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3

viii Contents

601626-B

Error Recovery Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3

Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9

Index

21 Dec 2001

Contents ix

xContents

601626-B

Figures

Figure 2-1 Logical Relationship Between AML Components . . . . . . . . . . . . . . .2-3

Figure 4-1 aci_barcode Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-5

Figure 4-2 Example of the aci_barcode Function. . . . . . . . . . . . . . . . . . . . . . . . . .4-7

Figure 4-3 aci_cancel Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7

Figure 4-4 Example of the aci_cancel Function . . . . . . . . . . . . . . . . . . . . . . . . . . .4-8

Figure 4-5 aci_cleandrive Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-9

Figure 4-6 aci_clientaccess Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11

Figure 4-7 Example of the aci_clientaccess Function . . . . . . . . . . . . . . . . . . . . .4-13

Figure 4-8 aci_clientstatus Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-14

Figure 4-9 Returned Configuration Information . . . . . . . . . . . . . . . . . . . . . . . . . 4-14

Figure 4-10 Example of the aci_clientstatus Function. . . . . . . . . . . . . . . . . . . . . .4-16

Figure 4-11 aci_dismount Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16

Figure 4-12 Example of the aci_dismount Function . . . . . . . . . . . . . . . . . . . . . . .4-18

Figure 4-13 aci_driveaccess Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-18

Figure 4-14 Example of the aci_driveaccess Function. . . . . . . . . . . . . . . . . . . . . . 4-20

Figure 4-15 aci_drivestatus Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21

Figure 4-16 Returned Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-21

Figure 4-17 aci_drivestatus2 Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-22

Figure 4-18 Returned Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-23

Figure 4-19 Example of the aci_drivestatus2 Function . . . . . . . . . . . . . . . . . . . . .4-26

Figure 4-20 aci_drivestatus3 Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27

Figure 4-21 Returned Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-27

Figure 4-22 aci_drivestatus4 Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29

Figure 4-23 Returned Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-30

Figure 4-24 aci_drivestatus_one Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-32

Figure 4-25 Returned Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-32

Figure 4-26 aci_drivestatus_2_one Function Call . . . . . . . . . . . . . . . . . . . . . . . . .4-34

Figure 4-27 Returned Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-34

Figure 4-28 aci_drivestatus_3_one Function Call . . . . . . . . . . . . . . . . . . . . . . . . .4-36

Figure 4-29 Returned Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-36

Figure 4-30 aci_eif_conf Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-38

Figure 4-31 Returned Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-38

Figure 4-32 aci_eject Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-39

Figure 4-33 Example of the aci_eject Function. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-41

Figure 4-34 aci_eject2 Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-42

Figure 4-35 Structure of the aci_ei_info function from aci.h . . . . . . . . . . . . . . . . 4-42

Figure 4-36 Example of the aci_eject2 Function. . . . . . . . . . . . . . . . . . . . . . . . . . . 4-45

Figure 4-37 aci_eject3 Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46

Figure 4-38 Structure of the aci_ei_info function. . . . . . . . . . . . . . . . . . . . . . . . . .4-46

Figure 4-39 aci_eject_complete function call . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-49

Figure 4-40 Example of the aci_eject_complete Function. . . . . . . . . . . . . . . . . . . 4-51

Figure 4-41 aci_eject2_complete Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . .4-51

Figure 4-42 Structure of the aci_ei_info function. . . . . . . . . . . . . . . . . . . . . . . . . .4-51

Figure 4-43 Example of the aci_eject2_complete Function. . . . . . . . . . . . . . . . . . 4-54

Figure 4-44 aci_eject3_complete Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . .4-54

Figure 4-45 Structure of the aci_ei_info function. . . . . . . . . . . . . . . . . . . . . . . . . .4-55

Figure 4-46 aci_ejectclean Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-57

Figure 4-47 Structure of the aci_ei_info function from aci.h . . . . . . . . . . . . . . . . 4-57

Figure 4-48 Example of the aci_ejectclean Function . . . . . . . . . . . . . . . . . . . . . . .4-60

Figure 4-49 aci_email Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-60

Figure 4-50 aci_flip Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-61

Figure 4-51 Example of the aci_flip Function. . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-63

Figure 4-52 aci_force Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-64

Figure 4-53 Example of the aci_force Function . . . . . . . . . . . . . . . . . . . . . . . . . . .4-65

Figure 4-54 aci_foreign Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-66

x Figures

601626-B

Figure 4-55 Example of the aci_foreign Function. . . . . . . . . . . . . . . . . . . . . . . . . .4-68

Figure 4-56 aci_getvolsertodrive Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . .4-68

Figure 4-57 aci_voltodrive_entry Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-69

Figure 4-58 Example of the aci_getvolertodrive Function . . . . . . . . . . . . . . . . . .4-70

Figure 4-59 aci_getVolserToSide Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . .4-70

Figure 4-60 Structure of Type aci_sideinfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-71

Figure 4-61 Example of the aci_getvolsertoside Function . . . . . . . . . . . . . . . . . .4-72

Figure 4-62 aci_init Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-72

Figure 4-63 Example of the aci_init Function. . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-73

Figure 4-64 aci_initialize Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-74

Figure 4-65 Example of the aci_initialize Function . . . . . . . . . . . . . . . . . . . . . . . .4-74

Figure 4-66 aci_insert Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-75

Figure 4-67 Example of the aci_insert Function. . . . . . . . . . . . . . . . . . . . . . . . . . .4-77

Figure 4-68 aci_insert2 Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-77

Figure 4-69 aci_ei_info Structure from aci.h. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-78

Figure 4-70 Example of the aci_insert2 Function. . . . . . . . . . . . . . . . . . . . . . . . . .4-80

Figure 4-71 aci_inventory Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-81

Figure 4-72 Example of the aci_inventory Function . . . . . . . . . . . . . . . . . . . . . . .4-82

Figure 4-73 aci_killamu Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-82

Figure 4-74 Example of the aci_killamu Function . . . . . . . . . . . . . . . . . . . . . . . . . 4-83

Figure 4-75 aci_list Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-84

Figure 4-76 Example of the Returned Structure. . . . . . . . . . . . . . . . . . . . . . . . . . .4-84

Figure 4-77 Example of the aci_list Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-86

Figure 4-78 aci_list2 Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-87

Figure 4-79 Example of the Returned Structure. . . . . . . . . . . . . . . . . . . . . . . . . . .4-87

Figure 4-80 aci_list_foreign Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-89

Figure 4-81 Example of the Returned Structure. . . . . . . . . . . . . . . . . . . . . . . . . . .4-90

Figure 4-82 aci_mount Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-91

Figure 4-83 Example of the aci_mount Function. . . . . . . . . . . . . . . . . . . . . . . . . .4-93

Figure 4-84 aci_partial_inventory Function Call . . . . . . . . . . . . . . . . . . . . . . . . . .4-93

Figure 4-85 Example of the aci_partial_inventory Function . . . . . . . . . . . . . . . .4-95

Figure 4-86 aci_perror Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-96

Figure 4-87 Example of the aci_perror Function . . . . . . . . . . . . . . . . . . . . . . . . . .4-96

21 Dec 2001

Figures xi

Figure 4-88 aci_qversion Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-97

Figure 4-89 Example of the aci_qversion Function . . . . . . . . . . . . . . . . . . . . . . . .4-98

Figure 4-90 aci_qvolsrange Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-98

Figure 4-91 Amount of Listed Volsers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-99

Figure 4-92 Structure for the aci_volserinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-99

Figure 4-93 Example of the aci_qvolsrange Function . . . . . . . . . . . . . . . . . . . . .4-102

Figure 4-94 aci_register Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-103

Figure 4-95 Example of the aci_register Function . . . . . . . . . . . . . . . . . . . . . . . .4-105

Figure 4-96 aci_robhome Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-106

Figure 4-97 Example of the aci_robhome Function. . . . . . . . . . . . . . . . . . . . . . .4-107

Figure 4-98 aci_robstat Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-107

Figure 4-99 Example of the aci_robstat Function. . . . . . . . . . . . . . . . . . . . . . . . .4-109

Figure 4-100 aci_scratch_get Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-109

Figure 4-101 Example of the aci_scratch_get Function. . . . . . . . . . . . . . . . . . . . . 4-111

Figure 4-102 aci_scratch_info Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-111

Figure 4-103 Example of the aci_scratch_info Function . . . . . . . . . . . . . . . . . . . . 4-113

Figure 4-104 aci_scratch_set Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-114

Figure 4-105 Example of the aci_scratch_set Function . . . . . . . . . . . . . . . . . . . . .4-115

Figure 4-106 aci_scratch_unset Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-116

Figure 4-107 Example of the aci_scratch_unset Function. . . . . . . . . . . . . . . . . . .4-117

Figure 4-108 aci_shutdown Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-118

Figure 4-109 Example of the aci_shutdown Function. . . . . . . . . . . . . . . . . . . . . .4-119

Figure 4-110 aci_snmp Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-119

Figure 4-111 aci_switch Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-120

Figure 4-112 Example of the aci_switch Function . . . . . . . . . . . . . . . . . . . . . . . . .4-121

Figure 4-113 aci_unload Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-122

Figure 4-114 aci_view Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-123

Figure 4-115 Volser Information Contained in the aci_volume_desc Structure4-123

Figure 4-116 Example of the aci_view Function . . . . . . . . . . . . . . . . . . . . . . . . . .4-126

Figure 4-117 aci_volser_inventory Function Call . . . . . . . . . . . . . . . . . . . . . . . . .4-126

Figure 4-118 aci_volseraccess Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-128

Figure 4-119 aci_volserstatus Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-129

Figure 4-120 aci_volser_entry Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-130

xii Figures

601626-B

Figure 5-1 Example of a Generic aci_async_add() Function . . . . . . . . . . . . . . . .5-5

Figure 5-2 aci_async_add Function with the das_mount Parameter . . . . . . . . . 5-6

Figure 5-3 Example of the aci_async_add Function with the das_mount Parame-

ter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-6

Figure 5-4 aci_async_add Function with the das_dismount Parameter . . . . . .5-7

Figure 5-5 aci_async_add Function with the das_force Parameter. . . . . . . . . . . 5-7

Figure 5-6 aci_async_add Function with the das_insert Parameter . . . . . . . . . .5-8

Figure 5-7 aci_async_add Function with the das_eject Parameter . . . . . . . . . . .5-9

Figure 5-8 aci_async_add Function with the das_eject_complete Parameter .5-10

Figure 5-9 Example of an aci_async_add Function . . . . . . . . . . . . . . . . . . . . . . .5-12

Figure 5-10 aci_async_create Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-13

Figure 5-11 Example if the aci_async_create Function . . . . . . . . . . . . . . . . . . . . .5-14

Figure 5-12 aci_async_find Function Call. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-14

Figure 5-13 Example of the aci_async_find Function . . . . . . . . . . . . . . . . . . . . . .5-15

Figure 5-14 aci_async_free Function Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-16

Figure 5-15 Example of aci_mount Asynchronous ACI Call. . . . . . . . . . . . . . . .5-16

Figure 5-16 aci_dismount Asynchronous ACI Call. . . . . . . . . . . . . . . . . . . . . . . .5-17

Figure 5-17 aci_force Asynchronous ACI Call. . . . . . . . . . . . . . . . . . . . . . . . . . . .5-18

Figure 5-18 aci_insert Asynchronous Function Call . . . . . . . . . . . . . . . . . . . . . . . 5-18

Figure 5-19 aci_eject Asynchronous Function Call . . . . . . . . . . . . . . . . . . . . . . . .5-19

Figure 5-20 aci_eject_complete Asynchronous Function Call . . . . . . . . . . . . . . .5-19

Figure 5-21 Setup Signal Handler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-21

Figure 5-22 dasadmin Sample Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-22

Figure 5-23 Common Structure for aci_async_entry. . . . . . . . . . . . . . . . . . . . . . . 5-24

Figure 5-24 async_drive_parms Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-25

Figure 5-25 async_ei_parms Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-25

Figure 5-26 async_response Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-26

Figure 5-27 async_mount_parms Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-26

Figure 5-28 async_insert_responce Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-27

21 Dec 2001

Figures xiii

xiv Figures

601626-B

Tables

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

Table 2-2 Routines Available with Complete Service Access . . . . . . . . . . . . . .2-5

Table 2-3 Supported Media Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7

Table 3-1 Hazard Alert Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-3

Table 4-1 Parameters for the aci_barcode Function Call. . . . . . . . . . . . . . . . . . . 4-5

Table 4-2 Parameter for the aci_cancel Function Call . . . . . . . . . . . . . . . . . . . . . 4-7

Table 4-3 Parameter for the aci_cleandrive Function Call . . . . . . . . . . . . . . . . .4-9

Table 4-4 Parameters for the aci_clientaccess Function Call . . . . . . . . . . . . . .4-11

Table 4-5 Parameters for the aci_clientstatus Function Call. . . . . . . . . . . . . . .4-15

Table 4-6 Parameters for the aci_dismount Function Call . . . . . . . . . . . . . . . .4-16

Table 4-7 Parameters for the aci_driveaccess Function Call . . . . . . . . . . . . . .4-19

Table 4-8 Parameters for the aci_drivestatus2 Function Call. . . . . . . . . . . . . .4-23

Table 4-9 Parameters for the aci_drivestatus3 Function Call. . . . . . . . . . . . . .4-27

Table 4-10 Parameters for the aci_drivestatus4 Function Call. . . . . . . . . . . . . . 4-30

Table 4-11 Parameters for the aci_drivestatus_one Function Call . . . . . . . . . .4-33

Table 4-12 Parameters for the aci_drivestatus2_one Function Call . . . . . . . . .4-35

Table 4-13 Parameters for the aci_drivestatus3_one Function Call . . . . . . . . .4-37

Table 4-14 Parameters for the aci_eif_conf Function Call. . . . . . . . . . . . . . . . . . 4-39

Table 4-15 Parameters for the aci_eject Function Call. . . . . . . . . . . . . . . . . . . . .4-40

Table 4-16 Parameters for the aci_eject2 Function Call. . . . . . . . . . . . . . . . . . . .4-42

Table 4-17 Parameters for the aci_eject3 Function Call. . . . . . . . . . . . . . . . . . . .4-46

Table 4-18 Parameters for the aci_eject_complete Function Call. . . . . . . . . . . .4-49

Table 4-19 Parameters for the aci_eject2_complete Function Call. . . . . . . . . . . 4-52

Table 4-20 Parameters for the aci_eject3_complete Function Call. . . . . . . . . . . 4-55

Table 4-21 Parameters for the aci_ejectclean Function Call . . . . . . . . . . . . . . . . 4-57

Table 4-22 Parameter for the aci_email Function Call. . . . . . . . . . . . . . . . . . . . .4-61

Table 4-23 Parameter for the aci_flip Function Call . . . . . . . . . . . . . . . . . . . . . .4-62

Table 4-24 Parameter for the aci_force Function Call . . . . . . . . . . . . . . . . . . . . .4-64

Table 4-25 Parameters for the aci_foreign Function Call . . . . . . . . . . . . . . . . . . 4-66

Table 4-26 Parameters for the aci_getvolsertodrive Function Call . . . . . . . . . .4-69

Table 4-27 Parameters for the aci_getvolsertoside Function Call . . . . . . . . . . . 4-71

Table 4-28 Parameters for the aci_insert Function Call. . . . . . . . . . . . . . . . . . . . 4-75

Table 4-29 Parameters for the aci_insert2 Function Call. . . . . . . . . . . . . . . . . . .4-78

Table 4-30 Parameters for the aci_list Function Call . . . . . . . . . . . . . . . . . . . . . . 4-85

Table 4-31 Explanation of the Req_types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-85

Table 4-32 Parameters for the aci_list2 Function Call . . . . . . . . . . . . . . . . . . . . .4-88

Table 4-33 Explanation of the Req_types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-88

Table 4-34 Parameters for the aci_list_foreign Function Call. . . . . . . . . . . . . . .4-90

Table 4-35 Parameters for the aci_mount Function Call. . . . . . . . . . . . . . . . . . . 4-91

Table 4-36 Parameters for the aci_partial_inventory Function Call . . . . . . . . . 4-94

Table 4-37 Parameter for the aci_perror Function Call. . . . . . . . . . . . . . . . . . . .4-96

Table 4-38 Parameters for the aci_qversion Function Call . . . . . . . . . . . . . . . . . 4-97

Table 4-39 Parameters for the aci_qvolsrange Function Call. . . . . . . . . . . . . . .4-99

Table 4-40 Explanation of the Attrib Values. . . . . . . . . . . . . . . . . . . . . . . . . . . .4-100

Table 4-41 Parameters for the aci_register Function Call . . . . . . . . . . . . . . . . .4-103

Table 4-42 Parameter for the aci_robhome Function Call . . . . . . . . . . . . . . . .4-106

Table 4-43 Parameters for the aci_robstat Function Call . . . . . . . . . . . . . . . . .4-108

Table 4-44 Parameters for the aci_scratch_get Function Call. . . . . . . . . . . . . . 4-110

Table 4-45 Parameters for the aci_scratch_info Function Call. . . . . . . . . . . . . 4-112

Table 4-46 Parameters for the aci_scratch_set Function Call . . . . . . . . . . . . . .4-114

Table 4-47 Parameters for the aci_scratch_unset Function Call. . . . . . . . . . . .4-116

Table 4-48 Parameter for the aci_shutdown Function Call . . . . . . . . . . . . . . .4-118

Table 4-49 Parameter for the aci_snmp Function Call . . . . . . . . . . . . . . . . . . .4-119

Table 4-50 Parameter for the aci_switch Function Call. . . . . . . . . . . . . . . . . . .4-120

Table 4-51 Parameter for the aci_unload Function Call . . . . . . . . . . . . . . . . . . 4-122

xvi Tables

601626-B

Table 4-52 Parameters for the aci_view Function Call . . . . . . . . . . . . . . . . . . .4-124

Table 4-53 Table Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-124

Table 4-54 Table Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-125

Table 4-55 Parameters for the aci_volser_inventory Function Call. . . . . . . . .4-127

Table 4-56 Parameters for the aci_volseraccess Function Call. . . . . . . . . . . . .4-128

Table 4-57 Parameters for the aci_volserstatus Function Call . . . . . . . . . . . . .4-130

Table 5-1 Parameters for the das_mount Parameter . . . . . . . . . . . . . . . . . . . . . .5-6

Table 5-2 Parameters for the das_dismount Parameter . . . . . . . . . . . . . . . . . . .5-7

Table 5-3 Parameter for the das_force Parameter . . . . . . . . . . . . . . . . . . . . . . . . 5-8

Table 5-4 Parameters for the das_insert Parameter. . . . . . . . . . . . . . . . . . . . . . .5-9

Table 5-5 Parameters for the das_eject Parameter . . . . . . . . . . . . . . . . . . . . . . . 5-10

Table 5-6 Parameters for the das_eject_complete Parameter. . . . . . . . . . . . . . 5-11

Table 5-7 Parameter for the aci_async_create Function . . . . . . . . . . . . . . . . . .5-13

Table 5-8 Parameter for the aci_async_find Function . . . . . . . . . . . . . . . . . . . . 5-14

Table 5-9 Parameters for the aci_async_free Function . . . . . . . . . . . . . . . . . . .5-16

Table A-1 Error Code Reactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3

21 Dec 2001

Tables xvii

xviii Tables

601626-B

Introduction

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3

Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3

Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

Associated Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4

Explanation of Symbols and Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-4

Assistance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-5

1-2 Introduction

601626-B

Overview

This guide contains information and instructions necessary to program an application for using the ADIC AML via the Distributed AML Server (DAS). 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. Knowledge of the UNIX and OS/2 operating systems is required.

Organization

This manual is divided into the following chapters:

Chapter 1 Introduction - Notes on the use of the

Chapter 2 DAS ACI - Overview of the DAS/2

Chapter 3 Safety - Describes the hazard symbols,

Chapter 4 DAS ACI Functions - Information and

Chapter 5 ACI 3.0 Asynchronous Support Layer -

Appendix A Important Information - Error recovery

Index

manual

software and information on AML Client Interface (ACI) services

messages, safety features, and operational considerations

descriptions of ACI functions and function callas

Provides a description of the Asynchronous ACI calls

procedures and explanations of terms used throughout this document

21 Dec 2001

Overview 1-3

Associated Documents

You may wish to reference the following documents:

• 601324-A DAS V3.1 Release Guide

• 601625-A DAS V3.1 Administration Guide

Explanation of Symbols and Notes

The following symbols and highlighted passages draw attention to important information.

Detailed explanations for the above symbols are provided in Hazard Alert Messages on page 3-3.

<1>+<2> Press these keys simultaneously.

Italic Headline, e.g., Chapter 3, Safety

File name, e.g., dasdata.ini

Bold Terms appearing on the operating panel

Special Term, e.g., Utilities Commands with or without parameters, e.g., INITIALIZE

1-4 Introduction

Courier Command appearing on a console, e.g., cd

Switch position, e.g., ON, OFF

601626-B

Assistance

If problems cannot be solved with the aid of this document or if recommended training is desired, contact the ADIC Technical Assistance Center (ATAC).

ADIC 10949 East Peakview Avenue Englewood, CO 80112 U.S.A.

• United States 1-800-827-3822

• Europe and Africa 00-800-9999-3822

21 Dec 2001

Assistance 1-5

1-6 Introduction

601626-B