Example 1: creating a Rule with MLSEG Minor = ALL

In this example, an IMS MLSEG message is processed by the Rule as a complete entity because MLWTO Minor ===> ALL is specified on the Selection Criteria panel.

The Rule in this example uses the Variable Dependencies panel and the variables &LINEx_WORDn. The Rule fires based on content within the MLSEG such as the message ID of the major segment, the job name, and some additional information in the third minor segment of the message.

When all of the selection and variable dependency criteria is met, this example Rule creates an ALERT with the appropriate text.

The IMS MLSEG message is DFS2503W:

M 09048 13:49:03.44 STC06054 00000090  DFS2503W DYNAMIC ALLOCATION   FAILED FOR 97
D                        978 00000090  (DFS2503W) DATASET NAME AAO.IMS111.DE2PCUST
E                        978 00000090  (DFS2503W) DATABASE BE2PCUST REASON CODE 1708
  1. Fill in the Selection Criteria - IMS panel as follows:
    BMC Software  ------------- Selection Criteria - IMS  ------------ AutoOPERATOR
     COMMAND ===>                                                 TGT  --- NS7A     
                                                                                    
            Rule-set === AAORUL01             Rule-id  === DFS2503W                 
                                                                                    
     Text Description:                                                              
     Text ID     ===> DFS2503W                          First word of message       
     Text String (Enter Below):                                                     
                                                                                    
                                                                                    
     Issuer Identification:                                                         
     Job name    ===> IMS11PRD                          Jobname of IMS              
     Type        ===>                                   (JOB, STC, or TSO)          
     Jobclass    ===>                                   Job class of issuer         
     Acct Info   ===>                                   Job accounting information  
     RACF User   ===>                                   RACF Userid                 
     RACF Group  ===>                                   RACF Group name 
     MLSEG Minor ===> ALL                               All/Single   
    
    
     Press ENTER to continue, END return to Detail Control, CANCEL to cancel changes

    When MLSEG Minor ===> ALL is specified all the lines of IMS multisegment message are processed by the Rule as a single entity. BMC Software recommends that you use the variables &LINEx_WORDn on the Variable Dependencies panel so that the Rule can fire based on specific content of the MLSEG.

    Note

    When creating a Rule for an IMS MLSEG message, the Rule compares the selection criteria values to the content of only the first (major) segment of the MLSEG.

    With the &LINEx_WORDn variables, x is set for every segment of the MLSEG and n is set for every word in a segment.

  2. Press Enter; the Variable Dependencies - IMS panel is displayed as shown in the following figure.

    Figure 1. Variable Dependencies for MLSEG Minor=ALL

    BMC Software  ------------ Variable Dependencies - IMS  ---------- AutoOPERATOR
    COMMAND ===>                                                 TGT  --- NS7A     
                                                                                   
           Rule-set === AAORUL01             Rule-id  === DFS2503W                 
                                                                               OR/ 
     Variable-name                    Op  Variable-Value                      AND  
                                                                                   
     LINE3_WORD3:1:4_________________ EQ  BE2P_______________________________  AND 
     LINE3_WORD6_____________________ EQ  1708_______________________________  AND 
     LINE2_WORD4_____________________ EQ  AAO*_______________________________  ___ 
     ________________________________ __  ___________________________________  ___ 
     ________________________________ __  ___________________________________  ___ 
     ________________________________ __  ___________________________________  ___ 
     ________________________________ __  ___________________________________  ___ 
     ________________________________ __  ___________________________________  ___ 
     ________________________________ __  ___________________________________  ___ 
     ________________________________ __  ___________________________________  ___ 
     ________________________________ __  ___________________________________  ___ 
     ________________________________ __  ___________________________________  ___ 
     ________________________________ __  ___________________________________      
                                                                                    
     --> ATTENTION: Use ASV command to add ASV criteria to the rule <--             
                                                                                    
     Press ENTER to continue, END return to Detail Control, CANCEL to cancel changes

    When you specify variable &LINE3_WORD3:1:4, the Rule Processor checks the value of the first four characters of the third word, in segment three of the IMS MLSEG message. If this value resolves to characters BE2P, and if the sixth word of the same segment (&LINE3_WORD6) resolves to 1708, and the value of the fourth word of the second segment starts with 'AAO', the Rule fires.

  3. Press Enter until the Alert Action(s) I - IMS panel is displayed as shown in the following figure.

    The following entry on the Alert Action(s) II - IMS panel specifies that when the Rule fires, a MainView AutoOPERATOR ALERT will be created.

    Figure 2. Alert Action(s) I - IMS for MLSEG Minor=ALL

    BMC Software -------------- Alert Action(s) I - IMS  ------------- AutoOPERATOR
    COMMAND ===>                                                 TGT  --- NS7A     
           Rule-set === AAORUL01             Rule-id  === DFS2503W                 
    Function ===> ADD                               (ADD, DELETE, DELETEQ)         
    Key      ===> PROD&IMFOJOB                                                                 
    Text     ===> PRODUCTION IMS &IMFOJOB - ALLOCATION FAILED FOR DATASET: &LINE2_
    WORD4, DATABASE: &LINE3_WORD3                                                 
                                                                                   
    Queues   ===> PRODQUE                           Alert Queue Name(s)            
    Priority ===> WARN                              (CRIT,MAJ,MIN,WARN,INFO,CLEAR) 
    Color    ===>                                   RED,PINK,YEL,DKBL,LTBL,GRE,WHI 
    PCMD     ===>                                                                  
                                                                                   
    System   ===>                                   Return to target after PCMD    
    * Exec   ===>                                   Follow-up EXEC                 
    Help     ===>                                   Associated HELP Panel          
    Targets  ===>                                   Target System                  
    Udata    ===>                                   User Data                      
    Origin   ===>                                   Origin                         
    User     ===>                                   Userid                         
    Alarm    ===>                                   Sound Alarm (YES/NO)           
    Publish  ===>                                   Alert Publishing Mode          
    * Enter a question mark(?) and blank for more options.                         
     Press ENTER to continue, END return to Detail Control, CANCEL to cancel change
  4. Press Enter and finish completing the Rule.

Was this page helpful? Yes No Submitting... Thank you

Comments