NonStop SOAP User's Manual

NonStop SOAP User-Exits
NonStop SOAP User’s Manual—520501-012
C-11
SOA Enable a Nonstop Server Application With
User-Exits
Create the DDL for the Service
Create the DDL, which defines the service request and response message structures
based upon the request and response message format definitions used by the service
provider. Generate the DDL dictionary definitions by compiling the DDL.
In this example, the DDL is created based upon the Service Request and Response
buffer structures required for the NonStop Tuxedo “SIMPAPP” service:
?DICT <DDL File location>
DEF REQUEST.
02 REQBUF PIC X(10).
END
DEF RESPONSE.
02 RESPBUF PIC X(10).
END
Define and Create a New Sdl File for the Service
The SDL file is used to define the SOA service to the NonStop SOAP server. An SDL
file must be created for each service that may be invoked by the NonStop SOAP
server.
The SDL file can be created by editing a template manually. In this case, it is
necessary to specify that user-exits need to be activated. This is done by specifying
the GenerateUserExits attribute in the SDL file. The GenerateUserExits
attribute is available at the Service element level.
However, the SOAP Admin tool graphical user interface (GUI) also provides the “New
SDL Wizard,” which allows you to create a new SDL file using a simple interactive GUI
from a Microsoft® Windows®-based PC, and then deploy the SDL file onto the
NonStop server.
The following section describes how to use the “New SDL Wizard” to create the SDL
file.
The first step is to start the New SDL Wizard, which is done via the SOAPGUI Admin
tool. This tool is started by launching the .bat file named AdminTool.bat. Once you start
this tool, the following screen will appear as shown in Figure C-3. Select the “new”
option in the File menu to create the new SDL file using the wizard.
Note. In the case of NonStop Tuxedo services, only buffers of NonStop Tuxedo type
“CARRAY” and “VIEW” can be defined directly in DDL format. NonStop Tuxedo buffer type
“FML” is not supported in DDL. To support a NonStop Tuxedo service provider using FML,
the customized NonStop SOAP server user-exit code would need to be able to create the
FML buffer from the SOAP Request structure, which is defined by DDL in an abstract way.