dl.maint - Data librarian maintenance
(Throughout this manual entry, dl denotes the prefix to the Data Library’s location as stored in $/sys/pdl/dl.dir).
This program performs five major functions in relation to the data librarian program:
maintenance of the card catalog (dl/lib/dl.data), the program subdirectory (dl/lib/prog/*), and the program description subdirectory (dl/lib/desc/*).
maintenance of the library shelves (dl/lib/dl.vars). A maximum of 16 shelves are allowed.
maintenance of index files (dl/lib/link/*) that contain the names of all programs in the Data Library that are related to one another (see subheading on LINK FILES).
configuration of certain “preference” settings, such as the assignment of a librarian other than the system administrator, requiring a minimum baud rate for Data Library access, guest caller access limits, the maximum number of downloads allowed per session, upload filesize limit, and freespace (volume overhead) limit.
moving “archived” programs to offline storage, freeing up disk space.
Options supported for file-oriented maintenance are:
Edit the record displayed on the screen.
Delete the record, program and description from the Data Library.
Find the record matching the program title entered. Using a “*” will instruct dl.maint to find all titles that are “on hold”.
Display the next record in the Data Library.
Display the previous record in the Data Library.
Exit the maintenance subroutine and return to the maintenance menu.
When the user downloads files placed on reserve the program will open the dl/lib/link/* file and search for any program/data files that are “related” to the selections placed on reserve. If related files are found the user will be given the option of including these “linked” files in the download.
For example, let’s assume that there is a program called EDITOR in the library that has associated documentation (EDITOR.DOCS) and will require the ShrinkIt program to “decompress” the program file. Since the user will need copies of EDITOR.DOCS and ShrinkIt to use the EDITOR program the librarian should add them to the dl/lib/link/* file using option #3 (Edit Link List) from the maintenance menu.
All information related to a record in the Data Library can be changed except for the program filename stored in the dl/lib/prog subdirectory. The program filename must remain unchanged in order for the link/support programs to work correctly!
All programs should be thoroughly tested before their status is changed from “on hold” to “available” so that pirated or non-working programs aren’t downloaded by users.
Even though a program has been “archived” (moved to offline storage) the card catalog entry will remain online. The entry must be deleted from the card catalog if you wish to remove all references to the program.
If you intend to access dl.maint via dialup (remote) your telecommunications program must support some type of terminal emulation mode.