Specifying Progress Host Procedures

• Name. This is the host task name, which you can rename to something more meaningful (such as "HTGetOpenInvoices").

• Program. This is the name that you assign to the Progress source program (such as "MyProgram.p") which will be automatically generated by Jargon Writer.

• Common include. This is the name that you assign to a Progress include file (such as "MyProgram.i") which will be included in the generated source program at the "top" level (the outer or main procedure of the program), not within an internal procedure. This include file is where you can define variables, temp-tables, "new shared" objects, functions and internal procedures so that they are accessible to all other internal procedures in the program.

• Procedure. This is the name that you assign to the internal procedure (such as "MyProcedure1") to be run for this host task within the source program. Jargon Writer will generate this procedure automatically. It will contain variable definitions for each host parameter and logic to parse these parameters and populate these variables. Java table values are put into temp-tables which are defined at the program level, not the internal procedure level, because of Progress syntax rules.

• Include file. This is the name of a Progress include file which is included at the end of the internal procedure (such as "MyProcedure1.i"). This include file is where you write the business logic for this host task. The host task logic typically uses the input parameters to perform various calculations and database accesses, the results of which are sent back to the client in one or more instructions to display data values or otherwise change the state of client visual elements or variables. The logic in this include file might also run other ".p" procedures (possibly from legacy code) and might exchange information with these sub-programs via shared variables (the "old" way) or input/output parameters (the preferred approach).