Skip to main content

IBM Systems  >   System z  >   z/VM  >  

Quick Test After Installing Service

Last Updated: 2001-03-18     (Subscribe to updates)

The test instructions in appendix A.1, A.2, and A.3 of the DirMaint 1.5.0 program directory are specifically designed to systematically test the functions of the DirMaint product in a sequence such that the point of failure, if any, isolates the cause and identifies the necessary corrective action. After a period of production, there is small likelihood that this procedure will encounter any problem, and is unnecessarily involved for routine regression testing.

This procedure provides an easier alternative. If the test is successful, testing is complete. If the test fails, there is no indication of the cause; return to and follow the more detailed steps to isolate the cause and identify the solution.

  1. Switch the DirMaint service machines from using the production code to use the code to be tested.

    Create a PROD2TST DVHBATCH file, for example, containing the following commands:

    OFFLINE
    DATAMOVE SHUTDOWN
    SATELLITE SHUTDOWN
    FOR DATAMOV* LINK P748XE4M 491 191 DELETE
    FOR DATAMOV* LINK P748XE4M 11F 11F DELETE
    FOR DATAMOV* LINK P748XE4M 492 192 DELETE
    FOR DATAMOV* LINK P748XE4M 41F 21F DELETE
    FOR DIRMSAT* LINK P748XE4M 491 191 DELETE
    FOR DIRMSAT* LINK P748XE4M 11F 11F DELETE
    FOR DIRMSAT* LINK P748XE4M 492 192 DELETE
    FOR DIRMSAT* LINK P748XE4M 41F 21F DELETE
    FOR DIRMAINT LINK P748XE4M 491 191 DELETE
    FOR DIRMAINT LINK P748XE4M 11F 11F DELETE
    FOR DIRMAINT LINK P748XE4M 492 192 DELETE
    FOR DIRMAINT LINK P748XE4M 41F 21F DELETE
    FOR DATAMOV* LINK P748XE4M 492 191 RR
    FOR DATAMOV* LINK P748XE4M 41F 11F RR
    FOR DATAMOV* LINK P748XE4M 491 192 RR
    FOR DATAMOV* LINK P748XE4M 11F 21F RR
    FOR DIRMSAT* LINK P748XE4M 492 191 RR
    FOR DIRMSAT* LINK P748XE4M 41F 11F RR
    FOR DIRMSAT* LINK P748XE4M 491 192 RR
    FOR DIRMSAT* LINK P748XE4M 11F 21F RR
    FOR DIRMAINT LINK P748XE4M 492 191 MR
    FOR DIRMAINT LINK P748XE4M 41F 11F MR
    FOR DIRMAINT LINK P748XE4M 491 192 MR
    FOR DIRMAINT LINK P748XE4M 11F 21F MR
    FOR DATAMOV* REVIEW NOPROF
    FOR DIRMSAT* REVIEW NOPROF
    FOR DIRMAINT REVIEW NOPROF
    CP MSG your_id PROD2TST is done!
    

  2. Submit this batch job to the DIRMAINT server using the following commands:
    DIRM BATCH PROD2TST DVHBATCH
    
  3. When the job has completed successfully, and you have reviewed the returned reader files verifying the LINK statements are correct, issue:
    DIRM DIRECT
    DIRM SHUTDOWN
    
  4. Then issue the following commands:
    CP XAUTOLOG DIRMAINT
    CP SLEEP 1 MIN
    CP XAUTOLOG DIRMSAT
    CP XAUTOLOG DATAMOVE
    
  5. Run a test that exploits most of DirMaint's critical code paths.

    Issue the following commands:

    DIRM ONLINE
    DIRM FOR any_id AMDISK 555 3390 AUTOG 1 groupname M
    
    You may substitute other values for the virtual address, device type, size, or groupname; as appropriate for your installation. This tests the communication paths between the originating user and the DIRMAINT server, the parser, message handler, and the path between DIRMAINT and the DIRMSAT servers, if any.

  6. Reverse the previous step by issuing the following command:
    DIRM FOR any_id DMDISK 555 CLEAN
    
    This retests the same paths as the previous step, and adds the communication paths between DIRMAINT and the DATAMOVE server, and from DATAMOVE back to DIRMAINT.
  7. Switch the DirMaint service machines from using the test code back to use the production code to be tested.

    Create a TST2PROD DVHBATCH file, for example, containing the following commands:

    OFFLINE
    DATAMOVE SHUTDOWN
    SATELLITE SHUTDOWN
    FOR DATAMOV* LINK P748XE4M 492 191 DELETE
    FOR DATAMOV* LINK P748XE4M 41F 11F DELETE
    FOR DATAMOV* LINK P748XE4M 491 192 DELETE
    FOR DATAMOV* LINK P748XE4M 11F 21F DELETE
    FOR DIRMSAT* LINK P748XE4M 492 191 DELETE
    FOR DIRMSAT* LINK P748XE4M 41F 11F DELETE
    FOR DIRMSAT* LINK P748XE4M 491 192 DELETE
    FOR DIRMSAT* LINK P748XE4M 11F 21F DELETE
    FOR DIRMAINT LINK P748XE4M 492 191 DELETE
    FOR DIRMAINT LINK P748XE4M 41F 11F DELETE
    FOR DIRMAINT LINK P748XE4M 491 192 DELETE
    FOR DIRMAINT LINK P748XE4M 11F 21F DELETE
    FOR DATAMOV* LINK P748XE4M 491 191 RR
    FOR DATAMOV* LINK P748XE4M 11F 11F RR
    FOR DATAMOV* LINK P748XE4M 492 192 RR
    FOR DATAMOV* LINK P748XE4M 41F 21F RR
    FOR DIRMSAT* LINK P748XE4M 491 191 RR
    FOR DIRMSAT* LINK P748XE4M 11F 11F RR
    FOR DIRMSAT* LINK P748XE4M 492 192 RR
    FOR DIRMSAT* LINK P748XE4M 41F 21F RR
    FOR DIRMAINT LINK P748XE4M 491 191 MR
    FOR DIRMAINT LINK P748XE4M 11F 11F MR
    FOR DIRMAINT LINK P748XE4M 492 192 MR
    FOR DIRMAINT LINK P748XE4M 41F 21F MR
    FOR DATAMOV* REVIEW NOPROF
    FOR DIRMSAT* REVIEW NOPROF
    FOR DIRMAINT REVIEW NOPROF
    CP MSG your_id TST2PROD is done!
    

  8. Submit this batch job to the DIRMAINT server by issuing the following command:
    DIRM BATCH TST2PROD DVHBATCH
    
  9. When the job has completed successfully, and you have reviewed the returned reader files verifying the LINK statements are correct, issue the following commands:
    DIRM DIRECT
    DIRM ONLINE
    DIRM SHUTDOWN
    
  10. While the DirMaint servers are down, logon to the P748XE4M user ID and issue the following commands:
    ACCESS 492 J
    IN2PROD PROD
    LOGOFF
    
    This will copy files from the test build disks to the production build disks.
  11. Logon to the MAINT user ID and issue the following commands:
    CP XAUTOLOG DIRMAINT
    CP SLEEP 1 MIN
    CP XAUTOLOG DIRMSAT
    CP XAUTOLOG DATAMOVE
    DIRM ONLINE
    
    DirMaint will now be running latest service in your production environment.


If you'd like to contact DirMaint development and support, you can

Thank you for visiting this web page. Please visit again next month and check out the latest news. (Or, subscribe to future updates.)