PC Installation Guide

Informatica SSA-NAME3
(Version 9.0.1 SP3 )
 1998–2011,
c Informatica Corporation. All rights reserved. All logos, brand and product names are or may be
trademarks of their respective owners.

THIS MANUAL CONTAINS CONFIDENTIAL INFORMATION AND IS THE SUBJECT OF COPYRIGHT, AND
ITS ONLY PERMITTED USE IS GOVERNED BY THE TERMS OF AN AGREEMENT WITH INFORMATICA
CORPORATION, OR ITS SUBLICENSORS. ANY USE THAT DEPARTS FROM THOSE TERMS, OR BREACHES
CONFIDENTIALITY OR COPYRIGHT MAY EXPOSE THE USER TO LEGAL LIABILITY.

Created on Tuesday 10th May, 2011.

Contents
Table of Contents 3

Introduction 4

Installation 6
Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Install SSA-NAME3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Install SSA-NAME3 Extensions for 1.8 Users . . . . . . . . . . . . . . . . . . . . . . . . . 6
Testing the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Transferring the Service Group Data File to the Target . . . . . . . . . . . . . . . . . . . . 8
On MS Windows, Create the DLL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

3 CONTENTS
Introduction
Installers should follow the G ETTING S TARTED manual in conjunction with this installation
documentation.

Even though the applications which will use SSA-NAME3 Extensions for 1.8 Users might be being
developed for execution on another platform, installation of the SSA-NAME3 Extensions for 1.8 Users
Customization and Development environments to a PC is always required. This is necessary for the
customization and generation of the SSA-NAME3 Extensions for 1.8 Users Definition Files. The only
exception to this is for MVS users, who can opt to perform customization and generation on MVS and
therefore install all components directly to the MVS system.

Installation of the SSA-NAME3 Extensions for 1.8 Users Development Environment to the target plat-
form, if it is not the PC, is also required, and this is covered by a separate Installation manual.

Installers should perform the target platform installation of SSA-NAME3 Extensions for 1.8
Users before this PC installation is started.

This manual describes the following PC installation steps:

1. Installation of the SSA-NAME3 Extensions for 1.8 Users PC Customization and Development envi-
ronments from a CD to a PC;
2. Testing the PC installation, by generating and testing the Fast-start country definition files;
3. Transfer of the Service Group Data File to the target platform where it will be used to test the instal-
lation of the target SSA-NAME3 Extensions for 1.8 Users environment.

For information on the specifications and pre-requisites for the PC environment, refer to the G ETTING
S TARTED manual.

The installation of the PC software uses a Visual Installation software package which most users would
be familiar with. Installation is from a CD.

The installation testing process and preparation of the generated Service Group Data File (ysg file)
is done using either the Visual Workshop, a suite of visual tools, or at a lower level, in a Command
window.

Physical transfer of the Service Group Data File from the PC to the target is achieved using whatever
appropriate file transfer software is available to the installer (e.g. FTP).

The end product of the installation and testing process is:

a Service Group Data File containing ’Fast-start’ rules generated from the chosen country’s fast-start
Definition files.
 an SSA-NAME3 Extensions for 1.8 Users PC application, called the Test-bed, is provided so that SSA-
NAME3 Extensions for 1.8 Users Service Calls can be tested in a stand-alone manner on the PC. This
Test-bed is created as part of the testing phase by linking the Test-bed object code with the SSA-NAME3
Extensions for 1.8 Users libraries.
 a 32-bit DLL which can be invoked from most 32-bit visual applications. This in turn accesses the
Service Group Data File to use the Service Group algorithms.

4
Later on, the Fast-start Service Group will need to be customized and re-generated to better suit the
application, database & environment. This work will normally be done by the analyst programmer
responsible for building the applications which call SSA-NAME3 Extensions for 1.8 Users. Refer to the
Prototype Application section of the G ETTING S TARTED manual for further information on this subject.

5 INTRODUCTION
Installation
A list of the resources and pre-requisites required to install SSA-NAME3 Extensions for 1.8 Users is
provided in the G ETTING S TARTED manual. It is advisable to have the Microsoft Visual C compiler
installed before beginning the SSA-NAME3 Extensions for 1.8 Users installation as this makes the in-
stallation testing phase easier.

Installation Steps
Following is a detailed description of the installation steps.

Install SSA-NAME3

Follow the steps outlined in the PC Installation Guide for SSA-NAME3. The Installation wizard will
guide you through the installation process, creating the product root directory (known symbolically as
%SSATOP%) and copying the selected CD contents to that directory and its sub-directories.

Install SSA-NAME3 Extensions for 1.8 Users

Follow the instructions in the I NFORMATICA IR P RODUCT I NSTALLER manual.

Testing the Installation

Initiate a Command window using the icon (SSA-NAME3 9.0 Extensions Generation) created in the
%SSATOP%) directory. This will establish the SSA-NAME3 Extensions for 1.8 Users environment vari-
ables and change to the %SSATOP%\ssaname directory.

At this stage, a country should have been chosen to use as the basis of testing the installation. If only
one country’s Definition files have been installed, that will be the one to use. If more than one country
was installed, choose the one you are most familiar with.

Then, follow these steps:

i. Determine the name of the sub-directory in %SSATOP%\ssaname containing the installed coun-
try’s Definition files. For example, the USA Country directory is %SSATOP%\ssaname\usa. (A
full list of directory names is listed in the Definition File Overview section of the D EFINITION &
C USTOMIZATION G UIDE, or simply do a dir and find the sub-directory name).
ii. Create a new sub-directory in %SSATOP%\ssaname. The name of this new sub-directory should
begin with the characters ’my’, followed by the name of the installed country sub-directory. For
example, if ’usa’ was the installed country sub-directory, the new sub-directory would be called
’myusa’. Next, change to this new sub-directory and copy all of the files from the installed country
sub-directory to the new sub-directory. The commands to perform these steps are shown below:

cd %SSATOP%\ssaname
md my\textitcountry
cd my\textitcountry
copy ..\country\*.*

For example:

6
 cd %SSATOP%\ssaname
md myusa
cd myusa
copy ..\usa\*.*

This should now become your working directory for the customization of this country’s Definition
files. All further work done on these definition files should be carried out in this sub-directory.
iii. Generate the Fast-start country Definition files by executing the command build (this will execute
a script in the sub-directory called build.bat):

cd %SSATOP%\ssaname\mycountry
build

To understand more about what build.bat is doing, read the comments in its header. To learn
more about Generation, read the Overview section of the G ENERATION & T ESTING G UIDE. To
learn more about the jobs which build.bat executes, refer to the Generation section of the same
manual.
If any errors occur during this process, the most likely cause is that the environment variables have
not been set up.
iv. Execute the Test-bed using the supplied input test file as follows:

cd %SSATOP%\ssaname\mycountry
testbed <testin >testout.pc

v. Check the results of the Test-bed execution by editing or viewing the file testout.pc. The results
should look something like is shown below. The main item to check is that the Response Code
(RESP) is zero, as highlighted. The other data may be different than what is shown depending on
what fast-start country is being used. If any doubts exist as to the success of this Test-bed execution,
call Informatica Corporation Technical Support.

PGM: TESTBED TST 1.8.2.07MSVC60 Oct 18 2002 12:28:38

DONE: TESTBED --DONE-- Nov 21 2002 15:52:06
USG: S_MDT MDT 1.8.2.0900255YLN5NY
SERVICE GROUP NAME: n3sgus

NOTE: THIS PROGRAM CONTAINS CONFIDENTIAL INFORMATION AND

IS THE SUBJECT OF COPYRIGHT, AND ITS ONLY PERMITTED USE
IS GOVERNED BY THE TERMS OF AN AGREEMENT WITH
INFORMATICA CORPORATION, OR ITS SUBLICENSORS.
ANY USE THAT DEPARTS FROM THOSE TERMS, OR
BREACHES CONFIDENTIALITY OR COPYRIGHT MAY EXPOSE THE
USER TO LEGAL LIABILITY.

SERVICE: NAMESETP
TYPE: NAMESET
ALG: PERSON
WSIZE: 4375 SSIZE: 2080
RESP: 00
FUNC: **
INPUT: TESTING NAME +
+
OUTPUT: TESTING NAME +
+
STACK: 02
1 TESTING Y T TASTANG
2 NAME M Y N NAN
KEYS: 02
1 F43366BE42 A1

7 INSTALLATION
 2 DAE4039334 A1
STAB: DAE4039334
1 DAE4039334 DAE4039337 60 00 20 A1 C 00
2 DAE4039000 DAE40393FF 68 00 12 A2 C 00
3 DAE4037800 DAE40393FF 70 00 11 A3 C 00
4 DAE4000000 DAE403FFFF 75 06 10 A4 C 00
5 DAC0000000 DAFFFFFFFF 93 27 02 A7 C 00
6 D6C0000000 DAFFFFFFFF 95 37 01 A8 C 00
7 0000000000 FFFFFFFFFF 00 49 00 A9 C 00
CATS: .
WORK: A1 00003100000000310000
SSA-NAME3 TESTBED PROCESSING COMPLETE

Transferring the Service Group Data File to the Target

If necessary, transfer the Service Group Data File (n3sgxx.ysg) to the target platform. If not then skip
this step and read step 4.

This is an ASCII text file and, if using unix, your ftp program settings should be configured appropri-
ately.

In addition, the files testin and testout.pc should be transferred.

Below is an example using ftp.

From your %SSATOP%\ssaname\mycountry sub-directory, which should have the same name as the
working directory created on Unix:

For example,

ftp <mysys>
. . .
cd myssatop/ssaname/mycountry
ascii
prompt
put n3sgus.ysg
put testin
put testout.pc
bye

You can now continue testing the target installation using the target installation manual.

Note that Unix file systems are case sensitive and the Service Group Data File name should always be
kept lower case.

On MS Windows, Create the DLL

For any application program calling SSA-NAME3 Extensions for 1.8 Users on MS Windows, it will call
a dynamic link library that is created in this step.

Create the dynamic link library using the Informatica Corporation supplied gendll command:

$SSABIN/gendll <service group name>

For example:

Installation Steps 8
 $SSABIN/gendll n3sgus

This example assumes that you use the SSA-NAME3 Extensions for 1.8 Users naming standard for your
Service Group, i.e. file names start with "n3".

After this step the library n3sgus.dll can access the Service Group Data File (n3sgus.ysg). The
Data File contains the algorithm rules from the Fast-start Definition files that were generated on the
PC.

At runtime it is necessary to set an environment variable SSAUSGDIR that references the directory
containing the Service Group Data File. For Example,

set SSAUSGDIR=c:\InformaticaIR\ssaname\myusa

and the dll should be available within the system search path.

9 INSTALLATION