How to Change Bib Info Displays

Releases
16, 17, 18

Last update: 26 May, 2007

TABLE OF CONTENTS

      A.   Introduction

B.	Bib_format / edit_doc / edit_paragraph / edit_field
                 1.   Programs which use edit_edit_doc
a.   alephm/source/copy/BIB_FORMAT (“-DOC”)
b.	edit_doc numbers in programs
2.	Programs which use edit_paragraph 
         a.   xxx50/tab/bib_format
b.	alephm/source/copy/BIB_FORMAT (“-LINE”)
c.	edit_paragraph numbers in programs

                   3.   Programs which work directly with edit_field

C.   What Program/Table produces what Bib Display
               
D.   Bib Display Diagram

E.   Use of “Short Doc” instead of bib info fields

A.  Introduction

This document describes the display/formatting of information from DOC/z00 (BIBliographic, ADMinistrative, HOLdings, and AUThority) records and from the “virtual DOC” fields created by expands of information from other records.   We will use “bib info” as a short-hand term for all of these fields.   

Note:   we are not talking here about the display of the complete records on the Cataloging form; we are talking about display of subsets of information in other places. 

Nor are we talking about “non-DOC” information:   The columnar display of information from non-DOC records is controlled in the GUI by xxx01/tab/pc_tab_col.lng (UTIL I.9) and on reports by xxx01/tab/rep_col.lng (UTIL I.11).   Non-columnar display is controlled by the Acq, Items, Circulation, and Serials display tables under UTIL L  and by the $xxx variables on individual forms in the form_lng directory.  These non-DOC displays are not addressed in this document.  

Some bib info displays use the general edit_doc / edit_paragraph / edit_field mechanism; some use separate, special tables to control their formats.  (In addition to the verbal description in sections B and C,  please see also the “Bib Display Diagram”, section D, which presents the relationships in the form of a diagram.)

Some programs use the “short doc” (Z13) rather reading the bib record itself.   See Section E.

B.  Bib_format / edit_doc / edit_paragraph / edit_field

In the regular mechanism, “documents” are built from “paragraph” pieces which are built from “field” pieces.   Edit_doc.lng (UTIL I.3) specifies which edit_paragraph.lng (UTIL I.2) entries are to be used; edit_paragraph.lng specifies which edit_field.lng (UTIL I.1) entries are to be used.  

The programs which follow this path are discussed in section B1.  

In other cases the programs go directly to edit_paragraph.lng (see section B2) or edit_field.lng (see section B3). 

   1.  Programs which use edit_doc

Many of the programs which use edit_doc use bib_format to determine which edit_doc entry to use.  There are two bib_format’s:  

•	the xxx50/tab/bib_format (prior to version 16 some of the numbers in bib_format were edi_doc numbers; beginning with v16, they are all edit_paragraph numbers rather than edit_doc numbers, see Section 2 below).

•	the alephm/source/copy/BIB_FORMAT.     

The former is a table which the user can modify; the latter is a program “copybook” which is not intended to be modified, but which you may want to access as a reference.  

  

 a.  alephm/source/copy/BIB_FORMAT (“-DOC”)

An example of the use of alephm/source/copy/BIB_FORMAT is the display of the xxx01 bib info on the WWW Holdings Detail screen.   The www_f/www_f_item_global program copies in the alephm/source/copy/BIB_FORMAT and uses this entry:  

    OPAC-ITEM-FORMAT-DOC   …  VALUE 012

which, in turn, points to a particular usm01/tab/edit_doc.eng entry:

012                 ##  ##          013

which points to the usm01/tab/edit_paragraph.eng: 

!   Author-Title for Bib Inf
013 1#### D           ^:^
013 245## 9 ##        .
013 260## W ##^       .
013 300## D ##^       .

Each of which, of course, points to an usm01/tab/edit_field.eng  entry…

Other programs which use these BIB_FORMAT  “-DOC” entries are the GUI circ, cash, acq, items, and serials screens.  (Note:  BIB_FORMAT also contains “-LINE” entries which work directly with edit_paragraph.  See below.)

            b.     Edit_doc numbers in programs

In some cases the program does not use either of the above bib_format’s to get an edit_doc number but actually has the edit_doc number coded in it.   One example is the www_f/www_f_edit_hol:
 
                CALL "www_f_edit_doc" USING
                    DOCX-DOC-NUMBER
                    "101"

which points to the exu60/tab/edit_doc.eng entry:

!Full HOL over ITEMS in ITEMS. Single column, multiple lines and 2 paragraphs
101	109 

which points to the exu60/tab/edit_paragraph.eng entry:

109 856## D            ##
109 852## D            ##
109 866## D -^         ##         A
109 867## D -^         ##         A
109 868## D -^         ##         A

Each of which points to an exu60/tab/edit_field.eng  entry…

Another screen/program which has an edit_doc numbers coded into it is the www_f_lng/full-set-head:

 <a href=&server_opac/full-set/$0500-040>Citation</a>&nbsp;

which points to the usm01/tab/edit_doc.eng entry:

!Citation display
040                                  513 

which points to the usm01/tab/edit_paragraph.eng entry:

!   Simple citation paragraph
513 1#### P           ^ ^
513 245## P
513 260## P ^

Each of which points to an usm01/tab/edit_field.eng  entry…

On the GUI side, the “FO” entries in pc_tab_sear.lng contain edit_doc numbers specifying that a specific format is to be used:

FO  USM01                L Catalogue Card                 037

which points to the “037” entry in usm01/tab/edit_doc.eng:

037 System number^  ##  ##          001
037                                 110
037                                 120
037                                 130
037                                 140
037                                 004
 
Each of which points to an usm01/tab/edit_paragraph.eng entry.   Each of which, in turn, points to an  usm01/tab/edit_field.eng table entry.

    2.  Programs which work directly with edit_paragraph

Some programs skip the edit_doc step and work directly with edit_paragraph.  

a.  xxx50/tab/bib_format

•	Almost all the programs which process the forms in the xxx01/form_lng directory (used to produce most reports, slips, labels, etc.)  call the com/get_bib_line_x program which reads the xxx50/tab/bib_format.   [prior to version 16 some of the numbers in bib_format were edi_doc numbers; beginning with v16, they are all edit_paragraph numbers rather than edit_doc numbers.]
.] 

An example of the use of this bib_format is the bib info which appears in the acquistions claim letter:

In usm50/tab/bib_format we have: 

acq-order-claim-01             300

In usm01/tab edit_paragraph.eng we have:

!*   BIB  for acq order slip
300 1#### D ##
300 245## D ##
300 250## D ##
300 260## D ##
300 300## D ##

In usm01/tab/edit_field.eng we have:

1 # 260## D   -6
2                        a A ^ ^
2                        b A ^
2                        c A ^

Some of these (e.g.,  pc_cir) use the alephm/source/copy/BIB_FORMAT “-LINE” entries to get the edit_paragraph number:  

        CIR-ITEM-FORMAT-LINE    …  210
 
which points to a specific usm01/tab/edit_paragraph.eng entry:

!   Short BIB in for loan/photo/hold list in USER & CIRC
210 LOC## D
210 1#### D ##
210 245## 9 ^:^        .

Other programs (for instance, the www_f/www_f_bor_xxx programs) have the edit_paragraph number in the program itself:

                CALL "get_bib_line_x" USING
                    DOCX-PTR
                    CON-LNG
                    "009"
                    EDIT-BUF

which points to a specific usm01/tab/edit_paragraph.eng entry:

!   Author-Title for Bib Inf on OPAC Items
009 PST## J            ##
009 020## D ^ISBN:     ##
009 022## D ^ISSN:     ##
009 1#### D ^         ^:^
…

    3.   Programs which work directly with edit_field

In other cases programs skip both the edit_doc and the edit_paragraph tables and work directly with edit_field.lng.   Examples of this are 
•	the full+link bib display (xxx01/tab/edit_doc_999.lng –UTIL I.8), 
•	the WWW Brief list (xxx01/tab/www_tab_short.lng -UTIL I.4), 
•	the GUI Brief list (xxx01/tab/pc_tab_short.lng -UTIL I.7), and 
•	the Navigation window bib data (xxx50/tab/tab33.lng –UTIL G.4.33) . 

For instance (from edit_doc_999):

245##                D LTitle               Y Z     E

which points to the 245 field in usm01/tab/www_tab_short.eng:

1 L 245## D
2	# A  ^

Note:  tab33.lng doesn’t allow for any edit_field ID specification; edit_field ID “D” is always used.

C.  What Program/Table produces what Bib Display

Note:  This table is intended to be used with the Bib Display Diagram (section D, below).  Get the initial program/table from this chart and then refer to the Bib Display Diagram for the other steps.

Bib Display				Initial Program/Table 

WWW Full display			alephe/www_f_lng/full-set-head

GUI Full display				xxx01/tab/pc_tab_sear.lng (“FO” entries) (UTIL L.3.a)

WWW Brief list				xxx01/tab/www_tab_short.lng  (UTIL I.4)

GUI Brief list				xxx01/tab/pc_tab_short.lng  (UTIL I.7)
 
WWW Holdings Detail (bib record fields) 	alephm/source/copy/BIB_FORMAT                                                       (      OPAC_ITEM_FORMAT_DOC  “012”)
WWW Holdings Detail (HOL record fields) www_f/ www_f_edit_doc (doc .“999”)

WWW Borrower item display	www_f/www_f_bor_xxx  (para. “009”)

GUI Navigation window (Nav Map)	xxx50/tab/tab33.lng  (UTIL G.4.33)

form_lng forms	xxx50/tab/bib_format  (UTIL I.14*)

p_print_08 (“Print Catalog Recs”--columnar)	xxx01/tab/rep_tab_short.lng  (UTIL I.10) 

GUI Acq displays	alephm/source/copy/BIB_FORMAT                                                       (      ACQ_ITEM_FORMAT_DOC  012 or   
                                                                               ACQ_ITEM_FORMAT_HOL  013 )
GUI Circ displays	alephm/source/copy/BIB_FORMAT                                                       (      CIR_ITEM_FORMAT_DOC  012 or   
                                                                               CIR_ITEM_FORMAT_LINE 210 [para.] )
GUI Cash displays	alephm/source/copy/BIB_FORMAT                                                       (      CASH_FORMAT_DOC  012)		
GUI Item displays	alephm/source/copy/BIB_FORMAT                                                       (      ITEM_ITEM_FORMAT_DOC  012 or   
                                                                               ITEM_ITEM_FORMAT_HOL  013 )
GUI Serials displays	alephm/source/copy/BIB_FORMAT                                                       (      SERIAL_ITEM_FORMAT_DOC  012)

D.   Bib Display Diagram

Note:  To see what initial program/table is used for each display, please refer to the preceding section C, “What Program/Table produces what Bib Display”.

                                                                         xxx01/tab/pc_tab_sear.lng (“FO” entries) (UTIL L.3.a)
                                                                                      
                                                                                      alephe/www_f_lng/full-set-head 

                                                                                     “001” 
                                                                                     “002”
                                                                                     “099”
                                                                                     [other]                                                                                                                                           
                                                                                                                               alephm/source/
                                                                                                                                   com/edit_doc_001       
                                                                                                                                alephm/source/
                                                                                                                                   com/edit_doc_002
                                                                                                                                 alephm/source/
                                                                                                                                    com/edit_doc_999                          

                                                                                                                                          xxx01/tab/edit_doc_999.lng
alephm/source/copy/BIB_FORMAT (“_DOC”)

           www_f/www_f_edit_hol  (“101”)

                          xxx50/tab/bib_format  (UTIL I.14*)

                                                    xxxnn/tab/edit_doc.eng  (UTIL I.3)

alephm/source/copy/
BIB_FORMAT (“_LINE”)                            

www_f/www_f_bor_xxx                                xxxnn/tab/edit_paragraph.eng  
(para. “009”)                                                                                            (UTIL I.2) 

xxx01/tab/www_tab_short.lng  (UTIL I.4)                xxxnn/tab/edit_field.eng  (UTIL I.1)

         xxx01/tab/pc_tab_short.lng  (UTIL I.7)

            xxx01/tab/rep_tab_short.lng  (UTIL I.10)
 
                      xxx50/tab/tab33.lng  (UTIL G.4.33)

E.   Use of the “Short Doc” (Z13)

Other displays do not work with the complete bib record at all, but instead use the Z13 “short doc” record.  Examples of such displays are: 
•	the bib info for each item in the GUI Circulation –User –Cash Transactions;  
•	the “Brief List” that you see when, in GUI Cataloging, you select “Search” at the top, then “Search field headings of … library”, and (when the heading has multiple records associated with it) and click on “View Docs” or “Expand”. 

What fields are included in this short doc display is determined by the xxx01/tab/tab22 (UTIL G 1.22).  But note that, since this Z13 is an actual, separate physical record, the fields included are those in effect in tab22 at the time the bib record was last stored on the server.