1.1.1.1 Defining Service-Level Keywords for SALT

The following table lists Oracle Tuxedo Service Metadata Repository service-level keywords used and interpreted by SALT.

Note:

Metadata Repository service-level keywords that are not listed have no relevance to SALT and are ignored when SALT components load the Oracle Tuxedo Service Metadata Repository.

Table 1-1 SALT Usage of Service-Level Keywords in Oracle Tuxedo Service Metadata Repository

Service-Level Keyword SALT Usage
service The unique key value of the service. This value is referenced in the SALT WSDF file.

For native Oracle Tuxedo services, this value can be the same as the Oracle Tuxedo advertised service name, or an alias name different from the actual Oracle Tuxedo advertised service name.

For SALT proxy services, this value typically is the Web service operation local name.
servicemode

Determines the service mode (i.e., native Oracle Tuxedo service or SALT proxy service).

The valid values are:

  • tuxedo

    Represents a native Oracle Tuxedo service

  • webservice

    Represents aSALT proxy service (i.e., a service definition converted from a wsdl:operation).

Do not use “webservice” to define a native Oracle Tuxedo service. This value is always used to define services converted from external Web services.

tuxservice The actual Oracle Tuxedo advertised service name. If no value is specified, then the value is the same as the value in the service keyword.

For native Oracle Tuxedo services, SALT invokes the Oracle Tuxedo services defined using this keyword.

For SALT proxy service, GWWS server advertises the service name using this keyword value.
servicetype Determines the service message exchange pattern for the specified Oracle Tuxedo service.

The following values specify mapping rules between the Oracle Tuxedo service types and the Web Service message exchange pattern (MEP):

  • service

    Corresponds to request-response MEP.

  • oneway

    Corresponds to oneway request MEP.

  • queue

    Corresponds to request-response MEP.
inbuf Specifies the input buffer (request buffer), type for the service.

For native Oracle Tuxedo services, the value can be any Oracle Tuxedo typed buffers. The following values are Oracle Tuxedo reserved buffer types:

STRING, CARRAY, XML, MBSTRING, VIEW, VIEW32, FML, FML32, X_C_TYPE, X_COMMON, X_OCTET, NULL (input buffer is empty)

Note:

The value is case sensitive, if inbuf specifies any buffertype other than the above mentioned buffer types, the buffer is treated as a custom buffer type.

For SALT proxy services, the value is always FML32.

outbuf Specifies the output buffer (response buffer with TPSUCCESS), type for the service.

For native Oracle Tuxedo services, the value can be any Oracle Tuxedo typed buffer. The following values are Oracle Tuxedo reserved buffer types:

STRING, CARRAY, XML, MBSTRING, VIEW, VIEW32, FML, FML32, X_C_TYPE, X_COMMON, X_OCTET, NULL (input buffer is empty)

Note:

The value is case sensitive, if outbuf specifies any buffer type other than the above mentioned buffer types, the buffer is treated as a custom buffer type.

For SALT proxy services, the value is always FML32.

errbuf Specifies the error buffer type(response buffer with TPFAIL),for the service.

For native Oracle Tuxedo services, the value can be any Oracle Tuxedo typed buffer. The following values are Oracle Tuxedo reserved buffer types:

STRING, CARRAY, XML, MBSTRING, VIEW, VIEW32, FML, FML32, X_C_TYPE, X_COMMON, X_OCTET, NULL (input buffer is empty).

Note:

The value is case sensitive, if errbuf specifies any buffer type other than the above mentioned buffer types, the buffer is treated as a custom buffer type.

For SALT proxy services, the value is always FML32.

inview Specifies the view name used by the service for the following input buffer types:

VIEW, VIEW32, X_C_TYPE, X_COMMON

SALT requires that you specify the view name rather than accept the default inview setting.

Note:

This keyword is for native Oracle Tuxedo services only.
outview Specifies the view name used by the service for the following output buffer types:

VIEW, VIEW32, X_C_TYPE, X_COMMON

SALT requires that you specify the view name rather than accept the default outview setting.

Note:

This keyword is for native Oracle Tuxedo services only.
errview Specifies the view name used by the service for the following error buffer types:

VIEW, VIEW32, X_C_TYPE, X_COMMON

SALT requires that you specify the view name rather than accept the default errview setting.

Note:

This keyword is for native Oracle Tuxedo services only.
inbufschema Specifies external XML Schema elements associated with the service input buffer. If this value is specified, SALT incorporates the external schema in the generated WSDL to replace the default data type mapping rule for the service input buffer.

Note:

This keyword is for native Oracle Tuxedo services only.
outbufschema Specifies external XML Schema elements associated with the service output buffer. If this value is specified, SALT incorporates the external schema in the generated WSDL to replace the default data type mapping rule for the service output buffer.

Note:

This keyword is for native Oracle Tuxedo services only.
errbufschema Specifies external XML Schema elements associated with the service error buffer. If this value is specified, SALT incorporates the external schema in the generated WSDL to replace the default data type mapping rule for the service error buffer.

Note:

This keyword is for native Oracle Tuxedo services only.
RECORD Oracle Tuxedo RECORD typed buffers can describe COBOL copybook information.

Generated COBOL types:

  • RECORD
  • COMP-2
  • S9(18)
  • 9(18)
  • S9(9)
  • 9(9)
  • S9(4)
  • S9(10)V9(10)
  • X(1024)
  • @binary=true
inrecord Specifies the record name used by the service for the following input buffer types: RECORD. Oracle SALT requires that you specify the record name rather than accept the default in record setting. This keyword is for native Tuxedo services only.
outrecord Specifies the record name used by the service for the following output buffer types: RECORD. Oracle SALT requires that you specify the record name rather than accept the default outrecord setting. This keyword is for native Tuxedo services only.
errrecord Specifies the record name used by the service for the following error buffer types: RECORD. Oracle SALT requires that you specify the record name rather than accept the default errrecord setting.

This keyword is for native Tuxedo services only.

Parent topic: Using Oracle Tuxedo Service Metadata Repository for SALT