The SOAP Procedure

PROC SOAP Statement

Invokes a Web service through Java Native Interface (JNI).

PROC SOAP option(s) <properties>;

Task		Option
Specify a complete path to the Axis2 repository, which is a folder or directory to which the deployment search mechanism is limited.		AXIS2CONFIGDIR
Specify a complete path to your Axis2 configuration XML file.		AXIS2CONFIGFILE
Specify the location of the SAS environments file.		ENVFILE
Specify to use the environment that is defined in the SAS environments file.		ENVIRONMENT
Specify the fileref to input XML data that contains the SOAP request.		IN
Specify the fileref where the SOAP response output XML will be written.		OUT
Specify an HTTP proxy server host name.		PROXYHOST
Specify an HTTP proxy server port.		PROXYPORT
Specify an HTTP proxy server domain.		PROXYDOMAIN
Specify an HTTP proxy server password. Encodings that are produced by PROC PWENCODE are supported.		PROXYPASSWORD
Specify an HTTP proxy server user name.		PROXYUSERNAME
Specify a SOAPAction element to invoke on the Web service.		SOAPACTION
Specify the URL of the System Registry Service.		SRSURL
Specify the SAS Web service to call.		SERVICE
Specify a URL of the Web service endpoint.		URL
Specify that a user name and password be retrieved from metadata for the specified authentication domain.		WEBAUTHDOMAIN
Specify the domain or realm for the user name and password for NTLM authentication.		WEBDOMAIN
Specify a password for either Basic or NTLM Web server authentication. Encodings that are produced by PROC PWENCODE are supported.		WEBPASSWORD
Specify a user name for either Basic or NTLM Web authentication.		WEBUSERNAME
Specify that the active connection to the SAS Metadata Server will be used to retrieve credentials in the specified authentication domain.		WSSAUTHDOMAIN
Specify a WS-Security password, which is the password for WSSUSERNAME. Encodings that are produced by PROC PWENCODE are supported.		WSSPASSWORD
Specify a WS-Security user name.		WSSUSERNAME

Operating Environment Information:

In the VMS operating environment, you must use the RECFM=streamlf option on the FILE statement to create valid XML. The following example shows this option in the FILE statement:

FILE REQUEST recfm=streamlf;

[cautionend]

Options

AXIS2CONFIGDIR

specifies a complete path to the Axis2 repository, which is a folder or directory to which the deployment search mechanism is limited.

The deployment model can load and read files only inside the repository. The repository includes two subdirectories: services and modules. Service archives are located in the services directory, and modules are located in the modules directory. If WS-Security is required, then rampart.mar is required. The version of rampart.mar that is required for PROC SOAP will be listed in the classpath. However, if you choose to deploy rampart.mar or other modules in a repository, you could use this option to specify the repository location.

AXIS2CONFIGFILE

specifies the complete path to your Axis2 configuration XML file. If you do not specify this option, then axis2_default.xml in the Axis2 jar is used.

ENVFILE

specifies the location of the SAS environments file.

ENVIRONMENT

specifies to use the environment that is defined in the SAS environments file.

IN=fileref 'your-input-file'

specifies the fileref that is used to input XML data that contains a PROC SOAP request. The fileref might have SOAPEnvelope and SOAPHeader elements as part of its content, but they are not required unless you have specific header information to provide.

MUSTUNDERSTAND

specifies the setting for the mustUnderstand attribute in the PROC SOAP header.

OUT=fileref 'your-output-file'

specifies the fileref where the PROC SOAP XML response output is written.

PROXYDOMAIN

specifies an HTTP proxy server domain. This option is required only if your proxy server requires domain- or realm-qualified credentials.

PROXYHOST

specifies an HTTP proxy server host name.

PROXYPASSWORD

specifies an HTTP proxy server password. This option is required only if your proxy server requires credentials.

PROXYPORT

specifies an HTTP proxy server port.

PROXYUSERNAME

specifies an HTTP proxy server user name. This option is required only if your proxy server requires credentials.

SERVICE

specifies the SAS Web service to use.

SOAPACTION

specifies a SOAPAction element to invoke on the Web service.

SRSURL

specifies the URL of the System Registry Services.

URL

specifies the URL of the Web service endpoint.

WEBAUTHDOMAIN

specifies that a user name and password be retrieved from metadata for the specified authentication domain.

WEBDOMAIN

specifies the domain or realm for the user name and password for NTLM authentication.

WEBPASSWORD

specifies a password for either Basic or NTLM Web server authentication.

WEBUSERNAME

specifies a user name for either Basic or NTLM Web server authentication.

WSSAUTHDOMAIN

specifies that the active connection to the SAS Metadata Server will be used to retrieve credentials in the specified authentication domain.

If credentials are found, they will be used as the credentials for a WS-Security UsernameToken.

WSSPASSWORD

specifies a WS-Security password that is the password for WSSUSERNAME.

WSSUSERNAME

specifies a WS-Security user name. If a value is set, then WS-Security is used and a UsernameToken is sent with the Web service request for user authentication, security, and encryption.

Properties

ENVELOPE: specifies that a SOAP envelope is to be included in the response.

Top of Page