gtpc2mgqC/C++ Language Support User's Guide

TO2_createDS-Create a Data Store

This function creates a data store (DS).

Format

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

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

dsname
The pointer to a character string, which is the DS being 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

The normal return is a positive value.

Error Return

An error return is indicated by a zero. When zero is returned, use the TO2_getErrorCode function to determine the specific error code. For more information, see Error Handling.

Programming Considerations

A commit scope will be created for the TO2_createDS request. If the request is successful, the scope will be committed. If an error occurs while processing the TO2_createDS request, the scope will be rolled back.

Examples

The following example creates a data store with the name indicated.

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

  ·
  ·
  ·
if (TO2_createDS(env_ptr,dsname) == TO2_ERROR) { printf("TO2_createDS failed!\n"); process_error(env_ptr); } else { printf("TO2_createDS successful!\n"); }

Related Information

See TPF Application Programming for more information about commit scope.