DBMaker DCI MFCOBOL User's Guide Version: 5.1 Document No: 51/DBME51-T12302010-01-DMFC Author: DBMaster Support & production Team, Research & Development Division, SYSCOM Computer Engineering CO. Print Date: Nov 1 2011 Introduction Table of Content 1 Introduction ........................................................................................4 1.1 Additional Resources..................................................................................... 5 1.2 Technical Support .......................................................................................... 5 1.3 Document Conventions.................................................................................. 6 2 DCI for MFCOBOL ..............................................................................7 2.1 DCI for MFCOBOL Overview......................................................................... 7 File System and Databases......................................................................................................... 7 Relation Chart .............................................................................................................................. 8 System Requirements.................................................................................................................. 8 2.2 Setup Instructions .......................................................................................... 9 Install Net Express 5.1 ............................................................................................................... 9 Install DBMaster 5.1................................................................................................................... 9 Obtain the DBMaster libraries for MFCOBOL..................................................................... 9 Obtain the oldnames.lib from Visual Studio........................................................................... 9 SET CALLFH "DBMAKERINTF"........................................................................................ 9 Building and Running program with IDE............................................................................... 9 Building and Running program with Command Line ......................................................... 10 2.3 Basic Configuration for DCI ..........................................................................11 DCI_DATABASE..................................................................................................................... 11 DCI_LOGIN............................................................................................................................. 11 DCI_PASSWD .......................................................................................................................... 11 2.4 Generate XFD files ...................................................................................... 12 Generate XFD files with configure Option .......................................................................... 12 3 Compiler and Runtime Options ......................................................13 3.1 Using DCI for MFCOBOL Systems .............................................................. 13 3.2 Using the MFCOBOL Default System.......................................................... 13 3.3 Using Views ................................................................................................. 14 3.4 Using DCI_SET_WHERE ............................................................................ 14 4 Configuration File Variables............................................................15 4.1 Setting DCI_CONFIG Variables................................................................... 15 DCI_CASE ................................................................................................................................15 DCI_COMMIT_COUNT....................................................................................................... 16 DCI_DATABASE..................................................................................................................... 16 DCI_DEFAULT_TABLESPACE.......................................................................................... 17 DCI_DISCONNECT .............................................................................................................. 17 DCI_GETENV......................................................................................................................... 17 DCI_LOGFILE........................................................................................................................ 17 DBMaster DCI MFCOBOL User’s Guide 1 Introduction DCI_LOGIN............................................................................................................................. 18 DCI_LOGTRACE ................................................................................................................... 18 DCI_MAPPING....................................................................................................................... 18 DCI_MAX_ATTRS_PER_TABLE....................................................................................... 19 DCI_MAX_BUFFER_LENGTH ......................................................................................... 19 DCI_PASSWD .......................................................................................................................... 20 DCI_STANDARD_FILE ....................................................................................................... 20 DCI_SETENV.......................................................................................................................... 21 DCI_SET_WHERE................................................................................................................. 21 DCI_TABLESPACE ................................................................................................................ 22 DCI_USEDIR_LEVEL........................................................................................................... 22 DCI_USER_PATH................................................................................................................... 23 DCI_VARCHAR....................................................................................................................... 23 DCI_XFDPATH....................................................................................................................... 23 4.2 DCI_SET_TABLE_CACHE Variables .......................................................... 23 4.3 Mapping to Multiple Databases.................................................................... 25 5 MFCobol Application with DCI........................................................27 5.1 DLL .............................................................................................................. 27 5.2 EXE.............................................................................................................. 27 5.3 GNT ............................................................................................................. 27 Use DCI Indirectly.................................................................................................................... 27 Use DCI Directly....................................................................................................................... 29 6 How to build DBMASTERINTF.DLL.................................................30 6.1 DBMASTERINTF and DBMASTERINTF.dll .......................................... 30 Usage of DBMASTERINTF.................................................................................................. 30 Usage of DBMASTERINTF.dll ............................................................................................. 30 6.2 Build Steps ................................................................................................. 31 Environment preparing ............................................................................................................ 31 Related file preparing ................................................................................................................ 31 The bulid dll command ............................................................................................................ 32 Reference DBMASTERINTF.dll in program....................................................................... 32 7 Additions of DCI ...............................................................................33 7.1 Addition DCI Feature ................................................................................... 33 7.2 Addition DCI Functions ................................................................................ 33 DCI_SETENV.......................................................................................................................... 34 DCI_GETENV......................................................................................................................... 34 DCI_DISCONNECT .............................................................................................................. 34 DCI_SET_TABLE_CACHE.................................................................................................. 35 8 COBOL Conversions .......................................................................36 8.1 Mapping COBOL Data Types....................................................................... 36 8.2 Mapping DBMaster Data Types ..................................................................