com.waveset.adapter
Class RACFResourceAdapter

java.lang.Object
  extended bycom.waveset.adapter.ResourceAdapterBase
      extended bycom.waveset.adapter.HostAccessResourceAdapter
          extended bycom.waveset.adapter.RACFResourceAdapter
All Implemented Interfaces:
HostAccessLogin, ResourceAdapter

public class RACFResourceAdapter
extends HostAccessResourceAdapter
implements HostAccessLogin


Nested Class Summary
 
Nested classes inherited from class com.waveset.adapter.ResourceAdapterBase
ResourceAdapterBase.SimpleAccountIterator
 
Nested classes inherited from class com.waveset.adapter.ResourceAdapter
ResourceAdapter.ActionResult, ResourceAdapter.Features, ResourceAdapter.ObjectType
 
Field Summary
protected  HostAccess _hostAccess
           
protected static java.util.Set _quotedAttributeValues
          Set of attributes whose values are always quoted.
protected static java.util.Map _supportedSegments
           
protected  java.lang.String[] _warnMessagesUpdate
           
static java.lang.String ATTRIBUTES
           
static java.lang.String CATALOG_ALIAS
           
static java.lang.String code_id
           
static java.lang.String EXPIRED
           
static java.lang.String GROUP_CONN_OWNERS
           
static java.lang.String GROUPS
           
static java.lang.String MASTER_CATALOG
           
static java.lang.String PASSWORD_INTERVAL
           
static java.lang.String PASSWORD_INTERVAL_DEFAULT
           
static java.lang.String PASSWORD_NOINTERVAL
           
static java.lang.String RA_AFFINITY_LIST
          The account name used to connect to the resource.
static java.lang.String RA_CICS_SEGMENT_ATTR_PARSE
           
static java.lang.String RA_HOST
          Resource attributes are the common names that will be visible in the GUI that will prompt the user for values.
static java.lang.String RA_IDLETIMEOUT
           
static java.lang.String RA_LIST_TIMEOUT
           
static java.lang.String RA_LISTUSER_ATTR_PARSE
           
static java.lang.String RA_NETVIEW_SEGMENT_ATTR_PARSE
           
static java.lang.String RA_OMVS_SEGMENT_ATTR_PARSE
           
static java.lang.String RA_PORT
          The port on which to communicate to the resource.
static java.lang.String RA_TIMEOUT
           
static java.lang.String RA_TSO_SEGMENT_ATTR_PARSE
           
protected static java.lang.String RACF_MORE
           
protected static java.lang.String RACF_PROMPT
           
protected static java.lang.String SEGMENT_SEPARATOR
           
protected static java.lang.String TSO_MORE
           
protected static java.lang.String TSO_PROMPT
           
static java.lang.String USER_CATALOG
           
protected static java.lang.String USER_TYPE
           
static java.lang.String USERID
           
 
Fields inherited from class com.waveset.adapter.HostAccessResourceAdapter
HOST_ACCESS_GLOBAL_NAME, JAVASCRIPT_GLOBALS_ACTION_PROPERTY, USER_ATTRS_GLOBAL_NAME, USER_IDENTITY_GLOBAL_NAME
 
Fields inherited from class com.waveset.adapter.ResourceAdapterBase
_cache, _context, _excludedAccountsRule, _excludedAccountsRuleInited, _listAllObjectsAttrParse, _listAllObjectsAttrParseName, _listUserAttrParse, _listUserAttrParseName, _listUserGroupsAttrParse, _listUserGroupsAttrParseName, _resource, _thread, _trace, displayInfoCode, RA_BLOCKCOUNT, RA_LOGIN_ACTION, RA_LOGOFF_ACTION, RA_MULTI_VALUED_ATTRS, RA_TEST_MODE
 
Fields inherited from interface com.waveset.adapter.ResourceAdapter
CHANGE_PASSWORD_LOCATION, DISABLE, ENABLE, EXPIRE_PASSWORD, GUID, IGNORE_ATTR, NEW_ACCOUNT_ID, OP_DAYS_INACTIVE, OP_DISABLED, OP_DORMANT, OP_EXPIRED, OP_EXPIREDPWD, OP_INACTIVE, OP_LOCKED, OP_NO_PASSWORD_SET, OP_NOOWNERSHIP, OP_NOPASSWORDREQ, OP_NUMINACTIVEDAYS, OP_NUMPWDAYS, OP_PWNUMDAYS, RA_BASE_CTX, RA_DISPLAY_NAME_ATTR, RA_NEW_OBJECT_ID, RA_NEW_OBJECT_NAME, RA_OBJECT_ATTRIBUTES, RA_OBJECT_CLASS, RA_OBJECT_ID, RA_OBJECT_TYPE, RA_OP_TYPE, RA_RENAME_OP, RA_REQUESTOR, RA_SAVEAS_OP, RA_SEARCH_ATTRIBUTE_NAMES, RA_SEARCH_ATTRS_TO_GET, RA_SEARCH_CONTEXT, RA_SEARCH_FILTER, RA_SEARCH_RUN_AS_PASSWORD, RA_SEARCH_RUN_AS_USER, RA_SEARCH_SCOPE, RA_SEARCH_SCOPE_OBJECT, RA_SEARCH_SCOPE_ONE_LEVEL, RA_SEARCH_SCOPE_SUBTREE, RA_SEARCH_TIME_LIMIT, RESET_PASSWORD, SYSTEM_ATTRIBUTES, UNLOCK, WS_USER_PASSWORD
 
Constructor Summary
RACFResourceAdapter()
           
RACFResourceAdapter(Resource res, ObjectCache cache)
           
 
Method Summary
protected  void addCatalogAliasAndDSRules(WSUser user)
           
protected  void addDatasetRules(WSUser user)
           
protected  java.lang.String addEol(java.lang.String s, java.lang.String eol, int width)
           
protected  void addUserToGroup(WSUser user, java.lang.String group, java.lang.String groupOwner)
           
protected  void addUserToGroups(WSUser user, java.util.Set groups, WavesetResult result)
           
protected  void addUserToGroups(WSUser user, java.util.TreeMap groups, WavesetResult result)
           
protected  void addUserToGroups(WSUser user, WavesetResult result)
           
 WavesetResult authenticate(java.util.HashMap loginInfo)
          Authenticates the user against the resource.
 WavesetResult checkCreateAccount(WSUser user)
          Checks to see if an account can be created.
 WavesetResult checkDeleteAccount(WSUser user)
           
 WavesetResult checkUpdateAccount(WSUser user)
           
 java.lang.String createIdentity(WSUser user)
          Override base class' createIdentity to always uppercase the identity since RACF will upper case the user ID anyway.
 Resource createPrototypeResource()
           
protected  void deleteCatalogAlias(java.lang.String identity, WavesetResult result)
           
protected  void deleteDatasetProfile(java.lang.String identity, WavesetResult result)
           
 WSAttributes getAccountAttributes(java.lang.String accountIdentity)
          This method is obsolete.
 java.util.List getAffinityList()
           
protected  void getCatalogAttr(java.lang.String resp, java.lang.String label, java.lang.String attr, java.util.Map map)
           
protected  void getCatalogAttrs(java.lang.String identity, java.util.Map map)
           
protected  java.lang.String getDefaultGroup(WSUser user)
           
 GenericObject getFeatures()
          Indicates what functionality the resource adapter supports.
protected  java.util.TreeMap getGroups(WSUser user)
          Get the GROUPS and GROUP_CONN_OWNERS from the user and build a map with the group name as the key and the owner as the value.
 java.lang.String getHost()
           
protected  HostAccess getHostAccess()
           
 int getIdleTimeout()
           
 java.lang.String getKey()
           
 int getMaxConnections()
           
 java.lang.String getPort()
           
 java.util.Properties getProperties()
           
 int getRequestTimeout()
           
protected  void getSegmentAttrs(java.lang.String identity, java.util.Map map)
           
 java.lang.String getUser()
           
 WSUser getUser(WSUser user)
          Retrieve information about an account, and package it as a WSUser object.
protected  void initSupportedSegments()
           
protected static boolean isValidTsoAccountName(java.lang.String name)
           
 java.util.ArrayList listAllObjects(java.lang.String resourceObjectType, java.util.Map options, java.lang.String runAsUser, EncryptedData runAsPassword)
          This method will return a list of object names of the specified object type.
 void login(HostAccess hostAccess)
           
 void login(HostAccess hostAccess, ServerAffinity affinity)
           
 void logoff(HostAccess hostAccess)
           
static void main(java.lang.String[] args)
           
protected  java.lang.String processResponse(java.lang.String resp, java.lang.String[] warnMessages, WavesetResult result)
           
protected  void quoteValue(java.lang.StringBuffer b, java.lang.String attrName, java.lang.String value)
           
protected  void realCreate(WSUser user, WavesetResult result)
          Create a new user account on the resource This method is called by createAccounts (the multiuser create method).
protected  void realDelete(WSUser user, WavesetResult result)
          Needs to be overridden by subclass if default deleteAccounts() implementation is used.
 void realDisable(WSUser user, WavesetResult result)
           
 void realEnable(WSUser user, WavesetResult result)
           
protected  WSUser realGetUser(WSUser user)
           
protected  void realUpdate(WSUser user, WavesetResult result)
          Needs to be overridden by subclass if default updateAccounts() implementation is used.
protected  void removeUserFromGroup(WSUser user, java.lang.String group)
           
protected  void removeUserFromGroups(WSUser user, java.util.Set groups, WavesetResult result)
           
protected  WSAttributes reverseMap(java.util.Map map)
           
protected  void setFromResource()
           
protected  void startConnection()
          Needs to be overridden by subclass if default createAccounts() implementation is used.
static Resource staticCreatePrototypeResource()
           
protected  void stopConnection()
          Needs to be overridden by subclass if default createAccounts() implementation is used.
 boolean supportsAccountDisable()
          Indicates whether or not this resource supports account disable.
protected  java.lang.String updateGroups(WSUser newUser, WavesetResult result)
          Updates the user's groups.
 
Methods inherited from class com.waveset.adapter.HostAccessResourceAdapter
filterAndParseData, formatOutputStr, getResourceId, lookupAndRunJavascriptAction, parseDataFromFile, readDataFile, run, runAfterJavascriptAction, runBeforeJavascriptAction, runJavascript, runJavascriptAction, runResourceAttributeJavascriptAction, supportsActions, verifyUsers
 
Methods inherited from class com.waveset.adapter.ResourceAdapterBase
checkForNoPasswordInSchema, checkSyntax, createAccount, createAccounts, createObject, deleteAccount, deleteAccount, deleteAccounts, deleteObject, disableAccount, disableAccounts, dnsEqual, dnsEqual, enableAccount, enableAccounts, executeResourceAttributeJavascriptAction, fillInResourceInfo, fillInResourceInfo, getAccountIterator, getAccountIterator, getAccountIterator, getAction, getActionNotFoundErrorMessage, getActionNotFoundMessage, getActionRunAsPassword, getActionRunAsUser, getActionTimeout, getActionType, getAdapter, getAdapter, getAdapter, getAdapterProxy, getAdapterProxy, getAllAccounts, getAttrNameFromMapName, getAttrNameFromMapName, getAttrParse, getAttrTypeFromMapName, getAttrTypeFromMapName, getAUserName, getBaseContextAttrName, getBaseContextObject, getBaseContexts, getBlockSize, getContext, getExcludedAccountsRule, getIdentity, getListAllObjectsAttrParse, getListUserAttrParse, getListUserGroupsAttrParse, getObject, getOptionalBooleanResAttrVal, getOptionalBooleanResAttrVal, getOptionalEncryptedResAttrVal, getOptionalResAttrVal, getOptionalStringResAttrVal, getRequiredResAttr, getRequiredResAttr, getRequiredResAttrVal, getRequiredResAttrVal, getRequiredResAttrVals, getRequiredUserAttributeNames, getResAttrValActionOnUser, getResAttrVals, getResource, getResourceAccounts, getResourceInfo, getResourceObjectAttrValNameAttr, getResourceObjectClassAttr, getResourceObjectTypePrefix, getSchemaMap, getUser, getWSAttrByMapName, getWSAttrByMapName, getWSAttrFromMap, handleActionResult, handleJavascriptActionResult, isAccountAttributeSecret, isExcludedAccount, isExcludedAccount, isFeatureEnabled, isSupported, isTestMode, listAllObjects, listObjects, listObjects, listObjectsOfType, lookupAction, lookupAction, lookupActions, namesEqual, objectClassesMatchType, println, restoreResourceObjectClassAttr, run, runResourceAttributeJavascriptAction, scan, setCache, setContext, setDisabled, setResource, setResourceObjectClassAttr, setResourceOptionAttrs, startConnectionWrapper, supportsAccountActions, supportsCaseInsensitiveAccountIds, supportsContainerObjectTypes, supportsExcludedAccounts, supportsResourceAccount, supportsScanning, testConfiguration, updateAccount, updateAccounts, updateObject, updateResourceAccount, updateResourceIdentity, vmStoreBoot, vmStoreGet, vmStoreInit, vmStoreLatch, vmStorePut
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

code_id

public static final java.lang.String code_id
See Also:
Constant Field Values

RACF_PROMPT

protected static java.lang.String RACF_PROMPT

RACF_MORE

protected static java.lang.String RACF_MORE

TSO_PROMPT

protected static java.lang.String TSO_PROMPT

TSO_MORE

protected static java.lang.String TSO_MORE

SEGMENT_SEPARATOR

protected static final java.lang.String SEGMENT_SEPARATOR
See Also:
Constant Field Values

USER_TYPE

protected static final java.lang.String USER_TYPE
See Also:
Constant Field Values

_hostAccess

protected HostAccess _hostAccess

_warnMessagesUpdate

protected java.lang.String[] _warnMessagesUpdate

_quotedAttributeValues

protected static java.util.Set _quotedAttributeValues
Set of attributes whose values are always quoted.


RA_HOST

public static final java.lang.String RA_HOST
Resource attributes are the common names that will be visible in the GUI that will prompt the user for values. For example, the GUI will show "host" and have a box next to it for the user to enter a host name. The name of the host used to communicate with the resource.

See Also:
Constant Field Values

RA_PORT

public static final java.lang.String RA_PORT
The port on which to communicate to the resource.

See Also:
Constant Field Values

RA_AFFINITY_LIST

public static final java.lang.String RA_AFFINITY_LIST
The account name used to connect to the resource.

See Also:
Constant Field Values

RA_TIMEOUT

public static final java.lang.String RA_TIMEOUT
See Also:
Constant Field Values

RA_IDLETIMEOUT

public static final java.lang.String RA_IDLETIMEOUT
See Also:
Constant Field Values

RA_LIST_TIMEOUT

public static final java.lang.String RA_LIST_TIMEOUT
See Also:
Constant Field Values

RA_LISTUSER_ATTR_PARSE

public static final java.lang.String RA_LISTUSER_ATTR_PARSE
See Also:
Constant Field Values

RA_TSO_SEGMENT_ATTR_PARSE

public static final java.lang.String RA_TSO_SEGMENT_ATTR_PARSE
See Also:
Constant Field Values

RA_OMVS_SEGMENT_ATTR_PARSE

public static final java.lang.String RA_OMVS_SEGMENT_ATTR_PARSE
See Also:
Constant Field Values

RA_CICS_SEGMENT_ATTR_PARSE

public static final java.lang.String RA_CICS_SEGMENT_ATTR_PARSE
See Also:
Constant Field Values

RA_NETVIEW_SEGMENT_ATTR_PARSE

public static final java.lang.String RA_NETVIEW_SEGMENT_ATTR_PARSE
See Also:
Constant Field Values

USER_CATALOG

public static final java.lang.String USER_CATALOG
See Also:
Constant Field Values

MASTER_CATALOG

public static final java.lang.String MASTER_CATALOG
See Also:
Constant Field Values

CATALOG_ALIAS

public static final java.lang.String CATALOG_ALIAS
See Also:
Constant Field Values

ATTRIBUTES

public static final java.lang.String ATTRIBUTES
See Also:
Constant Field Values

GROUPS

public static final java.lang.String GROUPS
See Also:
Constant Field Values

GROUP_CONN_OWNERS

public static final java.lang.String GROUP_CONN_OWNERS
See Also:
Constant Field Values

USERID

public static final java.lang.String USERID
See Also:
Constant Field Values

EXPIRED

public static final java.lang.String EXPIRED
See Also:
Constant Field Values

PASSWORD_INTERVAL

public static final java.lang.String PASSWORD_INTERVAL
See Also:
Constant Field Values

PASSWORD_INTERVAL_DEFAULT

public static final java.lang.String PASSWORD_INTERVAL_DEFAULT
See Also:
Constant Field Values

PASSWORD_NOINTERVAL

public static final java.lang.String PASSWORD_NOINTERVAL
See Also:
Constant Field Values

_supportedSegments

protected static java.util.Map _supportedSegments
Constructor Detail

RACFResourceAdapter

public RACFResourceAdapter(Resource res,
                           ObjectCache cache)
                    throws WavesetException

RACFResourceAdapter

public RACFResourceAdapter()
                    throws WavesetException
Method Detail

initSupportedSegments

protected void initSupportedSegments()
                              throws WavesetException
Throws:
WavesetException

staticCreatePrototypeResource

public static Resource staticCreatePrototypeResource()
                                              throws WavesetException
Throws:
WavesetException

createPrototypeResource

public Resource createPrototypeResource()
                                 throws WavesetException
Specified by:
createPrototypeResource in interface ResourceAdapter
Specified by:
createPrototypeResource in class ResourceAdapterBase
Throws:
WavesetException

setFromResource

protected void setFromResource()
Overrides:
setFromResource in class ResourceAdapterBase

createIdentity

public java.lang.String createIdentity(WSUser user)
                                throws WavesetException
Override base class' createIdentity to always uppercase the identity since RACF will upper case the user ID anyway.

Specified by:
createIdentity in interface ResourceAdapter
Overrides:
createIdentity in class ResourceAdapterBase
Throws:
WavesetException

realGetUser

protected WSUser realGetUser(WSUser user)
                      throws WavesetException
Throws:
WavesetException

getUser

public WSUser getUser(WSUser user)
               throws WavesetException
Retrieve information about an account, and package it as a WSUser object.

Information required to identify the resource account is supplied in another WSUser object.

The returned user object will resemble the source object, but will have its account attribute list filled in.

Returns "null" if there is no account that corresponds to the user.

Specified by:
getUser in interface ResourceAdapter
Overrides:
getUser in class ResourceAdapterBase
Throws:
WavesetException

getSegmentAttrs

protected void getSegmentAttrs(java.lang.String identity,
                               java.util.Map map)
                        throws WavesetException
Throws:
WavesetException

getCatalogAttrs

protected void getCatalogAttrs(java.lang.String identity,
                               java.util.Map map)

isValidTsoAccountName

protected static boolean isValidTsoAccountName(java.lang.String name)
Parameters:
name -
Returns:
true if name is a valid TSO account name (1-7 alphanumeric characters, beginning with an alphabetic or special character (#,$,@)). Otherwise, return false.

getCatalogAttr

protected void getCatalogAttr(java.lang.String resp,
                              java.lang.String label,
                              java.lang.String attr,
                              java.util.Map map)

reverseMap

protected WSAttributes reverseMap(java.util.Map map)
                           throws WavesetException
Throws:
WavesetException

checkCreateAccount

public WavesetResult checkCreateAccount(WSUser user)
                                 throws WavesetException
Checks to see if an account can be created. Some of the things that might be checked are as follows: - can basic connectivity to the resource be established? - Do the account attribute values comply with all (if any) resource specific restrictions or policies that haven't been checked at a higher level? Currently there are 3 check methods: checkCreateAccount, checkDeleteAccount and checkUpdate account. All three of these methods could be performing similar actions, such as ensuring that the resource is available. These common actions can be moved to a common function such as doBasicCheck() which any/all check methods could call. Then the individual check methods would do additional checks to ensure that user accounts can be added, modified or deleted. checkCreateAccount is not designed to ensure that the account creation will succeed, only that the likelyhood of success is good. checkCreateAccount does not need to check to see if the account already exists. The provisioner method will follow checkCreateAccount with a getUser call.

Specified by:
checkCreateAccount in interface ResourceAdapter
Specified by:
checkCreateAccount in class ResourceAdapterBase
Throws:
WavesetException

realCreate

protected void realCreate(WSUser user,
                          WavesetResult result)
                   throws WavesetException
Create a new user account on the resource This method is called by createAccounts (the multiuser create method). CreateAccounts will open a connection, call realCreate for each user being created, then close the connection.

Overrides:
realCreate in class ResourceAdapterBase
Throws:
WavesetException

processResponse

protected java.lang.String processResponse(java.lang.String resp,
                                           java.lang.String[] warnMessages,
                                           WavesetResult result)

addCatalogAliasAndDSRules

protected void addCatalogAliasAndDSRules(WSUser user)
                                  throws WavesetException
Throws:
WavesetException

addDatasetRules

protected void addDatasetRules(WSUser user)
                        throws WavesetException
Throws:
WavesetException

getGroups

protected java.util.TreeMap getGroups(WSUser user)
                               throws WavesetException
Get the GROUPS and GROUP_CONN_OWNERS from the user and build a map with the group name as the key and the owner as the value. If the GROUP_CONN_OWNERS attribute isn't specified, default to using the group as the connection owner.

Throws:
WavesetException

getDefaultGroup

protected java.lang.String getDefaultGroup(WSUser user)

updateGroups

protected java.lang.String updateGroups(WSUser newUser,
                                        WavesetResult result)
                                 throws WavesetException
Updates the user's groups. Returns the name of the old default group if the user needs to be removed from that group after the user's default groups has been updated (after the ALTUSER command). RACF won't let you delete a user from his default group.

Throws:
WavesetException

removeUserFromGroups

protected void removeUserFromGroups(WSUser user,
                                    java.util.Set groups,
                                    WavesetResult result)
                             throws WavesetException
Throws:
WavesetException

removeUserFromGroup

protected void removeUserFromGroup(WSUser user,
                                   java.lang.String group)
                            throws WavesetException
Throws:
WavesetException

addUserToGroups

protected void addUserToGroups(WSUser user,
                               WavesetResult result)
                        throws WavesetException
Throws:
WavesetException

addUserToGroups

protected void addUserToGroups(WSUser user,
                               java.util.TreeMap groups,
                               WavesetResult result)
                        throws WavesetException
Throws:
WavesetException

addUserToGroups

protected void addUserToGroups(WSUser user,
                               java.util.Set groups,
                               WavesetResult result)
                        throws WavesetException
Throws:
WavesetException

addUserToGroup

protected void addUserToGroup(WSUser user,
                              java.lang.String group,
                              java.lang.String groupOwner)
                       throws WavesetException
Throws:
WavesetException

checkUpdateAccount

public WavesetResult checkUpdateAccount(WSUser user)
                                 throws WavesetException
Specified by:
checkUpdateAccount in interface ResourceAdapter
Specified by:
checkUpdateAccount in class ResourceAdapterBase
Throws:
WavesetException

realUpdate

protected void realUpdate(WSUser user,
                          WavesetResult result)
                   throws WavesetException
Description copied from class: ResourceAdapterBase
Needs to be overridden by subclass if default updateAccounts() implementation is used.

Overrides:
realUpdate in class ResourceAdapterBase
Throws:
WavesetException

checkDeleteAccount

public WavesetResult checkDeleteAccount(WSUser user)
                                 throws WavesetException
Specified by:
checkDeleteAccount in interface ResourceAdapter
Specified by:
checkDeleteAccount in class ResourceAdapterBase
Throws:
WavesetException

realDelete

protected void realDelete(WSUser user,
                          WavesetResult result)
                   throws WavesetException
Description copied from class: ResourceAdapterBase
Needs to be overridden by subclass if default deleteAccounts() implementation is used.

Overrides:
realDelete in class ResourceAdapterBase
Throws:
WavesetException

deleteCatalogAlias

protected void deleteCatalogAlias(java.lang.String identity,
                                  WavesetResult result)
                           throws WavesetException
Throws:
WavesetException

deleteDatasetProfile

protected void deleteDatasetProfile(java.lang.String identity,
                                    WavesetResult result)
                             throws WavesetException
Throws:
WavesetException

getAccountAttributes

public WSAttributes getAccountAttributes(java.lang.String accountIdentity)
                                  throws WavesetException
Description copied from interface: ResourceAdapter
This method is obsolete. ResourceAdapterBase provides a default implementation that throws a "not implemented" WavesetException.

Specified by:
getAccountAttributes in interface ResourceAdapter
Overrides:
getAccountAttributes in class ResourceAdapterBase
Throws:
WavesetException

authenticate

public WavesetResult authenticate(java.util.HashMap loginInfo)
                           throws WavesetException
Description copied from interface: ResourceAdapter
Authenticates the user against the resource. If authentication is successful, the authenticated id will be returned. If more info is required to complete authentication the result will contain the required info

Specified by:
authenticate in interface ResourceAdapter
Specified by:
authenticate in class ResourceAdapterBase
Throws:
WavesetException

startConnection

protected void startConnection()
                        throws WavesetException
Description copied from class: ResourceAdapterBase
Needs to be overridden by subclass if default createAccounts() implementation is used.

Overrides:
startConnection in class ResourceAdapterBase
Throws:
WavesetException

stopConnection

protected void stopConnection()
                       throws WavesetException
Description copied from class: ResourceAdapterBase
Needs to be overridden by subclass if default createAccounts() implementation is used.

Overrides:
stopConnection in class ResourceAdapterBase
Throws:
WavesetException

quoteValue

protected void quoteValue(java.lang.StringBuffer b,
                          java.lang.String attrName,
                          java.lang.String value)

addEol

protected java.lang.String addEol(java.lang.String s,
                                  java.lang.String eol,
                                  int width)

supportsAccountDisable

public boolean supportsAccountDisable()
Description copied from interface: ResourceAdapter
Indicates whether or not this resource supports account disable. If it does not, the provisioning engine will attempt to simulate disable by generating random passwords. If we end up with more of these "can you do this" methods, we might want to generalize it into a more extensible way to describe features and levels of support.

Specified by:
supportsAccountDisable in interface ResourceAdapter
Overrides:
supportsAccountDisable in class ResourceAdapterBase

realDisable

public void realDisable(WSUser user,
                        WavesetResult result)
                 throws WavesetException
Overrides:
realDisable in class ResourceAdapterBase
Throws:
WavesetException

realEnable

public void realEnable(WSUser user,
                       WavesetResult result)
                throws WavesetException
Overrides:
realEnable in class ResourceAdapterBase
Throws:
WavesetException

listAllObjects

public java.util.ArrayList listAllObjects(java.lang.String resourceObjectType,
                                          java.util.Map options,
                                          java.lang.String runAsUser,
                                          EncryptedData runAsPassword)
                                   throws WavesetException
Description copied from interface: ResourceAdapter
This method will return a list of object names of the specified object type. If you need to be able to specify which attrs to return, use listObjects instead

Specified by:
listAllObjects in interface ResourceAdapter
Overrides:
listAllObjects in class ResourceAdapterBase
Parameters:
resourceObjectType - - a type of object that is either well-known or is meaningful to the resource. Every resource is expected to recognize certain values. For example, listAllObjects(ACCOUNT) should return a list of all account names.
options - - a map of options
runAsUser - - (optional) if specified, connect as this user to list all objects of the specified type.
runAsPassword - - (optional) if specified, connect with this password to list all objects of the specified type.
Returns:
a list of all objects of a specified type.
Throws:
WavesetException

login

public void login(HostAccess hostAccess)
           throws java.lang.Exception
Specified by:
login in interface HostAccessLogin
Throws:
java.lang.Exception

login

public void login(HostAccess hostAccess,
                  ServerAffinity affinity)
           throws java.lang.Exception
Specified by:
login in interface HostAccessLogin
Throws:
java.lang.Exception

logoff

public void logoff(HostAccess hostAccess)
            throws java.lang.Exception
Specified by:
logoff in interface HostAccessLogin
Throws:
java.lang.Exception

getHost

public java.lang.String getHost()
                         throws java.lang.Exception
Specified by:
getHost in interface HostAccessLogin
Throws:
java.lang.Exception

getPort

public java.lang.String getPort()
                         throws java.lang.Exception
Specified by:
getPort in interface HostAccessLogin
Throws:
java.lang.Exception

getUser

public java.lang.String getUser()
                         throws java.lang.Exception
Specified by:
getUser in interface HostAccessLogin
Throws:
java.lang.Exception

getAffinityList

public java.util.List getAffinityList()
                               throws java.lang.Exception
Specified by:
getAffinityList in interface HostAccessLogin
Throws:
java.lang.Exception

getKey

public java.lang.String getKey()
                        throws java.lang.Exception
Specified by:
getKey in interface HostAccessLogin
Throws:
java.lang.Exception

getRequestTimeout

public int getRequestTimeout()
                      throws java.lang.Exception
Specified by:
getRequestTimeout in interface HostAccessLogin
Throws:
java.lang.Exception

getIdleTimeout

public int getIdleTimeout()
                   throws java.lang.Exception
Specified by:
getIdleTimeout in interface HostAccessLogin
Throws:
java.lang.Exception

getProperties

public java.util.Properties getProperties()
Specified by:
getProperties in interface HostAccessLogin

getMaxConnections

public int getMaxConnections()
Specified by:
getMaxConnections in interface HostAccessLogin

getFeatures

public GenericObject getFeatures()
Indicates what functionality the resource adapter supports.

Specified by:
getFeatures in interface ResourceAdapter
Overrides:
getFeatures in class ResourceAdapterBase
Returns:
Features supported by this resource adapter.
See Also:
ResourceAdapter.Features

getHostAccess

protected HostAccess getHostAccess()
Overrides:
getHostAccess in class HostAccessResourceAdapter
Returns:
Returns the hostAccess.

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception
Throws:
java.lang.Exception