Online documentation is defined as "Communication designed to be presented on VDT screens on order to ease interactions between computer software and the individuals who manage, audit, operate or maintain it" BRO1. "It allows people to instantly go to the screen without stopping what they were doing to go to a manual. It better serves the needs of users" MOR1.This paper sets out a way of interfacing on-line documentation with APL2 programs. It uses GDDM as the full-screen manager, and the text is stored in a VSAM file, although this is pure convenience and a BDAM file could be used by those sites where personnel are not trained in VSAM, or VSAM is not available.The HELP function is shown in the appendix together with the format of a HELP record from the file; these will show that the concept is beautifully simple. Feedback from staff in my organization has shown that this kind of on-line "HELP" facility has been most useful in assisting everybody from the rookie to the veteran to perform their tasks within the timescales laid down by the management team.
/lp/association-for-computing-machinery/an-on-line-help-facility-for-apl2-nYSSc5Y745