


----------------------------------------------------------------------
SHARING THE DATA (BOOKS, BOOKSHELVES AND SEARCH INDEXES)

The following steps assume that you have already successfully
installed either one of the BookManager Read products or one of the
IBM Library Readers on your work station.

1.  Create a subdirectory on the server hard disk to hold the shared
    data

2.  Create a file alias on the Server using the LAN Server.

3.  Grant access permissions to the file alias to the proper users.

4.  Have the alias assigned to a drive letter on the user's
    workstation

    o   by specifying the assignment as part of the user's logon
        assignments, or

    o   with a NET USE command executed on the user's workstation.

5.  Add the new drive to the BookManager path

    o   Run the Install program from the CD-ROM and specify the new
        drive when specifying where books are located

        Or,
    o   Update the environment variables for your read product to
        point to the new drive:
            SET BOOKMGR= for READ/2 (in CONFIG.SYS)
            SET READIBM2= for IBM Library Reader/2 (in CONFIG.SYS)
            -bpath= for READ/DOS (in READDOS.PRO)
            -bpath= for IBM Library Reader/DOS (in READIBM.PRO)


-------------------------
SHARING A CD-ROM ON A LAN

Almost the same as sharing a hard disk subdirectory.

Create a File Alias for the drive.

Since the CD-ROM discs are removable and each can have different
directory structures, it is better to grant access to the entire
drive.

To do this, create an access control profile for the drive and NOT the
root directory of the drive.  (for example, G: instead of G::\)

If a DOS Lan Requester is going to access an OS/2 Server's CD-ROM,
increase the Network Buffer Count (NBC) one higher than the
installation default in the requester's DOSLAN.INI file.

     RCV reqname  domain
     /SRV:8 /ASG:29 /NBC:5 /NBS:1K /BBC:1 /BBS:4K ...
     ...


---------------------
CD-ROM ACCESS CONTROL

+------------------------------------------------------------------------------+
| Actions  Servers  Exit                                            |  F1=Help |
|------------------------------------------------------------------------------|
|                                                                              |
|                      Create an Access Control Profile                        |
|                                                                              |
|                                                                              |
|  Complete the panel; then Enter.                                             |
|                                                                              |
|  Profile. . . . . . . . . . . . . .  (G:                                     |
|  Resource type. . . . . . . . . . . > File                                   |
|                                       Serial device                          |
|                                       Printer                                |
|                                                                              |
|  Universal Access Permission. . . .  (XR     )                               |
|                                                                              |
|  Audit trail. . . . . . . . . . . . > None                                   |
|                                       All accesses                           |
|                                       Failed accesses                        |
|                                                                              |
|------------------------------------------------------------------------------|
|  Enter  Esc=Cancel  F1=Help  F4=List                                         |
+------------------------------------------------------------------------------+

To get to this panel select the following pulldown items:

     Definitions
         Access control...
     Servers
         Display profiles by server...
     Actions
         Create...



----------------------------------------------------------------------
SHARING THE APPLICATION


You can share the IBM Library Reader program of the BookManager Read
program by defining it as a PUBLIC APPLICATION

NOTE:  If you are using one of the BookManager licensed programs
(BookManager Read/DOS or BookManager Read/2, you must purchase
licenses for the maximum number of concurrent users.

o   BookManager Read/2 or IBM Library Reader/2 can be defined as a
    Public Application for OS/2 Requesters.

o   BookManager Read/DOS of IBM Library Reader/DOS can be defined as a
    Public DOS Application for DOS Requesters.

LICENSING

LAN Server has facilities for controlling the number of workstations
that have concurrent access to a set of files.  The "Maximum number of
users" parameter should be set to the number of READ licenses that
have been purchased (if using BookManager Read/2 or BookManager
Read/DOS.


--------------------------------------------------
SHARING IBM LIBRARY READER/2 OR BOOKMANAGER READ/2

Factors to consider:

o   BOOKMGR= or READIBM2= environment variable (in CONFIG.SYS) needs
    to point to the books.

o   Read/2 and IBM Library Reader/2 need access to their dynamic link
    libraries (.DLL).


STEPS FOR SHARING IBM LIBRARY READER/2 OR BOOKMANAGER READ/2

STEPS

o   Put the code on the server in a directory.

o   Create a File alias for this subdirectory.

o   Grant access to alias to proper users.

o   Define the Public Application starting a command file instead of
    READ/2 or IBM Library Reader/2.


FILE ALIAS

+------------------------------------------------------------------------------+
| Actions  Access Profile  Exit                                     |  F1=Help |
|------------------------------------------------------------------------------|
|                                                                              |
|                           Update Aliases - Files                             |      |
|                                                                              |
|                                                                              |
|  Change the details; then Enter.                                             |
|                                                                              |
|                                                                              |
|  Alias . . . . . . . . . . . . . . . . . :  R2                               |
|  Description . . . . . . . . . . . . . . .  Access Online Books              |
|  Server name . . . . . . . . . . . . . . :  BOOKDC                           |
|  Server path to directory. . . . . . . . :  D:\TOOLS\READIBM2                |
|                                                                              |
|  Maximum number of users . . . . . . . . .  (20   )                          |
|                                                                              |
|  When shared . . . . . . . . . . > As required by user                       |
|                                    At server startup                         |
|                                    By administrator action                   |
|                                                                              |
|                                                                              |
|------------------------------------------------------------------------------|
|  Enter  Esc=Cancel  F1=Help                                                  |
+------------------------------------------------------------------------------+

This sample is for a LAN that has 20 users.  The LAN Server will allow
up to 20 workstations on the LAN to have access to the alias that
holds the product code.


ACCESS TO THE FILE ALIAS

+------------------------------------------------------------------------------+
| Actions  Access Profile  Exit                                     |  F1=Help |
|------------------------------------------------------------------------------|
|                                                                              |
|                      Update an Access Control Profile                        |
|                                                                              |
|  Change the details; then Enter.                                             |
|                                                                              |
|  Server . . . . . . . . . . . . :  BOOKDC                                    |
|  Profile. . . . . . . . . . . . :  D:\TOOLS\READIBM2                         |
|  Resource type. . . . . . . . . :  Files                                     |
|                                                                              |
|  Universal Access Permission. . .  (XR     )                                 |
|                                                                              |
|  Audit trail. . . . . . . . . . . > None                                     |
|                                     All accesses                             |
|                                     Failed accesses                          |
|                                                                              |
|------------------------------------------------------------------------------|
|  Enter  Esc=Cancel  F1=Help  F4=List                                         |
+------------------------------------------------------------------------------+


PUBLIC APPLICATION DEFINITION

+------------------------------------------------------------------------------+
| Actions  Network Assignments  Starter  Exit                       |  F1=Help |
|------------------------------------------------------------------------------|
|                                                                              |
|                       Update OS/2 Application Details                        |
|                                                                              |
|                                                                              |
|  Complete the panel; then Enter.                                             |
|                                                                              |
|  Application ID . . . . . . . . . . . . :  READ2                             |
|  Description. . . . . . . . . . . . . . .   IBM Library Reader/2             |
|  Program location . . . . . . . . . . . .   Local                            |
|                                           > Remote                           |
|  Drive or alias . . . . . . . . . . . . .   R2                               |
|  Remaining path to program. . . . . . . .   \                                |
|  Command line . . . . . . . . . . . . . .   lanread2.cmd                     |
|  Prompt user for parameters ? . . . . . . > No                               |
|                                             Yes                              |
|  Program type . . . . . . . . . . . . . .   OS/2 PM                          |
|                                             Protmode                         |
|                                           > VIO                              |
|------------------------------------------------------------------------------|
|  Enter  Esc=Cancel  F1=Help  F4=List                                         |
+------------------------------------------------------------------------------+




PUBLIC APPLICATION WORKING DIRECTORY

+------------------------------------------------------------------------------+
| Actions  Network Assignments  Starter  Exit                       |  F1=Help |
|------------------------------------------------------------------------------|
|                                                                              |
|                              Working Directory                               |
|                                                                              |
|                                                                              |
|  Complete the panel; then Enter.                                             |
|                                                                              |
|                                                                              |
|  Working directory . . . . . . . . . . .   Not specified                     |
|                                            Local                             |
|                                          > Remote                            |
|  Drive or alias. . . . . . . . . . . . .   R2                                |
|  Remaining path. . . . . . . . . . . . .   \                                 |
|  Assigned drive. . . . . . . . . . . . .   Q                                 |
|                                                                              |
|------------------------------------------------------------------------------|
|  Enter  Esc=Cancel  F1=Help  F4=List                                         |
+------------------------------------------------------------------------------+

This makes the directory with the read code the current directory while
the public application is running.

To make the .DLLs accessible to the requester either add q:\ or .
(dot) to the LIBPATH.

   LIBPATH=.;C:\OS2\DLL;C:\MUGLIB\DLL;\IBMLAN\NETLIB;


COMMAND FILE TO START LIBRARY READER/2

LANREAD2.CMD

  rem access books
  net use K: booksdir
  rem tell READ/2 where to look for books
  set readibm2=k:\
  rem start READ/2
  readibm2 /s
  rem drop access to books
  net use K: /d
  exit

The /S when starting Library Reader/2 will bring up the "BookManager
Books and Bookshelves" window filtered to show only the bookshelves in
the path.  This is useful when the number of objects available is very
large.

The /DS option can be used to show details of the bookshelves when
starting.








------------------------------------------------------
SHARING IBM LIBRARY READER/DOS OR BOOKMANAGER READ/DOS

Factors to consider:

    Profile

    o   contains -bpath and other variables

    o   user defined screen colors

    o   closing bookmarks

    o   desirable to have one per user

    Program structure

    o   multiple .exe files (found via PATH)

    o   creates temporary files (need to be written to a different
        location for each user).


STEPS FOR SHARING IBM LIBRARY READER/DOS OR BOOKMANAGER READ/DOS

o   Put the code on server in a subdirectory.

o   Create a file alias for this subdirectory.

o   Grant access to alias to proper users.

o   Define Public DOS Application starting a batch file instead of
    BookManager Read/DOS or IBM Library Reader/DOS.


FILE ALIAS

























+------------------------------------------------------------------------------+
| Actions  Access Profile  Exit                                     |  F1=Help |
|------------------------------------------------------------------------------|
|                                                                              |
|                           Update Aliases - Files                             |      |
|                                                                              |
|                                                                              |
|  Change the details; then Enter.                                             |
|                                                                              |
|                                                                              |
|  Alias . . . . . . . . . . . . . . . . . :  RDOS                             |
|  Description . . . . . . . . . . . . . . .  Library Reader/DOS Code          |
|  Server name . . . . . . . . . . . . . . :  BOOKDC                           |
|  Server path to directory. . . . . . . . :  D:\TOOLS\READIBM                 |
|                                                                              |
|  Maximum number of users . . . . . . . . .  (20   )                          |
|                                                                              |
|  When shared . . . . . . . . . . > As required by user                       |
|                                    At server startup                         |
|                                    By administrator action                   |
|                                                                              |
|                                                                              |
|------------------------------------------------------------------------------|
|  Enter  Esc=Cancel  F1=Help                                                  |
+------------------------------------------------------------------------------+

This sample is for a LAN that has 20 users.  The LAN Server will allow
up to 20 workstations on the LAN to have access to the alias that
holds the product code.


ACCESS TO THE FILE ALIAS

+------------------------------------------------------------------------------+
| Actions  Access Profile  Exit                                     |  F1=Help |
|------------------------------------------------------------------------------|
|                                                                              |
|                      Update an Access Control Profile                        |
|                                                                              |
|  Change the details; then Enter.                                             |
|                                                                              |
|  Server . . . . . . . . . . . . :  BOOKDC                                    |
|  Profile. . . . . . . . . . . . :   D:\TOOLS\READIBM                         |
|  Resource type. . . . . . . . . :  Files                                     |
|                                                                              |
|  Universal Access Permission. . .  (XR     )                                 |
|                                                                              |
|  Audit trail. . . . . . . . . . . > None                                     |
|                                     All accesses                             |
|                                     Failed accesses                          |
|                                                                              |
|------------------------------------------------------------------------------|
|  Enter  Esc=Cancel  F1=Help  F4=List                                         |
+------------------------------------------------------------------------------+


PUBLIC APPLICATION

+------------------------------------------------------------------------------+
| Actions  Network Assignments  Selector  Exit                      |  F1=Help |
|------------------------------------------------------------------------------|
|                                                                              |
|                        Update DOS Application Details                        |
|                                                                              |
|                                                                              |
| Complete the panel; then Enter.                                              |
|                                                                              |
| Application ID. . . . . . . . . . . . :  READIBM                             |
| Description . . . . . . . . . . . . . .  IBM Library Reader/DOS              |
| DOS command line. . . . . . . . . . . .  lanread.bat                         |
| Program Location                                                             |
|   Alias . . . . . . . . . . . . . . . . . . . . . . . . . .  RDOS            |
|   Remaining path to program . . . . . . . . . . . . . . . .  \               |
|   Assigned drive. . . . . . . . . . . . . . . . . . . . . .  *               |
|                                                                              |
| Prompt user for parameters. . . . . . . . . . . . . . . . . > No             |
|                                                               Yes            |
|                                                                              |
| Do you want to recreate the batch file ?. . . . . . . . . . > No             |
|                                                               Yes            |
|                                                                              |
|------------------------------------------------------------------------------|
|  Enter  Esc=Cancel  F1=Help  F4=List                                         |
+------------------------------------------------------------------------------+


BATCH FILE TO START LIBRARY READER/DOS

LANREAD.BAT

  rem get access to books
  net use K: booksdir
  rem save current path
  set oldpath=%PATH%
  rem the variable DRV gets set to drive with program
  rem      example   D:
  set path=%DRV%\
  c:
  cd \
  if exist readibm.pro goto isprof
  rem install profile on user workstation if not found
  copy %DRV%\readibm.pro c:\
  :isprof
  rem tell Library Reader/DOS where to look for profile
  set readibm=c:\readibm.pro
  rem start Library Reader/DOS bringing up list of shelves in path
  bookmgr *.bks
  rem restore path (so the net command can be found)
  path %oldpath%
  rem discard temporary variable
  set oldpath=
  rem drop access to books
  net use K: /d


SAMPLE PROFILE

READIBM.PRO

  *                       Library Reader/DOS Profile
  -p1
  -temppath=c:\
  -newnotefiledirectory=c:\
  *  add k: LAN drive to bpath
  -bpath=c:\;c:\books;k:\


---------------------------
NOTE FILES WITH OS/2 SYSTEM

The BookManager Read and IBM Library Reader products allow you to add
notes to online books.  These notes are kept in a file separate from
the book file.  Unfortunately, these products were not designed to
allow note files to be transparently shared across a LAN.

IBM LIBRARY READER/2 AND BOOKMANAGER READ/2 NOTE FILES

Notes are placed in the first writable directory found using the
following search pattern:

1.  The "current" directory (where the program was started from)
2.  The directory in which the book is located.
3.  The C:\ (C root) directory.


--------------------------
NOTE FILES WITH DOS SYSTEM

IBM LIBRARY READER/DOS AND BOOKMANAGER READ/DOS NOTE FILES

When searching for a note file for a book, the sequence is:

1.  the current directory
2.  the directories in the path in the order specified
3.  the new note file directory.

When asked to create a new note file, READ/DOS will create it in the
directory specified by -newnotefiledirectory= in the profile.  If not
specified, the note file will be created in the current directory.

