GENERAL PURPOSE SDI PROGRAM FOR USE WITH MICRO CDS/ISIS DATABASES. Program: NEWSDI.PCD Version 2.0, 1995 This README File explains the features of the Program caled NEWSDI which is used for the production of SDI outputs from Micro CDS/ISIS databases. The following files are being supplied: 1. SDIRUN.PAS 2. SDIRUN.PCD 3. NEWSDI.PCD 4. README.SDI These files are to be copied to the sub-directory where where ISIS Pascal programs under CDS/ISIS are stored. This is usually the subdirectory called PROG. Thus for instance, if a library has installed the Micro CDS/ISIS in a Directory called ISIS with subdirectories SYS, MENU, MSG, DATA and PROG, the above files supplied are to be copied to the \isis\prog subdirectory. This is accomplished as follows: Insert the diskette provided in the drive A. At the DOS C:\> prompt type cd isis. This will put you in the Directory where Micro CDS/ISIS is installed. You may now see the DOS prompt shown as C:\ISIS>. Now type cd PROG. This will put you in the PROG subdirectory. You may now see the DOS Prompt as c:\ISIS\PROG>. At this prompt type COPY a:*.* and press the Enter key. This will copy the files into the PROG subdirectory of the ISIS Directory. All enquiries about this program may be sent to: L.J.Haravu Sr. Manager, Library & Documentation Services, ICRISAT Patancheru Andhra Pradesh 502 324 India. e-mail: VHaravu@aol.com Version 2.0 of NEWSDI has added the following capabilities taking advantage of new features in ISIS Pacsal available with the release of version 3.07 of CDS/ISIS. 1. The program creates search expressions for Terms in the ANY file that may have been defined for a particular database. The resulting set numbers are stored in an array and recalled whenever there is a ANY term in a SDI User profile. This way the program does not need to execute an ANY term search each time it is encountered in SDI User Profiles. This has increased the speed of the program. 2. Wherever possible, String Arrays have been used to replace real arrays that were used in the first version. 3. The results of the execution of searches within User profiles is not displayed on the screen. Instead a Status Report appears giving information about which profile is being executed and the number of profiles already processed. Because of not displaying search sets while running, the program runs faster as compared to version 1.0 of the program. 4. The entry of SDI Service parameters, e.g., name of User Profile file; name of output file; are captured using a form instead of one by one as in version 1.0. The data entry form used allows the use of the key as in CDS/ISIS data entry worksheets to go to a previous field for re-entry of data. Also, data entered is validated. For instance, if the name of a profile file which is non-existing is entered the program will inform you of this condidtion. Display formats already defined for a database are shown on a pop-up window and the one needed for SDI output production can be selected using the arrow keys. THE PROGRAM ASSUMES THE FOLLOWING: 1. The name of the Organization, name of the library and the organizations address that provides the SDI service in a text file called INAME.DAT. This file can be created using any standard text editor and has 5 lines, one for the name of the instn., followed by the name of the library, acronym of the Institute and 2 lines for the address of the organization. If you use Wordstar to create this file please use it in the Non document mode. The file INAME.DAT should be stored in the ISIS root directory. An example of a file called INAME.DAT follows: International Crops Res. Inst. for the Semi-Arid Tropics Library and Documentation Services ICRISAT Patancheru, A.P. 502 324, India. The above names and address line will appear on each page of the SDI output to different profile holders. Each line of the above file is to be entered from Column 1 onwards. The name of the organization will be truncated at column 54 since the SDI outputs run into two identical columns. The name of the Instn. may use abbreviations if it is necessary to limit the length to 54 characters. 2. A SDI Users Profile file having the following structure: - The first line to contain a Profile ID. This is an alphanumeric field, and can contain any combination of numerals and letters to identify a given Users Profile. We suggest that you use simple serial numbers to identify profiles. A profile ID may be suffixed by the letter T to indicate Two-Column output to a given user. Two column output in which one of the columns is the feedback part of the output is useful to be provided to users until the profile is found to be fully satisfactory, i.e., until it meets the needs of a given user. Once the profile is found to be meeting needs, the Profile ID for the user may be changed to remove the suffix T. The SDI program then produces single column output to this user. (See also paragraph 4, below). - Line 2 to contain the name of the profile holder. - lines 3 to 5 to contain his mailing address. If the address requires only one or two lines, enter as many blank lines to fill up the required three lines for the mailing address. - Line six and onwards to contain search terms which could be any valid search term and/or search expression or combination using set numbers, e.g. #1*#2, #1 * soil moisture, (#1 + #2) * (#3 + #4). Search terms could also be truncated, e.g. comput$. If the inverted file of the database uses prefixes for fields (e.g. AU=Lancaster$), remember to use the prefixes in building user profiles. If the database has one or more ANY files, these could also be included in the search expression or term. There is no limit to the number of search terms in a profile. However, the program assumes that a profile will refer to a maximum of 99 sets using the '#set number' (e.g. #4 * #5), method of referring to previously created sets. - The last line of each User Profile should contain @@. The Users Profile file can be created using any standard text editor. Each line of the User Profile is to be entered from Column 1 and onwards. Do not give any line space between two profiles. As can be seen in the example below all profiles can reside in one file. If you wish to use Wordstar to create the Users Profile File, please use it in the Nondocument mode. The Users Profile File should be stored in the ISIS root dir- ectory. Examples of user profiles are given below: 001-T L.J. Haravu Sr. Manager, Library and Documentation Services ICRISAT, Patancheru, A.P. 502 324, India. AU=Brown$ (Striga$ + orobanche) (India + Sudan) #1 * #2 * #3 @@ 002 K.F.Nwanze Principal Sorghum Entomologist ICRISAT Patancheru, A.P. 502324, India. sorghum$ striga hermonthica Any West Africa #1 * #2 * #3 @@ In the above examples the first user (ID 001-T) will get two column output and the second user (ID 002) will get single column output. 3. The program provides the option to produce SDI outputs for items input into the database after a given date of data entry. This date will be used to create a subset and all SDI outputs will be for items within this subset. However, if the date option is not used,the whole database is used to produce the SDI outputs. If the date option is used the SDI program assumes that the database has a date of data entry field, and that this is indexed. The date of data entry to be given could be truncated (e.g. 199501$ to take into account all input added after 199501, i.e. Jan 1995). 4. The output produced by the program is in one or two columns depending on the Profile ID. Two column output contains a user copy part and a feedback part. The latter is identical to the former, except that it also has two questions which the user is expected to answer as feedback. SDI outputs are all accumulated into an output disk file which can then be printed off line. The SDI output file specified at run time is created in the ISIS root directory. 5. SDI outputs will be produced using the CDS/ISIS display format that is specified at run time. If no CDS/ISIS format is specified the program will take the default format to produce the SDI outputs. However, users are adviced not to specify a CDS/ISIS display format which itself uses a CDS/ISIS Pascal Format Exit. If it is required to use Format Exits in the print formats for SDI, change the Uses line in the program called SDIRUN.PAS to include the names of format exits that will be used by the display format. For instance, if the format exits called Auth and Titl will be used, include the line Uses auth,titl; in the SDIRUN.PAS file and recompile SDIRUN. 6. The number of lines per printed page is also required to be specified at run time. The program automatically adjusts the number of lines printed per page which can vary also depending on whether the output is in two columns or one column. 7. SDI outputs contain a first title page that contains the name, address and Profile ID of user, followed by his Profile, and the number of hits output to him in that particular run. RUNNING THE PROGRAM. 1. Invoke the ISIS program and come to the main menu. 2. Choose A for Advanced Programming Services (APS). 3. Choose R for Run at the menu of the APS. 4. Type NEWSDI Note: It is assummed that you already have compiled versions of the programs Newsdi and Sdirun The program now asks for the following: 1. Name of the database. 2. Name of the Users Profile file. 3. Name of the SDI output file, i.e. the name of the file in which SDI outputs to all users will be accumulated. 4. Name of the CDS/ISIS display format to be used in formatting the SDI outputs. The available formats are shown in a pop-up window and may be chosen by moving up or down in the window with the arrow keys and pressing the Enter key at the required format. 5. The profile ID from which the SDI run should begin, and the Profile ID at which to end the run. 6. The number of lines per page of printed output. 7. Lastly, the program asks you if you wish to use the date search facility, i.e. whether you want your SDI output to be restricted to records entered into the database after a given date of entry. If you decide to use the date search facility, the program asks you to enter the date. However, to use the date search facility, the database must have a field for date of entry and this field must be an indexed field. Enter the information prompted for. The program then begins by creating sets for each of the ANY terms that may have been defined for the database chosen. Following this, the program begins processing the User Profiles, one by one. The output for each profile is accumulated in the output file given. A Status Report is shown on the screen. At the end of the run the program returns to the Advanced Programming Services menu. Type Q to return to the main menu of CDS/ISIS. You may then print the output file using the Print command at the DOS prompt after exiting from CDS/ISIS. A 2-column output file will require 132 column stationery on your printer.