Previous Topic: DEFAULTS Control StatementNext Topic: Shutting Down CAISDI/els

CA Service Desk Configuration › CAISDI/elmds Backout Procedure › How to Implement Standalone CAISDI/els › Run Standalone CAISDI/els › CAISDI/els Control Statements › Defining Products to CAISDI/els › DEFINE Control Statement

DEFINE Control Statement

The DEFINE control statement establishes CAISDI/els with a given CA Technologies product.

Use this syntax for the DEFINE control statement:

DEFINE
    PRODUCT=prodname
    EVENTLIB=dsn
    PRODCNTL=prod_ctl_mem
    URL_SYMBOL=symbol
    USD_ID=uid
    USD_PW=password
    [LANG=lang]
    [MASK=mask]
    [USD_AUTODEF={YES|NO}]
PRODUCT

Required. A product code that uniquely identifies a given CA Technologies product.

EVENTLIB

Required. The fully qualified partitioned data set name containing the product control member and the product event members. In most cases, this is CAI.CAIEVENT.

PRODCNTL

Required. Identifies the name of the product control member.

MASK

Required for some products. A generic mask that is used to identify event member names where the event library can contain event members or nonevent members from multiple products.

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 can 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 (deprecated with elmds). The logon ID to be used in accessing CA Service Desk. If omitted, the ID is taken from the CAISDI/soap SOAP client address space configuration file from the SD_USER variable.

USD_PW

Optional (deprecated with elmds). The password to be used with the CA Service Desk logon ID. If omitted, the password is taken from the CAISDI/soap SOAP client address space configuration file from the SD_PASS variable.

LANG

Optional. A code designating the language to be used in the summary and description texts of the CA Service Desk SD tickets opened by CAISDI/els. Valid codes are:

Default: LANG=EN

USD_AUTODEF

(Optional) Controls whether CAISDI/els automatically defines contacts and assets if they are not already defined.

Default: USD_AUTODEF=YES

Consider the following example: 

//DEFINE   JOB  '1234','Systems',CLASS=A
//CASDIELS EXEC PGM=CSDECNTL
//STEPLIB  DD  DSN=CAI.CAW0LOAD,DISP=SHR    
//SYSPRINT DD  SYSOUT=*    
//REPORT   DD  SYSOUT=*
//SYSIN    DD  *
DEFINE PRODUCT=CA-1,EVENTLIB=cai.caievent,PRODCNTL=al0cntl,MASK=l0*
DEFINE PRODUCT=ALLOCATE,EVENTLIB=casisd.eventlib,PRODCNTL=xfgcntl,MASK=xf*