======================================= DataStage Windows NT Server DEC format 64bit integer support October 2001 ======================================= These notes contain

important information about the installable GCI routine in XCONV.DLL. Contents ======== Overview of GCI routine Installation of GCI routine Use of GCI routine Example transform

Overview of the GCI routine =========================== The GCI routine provides a fast method of converting a data item supplied in DEC 64bit format to a format which DataStage can recognise. The GCI routine is in the XCONV.DLL file. It is callable from ServerEngine Basic, and hence from a DataStage transform. To use the routine, you first need to install the DLL, then write a DataStage transform to access it. The routine is suitable for NT servers only. Installation of the GCI routine =============================== To install the GCI routine: 1) 2) Ensure no DataStage jobs are running on your NT server, and no DataStage clients are accessing the server. Shut down your DataStage server engine. Do this on the DataStage control panel program by pressing the "Stop All Services" button. You must then exit the DataStage control panel program. On your NT server, find the home directory for your DataStage server engine. On a "standard" new installation, this is "Ascential\DataStage\Engine". On an upgraded system it may be "Ardent\DataStage\Serverengine" Copy the contents of the "gci64bit" directory from the DataStage installation CD to a new directory "gci64bit" in the server engine home directory. In a command prompt window, change to the new "gci64bit" directory in the DataStage server engine directory. Run the batch file gci64ins.bat. This will copy xconv.dll to its final position, and perform a number of NT and server engine

3)

4)

5) 6)

administration functions so that the contents can be used. 7) Restart your DataStage server engine. Do this by pressing the "Start All Services" button on the DataStage control panel.

Use of GCI routine ================== Once the GCI routine is installed, it can be accessed from DataStage Basic under the name of $CONV64. The first parameter to the routine is the DEC-format integer to be translated. The second parameter must contain enough allocated space to hold the answer. See the example below showing a use of $CONV64 in a DataStage transform.

Example transform - Testing the routine ======================================= The following is an example of a simple transform routine to access the DLL. Note that the DataStage Manager supplies the first and last lines as part of the transform definition: FUNCTION Conv64(Arg1) ******************************************************************** * Copyright (c) 2001 Asential Software Inc. - All Rights Reserved. * * This code may be copied on condition that this copyright * * notice is included as is in any code derived from this source. * ******************************************************************** Arg2=SPACES(50) CALL $CONV64(Arg1, Arg2) Ans=Arg2 RETURN(Ans) Note that the called routine expects sufficient storage space in Arg2 to store the resultant numeric string. You can test the routine using the Manager Routine test button. The value 11111111 should give 3544668469065756977. If the routine compiles but will not run, it may be that the GCI routine has not installed. Remember that the GCI installation will not take effect until the DataStage server engine has been stopped and restarted. Check steps 2 and 7 above. If you write your own transform to test the function, remember that sufficient space for the answer must be supplied in $CONV64 parameter 2. If this string is supplied from the DataStage transform test screen, note that spaces in parameter 2 will not be passed through to the routine; you must use printable characters on this form for them to be passed through correctly. ============================================================================ Copyright (c) 1997-2003 Ascential Software Corporation. All rights reserved.

Ascential, DataStage are trademarks of Ascential Software Corporation or its affiliates and may be registered in the United States or other jurisdictions. Other marks are the property of the owners of those marks. This product may contain or utilize third party components subject to the user documentation previously provided by Ascential Software Corporation or contained herein. ============================================================================