NonStop SOAP 4.1 User's Manual

NOTE: The following example has the steps to deploy the Web service using the sample reflector
Pathway application. However, if you already have an existing pathway server class and a
corresponding WSDL, then making changes to the services.xml should suffice in being able
to get the server class deployed as a Web service.
The steps to deploy the Web service using the sample reflector Pathway application are as follows:
1. Getting the sample application files from sample_services
2. Creating DDL dictionary files
3. Creating SDL files
4. Creating Web service files using SOAPAdminCL tools
5. Compiling reflector.c
6. Configuring and starting the reflector application
7. Accessing the Web service
NOTE: The steps mentioned can be used to deploy any server class other than reflector.
Getting the sample application files from sample_services
To copy the files from sample_services, complete the following steps:
1. Navigate to the <Reflector Source Directory> folder. This is a directory
of your choice where all reflector service related files reside.
2. Copy the reflector sample from <NonStop SOAP 4 Installation
Directory>/sample_services/reflector.
OSS>cp —r <NonStop SOAP 4 Installation Directory>/sample_services/reflector .
Creating DDL dictionary files
A DDL dictionary is required to expose a NonStop server class or Pathway application as a Web
service. The DDL data definitions are used to create the data fields in the WSDL file. To create the
DDL dictionaries, compile the DDL files that include the request and response structure for the
Pathway application.
The <Reflector Source Directory>/src directory includes the reflectorddl file for the
reflector application. Navigate to this folder and edit the following parameter in the reflectorddl
file:
$<VOLUME>.<SUBVOLUME>
is a Guardian location where you want the dictionary files for the reflector service to be created.
for example, $DATA.REFL. You must have read and write permissions for this directory. The
specified dictionary location should NOT have any existing dictionary files.
Create the DDL dictionaries using the following command:
OSS > gtacl –p ddl < reflectorddl
NOTE: Make sure that the command returns no errors. For information on developing DDL
definitions, see the Data Definition Language (DDL) Reference Manual.
For example, if you specified $DATA.REFL as the dictionary location, successful compilation of
reflectorddl generates the following output:
OSS> gtacl -p fup info \$DATA.REFL.*
CODE EOF LAST MODIFIED OWNER RWEP PExt SExt
DICTALT 201A 12288 07NOV2008 18:40 255,255 NUNU 4 32
DICTCDF 207A 0 07NOV2008 18:40 255,255 NUNU 4 32
DICTDDF 200 30 07NOV2008 18:40 255,255 NUNU 14 14
DICTKDF 206A 0 07NOV2008 18:40 255,255 NUNU 4 32
DICTMAP 209A 0 07NOV2008 18:40 255,255 NUNU 4 32
78 Getting Started with NonStop SOAP 4