Previous Topic: Define the Startup Variables for CAISDI/soapNext Topic: Configure CAISDI/elmds


CASOAPE Environmental Variables

SD_URL

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 typically determines the WSDL level from the URL, provided the absolute path in the URL is the standard CA Service Desk path.

Important! Only specify this variable at the direction of CA support.

SD_USER

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

SD_PASS

The password that is 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 typically determines the WSDL level from the URL, provided the absolute path in the URL is the standard CA Service Desk path.

Important! Only specify this variable 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 of 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 of the password.

SSL_SAF

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 SSL_SAF and SSL_HFS are specified, initialization fails.

SSL_HFS

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 SSL_HFS and SSL_SAF are specified, initialization fails.

SSL_STASH

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 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. For example:

This variable is used by the C/C++ functions and not directly inspected by the CAISDI/soap server.

TIMEOUT_CONNECT

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

Default: 60 seconds

Note: Setting a value too low can 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. Specify a number between 1 and 3600.

Default: 20 seconds

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

DEBUG

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

Default: N

TRACE

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

Default: N

CCI_DUMP_BUFFER

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

Default: N

TRACE_XML_PARSE

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

Default: N

LC_ALL

(Optional) Specify the language/code page used to convert XML data from EBCDIC to UTF-8 before sending it to CA Service Desk on a distributed server. For more details, see the IBM z/OS C/C++ Run-Time Library Reference.

For example:

C/C++ functions use this variable. If the LC_ALL is not specified, the code page IBM-1047 is used.

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