Examples of Search Strings That Filter Objects Based on UsageVersion

The SAS 9.2 Metadata Model defines an optional UsageVersion= attribute for all metadata types to enable version management of metadata definitions. A UsageVersion= value consists of a major version number (0<=major<=999), a minor version number (0<=minor<=99), and a build number (0<=build<=9999). The build number is reserved for future use. UsageVersion= values are persisted in metadata as a double value in the form MMMmmbbbb.0.

Major version zero is reserved to indicate that an object was created before SAS 9.2, or that the object is not versioned. Most SAS 9.2 Phase 2 objects are versioned as 1.0, unless there is a reason (such as an existing versioning scheme) to start at a higher version number.

The following examples show how the new SAS 9.2 comparison operators described in Attribute Criteria Component Syntax can be used to specify version criteria for the UsageVersion= attribute.

In the <XMLSELECT> search string, the UsageVersion= value can be expressed without the leading zeros in the MMM part of the MMMmmbbbb.0 format. These three examples all refer to version 1.1:

@UsageVersion LE   '1010000.0'
@UsageVersion LE  '01010000.0'
@UsageVersion LE '001010000.0'

The following are examples of search strings that execute common queries:

<XMLSELECT search="*[@UsageVersion EQ '0.0']"/>

<XMLSELECT search="*[@UsageVersion EQ '1000000.0']"/>

<XMLSELECT search="*[@UsageVersion EQ '1010000.0']"/>

<XMLSELECT search="*[@UsageVersion EQ '1100000.0']"/>

<XMLSELECT search="*[@UsageVersion GE '1000000.0' and 
@UsageVersion LE '1010000.0' ]"/>

<XMLSELECT search="*[@UsageVersion GE '1000000.0' and 
@UsageVersion LT '2000000.0']"/>

Copyright © 2010 by SAS Institute Inc., Cary, NC, USA. All rights reserved.