For proc CASOAPE, define the Environmental Variables in the file that is allocated to ENVVAR. A sample member, SOAPVARS, is provided in data set CAI.CAW0OPTV. These variables are read and processed by LE. See the z/OS XL C/C++ Programming Guide. LE sets the Environmental Variables before the CAISDI/soap server starts. For description of the variables, see the CASOAPE Environmental Variables.
For the CAISDI/soap server before Version 14.0 using proc CASOAP, define the startup variables for the CAISDI/soap server in a configuration file. A sample configuration file is provided in the SMP/E data set CAI.CAW0OPTN, member SDCONFIG, which you must customize and copy to a shared system PARMLIB.
The following rules apply to the parameter specification in the configuration file:
The following table describes the CAISDI/soap server startup parameters when using proc CASOAP.
Important! Many of these fields are case sensitive. Set your text editor so that it keeps the input values in mixed case.
|
Parameter |
Description |
|---|---|
|
SD_URL |
Sets the URL for SOAP requests to the Web Services directory of the CA Service Desk server. Specify SD_URL=url where url is the full URL. For example: SD_URL=http://server.local.com:8080\ /axis/services/USD_WebServiceSoap?wsdl Note the continuation character (\) at the end of line one on this two-line input. When coding the SD_URL parameter in the SDCONFIG member of PARMLIB, specify a host name if possible. If coding a literal IP address in a URL in an IPv6 environment, do not code an IPv4 address as an IPv4-mapped IPv6 address. Code an IPv4 address as such and the code will create the IPv4-mapped IPv6 address. If coding a literal IPv6 address for a URL for an IPv6 environment, the address should be enclosed in square brackets with any optional port designations placed outside the brackets. For example: [3FFE:2A00:100:7031::1]:8080 |
|
SD_USER |
The CA Service Desk User ID to be used in all CAISDI connections to the CA Service Desk. Set this parameter to the logon ID gathered in Step 4 above. Specify as SD_USER=userid where userid is the user ID. |
|
SD_PASS |
The password associated with SD_USER. Set this parameter to the logon password gathered in Step 4 above. Specify as SD_PASS=password where password is the password. |
|
SSL_SAF |
SSL only. Specifies the keyring name from Step 6 above 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, CAISDI/soap initialization fails. |
|
SSL_HFS |
SSL only. Specifies the HFS file name of the keyring file from Step 6 above 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, CAISDI/soap 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 above 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 |
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++ 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 Mountain Time Zone, and PST8PDT for Pacific Time Zone. |
|
WORK_DIR |
The UNIX System Services working directory for writing “debug” statements by the script process. This is required only in DEBUG mode and only if you need the debugging output of the script process. In DEBUG mode without this variable set, you get detailed debugging information and packet tracing written to the LOGFILE DD. Specify as WORK_DIR=hfsdir, where hfsdir is the HFS working directory where the script debugging lines will be written. The filename specified at open is "./soap_script.log". |
|
LOGIN |
Sets the registration value associated with the CA Service Desk Login method. This field must contain the following value: http://www.ca.com/UnicenterServicePlus/Service Desk/Login Specify as LOGIN=regvalue where regvalue is the CA Service Desk registration value for the Login Web Services method. |
|
LOGOUT |
Sets the registration value associated with the CA Service Desk Logout method. This field must contain the following value: http://www.ca.com/UnicenterServicePlus/Service Desk/Logout Specify as LOGOUT=regvalue where regvalue is the CA Service Desk registration value for the Logout Web Services method. |
|
CREATE |
The registration value that is associated with the CA Service Desk CreateRequest method. This field must contain the following value: http://www.ca.com/UnicenterServicePlus/Service Desk/CreateRequest Specify as CREATE=regvalue where regvalue is the CA Service Desk registration value for the CreateRequest Web Services method. |
|
DEBUG |
Keyword used to enable diagnostic logging in CAISDI/soap. |
|
NODEBUG |
Keyword used to disable diagnostic logging in CAISDI/soap. |
|
TIMEOUT_CONNECT |
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. Note: Setting a value too low may cause the connection to close prematurely. Specify a number between 1 and 3600. |
|
URL_symbol |
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. |
|
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. |
Note: For security purposes, secure the CAISDI/soap server configuration data set to prevent unauthorized access to the CA Service Desk user ID and password.
For a sample configuration file, see member SDCONFIG in the CAI.CAW0OPTN data set.
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|