Verifying NGL installation with NGLIVP

(BMC.AMIOPS.SPE2204)

The installation verification program (IVP) for Next Generation Logger (NGL) provides a mechanism to verify whether you have successfully installed and configured the NGL component and the connection of the products that use NGL. You can also use the IVP after applying your product maintenance to verify whether maintenance was applied successfully.

The IVP includes the following members:

  • $IVPNGL—contains the IVP batch job JCL
  • NGLCREAT—contains the REXX EXEC program to find the DBCENV data set and create temp data sets to hold the JESMSGs of the DBC
  • NGLINST—contains the REXX EXEC program to find the $420INF and $490TRIG jobs in the held queue and report on findings
  • NGLCTL—contains the control member to specify parameters for the IVP job
  • NGLIVP—contains the main REXX EXEC program

The IVP members are located in the NGLSAMP library. If you perform a target SMP/E install, the members are located in the XXSAMP library. Make sure that you modify the IVP batch job JCL accordingly.

To verify installation

The following tasks describe how to run the NGLIVP and test its results:

Task 1: To run the NGLIVP

Important

Before running the $IVPNGL batch job, make sure that you update the NGLCTL control member. The control member contains parameters that are required to identify an active job and its output. The instructions for updating the NGLCTL control member are contained in the member. 

  1. Update the NGLCTL control member.
    The following figure displays a sample control member:

    *** =====================================================================   
    ***   NGLCTL - IVP COMPONENTS NGL INFRASTRUCTURE                            
    *** =====================================================================   
    ***                                                                         
    *** NGL IVP CONTROL MEMBER                                                  
    ***                                                                         
    *** COMPONENT-BEGIN (REQUIRED): VALUE CAN BE ANYTHING                       
    ***  SIGNALS START OF PARAMETERS DESCRIPTIVE ONLY: NO AFFECT ON REPORT      
    ***                                                                         
    *** JOB (REQUIRED): STARTED TASK NAME OF THE DBC SUBSYSTEM                                        
    ***                                                                         
    *** COMPONENT-DESC (REQUIRED):  VALUE CAN BE ANYTHING                       
    ***                 DESCRIPTIVE ONLY: NO AFFECT ON REPORT                   
    ***                                                                         
    *** SEARCHTYPE (REQUIRED):                                                  
    ***     ** WHEN HOLD IS USED; PROVIDE INSTL_PRFX     **                     
    ***             ACTIVE - ACTIVE DBC                                         
    ***             HOLD   - DBC OUTPUT                                         
    ***                                                                         
    *** INSTL_PRFX (OPTIONAL):                                                  
    ***     ** INSTALL JOB NAME PREFIX                   **                     
    ***     ** WHEN USED; PROVIDE SEARCHTYPE=HOLD        **                     
    ***     ** USE WHEN DBC STARTUP FAILS OR IS DOWN     **                     
    ***     ** CORRECT VALUES ARE EITHER DFLT OR 5 CHAR  **                     
    ***     ** CUSTOMIZED JOBNAME PREFIX.                **                     
    ***     ** THIS PARM WILL REVIEW $420INF AND $490TRIG**                     
    ***     ** EXAMPLE INSTL_PRFX=DFLT                   **                     
    ***                                                                         
    *** DSN_PROVIDED (OPTIONAL):                                                
    ***     ** USE WHEN YOU HAVE THE DBC OUTPUT IN A DATASET **                 
    ***             USE OUTPUT DATASET NAME OR                                  
    ***               ENSURE IT'S BLANK WHEN NOT PROVIDING A DSN                
    ***                                                                         
    *** JESMSG_PRF (REQUIRED):                                                  
    ***     ** PROVIDE HLQ FOR DATASETS CREATED WHILE JOB IS RUNNING **         
    ***     ** THE DATASETS WILL BE DELETED AT THE END OF THE JOB   **          
    ***          IE. XXXXX.XXXXX 2 NODES NOT REQUIRED.                          
    ***                                                                 
    *** STORCLASS, DATACLASS, MGMTCLASS (REQUIRED):                     
    ***         ADD VALUES THAT YOU USE, LEAVE REST BLANK               
    ***                                                                 
    *** COMPONENT-END (REQUIRED):  MUST BE PRESENT                      
    ***  SIGNALS END OF PARAMETERS DESCRIPTIVE ONLY: NO AFFECT ON REPORT
    ***                                                                 
    COMPONENT-BEGIN=NGL IVP REPORT                                      
    JOB=XXXXXXXX                                                        
    COMPONENT-DESC=VERIFY NGL INSTALL  
    SEARCHTYPE=ACTIVE                                                   
    INSTL_PRFX=                                                         
    DSN_PROVIDED=                                                       
    JESMSG_PRF=XXXXXXXX                                                 
    STORCLASS=                                                          
    DATACLASS=                                                          
    MGMTCLASS=                                                          
    COMPONENT-END

    The parameters mentioned in the sample member are listed in the following table:

    Parameter

    Description

    COMPONENT-BEGIN

    (Required) This statement marks the beginning of the parameters.

    JOB

    (Required) Specify the started task name of the DBC subsystem.

    COMPONENT-DESC

    (Required) This statement describes your job.

    SEARCHTYPE

    (Required) This parameter includes one of the following values:

    • ACTIVE—if the DBC subsystem is active
    • HOLD—if the DBC subsystem is inactive
      The job output is in the output queue.

    INSTL_PRFX

    Specify either DFLT or the first five characters used on the job cards in the install jobs.

    This parameter is required only if the SEARCHTYPE parameter value is set to HOLD.

    When SEARCHTYPE=HOLD, specify one of the following values:

    • DFLT—the default job prefix, such as $420
    • The initial five characters of a customized install job name

    DSN_PROVIDED

    (Optional) To scan a data set that has the output of the DBC started task, specify the data set name.

    JESMSG_PRF

    (Required) Specify a high-level qualifier (HLQ) of the data sets to be created during the NGLIVP job processing.

    These data sets are deleted at the end of the job processing.

    STORCLASS

    DATACLASS

    MGMTCLASS

    (Required) Specify your storage information.

    COMPONENT-END

    (Required) This statement marks the end of the parameters.

  2. In $IVPNGL, update the following information:
    1. Job card that conforms to your environment
    2. Specify the &Install hlq that you used for your install

    3. Update the EXEC statement with your &Install hlqThe following figure displays a sample JCL:

      //$IVPNGL  JOB (9999),'NGLIVP',CLASS=A,MSGLEVEL=(1,1),                
      // MSGCLASS=X,REGION=0M,NOTIFY=&SYSUID OUTLIM=99999                   
      //*** ----------------------------------------------------------      
      //***                                                                 
      //*** NGLIVP: BEFORE RUNNING IVP PERFORM THE FOLLOWING:               
      //***        - UPDATE &INSTALL BELOW HLQ OF NGLSAMP LIB FROM INSTALL  
      //***        - UPDATE NGLCTL PARMS                                    
      //***        - UPDATE EX STATEMENT BELOW  &INSTALL HLQ NGLSAMP LIB    
      //***        - RUN JOB                                                
      //***                                                                 
      //*** ----------------------------------------------------------      
      //NGLIVP PROC                                                         
      //IKJEFT1B EXEC PGM=IKJEFT1B,REGION=4096K                             
      //SYSPRINT DD SYSOUT=*                                                
      //SYSTSPRT DD SYSOUT=X                                                
      //IVPCNTL DD DISP=SHR,DSN=&INSTALL.NGLSAMP(NGLCTL)                    
      //SYSTSIN DD *                                                        
      EX '&INSTALL.NGLSAMP(NGLIVP)' 'IVP'                                   
      /*                                                                    
      //   PEND                                                             
      //RUNIVP  EXEC NGLIVP                                       
  3. Submit the $IVPNGL job.

Task 2: To check the results of the NGLIVP

The results of NGLIVP are provided in the SYSTSPRT DD statement.

The following figure displays a sample output illustrating that NGL was successfully installed:

********************     NGL  IVP  REPORT    ********************               
*****   ISSUE REPORT    *****                                                   
NO ISSUE MESSAGES                                                               
*****   WARNING REPORT    *****                                                 
NO WARNING MESSAGES                                                             
*****   ERROR REPORT    *****                                                   
NO ERROR MESSAGES                                                               
*****   SUCCESS REPORT    *****                                                 
***> DBCENV DD CARD IS PRESENT IN JCL                                           
DBC USING SSID D3AJ VERSION 11.1.00 STATUS COMPLETE                             
NGLID=MVLR IS USING PARMLIB  LOGS=MVINF2.MV63D.MV63DDBC.UBMCPARM                
MVI/NGL INITIALIZATION COMPLETE                                                
MVL AGENT= BBM9ZLNG  HAS SUCCESSFULLY STARTED                                   
*** NGL SUCCESS PIIDS ***                                                       
PIID VERSION  PTF LVL  AGENTS                                                    
MVI1 V10.4.00 BQU3702 NGL9SAGT NGL9SAGT NGL9SAGT NGL9EOTA NGL9AGNT STARTED     
DOM1 V10.4.00 BQU3702 NGL9SAGT NGL9SAGT NGL9SAGT NGL9EOTA NGL9AGNT STARTED     
MVJ1 V10.4.00 BQU3702 NGL9SAGT NGL9SAGT NGL9SAGT NGL9EOTA NGL9AGNT STARTED     
IDC0550I ENTRY (A) MVSTXC.MV63DDBC.ESAJ.JESOUT DELETED                          
READY 

The following table describes the various elements of the IVP report:

IVP Report

Description

SUCCESS REPORT

In this report, the following messages are displayed:

  • Current version of DBC
  • DBCENV DD card in the JCL
  • SSID and completion of DBC initialization
  • Logger PIID and the PARM data set name
  • Logger initialization completion
  • Logger agent started successfully 
  • List of successful NGL PIIDs, versions, PTFs, and agents

WARNING REPORT

In this report, all the warning messages are listed.

ERROR REPORT

In this report, all the error messages are listed.

In the following example, in the ERROR REPORT section, a message is displayed describing a problem with an agent that could not start:

Click here to expand...
********************     NGL  IVP  REPORT    ********************               
*****   ISSUE REPORT    *****                                                   
NO ISSUE MESSAGES                                                               
*****   WARNING REPORT    *****                                                 
 09.20.56 S0227314  BMCNGL59277W NGL0REGA - //REGISTRY DD NOT FOUND. CONTINUE WITH NEW, EMPTY VLDS:
*****   ERROR REPORT    *****                                                   
 09.21.10 S0227314  BMCDBC0126I 09.21.10 D32B AGENT='DOM.ZDOM000(DOMSMAIN)' TASKID(0001) TCB(0X8A93B8) JSTCB(YES) IS STOPPED
 09.22.02 S0227314  BMCDBC0255E D32B PRODUCT GUD.ZGUD100 AGENT GUDDADDL TASKID(0001) HAS FAILED WITH ERROR 0X000C
*****   SUCCESS REPORT    *****                                                 
***> DBCENV DD CARD IS PRESENT IN JCL                                           
DBC USING SSID D32B VERSION 11.1.00 STATUS COMPLETE                             
NGLID=MVLR IS USING PARMLIB  LOGS=MVINF2.MV63T.DBC.UBBPARM                      
MVI/NGL INITIALIZATION COMPLETE                                                
MVL AGENT= BBM9ZLNG  HAS SUCCESSFULLY STARTED                                   
*** NGL SUCCESS PIIDS ***                                                       
PIID VERSION  PTF LVL  AGENTS                                                   
DOM1 V10.4.00 BQU3702 NGL9SAGT NGL9SAGT NGL9SAGT NGL9EOTA NGL9AGNT STARTED      
MVLR V10.4.00 BQU3702 NGL9SAGT NGL9SAGT NGL9SAGT NGL9EOTA NGL9AGNT STARTED      
IDC0550I ENTRY (A) MVSTXC.MV63TDBC.DB2B.JESOUT DELETED                          
READY                                                                           
END                                     

If you see such errors, only products that are impacted are referenced in the error messages; all other products are running properly.

ISSUE REPORT

Displays the message only if the following conditions exist:

  • The DBCENV DD is missing for the current version of the DBC
  • The DBC SSID or the NGL PIID that the Logger used are different from the ones that the DBC agent uses.


Related topic

Administering-Next-Generation-Logger-NGL

                

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*