com.pcbsys.nirvana.nAdminAPI.nContainer Class Reference

This represents a node within the Nirvana Realm namespace which contains other nodes, such as a directory or another Realm. More...

Inheritance diagram for com.pcbsys.nirvana.nAdminAPI.nContainer:
com.pcbsys.nirvana.nAdminAPI.nNode com.pcbsys.nirvana.nAdminAPI.nClusterNode com.pcbsys.nirvana.nAdminAPI.nDataGroupNode com.pcbsys.nirvana.nAdminAPI.nDataGroupsContainer com.pcbsys.nirvana.nAdminAPI.nLinkNode com.pcbsys.nirvana.nAdminAPI.nRealmNode com.pcbsys.nirvana.nAdminAPI.nSchedulerManager com.pcbsys.nirvana.nAdminAPI.nZoneNode

Public Member Functions

void addACLEntries (nACL acl) throws nAdminIllegalArgumentException, nBaseAdminException
 Adds a list acl entry to all nodes. More...
 
void addACLEntries (nACL acl, nNode[] nodes) throws nAdminIllegalArgumentException, nBaseAdminException
 Adds a list acl entry to all nodes contained with in the array of nNodes. More...
 
void addACLEntry (nACLEntry entry) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException
 Adds a specific acl entry to all known nodes within the nContainer node. More...
 
void addACLEntry (nACLEntry entry, boolean allChannels, boolean allQueues, boolean allServices) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException
 Adds a specific acl entry to all known nodes within the nContainer node. More...
 
void addACLEntry (nACLEntry entry, boolean allChannels, boolean allQueues) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException
 Adds a specific acl entry to all known nodes within the nContainer node. More...
 
void addACLEntry (nACLEntry entry, boolean allChannels, boolean allQueues, boolean allServices, boolean realm) throws nBaseAdminException
 Adds a specific acl entry to all known nodes within the nContainer node. More...
 
void addACLEntry (boolean realmLevel, nACLEntry entry, boolean allChannels, boolean allQueues) throws nBaseAdminException
 Adds a specific acl entry to all known nodes within the nContainer node. More...
 
void closed (nRealmNode node)
 Called when the nRealmNode is closed, for internal use only. More...
 
nNode findNode (String name) throws nAdminIllegalArgumentException
 Given a name of the form /container/container/name this function will locate the name object and return it, or null if that object can not be found. More...
 
nNode findNode (nNode node) throws nAdminIllegalArgumentException
 Given a name of the form /container/container/name this function will locate the nNode object and return it, or null if that can not be found. More...
 
nNode findNode (nNode node, boolean searchChildren) throws nAdminIllegalArgumentException
 Given a name of the form /container/container/name this function will locate the name object and return it, or null if that can not be found. More...
 
nNode getNextSibling ()
 Method to return the next sibling from this node's parent. More...
 
Enumeration getNodes ()
 Returns an Enumeration of all the nodes under this container. More...
 
nRealmNode getRealmAt (String name) throws nAdminIllegalArgumentException
 Given a mount point this function will return a realm if one exists at the specified mount point. More...
 
nRealmNode getRealmNode ()
 Get the realm node at the root of this container node. More...
 
int getSize ()
 Returns the number of nodes under this container. More...
 
int getTotalNodes ()
 Returns the total number of nodes within this container and all subsequent children by traversing the entire structure beneath this container node. More...
 
boolean hasRealmAt (String name) throws nAdminIllegalArgumentException
 Given a mount point this function will determine if this container contains a mounted realm at the specified mount point. More...
 
void modACLEntries (nACL acl) throws nAdminIllegalArgumentException, nBaseAdminException
 Modifies a list of acl entry to all known nodes within the nContainer node. More...
 
void modACLEntries (nACL acl, nNode[] nodes) throws nAdminIllegalArgumentException, nBaseAdminException
 Modifies a list of acl entry to all nodes contained with in the array of nNodes. More...
 
void modACLEntry (nACLEntry entry) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException
 modifies a specific acl entry's permissions for all known nodes within the nContainer node. More...
 
void modACLEntry (nACLEntry entry, boolean allChannels, boolean allQueues, boolean allServices) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException
 modifies a specific acl entry's permissions for all known nodes within the nContainer node. More...
 
void modACLEntry (nACLEntry entry, boolean allChannels, boolean allQueues) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException
 modifies a specific acl entry's permissions for all known nodes within the nContainer node. More...
 
void modACLEntry (nACLEntry entry, boolean allChannels, boolean allQueues, boolean allServices, boolean realm) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException
 modifies a specific acl entry's permissions for all known nodes within the nContainer node. More...
 
void modACLEntry (boolean realmLevel, nACLEntry entry, boolean allChannels, boolean allQueues) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException
 modifies a specific acl entry's permissions for all known nodes within the nContainer node. More...
 
void removeACLEntries (nACL acl) throws nAdminIllegalArgumentException, nBaseAdminException
 Removes a list of acl entries from all known nodes within the nContainer node. More...
 
void removeACLEntries (nACL acl, nNode[] nodes) throws nAdminIllegalArgumentException, nBaseAdminException
 Removes a list of acl entries from all nodes contained with in the array of nNodes. More...
 
void removeACLEntry (nACLEntry entry) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException
 removes a specific acl entry from all known nodes within the nContainer node. More...
 
void removeACLEntry (nACLEntry entry, boolean allChannels, boolean allQueues, boolean allServices) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException
 removes a specific acl entry from all known nodes within the nContainer node. More...
 
void removeACLEntry (nACLEntry entry, boolean allChannels, boolean allQueues) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException
 removes a specific acl entry from all known nodes within the nContainer node. More...
 
void removeACLEntry (nACLEntry entry, boolean allChannels, boolean allQueues, boolean allServices, boolean realm) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException
 Removes a specific acl entry from all known nodes within the nContainer node. More...
 
void removeACLEntry (boolean realmLevel, nACLEntry entry, boolean allChannels, boolean allQueues) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException
 Removes a specific acl entry from all known nodes within the nContainer node. More...
 
void setACL (nACL acl) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException
 Changes the entire ACL entries for all nodes within this container node. More...
 
void setACL (nACL acl, boolean allChannels, boolean allQueues, boolean allServices) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException
 Changes the entire ACL entries for the selected nodes with the new ACL passed in. More...
 
void setACL (nACL acl, boolean allChannels, boolean allQueues) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException
 Changes the entire ACL entries for the selected nodes with the new ACL passed in. More...
 
- Public Member Functions inherited from com.pcbsys.nirvana.nAdminAPI.nNode
boolean equals (long aLong)
 Needed as part of the SortedObject interface.
 
synchronized String getAbsolutePath ()
 This function walks the tree to the root to generate a fully qualified name for this node. More...
 
String getName ()
 Returns the generic name of this node within the namespace. More...
 
nNode getParent ()
 Returns this nodes parent node. More...
 
String getRelativePath (nNode top) throws nAdminIllegalArgumentException
 This method returns the relative path from this node to the nNode passed. More...
 
boolean isMatch (Object item)
 Compares this object with the passed object. More...
 
boolean lessThan (long aLong)
 Needed as part of the SortedObject interface.
 
boolean lessThan (Object item)
 Compares this object with the passed object. More...
 

Detailed Description

This represents a node within the Nirvana Realm namespace which contains other nodes, such as a directory or another Realm.

nContainer performs no functions other than containing the other nodes and being a placeholder in the namespace.

Member Function Documentation

void com.pcbsys.nirvana.nAdminAPI.nContainer.addACLEntries ( nACL  acl) throws nAdminIllegalArgumentException, nBaseAdminException

Adds a list acl entry to all nodes.

Parameters
aclthe acl to apply to all nodes in the container
void com.pcbsys.nirvana.nAdminAPI.nContainer.addACLEntries ( nACL  acl,
nNode[]  nodes 
) throws nAdminIllegalArgumentException, nBaseAdminException

Adds a list acl entry to all nodes contained with in the array of nNodes.

Parameters
aclthe acl to apply
nodesthe nodes to apply the acl to
void com.pcbsys.nirvana.nAdminAPI.nContainer.addACLEntry ( nACLEntry  entry) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException

Adds a specific acl entry to all known nodes within the nContainer node.

Parameters
entryAn nACL entry containing the subject and permissions to apply to all nodes under the container
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
void com.pcbsys.nirvana.nAdminAPI.nContainer.addACLEntry ( nACLEntry  entry,
boolean  allChannels,
boolean  allQueues,
boolean  allServices 
) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException

Adds a specific acl entry to all known nodes within the nContainer node.

Parameters
entryAn nACL entry containing the subject and permissions to apply to all nodes under the container
allChannelsif set then all channels within the container will have the acl applied
allQueuesif set then all queues within the container will have the acl applied
allServicesif set then all services within the container will have the acl applied
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
Deprecated:
9.12 as services no longer available
void com.pcbsys.nirvana.nAdminAPI.nContainer.addACLEntry ( nACLEntry  entry,
boolean  allChannels,
boolean  allQueues 
) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException

Adds a specific acl entry to all known nodes within the nContainer node.

Parameters
entryAn nACL entry containing the subject and permissions to apply to all nodes under the container
allChannelsif set then all channels within the container will have the acl applied
allQueuesif set then all queues within the container will have the acl applied
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
void com.pcbsys.nirvana.nAdminAPI.nContainer.addACLEntry ( nACLEntry  entry,
boolean  allChannels,
boolean  allQueues,
boolean  allServices,
boolean  realm 
) throws nBaseAdminException

Adds a specific acl entry to all known nodes within the nContainer node.

Parameters
entryAn nACL entry containing the subject and permissions to apply to all nodes under the container
allChannelsif set then all channels within the container will have the acl applied
allQueuesif set then all queues within the container will have the acl applied
allServicesif set then all services within the container will have the acl applied
realmif set the corresponding realm will have the acl applied
Exceptions
nInsufficientPrivilegesExceptionIf the user is not allowed to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
Deprecated:
void com.pcbsys.nirvana.nAdminAPI.nContainer.addACLEntry ( boolean  realmLevel,
nACLEntry  entry,
boolean  allChannels,
boolean  allQueues 
) throws nBaseAdminException

Adds a specific acl entry to all known nodes within the nContainer node.

Parameters
realmLevelif set the corresponding realm will have the acl applied
entryAn nACL entry containing the subject and permissions to apply to all nodes under the container
allChannelsif set then all channels within the container will have the acl applied
allQueuesif set then all queues within the container will have the acl applied
Exceptions
nInsufficientPrivilegesExceptionIf the user is not allowed to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
void com.pcbsys.nirvana.nAdminAPI.nContainer.closed ( nRealmNode  node)

Called when the nRealmNode is closed, for internal use only.

Parameters
nodeThe nRealmNode which has been closed.
nNode com.pcbsys.nirvana.nAdminAPI.nContainer.findNode ( String  name) throws nAdminIllegalArgumentException

Given a name of the form /container/container/name this function will locate the name object and return it, or null if that object can not be found.

Parameters
namethe name of the node to locate as a String
Returns
a nNode which could be a nRealmNode, nLeafNode or a nContainer
Exceptions
nAdminIllegalArgumentExceptionthrown if null is passed as the nNode
See Also
nRealmNode
nLeafNode
nContainer
nNode com.pcbsys.nirvana.nAdminAPI.nContainer.findNode ( nNode  node) throws nAdminIllegalArgumentException

Given a name of the form /container/container/name this function will locate the nNode object and return it, or null if that can not be found.

This function applies to the part of the namespace relative to the current node. Currently wildcards are NOT supported.

Parameters
nodethe nNode to be located
Returns
a nNode which could be a nRealmNode, nLeafNode or a nContainer
Exceptions
nAdminIllegalArgumentExceptionthrown if null is passed as the nNode
See Also
nRealmNode
nLeafNode
nContainer
nNode com.pcbsys.nirvana.nAdminAPI.nContainer.findNode ( nNode  node,
boolean  searchChildren 
) throws nAdminIllegalArgumentException

Given a name of the form /container/container/name this function will locate the name object and return it, or null if that can not be found.

The searchChildren flag specifies whether the search should be performed on the current container only or children containers too respectively. This function applies to the part of the namespace relative to the current node. Currently wildcards are NOT supported.

Parameters
nodethe nNode to be located
searchChildrenspecifies whether to traverse lower levels of the tree or not
Returns
a nNode which could be a nRealmNode, nLeafNode or a nContainer
Exceptions
nAdminIllegalArgumentExceptionthrown if null is passed as the nNode
See Also
nRealmNode
nLeafNode
nContainer
nNode com.pcbsys.nirvana.nAdminAPI.nContainer.getNextSibling ( )

Method to return the next sibling from this node's parent.

Returns the next sibling node from this node's parent.

Returns
a nNode which could be a nRealmNode, nLeafNode or a nContainer or null if there is no parent set or the current node is the last sibling.
See Also
nRealmNode
nLeafNode
nContainer
Enumeration com.pcbsys.nirvana.nAdminAPI.nContainer.getNodes ( )

Returns an Enumeration of all the nodes under this container.

These could be other nContainer nodes, nLeafNode or nRealmNode objects.

Returns
An Enumeration of nNode objects under this container
See Also
nRealmNode
nLeafNode
nContainer
nRealmNode com.pcbsys.nirvana.nAdminAPI.nContainer.getRealmAt ( String  name) throws nAdminIllegalArgumentException

Given a mount point this function will return a realm if one exists at the specified mount point.

Parameters
namethe mount point as a string as a String
Returns
nRealmNode if containier contains realm at that mount point, else null
Exceptions
nAdminIllegalArgumentExceptionthrown if null is passed as the nNode
nRealmNode com.pcbsys.nirvana.nAdminAPI.nContainer.getRealmNode ( )

Get the realm node at the root of this container node.

Returns
nRealmNode
int com.pcbsys.nirvana.nAdminAPI.nContainer.getSize ( )

Returns the number of nodes under this container.

Returns
an int specifying the number of nodes under this container.
int com.pcbsys.nirvana.nAdminAPI.nContainer.getTotalNodes ( )

Returns the total number of nodes within this container and all subsequent children by traversing the entire structure beneath this container node.

Returns
the total number of nodes counted beneath this container and it's children
boolean com.pcbsys.nirvana.nAdminAPI.nContainer.hasRealmAt ( String  name) throws nAdminIllegalArgumentException

Given a mount point this function will determine if this container contains a mounted realm at the specified mount point.

Parameters
namethe mount point as a string as a String
Returns
true if containier contains realm at that mount point
Exceptions
nAdminIllegalArgumentExceptionthrown if null is passed as the nNode
void com.pcbsys.nirvana.nAdminAPI.nContainer.modACLEntries ( nACL  acl) throws nAdminIllegalArgumentException, nBaseAdminException

Modifies a list of acl entry to all known nodes within the nContainer node.

Parameters
aclthe acl to apply
void com.pcbsys.nirvana.nAdminAPI.nContainer.modACLEntries ( nACL  acl,
nNode[]  nodes 
) throws nAdminIllegalArgumentException, nBaseAdminException

Modifies a list of acl entry to all nodes contained with in the array of nNodes.

Parameters
aclthe acl to apply
nodesthe nodes to apply the acl to
void com.pcbsys.nirvana.nAdminAPI.nContainer.modACLEntry ( nACLEntry  entry) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException

modifies a specific acl entry's permissions for all known nodes within the nContainer node.

Parameters
entryAn nACL entry containing the subject and permissions to apply to all nodes under the container
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
void com.pcbsys.nirvana.nAdminAPI.nContainer.modACLEntry ( nACLEntry  entry,
boolean  allChannels,
boolean  allQueues,
boolean  allServices 
) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException

modifies a specific acl entry's permissions for all known nodes within the nContainer node.

Parameters
entryAn nACL entry containing the subject and permissions to apply to all nodes under the container
allChannelsif set then all channels within the container will have the acl modified
allQueuesif set then all queues within the container will have the acl modified
allServicesif set then all services within the container will have the acl modified
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
Deprecated:
void com.pcbsys.nirvana.nAdminAPI.nContainer.modACLEntry ( nACLEntry  entry,
boolean  allChannels,
boolean  allQueues 
) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException

modifies a specific acl entry's permissions for all known nodes within the nContainer node.

Parameters
entryAn nACL entry containing the subject and permissions to apply to all nodes under the container
allChannelsif set then all channels within the container will have the acl modified
allQueuesif set then all queues within the container will have the acl modified
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
void com.pcbsys.nirvana.nAdminAPI.nContainer.modACLEntry ( nACLEntry  entry,
boolean  allChannels,
boolean  allQueues,
boolean  allServices,
boolean  realm 
) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException

modifies a specific acl entry's permissions for all known nodes within the nContainer node.

Parameters
entryAn nACL entry containing the subject and permissions to apply to all nodes under the container
allChannelsif set then all channels within the container will have the acl modified
allQueuesif set then all queues within the container will have the acl modified
allServicesif set then all services within the container will have the acl modified
realmif set then the realm will have the acl modified
Exceptions
nInsufficientPrivilegesExceptionIf the user is not allowed to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
Deprecated:
void com.pcbsys.nirvana.nAdminAPI.nContainer.modACLEntry ( boolean  realmLevel,
nACLEntry  entry,
boolean  allChannels,
boolean  allQueues 
) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException

modifies a specific acl entry's permissions for all known nodes within the nContainer node.

Parameters
realmLevelif set then the realm will have the acl modified
entryAn nACL entry containing the subject and permissions to apply to all nodes under the container
allChannelsif set then all channels within the container will have the acl modified
allQueuesif set then all queues within the container will have the acl modified
Exceptions
nInsufficientPrivilegesExceptionIf the user is not allowed to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
void com.pcbsys.nirvana.nAdminAPI.nContainer.removeACLEntries ( nACL  acl) throws nAdminIllegalArgumentException, nBaseAdminException

Removes a list of acl entries from all known nodes within the nContainer node.

Parameters
aclthe acl to apply
void com.pcbsys.nirvana.nAdminAPI.nContainer.removeACLEntries ( nACL  acl,
nNode[]  nodes 
) throws nAdminIllegalArgumentException, nBaseAdminException

Removes a list of acl entries from all nodes contained with in the array of nNodes.

Parameters
aclthe acl to apply to the list of nodes
nodesthe list of nodes
void com.pcbsys.nirvana.nAdminAPI.nContainer.removeACLEntry ( nACLEntry  entry) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException

removes a specific acl entry from all known nodes within the nContainer node.

Parameters
entryAn nACL entry containing the subject and permissions to apply to all nodes under the container
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
void com.pcbsys.nirvana.nAdminAPI.nContainer.removeACLEntry ( nACLEntry  entry,
boolean  allChannels,
boolean  allQueues,
boolean  allServices 
) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException

removes a specific acl entry from all known nodes within the nContainer node.

Parameters
entryAn nACL entry containing the subject and permissions to apply to all nodes under the container
allChannelsif set then all channels within the container will have the acl removed
allQueuesif set then all queues within the container will have the acl removed
allServicesif set then all services within the container will have the acl removed
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
Deprecated:
9.12 services are no longer available
void com.pcbsys.nirvana.nAdminAPI.nContainer.removeACLEntry ( nACLEntry  entry,
boolean  allChannels,
boolean  allQueues 
) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException

removes a specific acl entry from all known nodes within the nContainer node.

Parameters
entryAn nACL entry containing the subject and permissions to apply to all nodes under the container
allChannelsif set then all channels within the container will have the acl removed
allQueuesif set then all queues within the container will have the acl removed
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
void com.pcbsys.nirvana.nAdminAPI.nContainer.removeACLEntry ( nACLEntry  entry,
boolean  allChannels,
boolean  allQueues,
boolean  allServices,
boolean  realm 
) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException

Removes a specific acl entry from all known nodes within the nContainer node.

Parameters
entryAn nACL entry containing the subject and permissions to apply to all nodes under the container
allChannelsif set then all channels within the container will have the acl removed
allQueuesif set then all queues within the container will have the acl removed
allServicesif set then all services within the container will have the acl removed
realmif set then the realm will have the acl removed
Exceptions
nInsufficientPrivilegesExceptionIf the user is not allowed to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
Deprecated:
9.12 Services are no longer available
void com.pcbsys.nirvana.nAdminAPI.nContainer.removeACLEntry ( boolean  realmLevel,
nACLEntry  entry,
boolean  allChannels,
boolean  allQueues 
) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException

Removes a specific acl entry from all known nodes within the nContainer node.

Parameters
realmLevelif set then the realm will have the acl removed
entryAn nACL entry containing the subject and permissions to apply to all nodes under the container
allChannelsif set then all channels within the container will have the acl removed
allQueuesif set then all queues within the container will have the acl removed
Exceptions
nInsufficientPrivilegesExceptionIf the user is not allowed to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
void com.pcbsys.nirvana.nAdminAPI.nContainer.setACL ( nACL  acl) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException

Changes the entire ACL entries for all nodes within this container node.

Parameters
aclAn nACL containing the nAclEntry objects that will be applied to all nodes under the container
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
void com.pcbsys.nirvana.nAdminAPI.nContainer.setACL ( nACL  acl,
boolean  allChannels,
boolean  allQueues,
boolean  allServices 
) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException

Changes the entire ACL entries for the selected nodes with the new ACL passed in.

Parameters
aclAn nACL containing the nAclEntry objects that will be applied to all nodes under the container
allChannelsif set then all channels within the container will have the acl added
allQueuesif set then all queues within the container will have the acl added
allServicesif set then all services within the container will have the acl added
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
Deprecated:
9.12 Services are no longer available
void com.pcbsys.nirvana.nAdminAPI.nContainer.setACL ( nACL  acl,
boolean  allChannels,
boolean  allQueues 
) throws nInsufficientPrivilegesException, nNodeException, nBaseAdminException

Changes the entire ACL entries for the selected nodes with the new ACL passed in.

Parameters
aclAn nACL containing the nAclEntry objects that will be applied to all nodes under the container
allChannelsif set then all channels within the container will have the acl added
allQueuesif set then all queues within the container will have the acl added
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information