Message Events

CA Service Desk Configuration › Configuring CA Technologies Products for CAISDI › CA Technologies Products That Support CA Service Desk Integration › CA Spool™ Enterprise Print Management › Message Events

Message Events

To create CA Service Desk tickets for product messages, CA Spool™ Enterprise Print Management uses CAISDI/med services to interface with the CAISDI/soap task to open CA Service Desk tickets that are based on a CA Spool™ Enterprise Print Management message id. To activate this, in the CA Spool™ Enterprise Print Management parameters add SDI=YES. You control which CA Spool™ Enterprise Print Management messages cause a CA Service Desk ticket to be opened by adding SDIREQ=YES to the MESSAGE statement for that message number. Optionally, for some or all of these messages, you can code EXIT=YES on the MESSAGE statement to invoke user exit ESFMSG0 before making the request to open a CA Service Desk ticket. With this exit, the text of the CA Service Desk ticket can be updated or the creation of a CA Service Desk ticket can be skipped completely.

In addition to the changes to the CA Spool™ Enterprise Print Management parameters and MESSAGE statements, a PRODUCT initialization statement must be added to the CAISDI parameters to define the interaction between CAISDI and CA Spool™ Enterprise Print Management to generate the CA Service Desk tickets for the selected messages. Here is a sample of the PRODUCT statements:

/*==================================================================*/
/* Unicenter CA-Spool Product Interface Definitions                 */
/*                                                                  */
/* Define Unicenter CA-Spool product ABEND and message events that  */
/* are to be captured by CAISDI/med, and how that information is    */
/* to be presented in the 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-SPOOL,                       /* Product name             */+
        EVENT=(%ESF886),                /* Event qualifier          */+
        AFFECTED_END_USER=System_Spool_User, /* Affected End User   */+
        REPORTED_BY=System_Spool_User,  /* Reported by for tickets  */+
        ASSIGNEE=System_Spool_User,     /* Assigned contact name    */+
        PRIORITY=2,                     /* Priority for tickets     */+
     /* TEMPLATE='CA-Spool,Priority unassigned', /* template name   */+
        SERVER=USDSRV01         /* Direct requests to this server   */

PRODUCT CA-SPOOL,                       /* Product name             */+
        EVENT=(ABEND,%ESF*),            /* Event qualifier          */+
        AFFECTED_END_USER=System_Spool_User, /* Affected End User   */+
        REPORTED_BY=System_Spool_User,  /* Reported by for tickets  */+
        ASSIGNEE=System_Spool_User,     /* Assigned contact name    */+
        PRIORITY=3,                     /* Priority for tickets     */+
     /* TEMPLATE='CA-Spool,Priority unassigned', /* template name   */+
        SERVER=USDSRV01         /* Direct requests to this server   */

This sample shows two PRODUCT statements that are used to activate the capture of message events for CA Spool™ Enterprise Print Management. The PRODUCT statement defines:

The product
The event
The name of the CAISDI/med server that processes this event
The CA Service Desk attributes to be associated with the tickets that are opened as a result of the message events.

If all of the CA Service Desk attributes are the same for the message events, then only one PRODUCT statement would be necessary. However, the severity of messages can vary, and this sample shows how you can open CA Service Desk tickets with different priorities for different messages.

The parameters define the names of predefined CA Service Desk specific entities that are assigned to any generated tickets. The CA Service Desk administrator predefines these named entities on the target CA Service Desk server. The PRIORITY parameter is the only one that is different in the two preceding PRODUCT definitions. You could also set different templates and end user for the different messages.

PRODUCT

Defines the events that are associated with this PRODUCT definition. The event ID associated with the messages produced by CA Spool™ Enterprise Print Management is composed of the command character followed by the message id. For example, the event ID for message ESF355 could be -ESF355. This sample contains two PRODUCT statements, the first for message ESF886 and the second for all other CA Spool™ Enterprise Print Management messages by using the event name of %ESF*.

EVENT: Indicates that the product events associated with this PRODUCT definition are abend events.
AFFECTED_END_USER: Defines the contact name that appears in the Affected End User field of the ticket.
REPORTED_BY: Defines the contact name that appears in the Reported By field of the ticket.
ASSIGNEE: Defines the contact name that appears in the Assignee field of the ticket.
PRIORITY: Defines the Priority of the ticket.
TEMPLATE: Defines the CA Service Desk TEMPLATE name. The proper use of predefined CA Service Desk templates ensures that tickets, generated by CAISDI/med on behalf CA Spool™ Enterprise Print Management, are properly categorized, prioritized, and assigned.
SERVER: Refers to the SERVER statement that defines the CA Service Desk server that receives tickets that are associated with this product definition.

More information:

CAISDI Command Reference