Appendix A:  Comprehensive Examples

There are six examples presented in this section.  The examples consist of the same two applications written in three different languages (COBOL, C, and FORTRAN).  The programs are designed to demonstrate the calling of HLI procedures from a host language to ACCENT R.  The program comments indicate where the calls take place.  The calls are numbered in the order of their logical execution, not by their placement in the source listing.  The call numbers are referenced by the individual examples where each procedure is outlined (in a prior section of the manual).

The examples use a number of Data Sets from the sample BOOKS Data Base.  This sample DBL is included when ACCENT R is installed on your system.  Consult the ACCENT R Installation Guide for access instructions.  The programs assume that the BOOKS DBL is in the user directory and reference the Data Sets with the logical NISDEMO.  Users are assumed to have a working knowledge of ACCENT R.

The first application is used to enter sales orders.  New stores may be added.  Discounts are computed if applicable.  Year-to-date sales are updated.  This application uses 12 different HLI procedures--some of which are used more than once.  (Reference CALL's #1-12)

The second application deletes sales records.  It also lists the ACCENT R version being used and some information on the Sales Data Set.  This application uses six additional HLI procedures not called in the first application.  (Some HLI procedures calls are repeated from the first application. However, they are not referenced by call numbers here to avoid duplication.)  Some procedures are used more than once.  (Reference CALL's #13-18)

NOTE:  A COM file is used to build the application object code.  It also defines the logical names needed to run the application.  The application must be run in the same session as the .COM file.  Otherwise, the logical (NISDEMO in this case) and ACCHLI will need to be defined at the DCL command prompt before running the application.  The format of defining the logicals is the same as is shown in the .COM file.