gtpc2mgpC/C++ Language Support User's Guide

TO2_createDD-Create a Data Definition

This function creates a data definition (DD) and stores it in the data store (DS) dictionary.

Format

#include <c$to2.h>
long  TO2_createDD (      TO2_ENV_PTR     env_ptr,
                    const char            DDname[TO2_MAX_DDNAME],
                    const char            dsname[TO2_MAX_DSNAME],
                    const TO2_OPTION_PTR  optionListPtr);

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

DDname
The pointer to a character string, which is the name that will be assigned to the created data definition. The character string is assumed to be 32 characters in length. The name should be left-justified and padded with blanks (X'40') on the right if it less than 32 characters.

dsname
The pointer to a character string, which is the data store name for which the new DD is being created. The character string must be 8 characters or greater in length, left-justified, and padded with blanks (X'40') on the right.

optionListPtr
The pointer to the option list.

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.

The following error code is common for this function:

TO2_ERROR_LOCATOR_NOT_UNIQUE

Programming Considerations

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

Examples

The following example converts the class name provided into a class index.

#include <c$to2.h>             /* Needed for TO2 API functions */
 
long         err_code;
TO2_ENV_PTR    env_ptr;        /* Pointer to TO2 environment   */
char           DDname[32];
char           dsname[8];
TO2_OPTION_PTR optionListPtr

  ·
  ·
  ·
if (TO2_createDD(env_ptr, DDname, dsname, optionListPtr) == TO2_ERROR) { err_code = TO2_getErrorCode(env_ptr); { printf("TO2_createDD failed!\n"); process_error(env_ptr); } else { printf("TO2_createDD successful!\n"); } }

Related Information