Home >	Contents >	Index >
Template Tag TOC  |   Alpha TOC  |   Tag Family TOC  |   Purpose TOC  |   Annotated TOC  |   Index

DIR.SEARCH

Searches for entries matching the specified attributes.

Syntax

<DIR.SEARCH
      LIST="matches" 
      CONTEXT="common ancestor"
      [OPERATOR="and|or")]>
  <DIR.ARGUMENT NAME="ATTRIBUTE_NAME" 
          VALUE="ATTRIBUTE_VALUE"/>
</DIR.SEARCH>

Parameters

LIST (required)

List in which the distinguished names of the matching entries are returned. The list contains a single column called NAME.

CONTEXT (required)

Overrides the value of the parent in the property file CS.Property.dir.peopleParent for type=user. Specify this argument for searching under groups or under a branch of the user tree.

OPERATOR (optional)

Determines if the matching entries must contain all "and" or one or more "or" of the specified attribute/value pairs. The default is "and".

DIR.ARGUMENT NAME (required)

The name of the attribute to be matched.

DIR.ARGUMENT VALUE (required)

Value of the attribute to be matched.

errno

The possible values of errno include:

Value	Description
-15004	Implementation doesn't support this operation
-15005	Unexpected naming exceptions from JNDI provider.
-15006	A required property missing, or class name specified for factory classes is in error.
-15007	Unexpected schema violation errors from JNDI provider.
-15008	General error in the syntax of an IName.
-15009	Unexpected invalid attribute exceptions from JNDI provider
-15010	Unexpected invalid attribute id exceptions from JNDI provider.
-15011	Unexpected invalid attribute value exceptions from JNDI provider.
-15012	User does not have permission to perform the operation.
-15014	Unexpected JNDI read error.
-15015	Unexpected JNDI write error.
-15016	JNDI attribute already in use.
-15023	Unexpected JNDI connection errors.
-15024	Required attribute missing.
-15025	Unknown error.
-15030	SQL error.
-15031	Query failed.
-15036	Missing or invalid child argument tags for tag.

Example

<DIR.SEARCH LIST="matchList">
 <DIR.ARGUMENT NAME="CS.Property.dir.username"                         
               VALUE="Variables.loginid"/>
</DIR.SEARCH>

Release Introduced

This tag was introduced in CS release 4.0.

		Home >	Contents >	Index >
	FatWire XML Tag Reference Copyright 2005 by FatWire Software All rights reserved.