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

ACL.GATHER

Gathers fields into an ACL object.

Syntax

<ACL.GATHER NAME="ACL Name"
            PREFIX="Some Prefix"
            FIELDLIST="List of Field Names"/>

Parameters

NAME (required)

Name of the ACL.

PREFIX (required)

Specifies the name of a string to be used as the prefix for variable names, which may exist in the environment. When the ACL.GATHER tag looks for variables in the environment, a colon (:) is used to separate the prefix from the field name.

FIELDLIST (required)

Specifies a comma-separated list of field names that should be gathered. Any field in the list that does not exist in the environment is cleared. If this parameter is not specified, then the ACL.GATHER tag looks at all fields in the environment; if no field names are found, the existing value is maintained.

Description

This tag retrieves name/value pairs from the environment, and sets them into a loaded ACL object. The name/value pairs are grouped together using a prefix and a prefix separator (a colon).

Error Numbers

The possible values of errno include:

Value	Description
-10004	A required parameter is missing.
-10005	The requested object is not in the object pool (is not loaded into memory).

Example

The following example gathers the aclname and description fields from the environment into ACL1 using the prefix SAMPLE:

<ACL.GATHER NAME="ACL1"
               PREFIX="SAMPLE"
               FIELDLIST="aclname,description"/>

See Also

ACL.CREATE
ACL.GET
ACL.LIST
ACL.LOAD
ACL.SAVE
ACL.SCATTER
ACL.SET

		Home >	Contents >	Index >
	Oracle XML Tag Reference Copyright (c) 2013, 2015, Oracle and/or its affiliates. All rights reserved.