Executes the HCOSS Transfer Data tool from the command line.
Syntax:
{MFDataTransferCtlr16 | MFDataTransferCtlr17 | MFDataTransferCtlr19}
DB2=DB2dsn;
[U1=DB2userID;]
[P1=DB2Password;]
SRV=SQLServerDSN;
[U2=SQLServerUserID;]
[P2=SQLServerPassword;]
X=["]DataTransferList["];
[XLocal={TRUE | FALSE};]
[TRIG={TRUE | FALSE};]
[CONSTR={TRUE | FALSE};]
[ErrROW={TRUE | FALSE};]
[TYPELOG={CONSOLE | FILE | BOTH};]
[CQUERY="SELECT projectionList FROM tableName [searchCondition][optionalClauses]";]
[ADJBUF={TRUE | FALSE};]
[BUFROWS=n;]
[CSIZE=n;]
Parameters:
- MFDataTransferCtlr16
- The name of the command for SQL Server 2016.
- MFDataTransferCtlr17
- The name of the command for SQL Server 2017.
- MFDataTransferCtlr19
- The name of the command for SQL Server 2019.
- DB2
- The name of a cataloged and registered DB2 data source.
- U1
- The user ID required to access the DB2 data source specified by the
DB2 parameter, if applicable.
- P1
- The password required for the user ID specified by the
U1 parameter, if applicable.
- SRV
- The name of a cataloged and registered SQL Server data source.
- U2
- The user ID required to access the SQL Server data source specified by the
SRV parameter. Not required when using Windows authentication.
- P2
- The password required for the user ID specified by the
U2 parameter, if applicable.
- X
- The name of a transfer data task file containing a list of tables to be transferred and the queries required to transfer the
data. Do not specify a file extension. The file extension for a transfer data task file is
.hcodtt. If the transfer data task file name contains spaces, surround it with a set of double quotes ("). You can create a transfer
data task file using the UI version of the HCOSS Transfer Data tool, or you can create one manually in a text editor. If you
create a transfer data task file using the UI version of the tool, its location is determined by the selection of either the
Local or
Shared button for the transfer data task. If you create a data transfer task file manually, you must store it in the
\DataTasks subdirectory of either the directory specified by the
Local HCOSS Directory HCOSS option or the
Shared HCOSS Directory HCOSS option.
- XLocal
- Determines the location of the transfer data task file. Transfer data task files are stored in the
\DataTasks subdirectory of either of the following, depending on the value specified:
TRUE
|
Directory specified by the
Local HCOSS Directory HCOSS option. Default.
|
FALSE
|
Directory specified by the
Shared HCOSS Directory HCOSS option.
|
- TRIG
- Specifies whether or not to fire all triggers during the data transfer. Default is FALSE.
- CONSTR
- Specifies whether or not SQL Server performs all defined checks during the data transfer. Default is FALSE.
- ErrROW
- Specifies whether or not HCOSS logs errors encountered during the data transfer. Default is FALSE.
- TYPELOG
- Sets the type of logging to perform. Defaults to the equivalent of the value specified for the
Type of logging to do HCOSS option.
- CQUERY
- Specifies a customized SELECT statement that retrieves data from the source table in which the projection list, optional search
condition, and optional clauses can be tailored.
Note: When an expression replaces a column entry in the projection list, the column name has to be maintained by using the same
name as the alias. For example,
cast(Col1 as binary(8)) as
Col1.
- ADJBUF
- Specifies the
AutoAdjustBufferSize property of the DATAFLOW of the SSIS package. Default is
FALSE.
- BUFROWS
- An integer that specifies a value for the
DefaultBufferMaxRows property of the DATAFLOW of the SSIS package. Default is 1000.
- CSIZE
- An integer that specifies a value for the
FastLoadMaxInsertCommitSize custom property of the OLE DB Destination of the SSIS package. Default is 1000.
Comments:
Before running this tool, be sure that the appropriate target tables exist in the SQL Server database.
Examples:
MFDataTransferCtlr DB2=MVS91; SRV=HCODemo; X=LocalTransferList
MFDataTransferCtlr DB2=MVS91; SRV=HCODemo; X=SharedTransferList; XLocal=FALSE