home *** CD-ROM | disk | FTP | other *** search
/ ftp.pasteur.org/FAQ/ / ftp-pasteur-org-FAQ.zip / FAQ / databases / bus-objects-faq < prev    next >
Encoding:
Text File  |  1996-12-17  |  50.3 KB  |  1,145 lines

  1. Path: senator-bedfellow.mit.edu!faqserv
  2. From: thompson@isc.upenn.edu (Stephen W. Thompson)
  3. Newsgroups: comp.databases.olap,comp.databases.oracle,comp.databases.sybase,comp.answers,news.answers
  4. Subject: Business Objects FAQ, last modified 96/06/26
  5. Supersedes: <databases/bus-objects-faq_848196893@rtfm.mit.edu>
  6. Followup-To: poster
  7. Date: 17 Dec 1996 06:37:48 GMT
  8. Organization: University of Pennsylvania
  9. Lines: 1124
  10. Approved: news-answers-request@MIT.EDU
  11. Expires: 30 Jan 1997 06:26:40 GMT
  12. Message-ID: <databases/bus-objects-faq_850804000@rtfm.mit.edu>
  13. NNTP-Posting-Host: bloom-picayune.mit.edu
  14. Summary: Answers to Frequently Asked Questions (FAQs) about the Business
  15.          Objects query tool software, used to produce easier queries from
  16.          relational databases.
  17. X-Last-Updated: 1996/06/26
  18. Originator: faqserv@bloom-picayune.MIT.EDU
  19. Xref: senator-bedfellow.mit.edu comp.databases.olap:7878 comp.databases.sybase:43391 comp.answers:23150 news.answers:89764
  20.  
  21. Archive-name: databases/bus-objects-faq
  22. Posting-Frequency: monthly
  23. Last-modified: 1996/06/26
  24. URL: http://www.upenn.edu/da/bo/busob-faq.html
  25.  
  26.    
  27.                              BUSINESSOBJECTS FAQ
  28.                                        
  29.    This document was last changed June 26, 1996. Copyright 1995, 1996,
  30.    by Stephen W. Thompson. Provided that no modification is made in the
  31.    text and that this paragraph is retained, this document may be
  32.    reproduced; the only exception is that employees of BusinessObjects
  33.    must request permission for any reproduction.
  34.      _________________________________________________________________
  35.    
  36. FAQ Contents
  37.  
  38.    FAQ Maintenance & Updates
  39.           
  40.    User Issues
  41.           
  42.           + Business Objects Overview
  43.           + Installation on Windows
  44.           + Installation on Macintoshes
  45.           + Access
  46.           + Performance
  47.           + Training
  48.           + Upcoming Versions
  49.             
  50.    Manager Issues
  51.           
  52.    
  53. The Questions
  54.  
  55.    
  56.    
  57.   FAQ MAINTENANCE & UPDATES
  58.   
  59.    
  60.    F1.01
  61.           What recent changes have been made to this list?
  62.    F1.02
  63.           Who contributed to this FAQ?
  64.           
  65.   USER ISSUES
  66.    Business Objects Overview
  67.           
  68.    U0.01
  69.           Could you briefly explain what BusinessObjects is?
  70.    U0.02
  71.           What are some resources to learn about BusinessObjects?
  72.           
  73.           
  74.    Installation on Windows
  75.           
  76.    U1.01
  77.           How much space does Business Objects require on the hard drive?
  78.    U1.02
  79.           Why would a message about the environment variable CONFIG being
  80.           incorrectly set arise during installation?
  81.    U1.03
  82.           How do I test if a connection problem with Business Objects is
  83.           with BusOb itself or with SQL*Net instead?
  84.    U1.04
  85.           What type of configuration problems have you seen that prevent
  86.           NETTEST.EXE from being successful (that is, SQL*Net is
  87.           unhappy)?
  88.    U1.05
  89.           What type of configuration problems have you seen that prevent
  90.           Business Objects from working?
  91.    U1.06
  92.           Will Business Objects work on Windows 95?
  93.    U1.07
  94.           What is the latest patch to Windows, and which do I have?
  95.           
  96.    Installation on Macintoshes
  97.           
  98.    U2.01
  99.           Why when I try to open a universe for the first time do I get
  100.           the error "SYS-0331: Error Retrieving Parameters"?
  101.    U2.02
  102.           Does installation need to be done using the installation disks,
  103.           or can the files simply be copied?
  104.           
  105.    Some installation pointers written to be specific to University of
  106.           Pennsylvania may be found at
  107.           http://pobox.upenn.edu/~thompson/busob-penn.html.
  108.           
  109.    Access
  110.           
  111.    U3.01
  112.           (PENN SPECIFIC) Why am I having problems getting into Business
  113.           Objects with my password?
  114.    U3.02
  115.           Can I get rid of old universes by deleting directories/folders?
  116.    U3.03
  117.           What are some possible approaches to solving connection
  118.           problems?
  119.           
  120.    Performance
  121.           
  122.    U4.01
  123.           Why is Mac performance so poor?
  124.    U4.02
  125.           Why does canceling a query sometimes work and sometimes hang my
  126.           machine?
  127.           
  128.    User Interface
  129.           
  130.    U5.01
  131.           How can one retrieve queries from the repository?
  132.    U5.02
  133.           How does one find templates that are in the repository, or even
  134.           find the command to import them?
  135.    U5.03
  136.           How can a Mac user close one universe and open another
  137.           universe, short of quitting and restarting BusOb?
  138.    U5.04
  139.           How can I get labels to print 3-up (in three columns)?
  140.    U5.05
  141.           When creating conditions based on queries (rather than
  142.           Constant, Variable or Object), which queries does BusOb display
  143.           as candidate subqueries?
  144.           For example, if the condition is on SSN, are queries displayed
  145.           in the dialog box only if their result object is SSN?
  146.    U5.06
  147.           How can I query for records based on lists of id's that I have
  148.           from other data sources? Say I have a file of SSN's to look up?
  149.    U5.07
  150.           How can I get better control of how my headers and footers
  151.           appear? I want top-of-page headers related to some objects,
  152.           beginning-of-break footers related to others, and sometimes
  153.           text that accompanies each occurrence of an object.
  154.    U5.08
  155.           Why do some help screens describe features I can't locate, such
  156.           as the "complex query" button mentioned under "outer joins"?
  157.    U5.09
  158.           How can I have a query use an outer join?
  159.    U5.10
  160.           How do I input the pipe or or-bar character?
  161.           
  162.    Training
  163.           
  164.    U6.01
  165.           How is the training provided by Business Objects?
  166.    U6.02
  167.           How is training provided by others?
  168.           
  169.    Upcoming Versions
  170.           
  171.    U7.01
  172.           What can we expect from BusOb v4.0 (codenamed Mercury)?
  173.    U7.02
  174.           What are new features that we BusOb users and managers wish
  175.           would be added to the tool?
  176.           
  177.   MANAGER ISSUES
  178.    M1.01
  179.           What are some approaches to resolving loops in the joins?
  180.    M1.02
  181.           How can I have a context with no joins?
  182.    M1.03
  183.           Why can't I add new objects?
  184.    M1.04
  185.           Are there any "gotchas" with using the Advanced Login Strategy
  186.           for managing security?
  187.    M1.05
  188.           What do I do if I lose my manager password?
  189.    M1.06
  190.           How can I programmatically modify object names?
  191.    M1.07
  192.           How can I modify the MANAGERx universe to allow reporting on
  193.           aliases?
  194.    M1.08
  195.           How can I find the metamodel? for the repository files?
  196.           
  197.    
  198. The Answers
  199.  
  200.   FAQ MAINTENANCE & UPDATES
  201.    F1.01
  202.           What recent changes have been made to this list?
  203.           
  204.           
  205.           960611 Added info about BUSOB-L mailing list. Removed
  206.           comp.databases.ingres from posting list since it is also
  207.           received as an e-mail list.
  208.           
  209.           
  210.           960501 Revamped the HTML formatting so the FAQ looks better and
  211.           is easier to use interactively.
  212.           
  213.           
  214.           960501 Moved the FAQ to it's new, more official location.
  215.           
  216.           
  217.           Added a thumbnail explanation of what BusOb is for the
  218.           uninitiated. Added two user interface questions, one on help
  219.           text and one on outer joins.
  220.           
  221.           Added a paragraph for the "new versions" question concerning
  222.           Object Query.
  223.           
  224.    F1.02
  225.           Who contributed to this FAQ?
  226.           
  227.           Tad Davis: davist@isc.upenn.edu; Adam B. Greenfield:
  228.           agreenfield@epsilon.com; Andy Mannhart:
  229.           100751.1012@compuserve.com; Susan Quant:
  230.           squant@sas.upenn.edu; Lorraine Ratajczak:
  231.           ratajcza@isc.upenn.edu; Carol Rice: carol.rice@octel.com; Ann
  232.           Stockton: Ann.Stockton@wharton.upenn.edu .
  233.           
  234.           The document is very Oracle-specific right now; users of other
  235.           RDBMS's are invited to contribute. Send your contribution to:
  236.           thompson@isc.upenn.edu.
  237.           
  238.   USER ISSUES
  239.    Business Objects Overview
  240.           
  241.    U0.01
  242.           Could you briefly explain what Business Objects is?
  243.           
  244.           Business Objects is a query tool sold by a company by the same
  245.           name which is used to create 'ad hoc' reports from data stored
  246.           in databases in a client/server fashion. It provides facilities
  247.           to retrieve data from relational databases and create reports
  248.           and graphs, as well as to export the retrieved data to other
  249.           applications. Tools with which it might compare include
  250.           Impromptu from Cognos, GQL from Andyne, Browser from Oracle and
  251.           Brio Query from Brio Technology. It is available on Windows,
  252.           Macs and Motif.
  253.           
  254.    U0.02
  255.           What are some resources to learn about Business Objects?
  256.           
  257.           To subscribe to a mailing list, send the line "subscribe
  258.           busob-l Yourfirstname Yourlastname" to
  259.           listserv@listserv.aol.com. This is a list started June 1996
  260.           for discussion about both user and management issues.
  261.           Subscribers only may submit messages by mailing to
  262.           busob-l@listserv.aol.com. (Please remember: Text goes to
  263.           busob-l; commands go to listserv.)
  264.           
  265.           The current copy of this FAQ is always available at
  266.           http://www.upenn.edu/da/bo/busob-faq.html.
  267.           
  268.           A WWW site is maintained by Business Objects at
  269.           http://www.businessobjects.com/.
  270.           
  271.           Although there is no perfect newsgroup that exists yet,
  272.           comp.database.olap is perhaps the most appropriate.
  273.           
  274.    Installation on Windows
  275.           
  276.    U1.01
  277.           How much space does Business Objects require on the hard drive?
  278.           
  279.           
  280.           For version 3.1.1E I estimate about 6.5 Mb. Of course, once you
  281.           start downloading Universe definitions and doing reports, that
  282.           could grow enormously. Use the Query, Document and Template
  283.           management menus to delete work once you're done with it in
  284.           order to save disk space.
  285.           
  286.    U1.02
  287.           Why would a message about the environment variable CONFIG being
  288.           incorrectly set arise during installation?
  289.           
  290.           
  291.           This has happened when SQL*Net was already installed on the
  292.           machine and used with another query tool we were evaluating.
  293.           Removing the entire ORAWIN directory and the
  294.           \WINDOWS\ORACLE.INI file, removing any SET CONFIG or
  295.           CONFIG_FILES line from the AUTOEXEC.BAT and starting the TCP/IP
  296.           Adapter installation again was our fix.
  297.           
  298.    U1.03
  299.           How do I test if a connection problem with Business Objects is
  300.           with BusOb itself or with SQL*Net instead?
  301.           
  302.           
  303.           SQL*Net for Windows (not Mac, unfortunately) comes with
  304.           NETTEST.EXE in /ORAWIN/NETWORK/ADMIN. From FileManager, double
  305.           click it, and enter an Oracle uid and password and a connection
  306.           string, which at Penn is "warehouse". If you don't get a
  307.           successful connection then the problem is with SQL*Net and not
  308.           BusOb.
  309.           
  310.    U1.04
  311.           What type of configuration problems have you seen that prevent
  312.           NETTEST.EXE from being successful (that is, SQL*Net is
  313.           unhappy)?
  314.           
  315.           
  316.           SQL*Net was installed before TCP/IP Adapter, instead of TCP/IP
  317.           Adapter first, as is required. (We surmise that the "Required
  318.           Support Files", found with both packages, are bad somehow in
  319.           the SQL*Net set of disks but okay with TCP/IP Adapter disks.)
  320.           
  321.           Problems also arise if you choose a "wrong" TCP/IP product when
  322.           prompted during the TCP/IP Adapter installation. This is wrong
  323.           as far as SQL*Net is concerned, not necessarily anything you
  324.           have understood or done incorrectly. For instance, When using
  325.           LAN Workplace for DOS v. 12, which uses WINSOCK, we found you
  326.           must NOT select WINSOCK, but instead select LWP.
  327.           
  328.    U1.05
  329.           What type of configuration problems have you seen that prevent
  330.           Business Objects from working?
  331.           
  332.           
  333.           The PATH in AUTOEXEC.BAT does not include \ORAWIN\BIN.
  334.           
  335.           The TCP/IP package or WINSOCK.DLL was not compatible with the
  336.           JSB files that Business Objects installs. (A symptom of this is
  337.           an error message that appears when every server access is made,
  338.           after which Business Objects successfully continues working
  339.           fine.)
  340.           
  341.           There's a bug in 3.1.1E (at least) when using SQL*Net 2.1. A
  342.           difference between v. 2.0 and v. 2.1 is that what was
  343.           ORA7WIN.DLL is now ORA71WIN.DLL. Business Objects is expecting
  344.           to find ORA7WIN.DLL. We had success simply copying ORA71WIN.DLL
  345.           to ORA7WIN.DLL, and keeping both files around. This info came
  346.           direct from BusinessObjects themselves!
  347.           
  348.    U1.06 
  349.           Will Business Objects work on Windows 95?
  350.           
  351.           
  352.           Yes, at least v. 3.1.1E. Similarly, a U.S. company reports
  353.           using BusOb on Win95, with the added benefit that "In fact
  354.           Windows 95 can handle the "lockup" problem with Oracle and
  355.           SQL*net. You're still not able to cancel the query, but at
  356.           least your entire system is not tied up waiting for the first
  357.           row to be returned. Windows 95 allows the user to switch
  358.           applications during this lock up period (I guess they really
  359.           did build a true multitasking environment.?)" This was using
  360.           SQL*Net v1.1 and specifying "the generic WINDOCK TCP stack that
  361.           comes with Windows 95" as the vendor for installation of
  362.           Oracle's TCP/IP Adapter product.
  363.           
  364.           A European company reports much success using Windows 95 on
  365.           thousands of machines, using versions 1 and 2.1 of Oracle's
  366.           SQL*Net over TCP/IP as middleware.
  367.           
  368.           As to which vendor to specify when configuring TCP/IP Adapter,
  369.           this company reports that "this TCP_VENDOR, you nearly always
  370.           have problems. That's why we don't use the Oracle-Routines any
  371.           more. We just copy the most important files directly from CD or
  372.           diskettes. We have SQL*NET 2.1.4.1.0 at the time and the
  373.           generic Microsoft 32bit-TCP/IP. Here the most important files
  374.           are:
  375.           
  376.  
  377. - C:\WINDOWS\WINSOCK.DLL        42080 bytes     (came with Windows 95)
  378.          this DLL-file is often overwritten by other installations
  379.  
  380. - ...\ORAWIN\BIN:
  381.          COREWIN.DLL                   833856 bytes
  382.          CORE3WIN.DLL                  245136 bytes
  383.          MSOCKLIB.DLL                   42208 bytes
  384.          MWINSOCK.DLL                    7104 bytes
  385.          ORA71WIN.DLL                  321968 bytes
  386.          ORA7WIN.DLL                   272448 bytes
  387.          SQLTNS.DLL                      4848 bytes
  388.          SQLTNS1.DLL                   198080 bytes
  389.          NL.DLL                        137888 bytes
  390.          NLS23WIN.DLL                  749312 bytes
  391.          NS.DLL                        173600 bytes
  392.          NT.DLL                         26288 bytes
  393.          NTT.DLL                        42096 bytes
  394.    
  395.           
  396.           I don't enclose the file date because this may vary (Oracle
  397.           doesn't have the same versions in the USA and in Europe).
  398.           
  399.    U1.07
  400.           What is the latest patch to Windows, and which do I have?
  401.           
  402.           
  403.           The last patch known to me is Patch 9. Check the splash screen
  404.           for your patch level. If if only has "3.1.1 E" (for the English
  405.           version, anyway), you have no patches.
  406.           
  407.    Installation on Macintoshes
  408.           
  409.    U2.01
  410.           Why when I try to open a universe for the first time do I get
  411.           the error "SYS-0331: Error Retrieving Parameters"?
  412.           
  413.           
  414.           This message occurs on a DuoDock Macintosh. Our latest theory
  415.           is that the Duodock and the Powerbook 180 have only one port,
  416.           so ethernet, Appletalk, modem, etc., need to share it.
  417.           Apparently they don't do this well, and making a switch from
  418.           non-MacTCP to MacTCP wipes out a settings files which SQL*Net
  419.           uses. The problem is NOT a Business Objects problem, but is
  420.           entirely at the Mac and Oracle level.
  421.           
  422.    U2.02
  423.           Does installation need to be done using the installation disks,
  424.           or can the files simply be copied?
  425.           
  426.           
  427.           Copying the files, for instance over Appleshare network
  428.           connections, has worked successfully. Copy everything from the
  429.           old machine to the new one, including all the preference files,
  430.           etc.
  431.           
  432.           For Oracle users, you then need to re-set the "home" directory
  433.           for Oracle (using the "Set Oracle Home" application in the
  434.           Oracle Applications folder), and everything works OK.
  435.           
  436.           (Note: This action should be fully documented in complience
  437.           with your software license; document when BusOb is installed on
  438.           a user's machine, when it is moved to a new machine and when it
  439.           is removed from the old machine. The assumption in this FAQ is
  440.           that software licenses are being followed.)
  441.           
  442.    Access
  443.           
  444.    U3.01
  445.           (PENN SPECIFIC) Why am I having problems getting into Business
  446.           Objects with my password?
  447.           
  448.           
  449.           Initially we have everyone using Steve Thompson's Oracle
  450.           account to access BusOb. This is controlled by the DICT.KEY
  451.           file. We plan to change access so everyone uses their own
  452.           Oracle account, which is important so access to data can be
  453.           controlled by the Oracle built-in security scheme.
  454.           
  455.           What that means is that you need to remember your Oracle
  456.           account and password, because you'll need it when we make the
  457.           change. But for now a BusOb account and password need to be
  458.           created for you, currently by Lori or Steve.
  459.           
  460.           When we make the change, we'll make announcements about it by
  461.           e-mail, then change Steve's Oracle account password so the old
  462.           DICT.KEY no longer gives access to data. At the same time we'll
  463.           make available a new DICT.KEY that requires you to login to
  464.           BusOb using your ORACLE account and password. Hopefully there
  465.           are few enough of us in the pilot group that we can minimize
  466.           the confusion of this process.
  467.           
  468.           If your Oracle account is different from your Business Objects
  469.           account, it is a good idea to contact Lori or Steve to change
  470.           your BusOb account.
  471.           
  472.    U3.02
  473.           Can I get rid of old universes by deleting directories/folders?
  474.           
  475.           
  476.           
  477.           Yes. From either Windows or Mac, delete the contents of the
  478.           appropriate directories as you would any other directory or
  479.           folder. For a universe called FRED, there is a directory/folder
  480.           called DEF/FRED containing the "definition" of the FRED
  481.           universe to Business Objects and STORAGE/FRED containing the
  482.           queries and results of queries that you have run against FRED.
  483.           Deleting the STORAGE/FRED directory will delete all queries
  484.           you've done again FRED, also.
  485.           
  486.           You might wish to be more selective in your cleanup. Since
  487.           results of queries and reports against those results are called
  488.           *.ASC and *.E??, you may delete just those files in order to
  489.           save space and still have the queries themselves (*.REQ) to run
  490.           again later if you need to.
  491.           
  492.    U3.03
  493.           What are some possible approaches to solving connection
  494.           problems?
  495.           
  496.           
  497.           Even after flawless installations of the middleware product
  498.           such as SQL*Net from Oracle and of BusOb, there may still be
  499.           connection problems. For example, you might get the error
  500.           "UNI-0010: Invalid access code". Your problem then is to
  501.           determine where the problem is -- with BusOb, with your
  502.           desktop, with your network software (ie., TCP/IP), with your
  503.           middleware, or with the server.
  504.           
  505.           BusOb provides a trace facility to aid in this detective work.
  506.           In the OBJECTS.INI file, change "INTERNALTRACE=NO" to
  507.           "INTERNALTRACE=YES". Then try to connect or do whatever you had
  508.           tried before without success, and then quit BusOb.
  509.           
  510.           BusOb will have created TMP\SQLBO.LOG (TMP:SQLBO.LOG on Macs)
  511.           which shows internal procedure calls and parameters passed to
  512.           and returned from the middleware. Error codes and messages
  513.           shown there may be very helpful in determining in what
  514.           component of software the problem derives.
  515.           
  516.    Performance
  517.           
  518.    U4.01
  519.           Why is Mac performance so poor?
  520.           
  521.           
  522.           The standard release of version 3.1.1E for the Mac (internally
  523.           known as Patch #4) experiences a long (10 - 30 second) lag time
  524.           between double clicking on the "Result Objects" bar and when
  525.           the list of available objects appears. There are apparently
  526.           also long delays in notifying the user that the connection
  527.           parameters fail to give a valid connection.
  528.           
  529.           In mid-September 1995, Patch #5 of version 3.1 was being
  530.           delivered to customers. It makes performance 5 to 14 times
  531.           faster, making the Mac and Windows comparable for most
  532.           purposes. Congratulations, Business Objects!
  533.           
  534.           There are also recommendations from Business Objects has been
  535.           to open the "Get Info" window for the BusOb application and
  536.           give it the maximum "Minimum Memory" you can. While always wise
  537.           for Mac applications, this doesn't make a noticeable
  538.           difference.
  539.           
  540.    U4.02
  541.           Why does canceling a query sometimes work and sometimes hang my
  542.           machine?
  543.           
  544.           
  545.           At Penn we use Oracle's SQL*Net to access data from Oracle,
  546.           including for access by Business Objects. Apparently either
  547.           SQL*Net or the TCP/IP package (NOT BusOB) restricts you to
  548.           being able to cancel only after you've received the first row
  549.           back in response to your query, not before. So waiting for the
  550.           row counter to indicate at least one record has been retrieved
  551.           means it's safe to cancel your query; otherwise your machine
  552.           will probably hang.
  553.           
  554.    User Interface
  555.           
  556.    U5.01
  557.           How can one retrieve queries from the repository?
  558.           
  559.           
  560.           When a universe is open, use the "File->Import query from
  561.           repository" menu item. Be sure to select "Import with
  562.           associated documents" to get any reports and charts that
  563.           accompany the query.
  564.           
  565.    U5.02
  566.           How do you find templates that are in the repository, or even
  567.           find the command to import them?
  568.           
  569.           
  570.           The "Templates" menu only appears from within a report. So
  571.           create a plain, vanilla report from your .ASC file by going to
  572.           ReportAssist, choosing the first report-type icon, then "Ok."
  573.           From the report screen, then, you can see the Templates menu.
  574.           Use "Import Templates from Repository" if you have not yet
  575.           retrieved the templates.
  576.           
  577.    U5.03
  578.           How can a Mac user close one universe and open another
  579.           universe, short of quitting and restarting BusOb?
  580.           
  581.           
  582.           The problem in changing universes in the Mac is that the old
  583.           universe stays selected when it is closed, so the menu pick
  584.           remains "Open Universe". If you click in the Universe window on
  585.           a blank area to deselect the old universe, then you will be
  586.           able to choose "Open Universe..." (note the dots now) to open
  587.           another universe, perhaps one you have not yet received from
  588.           the repository.
  589.           
  590.    U5.04
  591.           How can I get labels to print 3-up (in three columns)?
  592.           
  593.           
  594.           Create a default report and use the "Report Editor" (accessed
  595.           from the "Modify Document" icon or the "Modify Report" command
  596.           from the Document menu) for most of this.
  597.           
  598.           First, stack the lines of the label. Delete the column labels,
  599.           then stack the lines by dragging and dropping name, then
  600.           street1, then street2, etc. Create a variable ("Tools" menu)
  601.           which concatenates city, state, zip and country with blanks and
  602.           commas as needed into one string, and insert that variable
  603.           *instead of* the individual components. If street2 is often
  604.           blank, you might create two other variables: one which returns
  605.           street2 is non-blank, otherwise cityStateZip; and another which
  606.           returns cityStateZip if street2 is non-blank, otherwise blank.
  607.           
  608.           Then, make each cell narrow enough so that 3 columns will be
  609.           accommodated.
  610.           
  611.           Remove all headers, footers and other non-essential cells.
  612.           Click on the 'G' symbol, and uncheck the "Break footers" box.
  613.           This will make the report contents and the Global contents the
  614.           same height.
  615.           
  616.           Close the Report Editor with the File->Generate Total Report
  617.           menu selection. Then use page setup to choose number of columns
  618.           (3 in this case). The columns will only appear side-by-side in
  619.           Page Preview.
  620.           
  621.    U5.05
  622.           When creating conditions based on queries (rather than
  623.           Constant, Variable or Object), which queries does BusOb display
  624.           as candidate subqueries? For example, if the condition is on
  625.           SSN, are queries displayed in the dialog box only if their
  626.           result object is SSN?
  627.           
  628.           
  629.           BusOb is none too intelligent here. If there is only a single
  630.           result object in a query, that query is displayed as a
  631.           candidate, even if the objects are of different data types.
  632.           
  633.           For instance, if you've started a condition such as "Employee
  634.           SSN is in list", a query BIGDEPT might be listed as a possible
  635.           subquery since it has only one result object, say "Department
  636.           of Manager" even though that comparison doesn't make sense
  637.           based on the data.
  638.           
  639.    U5.06
  640.           How can I query for records based on lists of id's that I have
  641.           from other data sources? Say I have a file of SSN's to look up?
  642.           
  643.           
  644.           
  645.           The idea is to create an "in list" condition, then coerce your
  646.           file to show up when you click the "List of Values" button
  647.           instead of querying the database. (A disaster for something
  648.           like SSN!)
  649.           
  650.           This approach works because the normal behavior is for BusOb to
  651.           query the database only the 'first time', then to use those
  652.           results again until the "Refresh" button is pressed. The
  653.           results are stored in an .ASC file (as for normal query raw
  654.           results), with a name prefaced by an ampersand, such as
  655.           "&SSN__3.ASC". If you put your data in that file instead, then
  656.           when you create the "in list" condition and click the "List of
  657.           Values" button your data will be displayed and may be
  658.           highlighted to select as usual.
  659.           
  660.           The two gotchas are knowing what .ASC file to manipulate and
  661.           using the correct field delimeter. Identifying the .ASC file
  662.           name is easy when the BusOb manager has given all users access
  663.           to the MANAGERx universe. This universe holds data *about* the
  664.           other universes, listing class names, Select SQL strings,
  665.           object names, and, helpful in the current situation, the List
  666.           of Values Name. (Care should be taken when exporting this
  667.           universe, since it contains an object for "User Password".
  668.           Rather than exporting the generic MANAGERO universe for Oracle,
  669.           at Penn we have duplicated that universe and then removed the
  670.           password object (and named it UNIVRSES). Then it's usable by
  671.           all, and a query for Class Name, Object Name and List of Value
  672.           Name for the universe in question will show you the .ASC file
  673.           to use. The delimiter, which can be difficult to create, is
  674.           best copied from an existing query and pasted into the new
  675.           file.
  676.           
  677.           Each line of the .ASC file will look like this (for SSN's):
  678.  123456789|
  679.    
  680.           
  681.           (The final character is the 'pipe' or OR-bar character.)
  682.           
  683.           Make all lines the same line length; crashes have been seen
  684.           when variable-length lines are not padded prior to the pipe
  685.           character. A few lines for a variable-length object might
  686.           appear like this:
  687.           
  688.  
  689. POTATO   |
  690. CARROT   |
  691. ONION    |
  692. RUTABAGA |
  693.    
  694.           
  695.    U5.07
  696.           How can I get better control of how my headers and footers
  697.           appear? I want top-of-page headers related to some objects,
  698.           beginning-of-break footers related to others, and sometimes
  699.           text that accompanies each occurrence of an object.
  700.           
  701.           
  702.           There are two kinds of headers and footers. We'll call them
  703.           document headers/footers and break headers/footers. (These are
  704.           my terms.)
  705.           
  706.           Document headers/footers are akin to those in Excel; default
  707.           ones are created for you with basic info about the current
  708.           document and page, you can edit them more or less by hand, and
  709.           what you see of the header or footer is basically what you'll
  710.           see in the finished document. They are only visible in
  711.           formatted form using "File->Print Preview" (or use the toolbar
  712.           button -- look for the magnifying glass). Edit them by using
  713.           "Document->Modify Report" (hint text labels it "Modify
  714.           Document", since it's also used for modifying charts). By
  715.           default (when using QuickReport or ReportAssistant) you'll find
  716.           the variables QueryName, QueryDate and QueryTime in the
  717.           document header, and Page centered in the document footer.
  718.           These may be replaced with anything that you would like.
  719.           
  720.           Break headers/footers are printed every time the value of the
  721.           break variable(s) change. For example, if a "Month" result
  722.           object were in a document and there was a break header on it,
  723.           then a new header would appear when a previous row was
  724.           "November" and the current row is "December".
  725.           
  726.           Break headers/footers are visible from the regular document
  727.           viewing window, EXCEPT THAT using "Repeat Header on New Page"
  728.           (from the "Tools->Breaks" window) is only visible on the FIRST
  729.           page. Use PagePreview to see these headers on following pages.
  730.           Note that though there are several places to get this dialog
  731.           box, clicking the break icon in BusinessAnalyzer gives you a
  732.           break editor which leaves out certain options that you'll want
  733.           sometimes.
  734.           
  735.           But first you need to be sure you have these headers and
  736.           footers populated with text or variables, or else nothing will
  737.           show up because there was nothing TO show up! (Did you follow
  738.           that?)
  739.           
  740.           From "ModifyDocument", you'll see something like this (pardon
  741.           poor text-based illustration):
  742.           
  743.  
  744.        +---------
  745.        |      hg
  746.        | +-------
  747.        | |    h1
  748.        | | +-----
  749.        | | |  h2
  750.        | | |
  751.        G 1 2  Object names appear here
  752.        | | |
  753.        | | |  f2
  754.        | | +-----
  755.        | |    f1
  756.        | +-------
  757.        |      fg
  758.        +---------
  759.  
  760.    
  761.           
  762.           The areas in which you place headers at the global (document),
  763.           first break and second break levels are labeled hg, h1 and h2
  764.           respectively. Likewise, fg, f1 and f2 label where labels for
  765.           global, first level and second level breaks are placed. If
  766.           there are not empty cells ready to be filled in, use
  767.           "Edit->Insert..." (or tool bar buttons with arrows) to add new
  768.           cells or rows above (for headers) or below (for footers) the
  769.           appropriate break-level cell.
  770.           
  771.           Then, when leaving the ModifyDocument window, use
  772.           "File->Generate Total Report" (or Partial).
  773.           
  774.    U5.08
  775.           Why do some help screens describe features I can't locate, such
  776.           as the "complex query" button mentioned under "outer joins"?
  777.           
  778.           
  779.           SADLY, the help for the User version of BusOb is the same help
  780.           as for the Manager version, and it doesn't indicate which help
  781.           is for which version. The "complex query" button that is
  782.           mentioned is only available to Managers, for use when creating
  783.           automatic joins between tables, not to users, unfortunately.
  784.           (Already called in as an enhancement request.)
  785.           
  786.    U5.09
  787.           How can I have a query use an outer join?
  788.           
  789.           
  790.           You have to modify the SQL (with "Generate SQL" and "View SQL"
  791.           from the File menu). There is no way to do so from the "Modify
  792.           Query" screen.
  793.           
  794.           To explain this more, imagine a universe with several joined
  795.           tables and another table used to lookup values. For instance,
  796.           to find department names that match department codes. Say there
  797.           are a number of objects which contain department codes. If you
  798.           wanted to create a Condition "ManagingDepartmentCode equals
  799.           LookupDeptCode", it is not presently possible to have that
  800.           Condition be an outer join. (Already called in as an
  801.           enhancement request.)
  802.           
  803.    U5.10
  804.           How do I input the pipe or or-bar character?
  805.           
  806.           
  807.           The delimiter looks like a solid pipe (|), or perhaps a broken
  808.           pipe (either is OK), but *do not* use the pipe key on the
  809.           keyboard, regardless of whether you're using a DOS platform or
  810.           a Mac.
  811.           
  812.           On DOS platforms, use the DOS editor to edit the .SQL or .ASC
  813.           file. Go to the spot where you want the delimiter. Press and
  814.           hold down the Alt key while using the *numeric key pad* to type
  815.           179 and then release the Alt key. *Do not* use the number keys
  816.           that are above the letter keys.
  817.           
  818.           On a Mac, use cut and paste to copy the delimiter from an
  819.           existing LoV file.
  820.           
  821.    Training
  822.           
  823.    U6.01
  824.           How is the training provided by Business Objects?
  825.           
  826.           
  827.           The only reports I am aware of currently are for the 1-day user
  828.           training. Based on two reports only, this training has not been
  829.           praised. Ours, for instance, had complaints of quick movement
  830.           thru slides despite students not having understood the material
  831.           and inexperienced teachers.
  832.           
  833.           Dennis Broderick, dbroderi@goliath.brauntech.com, reports that
  834.           "the Business Objects training enrollment coordinator is Darla
  835.           at 408-864-2084."
  836.           
  837.    U6.02
  838.           How is the training provided by others?
  839.           
  840.           
  841.           According to mail from Dennis Broderick
  842.           (dbroderi@goliath.brauntech.com), "Business Objects has a
  843.           certification/authorization process that 'authorized' training
  844.           facilities must complete. The process involves learning and
  845.           'student teaching' activities under BusObj supervision plus an
  846.           audit by BusObj. Contact Carla Parone, the BusObj training
  847.           manager, at 408 864-2010."
  848.           
  849.           
  850.           Some of these authorized trainers are:
  851.           + Braun Technology Group (BTG) (Chicago, 312-443-1317). Dennis
  852.             Broderick, dbroderi@goliath.brauntech.com, reports that:
  853.             
  854.             "Braun Technology Group (BTG) is the authorized training
  855.             center for Business Objects in the Midwest. BTG teaches both
  856.             the 1-day user course and the 3-day Universe Manager course.
  857.             Both courses are offered monthly in Chicago. BTG also
  858.             customizes and teaches Business Objects courses at client
  859.             sites. Also, BTG provides implementation consulting and
  860.             assistance for the Business Objects products. For enrollment
  861.             information contact Allen Rice, 312 443-1317x168 or
  862.             krice@brauntech.com.
  863.             
  864.           + Context Integration (New York City, 212-785-6100),
  865.             http://www.context.com.
  866.             Regan Coleman reports:
  867.             
  868.             "Yes, we are certified training partners, and we have three
  869.             facilities: one in New York, one in Austin, TX, and one in
  870.             South San Francicso,CA." They also offer customized end-user
  871.             and manager training, both on-site and off-site.
  872.             
  873.             I took the manager training from them and found it excellent,
  874.             and two other people have given me strong reviews for them
  875.             for both the 3-day manager training and the user training.
  876.             
  877.             They were expecting to have Advanced Users training beginning
  878.             the summer of 1995, and at that time were developing an
  879.             Advanced Managers training.
  880.             
  881.           + Recon Corp. Saratoga (San Jose) CA., 408-866-8676,
  882.             recon@netcom.com. "Based in the Silicon Valley, Recon
  883.             provides database development, consulting and training
  884.             solutions. As a certified training and consulting partner to
  885.             Business Objects we conduct the standard user and manager
  886.             training. Additionally we prepare customized user training
  887.             which has been very well received by our clients."
  888.    
  889.           
  890.           
  891.           (Standard disclaimer here. I have no connection other than as a
  892.           customer with any organization other than my employer. As
  893.           additional information is offered for this FAQ, it will be
  894.           added without prejudice.)
  895.           
  896.    Upcoming Versions
  897.           
  898.    U7.01
  899.           What can we expect from BubOb v4.0 (codenamed Mercury)?
  900.           
  901.           
  902.           Concerning the weakened security of storing the manager
  903.           password on the desktop where it may be copied to other
  904.           machines, a contributor reports: "I've seen the Alpha Version
  905.           of BO Version 4.0 and it seemed to me that they replaced the
  906.           OBJECTS.USE through a role concept which is stored somewhere in
  907.           the repository. I think they know at BO why they do that."
  908.           
  909.           Carol Rice, carol.rice@octel.com, reports:
  910.           
  911.           "I called Business Objects tech support relative to Business
  912.           Query 1.1 and its ability to run on Excel 7, and the official
  913.           word is that BizQuery 1.1 does not support Excel 7. The support
  914.           guy I spoke to was very vague as to when it WILL be supported,
  915.           and I'm expecting a call back from a more senior manager
  916.           regarding timing on this issue. Perhaps if someone other than
  917.           me called them about getting Business Query updated for Excel 7
  918.           (it's only an add-in, for heaven's sake), they might push
  919.           development forward."
  920.           
  921.           Tech Support reported in a phone call in early March that
  922.           Mercury is "on schedule" for the end of Q196 or early April,
  923.           but that it will be a "controlled release" only. For more
  924.           information about what that means, I was referred to my
  925.           salesperson. Mercury's beta version was out December 1995, and
  926.           is currently at the beta-2 level.
  927.           
  928.           Does anyone know anything else that we are able to publicize?
  929.           
  930.    U7.02
  931.           What are new features that we BusOb users and managers wish
  932.           would be added to the tool?
  933.           
  934.           
  935.           I am aware that Business Objects staff are aware of this FAQ.
  936.           Lacking a mail list or a newsgroup to communicate with them,
  937.           here are some features that have been frequently requested:
  938.           
  939.           + Allow objects of the same name in one universe, as long as
  940.             object names are unique within the class.
  941.    
  942.           
  943.           Please contact the maintainer of this list with additions. 
  944.           
  945.   MANAGER ISSUES
  946.    M1.01
  947.           What are some approaches to resolving loops in the joins?
  948.           
  949.           
  950.           A loop is at least two tables which have two or more sets of
  951.           joins between them, so an entity relationship diagram of the
  952.           tables would have an enclosed area composed of the tables and
  953.           their joins. An example from my subject area might involve the
  954.           tables STUDENT and INSTRUCTOR. A STUDENT is taught by an
  955.           INSTRUCTOR and is advised by an INSTRUCTOR. The tables can be
  956.           joined from STUDENT.INSTRUCTOR_ID to INSTRUCTOR.ID and also
  957.           from STUDENT.ADVISOR_ID to INSTRUCTOR.ID. Rarely will the
  958.           teacher be the same person as the advisor, so applying both
  959.           joins at the same time is rarely desired.
  960.           
  961.           One approach is to use contexts, always at least two. A context
  962.           is a set of joins that should be applied at one time. If
  963.           objects from classes are selected which involve tables from a
  964.           loop, the user is asked to decide which of the contexts to use.
  965.           Present experience, both within and not within BusOb, suggests
  966.           that creating and naming contexts so as to give the user a
  967.           clear idea of which to pick is hard.
  968.           
  969.           Another approach is to use aliases (available starting with
  970.           version 3.1, I believe). Aliases are alternate names for
  971.           tables. Joins and objects are then based on the alias for a
  972.           table instead of the table itself, and thus only the joins
  973.           which correspond to the alias are in effect for a join. This
  974.           sounds clearer, but it still requires decision on the part of
  975.           the user. Ought they select this object, or that object? It may
  976.           also require creating duplicate classes, one for each table or
  977.           alias name.
  978.           
  979.    M1.02
  980.           How can I have a context with no joins?
  981.           
  982.           
  983.           Create a join from one table to the same table, specify complex
  984.           join, then type in "1=1". This places a harmless condition on a
  985.           table. Then, create a new context for which only that 1=1 join
  986.           is selected. The only joins, then, will be user-created joins
  987.           by means of conditions. We have found some situations where
  988.           experienced users needed a clean slate environment to
  989.           experiment with new joins.
  990.           
  991.    M1.03
  992.           Why can't I add new objects?
  993.           
  994.           
  995.           Three possibilities come to mind: you've exceeded the value for
  996.           NBOBJ in OBJECTS.INI (which defaults to 2000 for ver. 3.0.1E);
  997.           you've exceeded the maximum for the individual "hashing file"
  998.           that your intended object would belong to; or your _OBJECTS.ASC
  999.           isn't a subset of your _STRUCT.ASC.
  1000.          1. NBOBJ exceeded. Entries in memory are reserved for the number
  1001.             of objects specified by NBOBJ in OBJECTS.INI, and you are
  1002.             trying to add yet another object. You may need to divide the
  1003.             objects between two or more universes, or increase NBOBJ.
  1004.             Note that increasing NBOBJ on one manager's machine means
  1005.             increasing NBOBJ on every machine (user and manager) that
  1006.             will need to use that universe, and BusOb will be using more
  1007.             RAM while running on each of those machines.
  1008.          2. Filled hashing file. BusOb divides a universe's objects
  1009.             between 8 files in the DEF directory, each of which is
  1010.             assigned to store a portion of all of the objects. For
  1011.             instance, for a universe XYZZY, the file XYZZY.ID2 stores all
  1012.             objects beginning with 'D' up to 'F' (inclusive), and
  1013.             XYZZY.ID8 has objects starting with W-Z, plus all numbers and
  1014.             symbols. Each of these files has a maximum number of objects,
  1015.             which may be ( NBOBJ / 8 ). If all of your objects are named
  1016.             starting, say, with "Data containing ...", then XYZZY.ID2 may
  1017.             be full even though the other hashing files are empty.
  1018.          3. _OBJECTS not subset of _STRUCT. The .PRM files allow
  1019.             different 'strategy files', with SQL other than the default
  1020.             SQL to create different sets of candidate objects from your
  1021.             data dictionary or other source. This may be useful, for
  1022.             example, if you use Oracle, since the default SQL requires
  1023.             that each user have private SYNONYMs created for each table
  1024.             that will be accessed. A different strategy file will vary
  1025.             the contents of _OBJECTS.ASC which represents the candidate
  1026.             objects. Unfortunately, _OBJECTS.ASC must be the same or a
  1027.             subset of _STRUCT.ASC, and _STRUCT.ASC is not affected by the
  1028.             strategy files. You also, then, must modify your ST*.SQL file
  1029.             (for Oracle 7, it's STORA7.SQL) to include tables for all
  1030.             possible objects in the _STRUCT.ASC.
  1031.    
  1032.           
  1033.    M1.04
  1034.           Are there any "gotchas" with using the Advanced Login Strategy
  1035.           for managing security?
  1036.           
  1037.           
  1038.           The Advanced Login Strategy allows the BusOb user to use their
  1039.           RDBMS userid and password to login to BusOb. The BusOb userid
  1040.           must match the RDBMS userid. The password, however, may be any
  1041.           value, since the strategy ignores the BusOb password entirely.
  1042.           All security restrictions are imposed by the RDBMS itself.
  1043.           Advanced Login is activated by installing a replacement .BUR
  1044.           for LIBRARY/DEFAULT.BUR, available from BusOb.
  1045.           
  1046.           Therefore, the user doesn't need to keep their BusOb password
  1047.           synchronized with their RDBMS password (as for Same Login), and
  1048.           all users don't access the RDBMS using only one userid/password
  1049.           with only one set of security privileges (as for Separate
  1050.           Login).
  1051.           
  1052.           At least one site (U. Penn.) has successfully tested .BUR files
  1053.           both for Windows 3.1 and Macintosh platforms.
  1054.           
  1055.    M1.05
  1056.           What do I do if I lose my manager password?
  1057.           
  1058.           
  1059.           Two options: Reinstall BusOb from the original disks, so that
  1060.           the defaults of USER/PASS are restored, or get another copy of
  1061.           OBJECTS.USE (*not* DICT.KEY as was previously stated here!) for
  1062.           which you *do* know the userid/password (from a co-manager?).
  1063.           Either way, change the userid/password to be the desired new
  1064.           password (that you can remember :-).
  1065.           
  1066.           A contributer to this FAQ rightly points out that publicizing
  1067.           this use of OBJECTS.USE may be a potential security hole. The
  1068.           contributor's policy is to require reinstallation of the
  1069.           Manager option. While I agree that public knowledge of it gives
  1070.           the potential cracker a key piece of information, they still do
  1071.           not have the password. We can hope that the encryption that
  1072.           BusOb uses for the password in this file is strong. To leave
  1073.           out the use of OBJECTS.USE to improve security, however, makes
  1074.           life harder for those who might benefit from knowing about it,
  1075.           and I assume a cracker could learn of it from other sources.
  1076.           Additional input on this choice is welcome. (See also the
  1077.           question on BusOb v4.0.)
  1078.           
  1079.    M1.06
  1080.           How can I programmatically modify object names?
  1081.           
  1082.           
  1083.           While the details of this task will vary based on your RDBMS,
  1084.           modifying several features of a universe consists of UPDATE sql
  1085.           commands sent to the RDBMS. First, Export the universe to be
  1086.           sure the "freshest" version is reflected in the repository. The
  1087.           repository tables are nicely normalized, so changing OBJ_NAME,
  1088.           for instance, from the OBJECTS table changes the object in the
  1089.           particular table while keeping integrity.
  1090.           
  1091.           For example, SQL might appear as follows:
  1092.  
  1093.  prompt MY_CLASS, MY_OBJ
  1094.  update objects
  1095.     set obj_name = 'New Object Name'
  1096.     where uni_id = 3
  1097.       and cla_id = 12
  1098.       and obj_id = 74  ;
  1099.    assuming, of course, that one had already determined that the object
  1100.           was in universe number 3 and class number 12 and object number
  1101.           is 74. Use joins in MANAGERx (exact name depends on your RDBMS)
  1102.           universe to determine these values correctly to correspond to
  1103.           the names of universe, class and object you wish to modify.
  1104.           Perl and SQL scripts already exist to help automate some of
  1105.           these steps; contact Steve Thompson at thompson@isc.upenn.edu.
  1106.           
  1107.    M1.07
  1108.           How can I modify the MANAGERx universe to allow reporting on
  1109.           aliases?
  1110.           
  1111.           
  1112.           Evidently when BusOb released v. 3.1.1E, they did not update
  1113.           the MANAGERx universe (x is 'O' for Oracle, 'S' for Sybase,
  1114.           others might exist) to reflect that aliases were now possible
  1115.           in universes. To modify MANAGERx, add the following classes and
  1116.           joins:
  1117.           
  1118.           + BO_ALIAS (table)
  1119.           + TABLES2 (alias for TABLES table)
  1120.           + TABLES.UNI_ID = BO_ALIAS.UNI_ID (+) AND TABLES.TAB_ID =
  1121.             BO_ALIAS.ALI_ID (+)
  1122.           + BO_ALIAS.UNI_ID = TABLES2.UNI_ID (+) AND BO_ALIAS.TAB_ID =
  1123.             TABLES2.TAB_ID (+)
  1124.    
  1125.           
  1126.           These joins assume Oracle, with Oracle outer joins indicated by
  1127.           "(+)" where nulls are permitted.
  1128.           
  1129.    M1.08
  1130.           How can I find the metamodel for the repository files?
  1131.           
  1132.           
  1133.           See the URL http://www.upenn.edu/da/bo/busob-model.gif for a
  1134.           reverse-engineered version. (Caveat! Caveat! No warrantees!)
  1135.           
  1136.    
  1137.    
  1138.    
  1139.      _________________________________________________________________
  1140.    
  1141.    Thanks to the contributors to this FAQ. This FAQ is maintained by
  1142.    thompson@isc.upenn.edu
  1143.      _________________________________________________________________
  1144.  
  1145.