Previous Topic: Interfacing with CA Mainframe Products

Next Topic: Allocate the Event Library

Set Up CAISDI/els Startup Parameters

The CAISDI/els parameter library contains several members designed to control the CAISDI/els component. The ELSSTART, ELSSTOP, ELSREMOV, ELSLIST, and ELSREQS members are installed into CAI.CAW0OPTN. You may wish to copy these members to a shared system PARMLIB. The ELSSTART member contains the control statements necessary to establish the CAISDI/els interface. This member must be customized to your environment. Consider the contents of the ELSSTART member as it is distributed:

DEFAULTS USD_AUTODEF=yes          Dynamically add contacts, assets

The DEFAULTS control statement sets the default values for several DEFINE control parameters. The DEFINE control statements that follow will inherit the values from the DEFAULTS control statement. Any parameter specified on the DEFAULTS control statement may also be coded on a DEFINE control statement, but if you plan to specify the same parameter on all of your DEFINE commands, the DEFAULTS control statement allows you to code these parameters once, rather than repeating the specification on multiple DEFINE control statements.

In configuring any parameter in the ELSSTART member, if the parameter value is too long to fit on one line, it may be broken onto multiple lines. Using the “+” sign and continuation indicator. For example:

DEFAULTS  USD_ID='Service'+
          'Desk'

The trailing “+” immediately following the quote mark is the “continued string” indicator. Either single or double quotes may be used, but for a continuation, the continued string must begin with the delimiter character immediately preceding the “+” character. You may continue a string value on as many lines as necessary.

These control parameters may be specified in upper/lower/mixed case, but many of the values are case sensitive. Be sure the editor you are using does not force your control statements into upper case. The parameters to be configured are:

USD_AUTODEF

Indicates whether CAISDI/els should automatically define contact names and asset names. Each CA product that uses this interface ships its event definitions with pseudo contact names and asset names. For example, CA 1 Tape Management is packaged with a pseudo asset named “CA 1 Tape Management” and pseudo contact ID of “System_CA1_User”. Associating these pseudo entities with the CA Service Desk tickets opened by CAISDI/els will simplify searching and tracking of those tickets. If USD_AUTODEF=YES has been specified, the contact IDs and asset names will be automatically defined in your CA Service Desk system if they are not already present.

If USD_AUTODEF=NO is specified, CAISDI/els cannot establish the interface for any product whose definitions include references to contacts or assets that do not already exist. The interface will not be enabled for those products.

Default: USD_AUTODEF=YES

URL_SYMBOL

Optional. Used to identify the CA Service Desk server on which you want the tickets opened. If omitted, the SD_URL value from the CAISDI/soap address space's Environmental Variables is used. You may select an alternate CA Service Desk server by assigning a “symbol” to URL_SYMBOL where URL_symbol is a defined Environmental Variable in the CAISDI/soap server and where its value is a URL identifying the CA Service Desk server. For example, if “URL_SYMBOL=WS2” then Environmental Variable “URL_WS2” must be defined to the CAISDI/soap server with a value which is the URL for the CA Service Desk server. See the CASOAPE Environmental Variables.

USD_ID

Optional. Designates the CA Service Desk logon ID that will be used to access the CA Service Desk. If omitted and URL_SYMBOL is specified, then if USER_symbol is defined in the CAISDI/soap server’s Environmental Variables its value is used, otherwise the SD_USER value from the CAISDI/soap server’s Environmental Variables is used. If omitted and URL_SYMBOL is not specified, then the SD_USER value from the CAISDI/soap Environmental Variables is used. While this ID will be used to open CA Service Desk tickets, this ID will not appear on the tickets themselves. The contact identified by the REPORTED_BY parameter will be used for that purpose. Each product using this interface provides a product control member containing the REPORTED_BY specification. You will have the opportunity to alter the REPORTED_BY designations when the individual products are configured for this interface.

USD_PW

Optional. Designates the password to use with the aforementioned ID. If omitted and URL_SYMBOL is specified, then if PASS_symbol is defined in the CAISDI/soap server’s Environmental Variables its value is used, otherwise the SD_PASS value from the CAISDI/soap server’s Environmental Variables is used. If omitted and URL_SYMBOL is not specified, then the SD_PASS value from the CAISDI/soap Environmental Variables is used. The password value is suppressed in all reports. If you specify an actual ID and password here, you should take measures to secure the parameter library that contains the ELSSTART member.

This step is complete when you have updated the ELSSTART member with the CA Service Desk server URL, ID, and password.