gtpc2mi0C/C++ Language Support User's Guide

TO2_recreateDS-Re-create a Data Store

This function re-creates a data store in an initialized state.

Format

#include <c$to2.h>
long TO2_recreateDS (TO2_PID_PTR pid_ptr,
                     TO2_ENV_PTR env_ptr,
                     const char  dsname[TO2_MAX_DSNAME]);

pid_ptr
A pointer to the field that holds the returned persistent identifier (PID) assigned to the temporary sequence collection that contains a list of the PIDs of the system collections before this function was called.

env_ptr
A pointer to the environment as returned by the TO2_createEnv function.

dsname
A pointer to a character string, which represents the data store being re-created. The character string must be 8 characters or less in length, left-justified, and padded with blanks (X'40') on the right.

Normal Return

A positive value. The sequence collection referred to by pid_ptr contains one element per system collection. The format of the data area of the element is as follows:

 struct TO2_dsCollection_element
{
    TO2_PID collectionPID[TO2_MAX_PID_SIZE];
};

Error Return

A value of zero. Use the TO2_getErrorCode function to determine the specific error code. For more information, see Error Handling.

Programming Considerations

Examples

The following example re-creates data store TESTX.DS.

#include <c$to2.h>             /* Needed for TO2 API functions    */
#include <stdio.h>             /* APIs for standard I/O functions */
 
TO2_PID       pid;             /* Holder for temp sequence collect */
TO2_ENV_PTR   env_ptr;         /* Pointer to TO2 environment      */
char          dsname[TO2_MAX_DSNAME]="TESTX.DS";

  ·
  ·
  ·
if (TO2_recreateDS(&pid, env_ptr, dsname) == TO2_ERROR) { printf("TO2_recreateDS failed! \n"); process_error(env_ptr); } else { printf("TO2_recreateDS successful! \n"); } /* Process the elements in the returned sequence collection */

Related Information

See TPF Application Programming for more information about commit scope. See TPF Database Reference for more information about data stores.