/**************************************************************************** ** (c) Copyright IBM Corp. 2007 All rights reserved. ** ** The following sample of source code ("Sample") is owned by International ** Business Machines Corporation or one of its subsidiaries ("IBM") and is ** copyrighted and licensed, not sold. You may use, copy, modify, and ** distribute the Sample in any form without payment to IBM, for the purpose of ** assisting you in the development of your applications. ** ** The Sample code is provided to you on an "AS IS" basis, without warranty of ** any kind. IBM HEREBY EXPRESSLY DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR ** IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF ** MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do ** not allow for the exclusion or limitation of implied warranties, so the above ** limitations or exclusions may not apply to you. IBM shall not be liable for ** any damages you suffer as a result of using, copying, modifying or ** distributing the Sample, even if IBM has been advised of the possibility of ** such damages. ***************************************************************************** ** ** SOURCE FILE NAME: utilapi.h ** ** SAMPLE: Checks for and prints to the screen SQL warnings and errors ** ** This is the header file for the utilapi.c error-checking utility ** file. The utilapi.c file is compiled and linked in as an object ** module with non-embedded SQL sample programs by the supplied ** makefile and build files. ** ** Macros defined: ** DB2_API_CHECK(MSG_STR) ** EXPECTED_ERR_CHECK(MSG_STR) ** EXPECTED_WARN_CHECK(MSG_STR) ** ** Functions declared: ** SqlInfoPrint - prints to the screen SQL warnings and errors ** CmdLineArgsCheck1 - checks the command line arguments, version 1 ** CmdLineArgsCheck2 - checks the command line arguments, version 2 ** CmdLineArgsCheck3 - checks the command line arguments, version 3 ** CmdLineArgsCheck4 - checks the command line arguments, version 4 ** InstanceAttach - attach to instance ** InstanceDetach - detach from instance ** ***************************************************************************** ** ** For more information on the sample programs, see the README file. ** ** For information on creating SQL procedures and developing C applications, ** see the Developing SQL and External Routines book. ** ** For more information on DB2 APIs, see the Administrative API Reference. ** ** For the latest information on programming, building, and running DB2 ** applications, visit the DB2 application development website: ** http://publib.boulder.ibm.com/infocenter/db2luw/v9r7/index.jsp ****************************************************************************/ #ifndef UTILAPI_H #define UTILAPI_H #ifdef __cplusplus extern "C" { #endif #ifndef max #define max(A, B) ((A) > (B) ? (A) : (B)) #endif #ifndef min #define min(A, B) ((A) > (B) ? (B) : (A)) #endif #define USERID_SZ 128 #define PSWD_SZ 14 #if (defined(DB2NT)) #define PATH_SEP "\\" #else /* UNIX */ #define PATH_SEP "/" #endif /* macro for DB2_API checking */ #define DB2_API_CHECK(MSG_STR) \ SqlInfoPrint(MSG_STR, &sqlca, __LINE__, __FILE__); \ if (sqlca.sqlcode < 0) \ { \ return 1; \ } /* macro for expected error checking and message */ #define EXPECTED_ERR_CHECK(MSG_STR) \ printf("\n-- The following error report is expected! --"); \ SqlInfoPrint(MSG_STR, &sqlca, __LINE__, __FILE__); \ /* macro for expected warning */ #define EXPECTED_WARN_CHECK(MSG_STR) \ printf("\n-- The following warning report is expected! --"); \ SqlInfoPrint(MSG_STR, &sqlca, __LINE__, __FILE__); \ /* functions used in ..._CHECK macros */ void SqlInfoPrint(char *, struct sqlca *, int, char *); /* other functions */ int CmdLineArgsCheck1(int, char * argv[], char *, char *, char *); int CmdLineArgsCheck2(int, char * argv[], char *, char *, char *); int CmdLineArgsCheck3(int, char * argv[], char *, char *, char *, char *); int CmdLineArgsCheck4(int, char * argv[], char *, char *, char *, char *, char *, char *); int InstanceAttach(char * , char *, char *); int InstanceDetach(char *); #ifdef __cplusplus } #endif #endif /* UTILAPI_H */