db2ACS_QueryInput and db2ACS_QueryOutput Db2 Advanced Copy Services (ACS) API data structures

db2ACS_QueryInput contains identifying information for an object about which you are querying. db2ACS_QueryOutput contains query result information about snapshot backup objects.


/* ==========================================================================
 * Unique Querying.
 *
 * When using this structure as query input, to indicate the
 * intention to supply a 'wildcard' search criteria, Db2 will supply:
 *
 *    -- character strings as "*".
 *    -- numeric values as (-1), cast as the appropriate signed or unsigned
 *       type.
 * ========================================================================== */

typedef struct db2ACS_ObjectInfo db2ACS_QueryInput;

typedef struct db2ACS_QueryOutput
{
   db2ACS_ObjectID            objectID;
   db2ACS_ObjectInfo          object;
   db2ACS_PostObjectInfo      postInfo;
   db2ACS_DB2ID               db2ID;
   db2ACS_ObjectStatus        status;

   /* Size of the object in bytes.
    * ----------------------------------------------------------------------  */
   db2Uint64                  objectSize;

   /* Size of the metadata associated with the object, if any, in bytes.
    * ----------------------------------------------------------------------  */
   db2Uint64                  metaDataSize;

   /* The creation time of the object is a 64bit value with a definition
    * equivalent to an ANSI C time_t value (seconds since the epoch, GMT).
    *
    * This field is equivalent to the file creation or modification time in
    * a traditional filesystem.  This should be created and stored
    * automatically by the BA subsystem, and a valid time value should be
    * returned with object query results, for all object types.
    * ----------------------------------------------------------------------  */
   db2Uint64                  createTime;
} db2ACS_QueryOutput;

objectID: Data type: db2ACS_ObjectID.
A db2ACS_ObjectID is a unique identifier for each stored object, which is returned by a query to the storage repository. A db2ACS_ObjectID is guaranteed to be unique and persistent only within the timeframe of a single Db2 ACS session.
object: Data type: db2ACS_ObjectInfo
db2ACS_ObjectInfo contains information about object created using the Db2 Advanced Copy Services (ACS) API.
postInfo: Data type: db2ACS_PostObjectInfo.
db2ACS_DB2ID is a set of data that can not be known at snapshot backup object creation time, but which must be maintained in the object repository.
db2ID: Data type: db2ACS_DB2ID.
db2ACS_DB2ID identifies the IBM® Data Server.
status: Data type: db2ACS_ObjectStatus.
db2ACS_ObjectStatus contains information about the status or progress of a snapshot backup operation, or the status or usability of a snapshot backup object.
objectSize: Data type: db2Uint64.
Size of the object in bytes.
metaDataSize: Data type: db2Uint64.
Size of the metadata associated with the object, if any, in bytes.
createTime: Data type: db2Uint64.
The creation time of an object. The value of createTime is equivalent to an ANSI C time_t value.