Differences

This shows you the differences between two versions of the page.

Link to this comparison view

sqlways:command-line:sqlways-ini:common-section [November 09, 2018, 03:24:53 PM] alexandr.kirpichnysqlways:command-line:sqlways-ini:common-section [May 31, 2023, 05:28:08 PM] (current) – external edit 127.0.0.1
Line 1: Line 1:
 \\ \\
-[[http://www.ispirer.com|Ispirer Home Page]] +[[https://www.ispirer.com|Ispirer Website]] 
-[[http://www.ispirer.com/products|Ispirer SQLWays Product Page]] +[[https://www.ispirer.com/products/migration-toolkit|Ispirer Toolkit Overview]] 
-[[http://www.ispirer.com/?click=RequestSQLWays&from=IspirerWIKI|Request SQLWays]]+[[https://www.ispirer.com/download/download-demo|Free Trial]]
 ====== Sqlways.ini File - Section [COMMON] ====== ====== Sqlways.ini File - Section [COMMON] ======
  
-This article describes sqlways.ini file [COMMON] section and the options it contains. +This article describes sqlways.ini file’s [COMMON] section and the options it contains. 
 ^  Option name  ^ Description  ^  Option name  ^ Description 
-| **DSN** | Data source name | +| **DSN** | Data source name
-| **USER** | User name | +| **USER** | User name
-| **PWD** | Password | +| **PWD** | Password
-| **TARGET** | Target database | +| **TARGET** | Target database
-| **TARGET_PRODUCT** | Target database product | +| **TARGET_PRODUCT** | Target database product
-| **TARGET_VERSION** | Target database version | +| **TARGET_VERSION** | Target database version
-| **IMPORT_ORDER** | Migration sequence. The default value is Clean. |+| **IMPORT_ORDER** | Migration sequence. The default value is Clean. |
 | **IMPORT_SYSTEM** | Import system. The default value is Windows. | | **IMPORT_SYSTEM** | Import system. The default value is Windows. |
-| **DIR** | Export directory | +| **DIR** | Export directory
-| **LOBDIR** | Directory for LOB files. By default Ispirer SQLWays Wizard will store LOB files in the Export directory. | +| **LOBDIR** | Directory for LOB files. By defaultIspirer SQLWays Wizard will store LOB files in the Export directory. | 
-| **IMPORT_DIR** | Import directory | +| **IMPORT_DIR** | Import directory
-| **IMPORT_LOBDIR** | Import directory for LOB files | +| **IMPORT_LOBDIR** | Import directory for LOB files
-| **OUTFORMAT** | Output text format |+| **OUTFORMAT** | Output text format|
 | **PREFETCHROWS** | Prefetch count. The default value is 1000. | | **PREFETCHROWS** | Prefetch count. The default value is 1000. |
-| **NONSTOP** | Continue when an error occurs. The default value is Yes.  | +| **NONSTOP** | Continue when an error occurs. The default value is Yes.  | 
-| **REGISTRATION_NAME** | Specifies the registration name \\ \\ This option can be used for custom SQLWays fixes or in case if access \\ to the registry to read license information is restricted |  +| **REGISTRATION_NAME** | Specifies the registration name\\ \\ This option can be used for custom tool fixes or when access to the registry to read license information is restricted|  
-| **REGISTRATION_NUMBER** | Specifies the registration number  \\ \\ Use this option if access to the registry to read license information is restricted |  +| **REGISTRATION_NUMBER** | Specifies the registration number \\ \\ Use this option if access to the registry to read license information is restricted|  
-| **TEST** | This option controls whether to generate testing scripts for destination database. More information about how to use this option can be found in this article: [[https://wiki.ispirer.com/sqlways/users-guide/test-features|How to Test Converted SQL Code]]\\ Possible values Yes, No or Empty. \\ Default value No or Empty. |  +| **TEST** | This option controls whether to generate testing scripts for destination database. More information about how to use this option can be found in this article: [[https://wiki.ispirer.com/sqlways/users-guide/test-features|How to Test Converted SQL Code]]\\ Possible values – “YesNo” or Empty. \\ Default value – “No” or Empty. |  
-| **MAX_NUMBER_OF_TEST_CALLS** | Controls the number of calling statements for option **TEST**. The default is 10 |  +| **MAX_NUMBER_OF_TEST_CALLS** | Controls the number of calling statements for option **TEST**. The default value is 10|  
-| **GENRPT** | Option that controls whether to generate the HTML report or not. The default value is Yes. Possible values Yes, No.|  +| **GENRPT** | Option that controls whether to generate the HTML report or not. The default value is Yes. Possible values – “YesNo.|  
-| **CONVERT_VIEW2TABLE** | Option that controls whether to convert all selected views to tables or not. The data for the tables is extracted from the source database using the select provided in a view. The default value is No. Possible values Yes, No.| +| **CONVERT_VIEW2TABLE** | Option that controls whether to convert all selected views to tables or not. The data for the tables will be extracted from the source database using the select provided in a view. The default value is No. Possible values – “YesNo.| 
-| **FN_WITH_EXC2SP** | Whenever there is EXEPTION block with WHEN OTHERS inside the function it converts to procedure with TRY CATCH block. The default value is No or Empty. Possible values Yes, No.|   +| **FN_WITH_EXC2SP** | Whenever there is EXEPTION block with WHEN OTHERS inside the function it will be converted to procedure with TRY CATCH block. The default value is No” or Empty. Possible values – “YesNo.|   
-| **OPTION_VARYING_PARSING** | Option that controls the way the delimited identifiers from Informix are parsed.  \\ \\ As the default in Informix double quotes represent the string literal. This behavior can be changed by using the DELIMIDENT option. If DELIMIDENT option is set to ON, one can use double quotes to represent the delimited identifiers in Informix database. So, if the BL objectlike Stored Procedure or UDF is created with this option and uses delimited identifiers inside, even if the option is OFF, the BL still will be working correctly.  \\ \\ SQLWays tries to parse double quotes as the string literal first, using the OPTION_VARYING_PARSING option. If the parser error arises, the source code is parsed as if the DELIMIDENT is set to ON - like a delimited identifier. \\ \\  Possible values Yes, No.| +| **OPTION_VARYING_PARSING** | Option that controls the way the delimited identifiers from Informix are parsed.  \\ \\ By default double quotes in Informix represent the string literal. This behavior can be changed by using the DELIMIDENT option. If DELIMIDENT option is set to ON, one can use double quotes to represent the delimited identifiers in Informix database. So, if the BL object like Stored Procedure or UDF is created with this option and uses delimited identifiers inside, even if the option is OFF, the BL still will be working correctly.  \\ \\ The tool tries to parse double quotes as the string literal first, using the OPTION_VARYING_PARSING option. If the parser error arises, the source code is parsed as if the DELIMIDENT is set to ON - like a delimited identifier. \\ \\  Possible values – “YesNo.| 
-| **CONVERT_VIEW2TABLE** | When this option is set to "yes" all views selected for convertion are converted to tables. Data for such tables is retrieved using select statements of these views. The default value is No. Possible values Yes, No.| +| **CONVERT_VIEW2TABLE** | When this option is set to "Yes" all views selected for conversion are converted to tables. Data for such tables is retrieved using select statements of these views. The default value is No. Possible values – “YesNo.| 
-| **USE_ODBC_FUNCTIONS** | When this option is set to "yes" only ODBC functions are used to extract data from source database. The default value is No. Possible values Yes, No.| +| **USE_ODBC_FUNCTIONS** | When this option is set to "Yes"only ODBC functions will be used to extract data from the source database. The default value is No. Possible values – “YesNo.| 
-| **PRECACHE_OBJECTS** | This option increases performance of SQLWays on working with large database. When you need to convert a number of tables that is greater than defined in PRECACHE_TABLES_COUNT option optimization is turned on. The default value is "True". Possible values True, False.| +| **PRECACHE_OBJECTS** | This option increases productivity of the tool when working with large databases. When you need to convert a number of tables that is greater than the number defined in PRECACHE_TABLES_COUNT optionoptimization is turned on. The default value is "True". Possible values – “TrueFalse.| 
-| **PRECACHE_TABLES_COUNT** | This option defines the minimum number of tables, which will be precached if PRECACHE_OBJECTS is set to True. The default value is 100.| +| **PRECACHE_TABLES_COUNT** | This option defines the minimum number of tables, which will be precached if PRECACHE_OBJECTS is set to True. The default value is 100.| 
-| **SUB_QUERY2VIEW** | Option that controls whether to convert the sub-queries from WITH Clause  into Views or no. The views in this case are created before the whole query and sub-query aliases are left the same as in the source. The conversion works when the option is set to Yes. The default value is No.| +| **SUB_QUERY2VIEW** | Option that controls whether to convert the sub-queries from WITH Clause into Views or not. The views in this case are created before the whole query and sub-query aliases are left the same as in the source. The conversion works when the option is set to Yes. The default value is No.| 
-| **USE_ANSI_CAST** | When this option is set to "yes" only ANSI SQL scalar function CAST is used to convert values from one datatype to another. The default value is No. Possible values Yes, No.\\ Supported directions:\\ Sybase ASA to PostgreSQL | +| **USE_ANSI_CAST** | When this option is set to "Yes"only ANSI SQL scalar function CAST is used to convert values from one datatype to another. The default value is No. Possible values – “YesNo.\\ Supported directions: \\ Sybase ASA to PostgreSQL | 
-| **REPLICATION_CONVERT** | When this option is set to "yesSQLWays, instead of the migration, performs the generation of the Triggers and additional tables for the [[:sqlways/replicator-users-guide/sqlways|SQLWays Replication Utility]]. The default value is No. Possible values Yes, No. | +| **REPLICATION_CONVERT** | When this option is set to "Yes" the tool performs generation of Triggers and additional tables for the [[:sqlways/replicator-users-guide/sqlways|SQLWays Replication Utility]] instead of migration. The default value is No. Possible values – “YesNo. | 
-| **LOGICAL_FILES_PATH** | To migrate Logical Files from DB2 AS400, should be provided a path to the files that will store LF definition. SQLWays Wizard will be able to readanalyze such description and convert it to the view in target database. This option should be set only if you are migrating from DB2 AS400 and need to convert Logical Files. | +| **LOGICAL_FILES_PATH** | To migrate Logical Files from DB2 AS400 you need to provide the path to the files that will store LF definition. SQLWays Wizard will be able to read and analyze such description and convert it to the view in the target database. This option should be set only if you are migrating from DB2 AS400 and need to convert Logical Files. | 
-| **SOURCE_DB** | Option that defines source database for embedded sql conversion. | +| **SOURCE_DB** | Option that defines source database for Embedded SQL conversion. | 
-| **TARGET_DB** | Option that defines target database for embedded sql conversion. | +| **TARGET_DB** | Option that defines target database for Embedded SQL conversion. | 
-| **API_SOURCE_DB** | Option that defines database API for source database for embedded sql conversion. | +| **API_SOURCE_DB** | Option that defines database API for source database for Embedded SQL conversion. | 
-| **API_TARGET_DB** | Option that defines database API for target database for embedded sql conversion. | +| **API_TARGET_DB** | Option that defines database API for target database for Embedded SQL conversion. | 
-| **API_SOURCE_DB_VERSION** | Option that defines version of database API for source database for embedded sql conversion. | +| **API_SOURCE_DB_VERSION** | Option that defines version of database API for source database for Embedded SQL conversion. | 
-| **API_TARGET_DB_VERSION** | Option that defines version of database API for target database for embedded sql conversion. | +| **API_TARGET_DB_VERSION** | Option that defines version of database API for target database for Embedded SQL conversion. | 
-| **PLACE_COMMENTED_SOURCE_END** | This option controls where the commented source code of the object will be located in generated the sql file. If this options is set to "Yes", the commented source code will be placeв at the end of the file. If this option is set to "No", the commented source code will be placed at the beginning of the sql file. \\  Possible values - "Yes", "No" or Empty.  \\ Default value - "No".| +| **PLACE_COMMENTED_SOURCE_END** | This option controls where the commented source code of the object will be located in the generated SQL file. If this options is set to "Yes", the commented source code will be placed at the end of the file. If this option is set to "No", the commented source code will be placed at the beginning of the SQL file. \\  Possible values - "Yes", "No" or Empty.  \\ Default value - "No".| 
-| **LICENSE_INFO** | This option generates the information about the date and time of conversion, version and license owner inside the converted sql code. \\ Possible values - "Yes", "No" or Empty. \\ Default value - "Noor Empty. | +| **LICENSE_INFO** | This option generates the information about the date and time of conversion, version and license owner inside the converted SQL code. \\ Possible values - "Yes", "No" or Empty. \\ Default value - "Yes". | 
-| **GENERATE_VERSION_TIMESTAMP** | This option generates the information about the datetime of conversion and version of the tool in the sql code. \\ Possible values - "Yes", "No" or Empty. \\ Default value - "No" or Empty. | +| **GENERATE_VERSION_TIMESTAMP** | This option generates the information about the datetime of conversion and version of the tool in the SQL code. \\ Possible values - "Yes", "No" or Empty. \\ Default value - "No" or Empty. | 
-| **FB_DIALECT** | This option defines the dialect number that will be used to connect to the FIREBIRD database. | +| **FB_DIALECT** | This option defines the dialect number that will be used to connect to FIREBIRD database. | 
-| **CACHE_OBJECTS_COUNT** | This option defines the number of objects that should be specified for conversion to launch the cache system for objects. If number of specified object is bigger than the number provided in the option, then cache system will be launched. If number of objects is less, then will be used common conversion.  |+| **CACHE_OBJECTS_COUNT** | This option defines the number of objects that should be specified for conversion to launch the cache system for objects. If number of specified object is bigger than the number provided in the option, cache system will be launched. If number of objects is less, common conversion will be used.  |
 | **PARSE_DIRECTIVES** | This option defines whether the toolkit should parse the directives in the C++ code. \\ Possible values - "Yes", "No" or Empty. \\ Default value - "Yes" | | **PARSE_DIRECTIVES** | This option defines whether the toolkit should parse the directives in the C++ code. \\ Possible values - "Yes", "No" or Empty. \\ Default value - "Yes" |
-| **REMOVE_SRC_FORMATTING** | This option removes source code formating, by removing extra separators for COBOL -> JAVA direction. \\ Possible values - "Yes", "No" or Empty. \\ Default value - "No" or Empty. +| **REMOVE_SRC_FORMATTING** | This option removes source code formatting by removing extra separators for COBOL to JAVA direction. \\ Possible values - "Yes", "No" or Empty. \\ Default value - "No" or Empty. 
-| **DETAIL_REPORT** | If this option is set to "Yes", detail report with the information about the converted objects will be generated and placed in the export directory in "Reports" folder.  \\ Possible values - "Yes", "No" or Empty. \\ Default value - "No" or Empty. +| **DETAIL_REPORT** | If this option is set to "Yes", detail report with the information about the converted objects will be generated and placed to the export directory in "Reports" folder.  \\ Possible values - "Yes", "No" or Empty. \\ Default value - "No" or Empty. 
-| **USE_SP_PRIMARYKEY** | By default our tool shouldn't extract the primary keys from Sybase ASE database, that were defined using the "sp_primarykey" system procedure. But if we set this option to "Yes", SQLWays will convert primary key defined with "sp_primarykey" system procedure also. \\ Possible values - "Yes", "No" or Empty. \\ Default value - "No" or Empty. +| **USE_SP_PRIMARYKEY** | By default our tool shouldn't extract primary keys that were defined using the "sp_primarykey" system procedure in Sybase ASE database. But if we set this option to "Yes", the tool will also convert the primary key defined with "sp_primarykey" system procedure. \\ Possible values - "Yes", "No" or Empty. \\ Default value - "No" or Empty. 
-| **OMIT_ORACLE_HINTS** | Since Oracle hints are specific only for Oracle database, by default these peaces of code are commented. If OMIT_ORACLE_HINTS option is set to "Yes", all Oracle hints will be omitted during the conversion.\\ Possible values - "Yes", "No" or Empty. \\ Default value - "No" or Empty. +| **OMIT_ORACLE_HINTS** | Since Oracle hints are specific only for Oracle database, by default these pieces of code are commented. If OMIT_ORACLE_HINTS option is set to "Yes", all Oracle hints will be omitted during the conversion.\\ Possible values - "Yes", "No" or Empty. \\ Default value - "No" or Empty. 
 +| **SHORTCUT_JOINS** | This option defines whether the OUTER keyword should be removed from Joins. If this option is set to "Yes", then OUTER will be removed. \\ Possible values - "Yes", "No" or Empty. \\ Default value - "No" or Empty. | 
 +| **EMBEDDED_SQL_CONVERSION_OFF** | This option switch off conversion of embedded statements that contains keywords specified in this option. User can specify multiple keywords using comma "," as a separator. \\ Default value -  Empty. |
  
 **Example**: **Example**:
Line 64: Line 65:
 \\ \\
  
-If you will have any questions on the supported options or some features that you may need during your migration project, please contact our technical team: **__[[[email protected]]]__**+If you have any questions about the supported options and features, please contact our technical team: **__[[[email protected]]]__** 
  
  
-\\ 
-[[http://www.ispirer.com|Ispirer Home Page]] 
-[[http://www.ispirer.com/products|Ispirer SQLWays Product Page]] 
-[[http://www.ispirer.com/?click=RequestSQLWays&from=IspirerWIKI|Request SQLWays]] 

© 1999-2024, Ispirer Systems, LLC. All Rights Reserved.