ASE Web Services directory tree

ASE Web Services is installed at the same level as the root directory for Adaptive Server Enterprise. The ASE Web Services root directory is named WS-15_0 and consists of these subdirectories:

Table A-1: ASE Web Services directories

Directory name

Contents

bin

Scripts for configuring and running ASE Web Services.

lib

Java libraries and packages used by ASE Web Services.

logs

Default location for log files.

producer

Files and subdirectories for ASE Web Services Engine at runtime.

props

Files for ASE Web Services properties.

samples

Sample scripts for building and running a sample client with the ASE Web Services Engine.

Table A-2 describes the contents of the bin directory.

Table A-2: bin directory contents

File/Directory name

Function

configssl

Configures SSL.

getpass.exe

Used for Adaptive Server Enterprise login. This file is only available on Windows.

installws

Installs sp_webservices stored procedure.

runtcpmon

Creates a monitor to trace SOAP messages.

runws

Starts the ASE Web Services Engine.

stopws

Stops the ASE Web Services Engine.

NoteThe Windows versions of these files have a .bat suffix.

Table A-3 describes the contents of the lib directory.

Table A-3: lib directory contents

File/Directory name

Function

axis.jar

Apache Axis file

commons-discovery.jar

Apache Axis file

commons-logging.jar

Apache Axis file

javax.servlet.jar

Servlet library

jaxrpc.jar

Apache Axis file

log4j-1.2.4.jar

log4j logger

mail.jar

Apache Axis file

org.mortbay.jetty.jar

HTTP server

saaj.jar

Apache Axis file

sqlx.jar

SQLX file

tools.jar

Java tools (for example, the javac compiler)

ws.jar

Code for ASE Web Services Engine

ws_debug.jar

Debugger Code for ASE Web Services Engine

wsdl4j.jar

Apache Axis file

xercesImpl.jar

Xerces parser

xmlParserAPIs.jar

Xerces parser

Table A-4 describes the contents of the logs directory.

Table A-4: logs directory contents

File/Directory name

Function

webservices.log

contains information and error messages for Web Services producers and consumers

http.log

Logs Web server activity.

Table A-5 describes the contents of the producer directory.

Table A-5: producer directory contents

File/Directory name

Function

index.html

Home page for the Web services browser interface.

keystore

Holds encryption keys.

ui

Directory structure for Web services browser interface.

WEB-INF

Directory structure required for Jetty.

wscertificate.cer

Auto-generated certificate for SSL. This file is present only the configssl script has been run.

Table A-6 describes the contents of the props directory.

Table A-6: props directory contents

Directory name

Function

logging.properties

Configuration file for log4j

ws.properties

All configuration parameters for ASE Web Services Engine

wsmsg.properties

Configuration file for messages

The samples directory contains precompiled and source code for both Apache and Microsoft .NET. You can use source code in your own applications. Table A-7 describes the contents of the samples directory.

Table A-7: samples directory contents

Directory name

Function

apacheclient

Directory containing sample scripts for compiling and running the sample client

ms.net

Directory containing samples for .NET