|
|
|
The following CAISDI/med PRODUCT and EVENT initialization statements define the interaction between CAISDI and CA View to generate CA Service Desk tickets for CA View abends:
/*==================================================================*/
/* Unicenter CA-View Product Interface Definitions */
/* */
/* Define Unicenter CA-View product ABEND events that are to be */
/* captured by CAISDI/med, and how that information is to be */
/* presented in the request ticket to CA Service Desk. */
/* */
/* Required customization: */
/* */
/* SERVER CAISDI/med name for Service Desk Server */
/* */
/* */
/* NOTE: Sample values for AFFECTED_END_USER, REPORTED_BY, */
/* ASSIGNEE, and TEMPLATE are valid, provided the */
/* CA Service Desk Administrator loads predefined */
/* templates and contacts. Otherwise, customize these */
/* parameters as directed by the Unicenter Service */
/* Desk Administrator. */
/* */
/*==================================================================*/
PRODUCT CA-VIEW, /* Product name */+
EVENT=ABEND, /* Event qualifier */+
JOBNAME=SAR*, /* Product JOB names */+
AFFECTED_END_USER=System_View_User, /* Affected End User */+
REPORTED_BY=System_View_User, /* Reported by for tickets */+
ASSIGNEE=System_View_User, /* Assigned contact name */+
PRIORITY=3, /* Priority for tickets */+
/* TEMPLATE='CA-View,Priority unassigned', /* template name */+
SERVER=USDSRV01 /* Direct requests to this server */
EVENT ABEND, /* Capture ABEND events */+
PRODUCT=CA-VIEW, /* Associated Product */+
COMPONENT='VIEW SAR*', /*Unicenter CA-View component*/+
JOBNAME=SAR*, /* Product JOB names */+
EXCLUDE=((0522,),(X'522',)) /* Ignore session time-outs */
This example shows how the PRODUCT and EVENT statements are used to activate the capture of abend events for CA View. These statements also define the CA Service Desk attributes to be associated with the tickets that are opened as a result of the abend event.
The PRODUCT statement defines the product, in this case CA View.
The JOBNAME parameter defines the jobname(s) to which this product statement applies. In the preceding sample, all jobs beginning with 'SAR*' would qualify for the processes defined for this product statement.
The EVENT parameter indicates that the events associated with this PRODUCT definition are abend events.
The SERVER parameter refers to the SERVER statement that defines the CA Service Desk server that is to receive tickets associated with this product definition.
The remaining parameters identify CA Service Desk entities that are assigned to any generated tickets. These entities should be predefined by the CA Service Desk administrator on the target CA Service Desk server.
The most important predefined entity is the CA Service Desk TEMPLATE name. The proper use of predefined CA Service Desk templates ensure that tickets generated by CAISDI/med on behalf of CA View are properly categorized, prioritized, and assigned.
The AFFECTED_END_USER parameter is used to define the contact name that appears in the Affected End User field of the ticket.
The REPORTED_BY parameter is used to define the contact name that appears in the Reported By field of the ticket.
The PRIORITY parameter defines the priority of the ticket.
The ASSIGNEE parameter is used to define the contact name that appears in the Assignee field of the ticket.
The EVENT statement contains the crucial COMPONENT operand that is used to match this event statement with the actual event. This is set to a value of 'VIEW SAR*' for CA View. This operand must be entered exactly as it is coded in this example.
Note: The space between VIEW and SAR in the parameter definition is significant.
CA View recovery routines will place the character string 'VIEW SAR' in the SDWACID field for all CA View abend events. This COMPONENT specification indicates that CAISDI/med abend event intercept should capture any detected abend event where the concatenation of the SDWACID and SDWASC fields begins with the characters VIEW SAR' The asterisk (*) in the sample initialization statement is a wild card and indicates that any subsequent characters are considered a match condition.
The EXCLUDE parameter of the EVENT statement lists abend/reason code combinations for CA View that should be ignored for problem reporting. (In the sample the S522 abends are eliminated because they are normal in CA View for XMS session time-outs.)
The JOBNAME parameter of the EVENT statement defines the job where the abend event may occur. In the sample, 'SAR*' is coded so that all intercepted abends are processed by this EVENT statement in CA View jobs such as SARSTC and SARDBASE. The JOBNAME parameter can be used to restrict the event to a specific JOB, or masked to handle a range of jobs. The JOBNAME parameter is also useful if multiple copies of CA View are operating in a single z/OS operating system image. In this situation, separate JOBNAME parameters can direct and categorize CA Service Desk tickets from each CA View address space.
The PRODUCT parameter on the EVENT statement defines the CAISDI/med product associated with the abend events captured. It is this PRODUCT name specification that makes the connection back to the CAISDI/med PRODUCT initialization statement.
For detailed information on these parameters, see Running CAISDI.
| Copyright © 2012 CA. All rights reserved. | Tell Technical Publications how we can improve this information |