System Librarian Training

System Librarian Training 2 Session Agenda ALEPH Speak / Jargon Directory tree overview Local sub-directories ALEPH sub-directories Tools and utilities Util F Util W Util G Running servers online

System Librarian Training 3 ALEPH Speak / Terms Libraries = Databases (EXU01) $data_root = root directory of specified database (u16_1/exu01) $alephe_root = root directory of alephe (u16_1/alephe) $data_tab = tab directory of specified database (u16_1/exu01/ tab)

System Librarian Training 4 ALEPH Speak / Terms $alephe_tab = tab directory of alephe (u16_1/alephe/tab) GUI Searching = Available in all staff modules (tool) for searching the catalog WWW OPAC = Web interface (tool) for searching the catalog, especially for Public.lng = generic extension for file/table names to indicate the need for a specific language code (tab_base.lng is tab_base.eng in North America)

System Librarian Training 5 ALEPH Speak / Terms Sub-library = physical location, branch, or section in a library that has a separate CIRC policy and / or related table definitions. Alias = shortcut to specific directory; may be dependent on the selected database.

System Librarian Training 6 Directories I Two types of directories on the server are of interest to system librarians: The alephe directory is a “global” directory that includes files used by every library/database. Local directories of databases (libraries) contain files/tables with definitions that are local to specific databases (e.g., exu01, exu50). They also contain the database’s file_list.

System Librarian Training 7 Directories II When we talk about a “library” in ALEPH “system speech”, we normally mean a “Local directory” or “database” (such as exu01 or exu50). So, the EXU “bibliographic library / database” is actually a Local directory called “exu01”.

System Librarian Training 8 Directories III Each directory contains sub- directories, which include tables and files. There are aliases (shortcuts) for some sub-directories (e.g., “dt” for tab/ ), which are listed in italicized orange font in the text below.

System Librarian Training 9 The Tree Structure Sub- directories Directories version etc.

System Librarian Training 10 Local Sub-directories Directories Sub- directories alepheAleph

System Librarian Training 11 The Local Root Directory To get to the root directory of the library you are in, type “dr”. exu01/ - is the $data_root of the exu01 tree/database.

System Librarian Training 12 Local Files file_list defines all the Oracle tables required for that library, their initial and subsequent extents and their indexes. IND z00r_id 100K 100K ts1 IND z00r_id1 100K 100K ts1 TAB z01 2M 1M ts0 IND z01_id 1M 1M ts1 IND z01_id2 300K 100K ts1 IND z01_id3 200K 100K ts1 IND z01_id4 200K 100K ts1 IND z01_id5 200K 100K ts1

System Librarian Training 13 Local Sub-directories I tab/ includes tables for defining the library’s behavior. (dt or cd $data_tab) pc_tab/ includes tables for defining the library’s behavior during cataloging. print/ includes final printouts. It can be accessed using the GUI’s Task Manager. (dp or cd $data_print)

System Librarian Training 14 Local Sub-directories II form_eng/ includes templates for printing, used by batch services and online printing. (E.g., overdue letters to patrons, order slips, etc.)

System Librarian Training 15 Local Sub-directories III files/ includes files to import/export using Oracle. Those files always have the suffix “.seq”. It also includes files such as the library’s batch_log, and queue_batch. (df1, cd $data_files) scratch/ includes temporary files and files to upload into aleph; e.g., bibliographic records. (ds, cd $data_ scratch)

System Librarian Training 16 The Tree Structure Sub- directories Directories version

System Librarian Training 17 alephe Sub-directories Directories Sub- directories usm01usm10

System Librarian Training 18 alephe Sub-directories I The alephe directory includes files that define behavior on the node level, affecting every database. Some files sit under the root (base) directory (cd $alephe_root): – aleph_start – aleph_start.private – aleph_startup – pc_server_defaults – www_server_defaults

System Librarian Training 19 alephe Sub-directories II tab/ includes tables for defining active libraries, sub-libraries and conventions among different libraries (cd $alephe_tab). Some important tables are: – tab_sub_library.eng – tab_attr_sub_library – path_convert – tab_base.eng

System Librarian Training 20 alephe Sub-directories III scratch/ includes log files (detailed files with information on the programs that run in all libraries). (cd $alephe_scratch) Retrieval utilities write their output files in this directory, in order to use them as input files for other batch utilities.

System Librarian Training 21 alephe Sub-directories IV apache/ defines apache settings in regards to ALEPH. error_eng/ includes error and information messages displayed online. headers/ includes definitions for the structure of all table headers.

System Librarian Training 22 alephe Sub-directories V www_eng/ includes general HTML files, such as the list of databases, sub-libraries information. www_f_eng/ includes HTML files for the Web OPAC. (alias is ‘wf’). pc_b_eng/ includes HTML files for the Web Services. (alias is ‘pcb’).

System Librarian Training 23 alephe Sub-directories VI www_e_eng includes HTML files with Web errors. (alias is ‘we’) www_r_eng includes HTML files for Course Reading. (alias is ‘wr’) www_s_eng includes HTML files for the Staff Menu. (alias is ‘ws’)

System Librarian Training 24 Tools and Utilities

System Librarian Training 25 Utils? Utils are a collection of programs for various system functions which cannot be performed by the GUI interface. For example, display of raw data, server management, Oracle management, daemon management.

System Librarian Training 26 Some Utils in Brief Util A -Oracle tables management Util C - Batch management Util E - Daemon management Util H - Synchronization of header and error directories Util I - Data formatting tables Util J - Server Management Util L - Modules display tables Util M -Cataloging tables Util Y - alephe/tab tables

System Librarian Training 27 Util F - View Procedures and Files For example: 2. Display/check word building routines 3. Display/check filing routines 4. Display records from data files 10. Display/check overdue fine calculation

System Librarian Training 28 Util F/2 : Display/Check Word Building Routines (Example I) This utility checks the word building procedures - i.e., how the system breaks up fields into words. Enter Procedure Identifier (Q to quit) Legal values are 01...: 01 Enter text (Q to quit) : Arab-Israeli conflict WORD 1 -arab- WORD 2 -israeli- WORD 3 -conflict-

System Librarian Training 29 Util F/2 : Display/Check Word Building Routines (Example II) Enter Procedure Identifier (Q to quit) Legal values are 01...: 41 Enter text (Q to quit) : engfreger WORD 1 -eng- WORD 2 -fre- WORD 3 -ger-

System Librarian Training 30 Util F/3 : Display/Check Filing Routines This utility checks the filing procedures. - i.e., how the system files fields into headings. Enter Filing Procedure (Q to quit) Legal values are 01: 01 Enter text (Q to quit) : $$aGeorge McDonald IN -$$aGeorge McDonald OUT - G E O R G E M A C D O N A L D

System Librarian Training 31 Util F/4 : Display Records from Data Files This utility displays records from the database, both lines from Oracle tables and cataloging records. Retrieval is by type of record and by a key (i.e., system number - optional). For example: doc - a bibliographic record z30 - an item

System Librarian Training 32 Util F/4 : Display Records from Data Files (Example I) enter file name (or q to exit) doc ENTER DOC NUMBER : 500 Reading doc : Load : /aleph/a53_5/usm01/tab/tab_expand Load : /aleph/a53_5/usm50/tab/tab40.eng FMT L BK LDR L 01015cam i L //r L s fr afre L $$a940.54/ L $$aRostaing, Pierre,$$d L $$aLe prix d'un serment :$$b : des plaines de Russie ב a l'enfer de Berlin

System Librarian Training 33 Util/F/4 : Display Records from Data Files (Example II) enter file name (or q to exit) z30 new key = K, exit = Q, continue = RETURN 01 z30_item \ 02 z30_rec_key \ 03 doc_number item_sequence z30_barcode z30_sub_library USMA1 02 z30_material BOOK 02 z30_item_status z30_open_date z30_update_date z30_cataloger YOHANAN

System Librarian Training 34 Util/G : Tables Defining Database Structure Util G includes most ALEPH tables, as well as all system counters (Util G/2). 0. Exit procedure 1. Database tables (tab files) [50] 2. Display/Update library parameters [59] 3. Create initial library parameters 4. Administrative tables 5. Circulation tables [50]

System Librarian Training 35 Util/G/2 Is for Counters Sequence Name Value Suppress Type Prefix inventory-number 6 n U Inv- 10. inventory-number-2 4 n U 11. last-barcode-number 1345 y S B 12. last-bor-id y S 13. last-bor-id y S Counter type: U - User S - System Counter type: U - User S - System Suppress leading zeroes Suppress leading zeroes Current counter value Current counter value Counter name Counter name

System Librarian Training 36 Util/G/4 : Administrative Tables Here is an example from the other Util G sections: 21 - Languages and script codes 25 - Item material type (ADM library only) 26 - EDItEUR codes (ADM library only) 33 - Fields for BIB-ADM record 35 - EAN-13 Location numbers (for EDI) (ADM library only) 36 - Acquisition item creation information (ADM library) 40 - Collection codes and names (ADM library only) 42 - Item status automatic change according to Order status 45 - Acquisition logger (ADM library only) a chrono (ADM library only) b numbering (ADM library only)...

System Librarian Training 37 Util W - Server Management 0. Exit procedure 1. Monitor servers 2. Stop servers 3. Start servers 4. View log file

System Librarian Training 38 Util W/1 - Monitor Servers 0. Exit procedure 1. All servers 2. WWW front server 3. WWW server 4. PC server 5. Z39 server 6. Z39 gate 7. SC server 8. Load records saved through OCLC Passport 10. Monitor by port number 12. Change loop status

System Librarian Training 39 Util W/1/1 Monitor All Servers | Port | Pid | Server Type | Started At | Status | | | | | | 4525 | | WWW Server | Sep 04 07:59:29 | Free | 4505 | | WWW Front | Sep 04 07:22:36 | Free | 6557 | 4746 | PC Server | Sep 03 13:39:24 | Free | 6505 | | PC Server | Sep 04 09:09:42 | Free

System Librarian Training 40 Util W/4/3 PC Server Log :09: Server No. 1 Read 70 (30386) Bytes, Total 70 Bytes (30386) SERVICE: C0202 MODULE: Catalog Services DESCRIPTION: Get doc ACTION : PROGRAM: pc_cat_c0202 Load : /aleph/a51_5/alephe/unicode/tab_character_conversio n_line Load: /aleph/a51_5/alephe/unicode/unicode_to_8859_1...

System Librarian Training 41 Running Servers Online WWW server: To run it in the background: www_server 4535 & To run it and display messages online: www_server 4535 stdout

System Librarian Training 42 Running Servers Online PC server: To run it in the background: pc_server 6535 & To run it and display messages online: pc_server 6535 stdout

System Librarian Training 43 Running Servers Online PC server transactions tools: pc_server view For example: pc_server view will display the last 10 transactions handled by port 6515.