Ijjas István - Kiss Guba Ferenc - Molnár Tibor: Mezőgazdasági vízépítés (Tankönyvkiadó, Budapest, 1981)
Bevezető
Az IPSP dokumentálását az OVH elnökének 5/1978. (V.É.G.) OVH számú utasitása alapján végezzük, az utasításban foglaltaknak a feladat jellegének megfelelő alkalmazásával. Az IPSP programjainak dokumentációja három kötetből és mellékletekből áll. Az egyes kötetek a következők: Felhasználói dokumentáció, Üzemeltetési dokumentáció, Karbantartási és fejlesztési dokumentáció. A felhasználói dokumentáció a pr ogramot használó mérnökök, kutatók számára készül, ismerteti a programmal megoldott feladatot, az alkalmazott módszer lényegét, az adatok előkészítésének módját, a számítás eredményeit és felhasználásuk módját. Az üzemeltetési dokuementáció a program futtatását végző számítástechnikai szakemberek számára szükséges ismereteket foglalja össze. A számításhoz szükséges adatok adathordozóra vitelének módját és a program futtatásával kapcsolatos tudnivalókat tartalmazza. Ebben az anyagban a programok felhasználói dokumentációját teljes részletességgel közöljük, az üzemeltetési dokumentációt lerövidítve adjuk közre, a karbantartási és, fejlesztési dokumentációval nem foglalkozunk. A karbantartási és fejlesztési dokumentáció azoknak a vízépítő mérnököknek és számítástechnikai szakembereknek (lehetőleg egyszemélyben) készül, akik a programban a későbbiekben módosításokat fognak végezni, illetve a program működését meghatározott időszakonként ellenőrzik. A programban végrehajtott kisebb módosításokat tekintjük karbantartásnak: pld. bemeneti és kimeneti egységek változásának megfelelő módosítások elvégzése, a programban szereplő állandók módosítása, a nyomtatási, vagy beolvastatási formátumok megváltoztatása, a megoldható feladat méreteinek növelése stb. Az üzemeltetési dokumentáció feltételezi azt, hogy a futtatásokat végző számítóközpont szakmai és számítástechnikai tanácsadást is végez, ezért a hibajelzéseket ez a dokumentáció tárgyalja. Ha a hibák okát a felhasználónak kell elemeznie, akkor az üzemeltetési dokumentációt is tanulmányoznia kell. Kérjük a felhasználókat, hogy az IPSP-vel kapcsolatos észrevételeiket juttassák el Intézetünkhöz, hogy ezeket a programok és szubrutinok karbantartásakor, vagy fejlesztésekor a továbbiakban felhasználhassuk. Az IPSP programjainak és szubritinjainak dokumentációja 18