IVP sample application

The IVP sample application is a simple telephone book application, also known as the phonebook application, that sends a transaction to request information from the IMS Telephone database.

The IVP phonebook application is demonstrated through the H series jobs and tasks of the IVP. After you complete the IVP jobs and tasks during the execution phase, the IVP sample application is fully executed, and the testing of the IMS components associated with the IVP sample application is complete. You can query the database to retrieve customer information such as first name, last name, telephone extension, and zip code. The Telephone database is loaded during the processing of the IVP jobs and tasks.

The functions and features that are tested by running the IVP sample application include several IMS databases and environments.

The tested IMS databases consist of HIDAM/OSAM, HDAM/VSAM, DEDB/VSAM, MSDB, and GSAM databases.
The tested IMS environments include non-conversational and conversational MPP, conversational JMP, non-conversational IFP (EMH), DB batch, DLI batch, BMP, JBP, message-driven WFI BMP, non-conversational and conversational message switch, IFP EMH message switch, WFI BMP GSAM, and BMP GSAM.

The IVP application program action is determined by a process code provided with the input data. The process codes are ADD, DELETE, UPDATE, DISPLAY, and TADD. Except for TADD, the process codes are self-explanatory. TADD causes the application program to add a record to the database and issue a WTOR request. Any character string could be used to reply to the WTOR issued by the TADD process. The database is changed, but the change is not committed. The TADD process code is used during the recovery portions of the IVP scripts.

For the EMH program that accesses the main storage database (MSDB), a TUPD process code is used instead of the TADD.

The online transactions are executed through an MFS block. For example, the DFSIVP1 program is executed by entering /FOR IVTNO at an IMS user terminal, and then entering a process code and data on the formatted screen.

When processing for the DFSIVP1 program is finished, press the Clear key and enter a new FORMAT command to execute a different application program.

The batch or BMP programs execute by using JCL. In the DCCTL environment, the IVP database is simulated through the use of a data area within program DFSIVAD (a message-driven WFI BMP). Programs DFSIVAE, DFSIVAF, and DFSIVAG perform message switches to send their transaction input to DFSIVAD for processing. DFSIVAD processes its input under the control of extended checkpoint/restart and returns its output to the originating terminal.

Two series of programs are included with the IVP sample application: The DFSIVA3 series and the DFSIVA6 series. The DFSIVA3 series programs test IMS components online. The DFSIVA6 series programs are executed through a batch process using JCL. These programs are provided in several different programming languages. The IVP assembles and tests several of these programs. If you do not want to use the assembled version, you must compile and bind the IVP execution outside of the IVP.

The DFSIVA3 series programs constitute a conversational MPP that accesses an HDAM/VSAM database. The Telephone database is accessed and queried through transaction input and output using an MFS screen format. Instructions on how to use the MFS screen are included in the IVP tasks. To display or delete a record, only the process code and the last name field are required input. To add or replace a record, all input fields are required.

The following figure shows the MFS screen format for the IVP sample application.

Figure 1. MFS screen format for the IVP sample application

                **************************************************
                *     IMS INSTALLATION VERIFICATION PROCEDURE    *
                **************************************************
 
 
                                         TRANSACTION TYPE : NON-CONV (VSAM DB)
                                         DATE             : mm/dd/yyyy
 
           PROCESS  CODE  (*1) :  ////////
                                                            (*1) PROCESS CODE
           LAST  NAME          :  //////////                        ADD
                                                                    DELETE
           FIRST  NAME         :  //////////                        UPDATE
                                                                    DISPLAY
           EXTENSION  NUMBER   :  //////////                        TADD
 
           INTERNAL  ZIP CODE  :  ///////
                                 input  area
 
           ///////////////////////////////////////           SEGMENT# :  0001
                        message  area
 ///////////////////////////////////////////////////////////////////////////////
                             system  message  area

The DFSIVA6 series programs are batch or BMP programs that access an HIDAM/OSAM database. The programs use GSAM to receive their transaction input and to display their transaction output. Instructions on how to run these jobs are included in the IVP online help of the IVP jobs and tasks.