1、American National StandardDeveloped byfor Information Technology Information Management Extensible Access Method (XAMTM)INCITS 464-2010INCITS 464-2010Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without
2、license from IHS-,-,-Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-INCITS 464-2010American National Standardfor Information Technology Information Management Extensible Access
3、 Method (XAMTM)SecretariatInformation Technology Industry CouncilApproved December 20, 2010American National Standards Institute, Inc.Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS
4、-,-,-Approval of an American National Standard requires review by ANSI that therequirements for due process, consensus, and other criteria for approval havebeen met by the standards developer.Consensus is established when, in the judgement of the ANSI Board ofStandards Review, substantial agreement
5、has been reached by directly andmaterially affected interests. Substantial agreement means much more thana simple majority, but not necessarily unanimity. Consensus requires that allviews and objections be considered, and that a concerted effort be madetowards their resolution.The use of American Na
6、tional Standards is completely voluntary; theirexistence does not in any respect preclude anyone, whether he has approvedthe standards or not, from manufacturing, marketing, purchasing, or usingproducts, processes, or procedures not conforming to the standards.The American National Standards Institu
7、te does not develop standards andwill in no circumstances give an interpretation of any American NationalStandard. Moreover, no person shall have the right or authority to issue aninterpretation of an American National Standard in the name of the AmericanNational Standards Institute. Requests for in
8、terpretations should beaddressed to the secretariat or sponsor whose name appears on the titlepage of this standard.CAUTION NOTICE: This American National Standard may be revised orwithdrawn at any time. The procedures of the American National StandardsInstitute require that action be taken periodic
9、ally to reaffirm, revise, orwithdraw this standard. Purchasers of American National Standards mayreceive current information on all standards by calling or writing the AmericanNational Standards Institute.American National StandardPublished byAmerican National Standards Institute, Inc.25 West 43rd S
10、treet, New York, NY 10036Copyright 2010 by Information Technology Industry Council (ITI)All rights reserved.No part of this publication may be reproduced in anyform, in an electronic retrieval system or otherwise,without prior written permission of ITI, 1101 K Street NW, Suite 610Washington, DC 2000
11、5. Printed in the United States of AmericaCAUTION: The developers of this standard have requested that holders of patents that may berequired for the implementation of the standard disclose such patents to the publisher. However,neither the developers nor the publisher have undertaken a patent searc
12、h in order to identifywhich, if any, patents may apply to this standard. As of the date of publication of this standardand following calls for the identification of patents that may be required for the implementation ofthe standard, no such claims have been made. No further patent search is conducte
13、d by the de-veloper or publisher in respect to any standard it processes. No representation is made or impliedthat licenses are not required to avoid infringement in the use of this standard.Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo repr
14、oduction or networking permitted without license from IHS-,-,-iContentsPageINCITS 464.1, Information Management - Extensible Access Method (XAMTM) - Part 1: ArchitectureINCITS 464.2, Information Management - Extensible Access Method (XAMTM) -Part 2: C APIINCITS 464.3, Information Management - Extens
15、ible Access Method (XAMTM) -Part 3: Java APICopyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-iiForeword (This foreword is not part of American National Standard INCITS 464-2010.)
16、INCITS 464 consists of the following parts, under the general title Information Tech-nolgy - Information Management - Extensible Access Method (XAMTM):- Part 1: Architecture- Part 2: C API- Part 3: Java APIRequests for interpretation, suggestions for improvement or addenda, or defect re-ports are we
17、lcome. They should be sent to InterNational Committee for InformationTechnology Standards (INCITS), ITI, 1101 K Street, NW, Suite 610, Washington, DC20005.This standard was processed and approved for submittal to ANSI by INCITS. Com-mittee approval of this standard does not necessarily imply that al
18、l committee mem-bers voted for its approval. At the time it approved this standard, INCITS had thefollowing members:Don Wright, ChairJennifer Garner, SecretaryOrganization Represented Name of RepresentativeAdobe Systems Inc. . Scott Foshee Steve Zilles (Alt.)AIM Global Inc. Dan Mullen Charles Biss (
19、Alt.)Apple Computer, Inc. . Kwok Lau Helene Workman (Alt.)David Singer (Alt.)Distributed Management Task Force John Crandall Jeff Hilland (Alt.)Electronic Industries Alliance Edward Mikoski, Jr. Henry Cuschieri (Alt.)EMC Corporation . Gary Robinson Farance Inc. . Frank Farance Timothy Schoechle (Alt
20、.)Google Zaheda Bhorat GS1 US . Ray Delnicki Frank Sharkey (Alt.)James Chronowski (Alt.)Mary Wilson (Alt.)Hewlett-Packard Company Karen Higginbottom Paul Jeran (Alt.)IBM Corporation Gerald Lane Robert Weir (Alt.)Arnaud Le Hors (Alt.)Debra Boland (Alt.)Steve Holbrook (Alt.)IEEE . Bill Ash Jodie Haasz
21、 (Alt.)Bob Labelle (Alt.)Intel Philip Wennblom Grace Wei (Alt.)Stephen Balogh (Alt.)Lexmark International. Don Wright Dwight Lewis (Alt.)Paul Menard (Alt.)Jerry Thrasher (Alt.)Microsoft Corporation . Jim Hughes Dick Brackney (Alt.)John Calhoun (Alt.)Copyright American National Standards Institute Pr
22、ovided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-iiiNational Institute of Standards Setting the Retention Identifier 120Table 58 Setting the Retention Enabled Flag .121Table 59 Setting the Duration .121Table 60 Setting the Start
23、 Time 122Table 61 Increasing the Retention Duration on an Active Retention Scope .122Table 62 Deletion Value Management Properties 124Table 63 XSet Policy Management Properties .127Table 64 Hold Properties 133Table 65 Valid Comparisons 136Table 66 Comparison Operators 136Table 67 Operator Descriptio
24、ns 136Table 68 Summary of “like“ Operator .137Table 69 Query Numeric Comparisons of Different types 138Table 70 Escape Sequences for Quoted Field Names and Strings .144Table 71 Query Job-Specific Fields 145Table 72 Query Job Error Codes 147Table 73 Query Example XSets .150Table 74 XAM Requirements f
25、or SASL 156Table 75 XSet Policy Management Properties .164Table 76 XSet Access Control Policy Methods 164Table A.1 XAMQuery Methods .166Table A.2 XUIDIterator Methods 166Table A.3 Base64 Methods 167Table A.4 XUID Padding Methods 167Table A.5 Field Determination Methods .168Copyright American Nationa
26、l Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-iForeword (This foreword is not part of American National Standard INCITS 464.1-2010.)Purpose and AudienceThis document is intended to be used by two broad
27、 audiences. The first audience consists of application programmers who wish to use the XAM Application Programmers Interface (API) to create, access, manage, and query reference content through standardized methods that are collectively referred to as XAM (eXtensible Access Method). The second audie
28、nce consists of those who implement reference content stores that wish to provide access to their stores through the XAM standardized methods.OrganizationThe contents of this part of INCITS 464 are described as follows:Chapter Contents1, “Scope” Defines the subject of the document and the aspects co
29、vered.2, “References” Lists the referenced documents that are indispensable for the application of this document.3, “Terms and Conventions” Defines the terms and typographical conventions used in the document.4, “Business Overview” Gives the background of the SNIA XAM and how XAM addresses the indus
30、try and market needs.5, “Overview of the XAM Architecture”Gives an overview of the XAM architecture, including how the XAM Storage System vendors connect their storage systems through the XAM standard APIs.6, “XAM Objects and Common Operations”Defines the XAM objects as well as the common data struc
31、tures and operations that can be associated with the XAM object.7, “XAM Library and XSystems”Specifies the XAM applications logical view of the XAM Storage System and the software modules that comprise XAM.8, “XSet Operations” Defines the behavioral and semantic model of an XSet by describing applic
32、able methods on individual XSets and their elements.9, “XSet Management” Specifies XSet lifecycle management capabilities, including retention, deletion, and hold.10, “Query” Describes the query language grammar and the two levels of query supported through the XAM API.11, “Security” Describes three
33、 XAM security functions: XAM application authentication, XSystem authorization, and XSet access control.Annex A, “(normative) XAM Toolkit”Describes toolkit methods to simplify some common operations within XAM.Annex A, “(normative) Canonical XSet Interchange Format”Describes the XSD (XML Schema Defi
34、nition) for the XML manifest that is used by the XSet canonical format when importing and exporting an XSet.Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-iiCopyright American
35、National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-11 ScopeThis part of the XAM standard is a normative specification of the general architecture and semantics of the XAM API. It applies to programme
36、rs who are generating XAM applications in any programming language. It also applies to storage system vendors who are creating vendor interface modules (VIMs).This document uses an object model to describe syntax in examples; these examples are informative only. It is not a normative specification o
37、f the syntax of the XAM interfaces in any language binding. The normative specification of the syntax of the C language binding is defined in the XAM C API Specification XAM-C-API. The normative specification of the syntax of the Java language binding is defined in the XAM Java API Specification XAM
38、-JAVA-API. AMERICAN NATIONAL STANDARD INCITS 464.1-2010American National Standardfor Information Technology Information Management Extensible Access Method (XAMTM) Part 1: ArchitectureCopyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproductio
39、n or networking permitted without license from IHS-,-,-INCITS 464.122 References2.1 Normative ReferencesThe following standards contain provisions which, through reference in this text, constitute provisions of this American National Standard. All standards are subject to revision, and parties to ag
40、reements based on this American National Standard are encouraged to investigate the possibility of applying the most recent editions of the standards indicated below.For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including
41、 any amendments) applies.CRC Williams, Ross, “A Painless Guide to CRC Error Detection Algorithms”, Chapter 16, August 1993, http:/www.repairfaq.org/filipg/LINK/F_crc_v3.html IANA-SASL “Simple Authentication and Security Layer (SASL) Mechanisms” http:/www.iana.org/assignments/sasl-mechanismsIEEE754 I
42、EEE Standard 754-1985. IEEE Standard for Binary Floating-Point Arithmetic. IEEE, New York, 1985.ISO8601 “Data elements and interchange formats - Information interchange - Representation of dates and times”, ISO 8601, http:/isotc.iso.org/livelink/livelink/4021199/ISO_8601_2004_E.zip?func=doc.Fetch al
43、l other invoked methods cause errors.3.1.5 CRCAcronym for cyclic redundancy check.3.1.6 fatal errorA method result indicating that the invoked method failed to completely perform its intended operation. A fatal error indicates that the object instance on which the method was invoked has transitioned
44、 to the corrupt state.3.1.7 fieldA piece of uniquely identifiable data that can be attached to an XSet, an XSystem, or a XAM Library. Two types of fields exist: a property and an XStream.3.1.8 field attributeOne or more features associated with a field. A field has multiple attributes associated wit
45、h it, including type (MIME type), binding (TRUE/FALSE), readonly (TRUE/FALSE), and length (length of the value).3.1.9 method An abstract interface definition for a specific piece of functionality. When mapped to a specific programming language definition of the method, this may be a function, a proc
46、edure, a macro, or an object-oriented method.3.1.10 MIMEAcronym for Multipurpose Internet Mail Extensions. MIME types are used by XAM to indicate the format of the data contained in an XStream. For additional information, see RFC2045 and RFC2046. Copyright American National Standards Institute Provi
47、ded by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-INCITS 464.153.1.11 nonbinding fieldAn XSet field that does not affect the value assigned to the XUID when the XUID is created after committing the XSet to persistent storage.3.1.12
48、nonbinding modificationA modification that includes all field editing that is not a binding modification, specifically, adding or deleting nonbinding fields, changing nonbinding field values, changing the nonbinding field type, or opening a nonbinding XStream in writeonly or appendonly mode.3.1.13 non-fatal errorA method result indicating that the invoked method did not perform its intended operation. A non-fatal error shall not cause an object instance to change its current state.3.1.14
