> Reference Guide > BEA SALT Reference Guide

Reference Guide

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

BEA SALT Reference Guide

The BEA SALT Reference Guide describes, in alphabetical order, system processes, commands, and utilities delivered with the BEA SALT software.

 

GWWS

Name

GWWS - Web service gateway server.

Synopsis 

GWWS SRVGRP="identifier" SRVID=number [other_parms]
CLOPT="-A -- -c Config_file -i InstanceID"

Description

The GWWS server is the Web service gateway for SALT and Tuxedo. It provides communication with Web service client programs via SOAP protocol. The GWWS server accepts SOAP requests over HTTP/S, converts them into Tuxedo native calls, and sends back the Tuxedo service responses as SOAP responses. GWWS gateways are used as Tuxedo system processes and are described in the *SERVERS section of the UBBCONFIG file.

The CLOPT option is a string of command-line options passed to the GWWS server when it is booted. The GWWS server accepts the following CLOPT options:

-c Config_file

Specifies the configuration file.

-i InstanceID

Specifies the GWWS instance unique ID. The value must be unique among multiple GWWS items within the UBBCONFIG file. This option is used to distinguish multiple GWWS instances provided in the same Tuxedo domain.
Note: The InstanceID value must already be defined in the BEA SALT configuration file in the <WSGateway> section.

Diagnostics

If an error happens during SOAP message processing, the error is logged. The error is also translated into appropriate SOAP fault and/or HTTP error status code and returned to the client.

Examples

Listing 1 GWWS Description in the UBBCONFIG File

*SERVERS

GWWS SRVGRP=GROUP1 SRVID=10
CLOPT="-A -- -c saltconf_1.xml -i GW1"
GWWS SRVGRP=GROUP1 SRVID=11
CLOPT="-A -- -c saltconf_1.xml -i GW2"
GWWS SRVGRP=GROUP2 SRVID=20
CLOPT="-A -- -c saltconf_2.xml -i GW3"

See Also

UBBCONFIG(5)

tmwsdlgen

wsadmin

Components For Administering BEA SALT
in the BEA SALT Administration Guide

 

tmwsdlgen

Name

tmwsdlgen - BEA Salt WSDL document file generator.

Synopsis 

tmwsdlgen -c Config_file [-y] [-o wsdl_file] [-s rpc|doc] [-v 1.1|1.2] [-m pack|raw] [-t wls|axis]

Description

tmwsdlgen generates a WSDL document file from the BEA SALT configuration file and the Tuxedo Service Metadata Repository. The generated WSDL document is Web service specification compliant and represents both the service contracts and policies. tmwsdlgen works as a Tuxedo native client, therefore the TUXCONFIG environment variable must be set correctly in order to access the TMMETADATA server.

tmwsdlgen accepts the following parameters:

-c

Mandatory. Used to specify the path of the configuration file.

tmwsdlgen accepts the following optional parameters:

-o

Used to specify the output WSDL document file path. If the option is not present, a default file named tuxedo.wsdl is created in the current directory. If the specified WSDL document file already exists, then a prompt displays allowing confirmation to overwrite the existing file.

-y

Overwrites the existing WSDL document file without prompting.

-s

Used to specify the encoding style used for Web service SOAP messages. Specifies rpc for RPC/encoded style and doc for Doc/literal encoded style. If this option is not present or the specified value is invalid, Doc is the default style.

-v

Used to specify the SOAP protocol version that WSDL file supports. Specify 1.1 for SOAP 1.1 protocol and 1.2 for SOAP 1.2 protocol. If this option is not present or the specified value is invalid, SOAP 1.1 is used as the default.

-m

Used to specify the WSDL data mapping policy for certain Tuxedo typed buffers. Currently, it applies to the Tuxedo CARRAY buffer type. If raw mode is specified, CARRAY is represented to the MIME attachment. If pack mode is specified, xsd:base64Binary is used to represent CARRAY. The default value is pack mode.
Note: raw mode cannot be used for .Net clients. The .Net Framework does not support MIME attachments.

-t

Takes effect only when the -m option is specified in raw mode. It accepts two options, wls or axis:

Diagnostics

If an error is detected, an error message is printed.

Examples

The following command generates a WSDL document file named Salt.wsdl from a specified configuration file named config.xml. 

tmwsdlgen -c config.xml -o Salt.wsdl

The following command generates a default WSDL document file with RPC/encoded style and SOAP version 1.2. 

tmwsdlgen -c config.xml -s rpc -v 1.2

SEE ALSO

GWWS

wsadmin

Components For Administering BEA SALT
in the BEA SALT Administration Guide

 

wsadmin

Name

wsadmin - BEA SALT administration command interpreter.

Synopsis 

wsadmin [-v]

Description

wsadmin uses specific commands to monitor and administrate active GWWS processes in the specified Tuxedo domain. The TUXCONFIG environment variable is used to determine the location where the Tuxedo configuration file is loaded. wsadmin is used in the same manner as tmadmin(1) or dmadmin(1).

Normally, wsadmin may be run on any active node within an active Tuxedo application. If the application is inactive, wsadmin may be used but has no effect.

wsadmin supports the following optional parameter:

-v

Causes wsadmin to display the BEA SALT version number and license information. wsadmin exits after print out.

wsadmin Commands

Commands may be entered using either their full name or their abbreviation (as given in parentheses), followed by any appropriate arguments. Arguments appearing in brackets,
[ ], are optional; arguments in braces, {}, indicate a selection from mutually exclusive options.

Note: Command line options that are not in brackets do not need to appear in the command line (that is, they are optional) if the corresponding default has been set via the default command.

wsadmin supports the following commands:

configreload (creload) -i gwws_instance_id

Triggers SALT configuration runtime reloading for the specified GWWS process.
The -i parameter must be specified.

configstats(cstat) -i gwws_instance_id

Displays the current configuration status for the specified GWWS process.
The -i parameter must be specified.

default(d) [-i gwws_instance_id]

Sets the corresponding argument to the default GWWS Instance ID. The defaults can be changed by specifying * as an parameter.
If the default command is entered without parameters, the current defaults are printed.

echo(e) [{off | on}]

Echoes input command lines when turned on. If an option is not given, the current setting is toggled, and the new setting is printed.
The initial setting is off.

help (h) [command]

Prints help messages. If command is specified, the abbreviation, arguments, and description for that command are printed.
Omitting all parameters causes the syntax of all commands to be displayed.

gwstats(gws) -i gwws_instance_id

Displays runtime statistics information for the specified GWWS processes.
The -i parameter must be specified.

paginate(page) [{off | on}]

Paginates output. If no option is given, the current setting is toggled, and the new setting is printed. The initial setting is on, unless either standard input or standard output is a non-tty device. Pagination may be turned on only when both standard input and standard output are tty devices.
The default paging command is indigenous to the native operating system environment. In a UNIX operating system environment, for example, the default paging command is pg. The shell environment variable PAGER may be used to override the default command used for paging output.

quit (q)

Terminates the session.

verbose (v) [{off | on}]

Produces output in verbose mode. If no option is given, the current setting is toggled, and the new setting is printed. The initial setting is off.

! shellcommand

Escapes to the shell and executes shell command.

! !

Repeats previous shell command.

# [text]

Specifies comments. Lines beginning with # are ignored.

<CR>

Repeats the last command.

Examples

The following command sends a reloading request to GWWS for GW1. 

wsadmin
>configreload -i GW1
>quit

The following command inspects GWWS statistics for GW1 and gets output in verbose mode. 

wsadmin
> verbose
> gwstats -i  GW1
> quit

See Also

GWWS

tmwsdlgen

Components For Administering BEA SALT
in the BEA SALT Administration Guide


  Back to Top       Previous  Next