Previous Topic: Step 8: Define the Startup Variables for CAISDI/soap

Next Topic: Configure CAISDI/elmds

CASOAPE Environmental Variables

The following are the Environmental Variables for CASOAPE.

SD_URL

(Required) URL that identifies the Service Desk Service. Obtain the URL from the CA Service Desk administrator. See Step 3.

SD_WSDL_LEVEL

(Optional) Defines the WSDL level corresponding to the URL identified by SD_URL. The CAISDI/soap server normally determines the WSDL level from the URL, provided the absolute path in the URL is the standard CA Service Desk path.

Important! This should only be specified at the direction of CA support.

SD_USER

(Required) The user ID associated with the Service Desk identified in SD_URL. See Step 4.

SD_PASS

(Required) The password associated with the user identified by SD_USER.

URL_symbol

(Optional) A product may require a web server other than the default web server as specified by SD_URL. In this case the product provides the value for symbol. The value of URL_symbol is the URL that identifies the web server. For example, if a product associates symbol WS2 with an alternate web server, then define variable “URL_WS2” and assign the value the URL of the alternate web server.

WSDL_LEVEL_symbol

(Optional) Defines the WSDL level corresponding to the URL identified by URL_symbol. The CAISDI/soap server normally determines the WSDL level from the URL, provided the absolute path in the URL is the standard CA Service Desk path.

Important! This should only be specified at the direction of CA support.

USER_symbol

If URL_symbol is defined and the associated user ID is different from SD_USER, use USER_symbol to specify the associated user ID. For example, if the symbol is WS2, define variable “USER_WS2” and assign the value the associated user ID.

PASS_symbol

If URL_symbol is defined and the password of the associated user ID is different from SD_PASS, use PASS_symbol to specify the password. For example, if the symbol is WS2, define variable “PASS_WS2” and assign the value the password.

SSL_SAF

For SSL only. Specifies the keyring name from Step 6 if your chose method 1. Specify as SSL_SAF=ringname where ringname is the name of the ring to which the certificates are connected.

This parameter is mutually exclusive with SSH_HFS. If both SSL_SAF and SSL_HFS are specified, initialization will fail.

SSL_HFS

For SSL only. Specifies the HFS file name of the keyring file from Step 6 if you chose method 2. Specify as SSL_HFS=filename where filename is the HFS file containing the certificates.

This parameter is mutually exclusive with SSH_SAF. If both SSL_HFS and SSL_SAF are specified, initialization will fail.

SSL_STASH

For SSL only when SSL_HFS has been specified. Specifies the HFS file name of the password file for the keyring file from Step 6 if you chose method 2. Specify as SSL_STASH=filename where filename is the HFS file containing the password to the keyring file specified in SSL_HFS.

TZ

(Optional) Sets the time zone that is to be used for the message logging in the CAISDI/soap server address space. Specify this as TZ=timezone where timezone is a valid C/C++ time zone notation. See the IBM z/OS C/C++ Run-Time Library Reference for more details. Some examples are: EST5EDT for Eastern Time Zone; CST6CDT for Central Time Zone, MST7MDT for MountainTime Zone, and PST8PDT for Pacific Time Zone. This is not directly inspected by the CAISDI/soap server; rather it is used by the C/C++ functions.

TIMEOUT_CONNECT

(Optional) Specifies the maximum time in seconds to wait for a connection to a web server. The default is 60 seconds. Specify a number between 1 and 3600.

Note: Setting a value too low may prevent a connection from completing that would otherwise complete.

TIMEOUT_IO

Specifies the maximum time in seconds for a socket to wait for data from a Web Server or to be able to send it data. The default is 20 seconds. Specify a number between 1 and 3600.

Note: Setting a value too low may cause the connection to close prematurely.

DEBUG

N|Y. (Optional) The default is DEBUG=N. Specify DEBUG=Y for diagnostic information to be logged to the LOGFILE file.

TRACE

N|Y. (Optional) The default is TRACE=N. Specify TRACE=Y for internal trace information to be logged to the LOGFILE file. Only set at the direction of CA support.

CCI_DUMP_BUFFER

N|Y. (Optional) The default is CCI_DUMP_BUFFER=N. Specify CCI_DUMP_BUFFER=Y for CCI buffers to be dumped to the LOGFILE file. Only set at the direction of CA support.

TRACE_XML_PARSE

N|Y. (Optional) The default is TRACE_XML_PARSE=N. Specify TRACE_XML_PARSE=Y for trace information related to XML parsing to be logged to the LOGFILE file. Only set at the direction of CA support.

Note: For security purposes, the data set containing the Environmental Variables should be secured to prevent unauthorized access to any CA Service Desk user ID and password.