Purpose:
This is the class that is used to represent a datastore for OnDemand.
Methods:
connect(LPCTSTR datastoreName, LPCTSTR userName, LPCTSTR authentication, VARIANT connectString);
Connects to a datastore.
Parameters:
LPDISPATCH createQuery(LPCTSTR command, short commandLangType [,VARIANT paramList]);
Creates a query object using a command. The parameter list is in the form of an array of DXNVPairOD objects. The returned LPDISPATCH pointer contains a DXParametricQueryOD object.
LPDISPATCH datastoreDef();
Gets the datastore def. The returned LPDISPATCH pointer contains a DXDatastoreDefOD object.
BSTR datastoreName();
BSTR datastoreType();
disconnect()
VARIANT evaluate(LPCTSTR command, short commandLangType [,VARIANT paramList]);
Evaluate a query using a command. The parameter list is in the form of an array of DXNVPairOD objects. The value of the returned VARIANT is a DXResultsOD object.
VARIANT evaluateQuery(LPDISPATCH query);
Evaluate a query using a query object. The value of the returned VARIANT is a DXResultsOD object. The input parameter LPDISPATCH pointer contains a DXParametricQueryOD object.
LPDISPATCH execute(LPCTSTR command, short commandLangType [,VARIANT paramList]);
Execute a query using a command. The parameter list is in the form of an array of DXNVPairOD objects. The returned LPDISPATCH pointer contains a DXResultSetCursorOD object.
LPDISPATCH executeQuery(LPDISPATCH query);
Execute a query using a query object. The input parameter LPDISPATCH pointer contains a DXParametricQueryOD object. The returned LPDISPATCH pointer contains a DXResultSetCursorOD object.
getOption(long option, VARIANT* value);
Gets the value for the specified datastore option. Valid options for OnDemand are:
initConfiguration(LPCTSTR configuration);
Initializes the datastore with the specified configuration string. The configuration string supplies the specific initialization parameters. Valid parameters include:
BOOL isConnected();
VARIANT listDataSourceNames(long* arraySize);
Gets a list of server names. The output parameter arraySize is the size of the array. For OnDemand, this will always be an empty list.
LPDISPATCH listDataSources();
Gets a list of servers. The returned LPDISPATCH pointer contains a DXSequentialCollectionOD object.
LPDISPATCH listEntities();
Gets a list of entities. The returned LPDISPATCH pointer contains a DXSequentialCollectionOD object.
VARIANT listEntityAttrNames(LPCTSTR entityName, long* arraySize);
Gets a list of entity attribute names. The output parameter arraySize is the size of the array.
LPDISPATCH listEntityAttrs(LPCTSTR entityName);
Gets a list of entity attributes. The returned LPDISPATCH pointer contains a DXSequentialCollectionOD object.
VARIANT listEntityNames(long* arraySize);
Gets a list of entity names. The output parameter arraySize is the size of the array.
retrieveObject(LPDISPATCH ddobase);
Retrieve the data object from the persistent datastore into memory. The input parameter LPDISPATCH pointer contains a DXDDOOD object.
setOption(long option, VARIANT value);
Sets the value for the specified option. See getOption for the list of options for Image Plus for OS/390.
BSTR userName();
Returns the user name that was used to connect to the datastore.
(c) Copyright International Business Machines Corporation 1996, 2002. IBM Corp. All rights reserved.