NonStop SOAP 4.1 User's Manual

Accessing the echo service.............................................................................................43
Setting up Multiple NonStop SOAP Deployment Instances in a Single iTP WebServer.................43
Deploying a Sample Web Service............................................................................................44
Deploying the empdb Service..............................................................................................44
Setting up the empdb environment...................................................................................45
Accessing the empdb service..........................................................................................48
Deploying the adminserver Service...........................................................................................50
Setting up the adminserver Environment................................................................................50
Accessing the adminserver Service.......................................................................................51
3 Migrating NonStop SOAP 3 Services to NonStop SOAP 4 or Higher
Versions.....................................................................................................52
Prerequisites...........................................................................................................................52
Migrating the NonStop SOAP 3 Services...................................................................................52
Generating SOAP 4 Service Artifacts and Client Files from NonStop SOAP 3............................52
Generating the SDL File from the NonStop SOAP 3 SDR File...............................................53
Modifying the SDL File...................................................................................................54
Generating the HTML Client, WSDL, XML Schema, and services.xml Files to Deploy the
Service........................................................................................................................54
Migration Considerations...............................................................................................56
Accessing the Migrated Application.....................................................................................56
Migrating NonStop SOAP 3 Transactions..................................................................................58
Migrating NonStop SOAP 3 User-exits.......................................................................................61
Migrating the NonStop SOAP 3 User-exit Samples.................................................................62
Migrating the pre_process() and post_process() user-exits using mod_empdb.........................62
Implementation of the pre_process() user-exit in NonStop SOAP 3...................................63
Implementation of the post_process()user-exit in NonStop SOAP 3...................................63
Migration of the pre_process() and post_process() user-exits in NonStop SOAP
4............................................................................................................................64
Migrating the pre_service() and pre_marshal() user-exits in NonStop SOAP 3 to Message
Receiver User Functions in NonStop SOAP 4.1..................................................................71
Implementation of the pre_service() and pre_marshal() user-exit in NonStop SOAP 3.........71
Migration of pre_service() and pre_marshal() user-exits in NonStop SOAP 4.1..................72
4 Getting Started with NonStop SOAP 4........................................................77
Deploying a Pathway Application and a NonStop Process as a Web Service ................................77
Getting the sample application files from sample_services.......................................................78
Creating DDL dictionary files...............................................................................................78
Creating SDL files..............................................................................................................79
Creating Web Service files using SOAPAdminCL tool.............................................................79
Compiling reflector.c..........................................................................................................81
Configuring and starting the reflector application...................................................................81
Accessing the Web Service deployment................................................................................82
Deploying a NonStop process as a Web Service........................................................................83
5 NonStop SOAP 4 Service APIs...................................................................85
Basic NonStop SOAP 4 Service APIs.........................................................................................85
APIs to Implement the Service Interface with NonStop SOAP 4.................................................85
The axis2_get_instance()Function.....................................................................................85
Creating the service skeleton structure.........................................................................86
Setting the service skeleton operations structure............................................................86
Returning the service skeleton structure to the service.....................................................86
The axis2_remove_instance()Function...............................................................................86
APIs to Implement the Service Skeleton Structure Interface........................................................87
The init Function............................................................................................................87
The invoke Function.......................................................................................................87
4 Contents