home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / netdor3.zip / VNDINST / DOCS / ADMINDOC.INF (.txt)
OS/2 Help File  |  1996-04-04  |  36KB  |  1,373 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Managing the Concurrent Use of Licensed Programs ΓòÉΓòÉΓòÉ
  3.  
  4. The concurrent use of licensed software applications is provided by a component 
  5. of NetDoor called Vendor. Vendor is a front-end to licensed software residing 
  6. on a local area network. The Vendor client is a Presentation Manager program 
  7. that users must run to gain access to remote vendor software. You can install a 
  8. licensed application on a remote server so that a user's sole access method to 
  9. the application is through Vendor. All of the monitoring details are performed 
  10. by the Vendor Server to ensure that each use of each application is recorded. 
  11.  
  12. Vendor is a client/server set of applications to share the use of licensed 
  13. software in a LAN environment. The vendor client application is discussed in 
  14. the IBM Network Door/2 User's Guide. The Vendor Server component consists of 
  15. several programs described in this section. These programs need to be run on a 
  16. LAN file server. The file server that runs these programs is called the Vendor 
  17. Server. 
  18.  
  19.  
  20. ΓòÉΓòÉΓòÉ 2. Using Licensed Software ΓòÉΓòÉΓòÉ
  21.  
  22. Using licensed software accessed via the Vendor program offers many benefits 
  23. over installing the software locally: 
  24.  
  25.  o Reduced costs 
  26.  
  27.    Many software companies provide LAN versions of their programs. A LAN 
  28.    version of a program can be obtained at a substantial cost savings when 
  29.    compared to its stand-alone or local version. Many companies that do not 
  30.    have LAN versions of their products require an additional license fee or 
  31.    some other form of reimbursement for each person using their product. These 
  32.    fees are usually much less than the usual product price. 
  33.  
  34.  o Maximum use per dollars spent 
  35.  
  36.    Traditionally the amount of time a user uses an application is limited. For 
  37.    this reason many users own software that lies dormant for hours, days, 
  38.    weeks, or even months. Vendor addresses this problem by providing a 
  39.    mechanism by which users can share licenses. These licenses are referred to 
  40.    as simultaneous or concurrent use licenses. 
  41.  
  42.  o Instant access to licensed software packages 
  43.  
  44.    The Vendor program provides users with immediate access to applications. 
  45.  
  46.  o Reduced installation time and complexity 
  47.  
  48.    Software applications are often complex and difficult to install. Instead of 
  49.    each user installing the package, the NetDoor administrator can install and 
  50.    test all software accessible by the Vendor program. If needed, the 
  51.    administrator can write additional documentation to aid in the use or setup 
  52.    of packages that are difficult to use or configure. 
  53.  
  54.  o Remote software saves local hard-disk storage space 
  55.  
  56.    Application software running under OS/2 often contains many files and 
  57.    requires significant hard-disk storage space. By storing these packages 
  58.    remotely, where users can use one copy of the package, hard-disk storage 
  59.    requirements are greatly reduced. If 20 users frequently use a remote 
  60.    package requiring 10MB of diskette space, the total savings is 190MB. 
  61.  
  62.  
  63. ΓòÉΓòÉΓòÉ 3. What You Will Need ΓòÉΓòÉΓòÉ
  64.  
  65. Vendor provides all of its functions in both LAN Server and TCP/IP 
  66. environments. 
  67.  
  68.  o NetBIOS 
  69.  
  70.    In a NetBIOS environment the Vendor Server must be running OS/2 Version 1.3 
  71.    Extended Edition or higher. The Vendor Server must be an additional LAN 
  72.    server or the domain controller in a domain in which all users have access. 
  73.    To be given access to the vendor server, a user must have a user ID and 
  74.    password in that domain. 
  75.  
  76.  o TCP/IP 
  77.  
  78.    In a TCP/IP environment the vendor server must have a minimum operating 
  79.    system level of OS/2 Version 1.3 Standard Edition with OS/2 TCP/IP 1.2.1 
  80.    (service level UN 37938) and LAPS installed. A TCP/IP user with IP access to 
  81.    the vendor server can access software applications. 
  82.  
  83.  
  84. ΓòÉΓòÉΓòÉ 4. What the Installation Diskette Contains ΓòÉΓòÉΓòÉ
  85.  
  86. Many different files are mentioned in this chapter. Refer to this list to 
  87. determine the source of a given file. 
  88.  
  89.  
  90.  \ (root) directory
  91.      INSTALL.EXE    -  Installation program.  Run this to install Vendor Server.
  92.      CONTENTS.CID   -  Data file indicating title and version information.
  93.      READ.ME        -  Important getting started and last minute info.
  94.  
  95.  \VNDADMIN subdirectory
  96.      INSTNET.FIL    -  Installation commands for NetBIOS vendor server installation.
  97.      INSTNFS.FIL    -  Installation commands for TCP/IP vendor server installation.
  98.      SAMPLE.INF     -  Sample vendor application information file.
  99.      SAMPLE.LIC     -  Sample vendor application license file.
  100.      VNDADMIN.EXE   -  Administrators exec.
  101.      VNDADMIN.HLP   -  Help Manager documentation for VndAdmin.
  102.      VNDNET.DLL     -  Vendor NetBIOS specific DLL.
  103.      VNDSRVR.ICO    -  Icon file for VNDSRVR.EXE.
  104.      VNDTCP.DLL     -  Vendor TCP/IP specific DLL.
  105.  
  106.  \VNDADMIN\NETBIOS subdirectory
  107.      VNDSRVR.EXE    -  NetBIOS server daemon which runs on the vendor server.
  108.      VNDTRACE.EXE   -  NetBIOS admin utility used to toggle vendor daemon output.
  109.      VNDKILL.EXE    -  NetBIOS admin utility used to stop vendor daemon.
  110.      VNDMON.EXE     -  NetBIOS admin utility useful for monitoring vendor daemon.
  111.      VNDSTART.EXE   -  Utility program used to start vendor server.
  112.  
  113.  \VNDADMIN\TCPIP subdirectory
  114.      VNDSRVR.EXE    -  TCP/IP server daemon which runs on the vendor server.
  115.      VNDTRACE.EXE   -  TCP/IP admin utility used to toggle vendor daemon output.
  116.      VNDKILL.EXE    -  TCP/IP admin utility used to stop vendor daemon.
  117.      VNDMON.EXE     -  TCP/IP admin utility useful for monitoring vendor daemon.
  118.      VNDSTART.EXE   -  Utility program used to start vendor server.
  119.  
  120.  \AUXPROGS subdirectory
  121.      HIDEWIN.EXE    -  Used to hide package setup sessions (if desired).
  122.      LIBEDIT.CMD    -  Utility used by many sample front-ends.
  123.  
  124.  \FRNTENDS subdirectory
  125.      Miscellaneous vendor application installation and execution front
  126.      ends.
  127.  
  128.  \DOCS subdirectory
  129.      ADMINDOC.INF   -  OS/2 View compatible Vendor Admin Documentation.
  130.  
  131.  
  132. ΓòÉΓòÉΓòÉ 5. Installing a Vendor Server ΓòÉΓòÉΓòÉ
  133.  
  134. The following sections give detailed instructions on how to install or update 
  135. the components of a vendor server. 
  136.  
  137.  
  138. ΓòÉΓòÉΓòÉ 5.1. Using Diskettes ΓòÉΓòÉΓòÉ
  139.  
  140. The vendor administration program (VNDADMIN) is used to install or update a 
  141. Vendor Server. However, before you can install or update the server, you have 
  142. to install the VNDADMIN program. This section describes how to install the 
  143. Vendor administration program from the IBM NetDoor Vendor Server installation 
  144. diskette. 
  145.  
  146. Follow the installation instructions: 
  147.  
  148. Note:  NetBIOS Before starting the installation on a LAN Server, prepare the 
  149. server by performing these tasks: 
  150.  
  151.   1. Start the server by typing NET START SERVER. 
  152.  
  153.   2. Log on with an administrator user ID. 
  154.  
  155.  Note:  TCP/IP Before starting the installation on a TCP/IP server, prepare the 
  156.  server by performing these tasks: 
  157.  
  158.   1. Install and start TCP/IP for OS/2 1.2.1 or higher. 
  159.  
  160.   2. Start the PORTMAP.EXE application. 
  161.  
  162.  Do not start NFSD.EXE. 
  163.  
  164.  From the new server place the IBM NetDoor Vendor Server installation diskette 
  165.  in the drive A and type: 
  166.  
  167.    A:\INSTALL
  168.  The installation program asks you for a local directory in which to install 
  169.  the Vendor administration program. 
  170.  
  171.  After installing the VNDADMIN program and supporting files on the local 
  172.  directory, the installation program creates a Vendor Admin program group. 
  173.  Program entries for the Vendor Admin program and online documentation are 
  174.  added to this group. To perform additional maintenance in the future, you can 
  175.  run VNDADMIN from this program group. 
  176.  
  177.  Then, the installation program starts VNDADMIN so that the vendor server can 
  178.  be installed or updated. VNDADMIN contains online help if you have any 
  179.  questions; see Installing a Vendor Server for details about the installation 
  180.  dialog. 
  181.  
  182.  Finally, copy the VENDOR\PACKDATA\VENDOR.CTL file into the COUIMAGE alias of 
  183.  all the image servers that will use the server you are installing like a 
  184.  vendor server. 
  185.  
  186.  If you have a NETBIOS environment and you are already using the Vendor program 
  187.  provided by LAN Server 2.0, you can migrate to without losing your 
  188.  configuration using the following installation instructions: 
  189.  
  190.   1. Place the NetDoor Vendor Server Installation Diskette into drive A and 
  191.      copy the following files into the VENDOR\USEDATA subdirectory: 
  192.  
  193.     o A:\VNDADMIN\NETBIOS\VNDSRVR.EXE 
  194.  
  195.     o A:\VNDADMIN\NETBIOS\VNDMON.EXE 
  196.  
  197.     o A:\VNDADMIN\NETBIOS\VNDKILL.EXE 
  198.  
  199.     o A:\VNDADMIN\NETBIOS\VNDTRACE.EXE 
  200.  
  201.     o A:\VNDADMIN\NETBIOS\VNDSTART.EXE 
  202.  
  203.   2. Copy the VENDOR\PACKDATA\VENDOR.CTL file into the COUIMAGE alias of all 
  204.      the image servers that will use the server you are installing like a 
  205.      vendor server. 
  206.  
  207.   3. Start the vendor server running VNDSTART from VENDOR\PACKDATA 
  208.      subdirectory. 
  209.  
  210.  
  211. ΓòÉΓòÉΓòÉ 5.2. Using a Code Server ΓòÉΓòÉΓòÉ
  212.  
  213. You can install the Vendor Server from diskettes or from a code server. A code 
  214. server enables you to use the installation diskette in any drive in the system. 
  215. The entire contents of the installation diskette can be copied intact to any 
  216. drive and directory on the code server. 
  217.  
  218. This procedure allows the contents of the diskette to reside almost anywhere, 
  219. including a LAN alias, an NFS-mounted drive, or a CD-ROM, and still be used for 
  220. installation of a Vendor Server. 
  221. Using Response Files 
  222.  
  223. The installation program included with the installation diskette asks what 
  224. local directory you would like to use for creating a work area to be used when 
  225. installing and updating Vendor Servers. The installation program supports a 
  226. response file for getting this information. 
  227.  
  228. To call the installation program with a response file, use the following 
  229. syntax: 
  230.  
  231. INSTALL /R:<specific response file>
  232.  
  233. For example: 
  234.  
  235. INSTALL /R:a:\install.rsp
  236.  
  237. The response file should contain these keywords and their associated values: 
  238.  
  239. WORKDIR = <directory>
  240.  
  241. For example: 
  242.  
  243. WORKDIR = d:\vndwork
  244.  
  245.  
  246. ΓòÉΓòÉΓòÉ 5.3. Describing Vendor Server Files ΓòÉΓòÉΓòÉ
  247.  
  248. The vendor administration program can edit four kinds of Vendor Server files. 
  249. For information on creating and changing these files, see Editing Files 
  250.  
  251.  o Control file (CTL) 
  252.  
  253.    The control file is used by the VENDOR.EXE client program. It must be named 
  254.    VENDOR.CTL and stored somewhere along the user's DPATH. This file tells 
  255.    vendor the name of the Vendor Server to use as well as the name of the 
  256.    catalog file on the server. 
  257.  
  258.    Note:  If VNDADMIN does not have access to the same VENDOR.CTL file that the 
  259.    user population uses (or if the file must exist in more than one place), 
  260.    make sure to copy it manually to wherever it is needed. 
  261.  
  262.  o License file (LIC) 
  263.  
  264.    The license file is read by the VNDSRVR.EXE program. This file must be named 
  265.    VNDSRVR.LIC and reside in the \\server\d$\VENDOR\USEDATA (NetBIOS) or 
  266.    d:\VENDOR\USEDATA (TCP/IP) subdirectory along with the VNDSRVR.EXE program. 
  267.    Create this file on every Vendor Server, whether or not the server is a 
  268.    license server. The license file is read when you start the Vendor Server; 
  269.    if it is changed, you can stop the Vendor Server program using VNDKILL and 
  270.    restart it. VNDADMIN also sends a message to the Vendor Server telling it to 
  271.    reread the license file dynamically. 
  272.  
  273.  o Catalog file (CAT) 
  274.  
  275.    The catalog file is read by the VENDOR.EXE client program. This file lists 
  276.    all the package categories available. You can group similar packages into 
  277.    one package file. The catalog file is a listing of all package files and 
  278.    their associated descriptions. You can give the catalog file any name; it is 
  279.    created in the directory specified by the VENDOR alias. For example: 
  280.  
  281.       \\server\d$\VENDOR\PACKDATA
  282.    or 
  283.  
  284.       d:\VENDOR\PACKDATA
  285.  
  286.    Note:  The catalog file name CATALOG.CAT is recommended. 
  287.  
  288.  o Package file (PKG) 
  289.  
  290.    A package file is read by the VENDOR.EXE client program. This file lists all 
  291.    the packages contained within a certain package category. Similar packages 
  292.    should be categorized and grouped into one package file. Package files can 
  293.    be named anything, but are created in the directory specified by the VENDOR 
  294.    alias. For example: 
  295.  
  296.       \\server\d$\VENDOR\PACKDATA
  297.    or 
  298.  
  299.       d:\VENDOR\PACKDATA
  300.  
  301.    Note:  Package files should end with the PKG extension. 
  302.  
  303.  
  304. ΓòÉΓòÉΓòÉ 6. Installing Applications on a Vendor Server ΓòÉΓòÉΓòÉ
  305.  
  306. Installing software applications on the Vendor Server so that they are 
  307. accessible with the vendor front-end program is not always trivial. 
  308.  
  309. Because many software applications have unique setup and configuration 
  310. requirements, there is no predefined, absolute method of installing a licensed 
  311. application in the Vendor environment. Therefore, this section describes what 
  312. must be done in all cases, and provides pointers on how to install most 
  313. software packages. 
  314.  
  315. The following checklist describes what you need to do before installing a 
  316. package in the Vendor environment. 
  317.  
  318.   1. Get legal permission to use the package 
  319.  
  320.      Contact the owners of the software application and obtain the required 
  321.      licenses and agreements for running the package in the Vendor environment. 
  322.  
  323.   2. Determine where the software application will be installed 
  324.  
  325.      You can install the application package on any server that the Vendor 
  326.      Server user ID has administrative privileges on or that is running NFSD 
  327.      with TRUSTED privileges. Place the package on any drive and directory on 
  328.      the server. No predefined netname needs to be created for this resource; 
  329.      the Vendor Server creates dynamic netnames as needed. The TCP/IP Vendor 
  330.      Server dynamically export this resource as needed. 
  331.  
  332.      For example, you may want to install the new package in the subdirectory 
  333.      D:\IBMC2 on the server YKVNS01. 
  334.  
  335.   3. Install the package as described by the documentation 
  336.  
  337.      Most packages will allow you to run some sort of installation program, 
  338.      specifying that you would like to install the package on a certain drive 
  339.      and a certain subdirectory. Therefore, you usually have the following 
  340.      options when installing packages: 
  341.  
  342.     o Install the package on the server while running from the server. 
  343.  
  344.     o Install the package onto a redirected or NFS mounted drive, if possible. 
  345.       When logged on as an administrator, you can assign any drive on the 
  346.       server as a local drive with the command: 
  347.  
  348.             NET USE x: \\server\d$
  349.             or
  350.             MOUNT x: server:d:\
  351.  
  352.     o Install the package on a workstation and use COPY/XCOPY (with directory 
  353.       structure intact) to the server. Be sure to remove the workstation copy. 
  354.  
  355.       Be cautious when installing packages onto redirected server drives. The 
  356.       installation programs for certain programs understand that the drive you 
  357.       are trying to install the package on is not a physical drive, and will 
  358.       not let you continue. Usually, you can install these packages on a 
  359.       physical drive and then use XCOPY on the remote drive. LAN versions of 
  360.       software applications usually allow installation on a remote drive, but 
  361.       applications written for the stand-alone environment often do not. 
  362.  
  363.       Note:  Contact the owners of the software application if you have any 
  364.       problems installing it in the Vendor environment. 
  365.  
  366.   4. Create front-end programs 
  367.  
  368.      Often, software applications cannot run properly unless certain 
  369.      environment variables are set up, or other tasks have been performed. For 
  370.      this reason, you need to write a front-end program to the actual software 
  371.      program that performs these functions. 
  372.  
  373.      The standard names for these front-end programs or execs is PACKINST.CMD 
  374.      and PACKRUN.CMD, but they can be called anything as stated by the package 
  375.      file entry. Use the PACKINST.CMD exec to run any configuration or 
  376.      installation tasks for a particular package and the PACKRUN.CMD exec to 
  377.      actually run the application program. These front-end programs can be very 
  378.      different from one software package to the next. Install these front-ends 
  379.      in the same directory in which you installed the software application. 
  380.      Refer  to the IBM Network Door/2 Programming Guide for information on 
  381.      writing or using existing front-ends for many software applications. 
  382.  
  383.   5. Create a package file entry 
  384.  
  385.      Use VNDADMIN to create a package file entry for the newly installed 
  386.      package. You may need to create a new package file if you have not 
  387.      installed similar packages before. For example; if you are installing a 
  388.      new compiler and you do not have any other compilers installed, you may 
  389.      want to first create a COMPILER.CAT package catalog file for the package 
  390.      entry.  See Editing Package Files for information on editing package 
  391.      files. 
  392.  
  393.      Note:  You may want to test the new package entry by using a local catalog 
  394.      file that points to a local package catalog file before you add the new 
  395.      package entry to the package files to which users have access. 
  396.  
  397.   6. Update package license and information files 
  398.  
  399.      After you create a package file entry for the newly installed package, the 
  400.      following files are created: 
  401.  
  402.           d:\VENDOR\package\package.LIC
  403.           d:\VENDOR\package\package.INF
  404.      where : is the drive letter where the Vendor Server is installed and 
  405.      package is the short package name (such as IBMC2) 
  406.  
  407.      Make sure to edit these files and add package and site-specific license 
  408.      and usage information. 
  409.  
  410.      If the newly installed package is not free, then make sure to add a 
  411.      package.WRN file that contains information about the cost of the package 
  412.      to the user. VENDOR.EXE automatically displays this file the first time a 
  413.      user runs a package that costs money. 
  414.  
  415.   7. Add package license count information 
  416.  
  417.      Use VNDADMIN to add license count information about the newly installed 
  418.      package. License information is stored in the VNDSRVR.LIC file. 
  419.  
  420.      Refer to Editing License Files for information on editing license files. 
  421.  
  422.  The package should be ready to run. Be sure to test all newly installed Vendor 
  423.  packages fully before providing access to the user population. 
  424.  
  425.  
  426. ΓòÉΓòÉΓòÉ 6.1. Installing Vendor Client Program Components ΓòÉΓòÉΓòÉ
  427.  
  428. The Vendor client program is included on the The client files are already 
  429. installed on the NetDoor server image. The Vendor client program is ready to 
  430. run from any NetDoor workstation. Refer to the IBM Network Door/2 User's Guide 
  431. for information on using the Vendor client application. 
  432.  
  433.  
  434. ΓòÉΓòÉΓòÉ 6.2. Starting the Vendor Server ΓòÉΓòÉΓòÉ
  435.  
  436. The VNDSRVR.EXE program must be running for users to have access to application 
  437. software residing on the server. 
  438.  
  439. Always use the VNDSTART.EXE program to start the Vendor Server. Type VNDSTART ? 
  440. from an OS/2 command line for details on VNDSTART. 
  441.  
  442. If you want the Vendor Server starts automatically add the following line to 
  443. the STARTUP.CMD file of the Vendor Server. 
  444.  
  445. D:\VENDOR\USEDATA\VNDSTART
  446.  
  447. Note:  Substitute the actual drive letter in place of D: if needed. 
  448.  
  449. Note:  NetBIOS The LAN Server running the VNDSRVR.EXE is known as the Vendor 
  450. Server. This server must have an administrator user ID logged on at all times. 
  451. This ID is needed so that the server can dynamically share resources on itself 
  452. and other servers in the domain. 
  453.  
  454. Note:  TCP/IP The TCP/IP workstation running the VNDSRVR.EXE is known as the 
  455. Vendor Server. Before the Vendor Server is started, CNTRL.EXE, PORTMAP.EXE, and 
  456. NFSD.EXE TCP/IP services must be running. 
  457.  
  458.  
  459. ΓòÉΓòÉΓòÉ 7. Managing Trace Messages ΓòÉΓòÉΓòÉ
  460.  
  461. Use the Vendor Database Trace Setting program (VNDTRACE) to debug errors or to 
  462. view program usage. 
  463.  
  464. You can run the Vendor Server with the trace mode on or off. The default mode 
  465. is off. To start VNDSRVR with the trace mode on, type VNDSRVR -t. In the trace 
  466. mode, VNDSRVR will echo to the screen all messages received from vendor client 
  467. programs, all functions executed and their associated return codes, and the 
  468. output messages sent to clients. 
  469.  
  470. Note:  Running VNDSRVR with the trace mode on reduces the speed of execution. 
  471. Use this mode as a debugging aid only. 
  472.  
  473. >ΓöÇΓöÇΓöÇΓöÇΓöÇVNDTRACEΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇ>
  474.                 ΓööΓöÇserverΓöÇΓöÿ  Γö£ΓöÇOFFΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  475.                             ΓööΓöÇONΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÿ
  476.                                   Γö£ΓöÇSCREENΓöÇΓöñ
  477.                                   Γö£ΓöÇFILEΓöÇΓöÇΓöÇΓöñ
  478.                                   ΓööΓöÇBOTHΓöÇΓöÇΓöÇΓöÿ
  479.  
  480.  
  481. ΓòÉΓòÉΓòÉ 7.1. Parameters ΓòÉΓòÉΓòÉ
  482.  
  483.  server 
  484.            The name of the server to perform on. (The default is the local 
  485.            machine.) 
  486.  
  487.  ON 
  488.            Enables tracing. 
  489.  
  490.  OFF 
  491.            Disables tracing. 
  492.  
  493.  SCREEN 
  494.            Displays trace messages in the VNDSRVR window. 
  495.  
  496.  FILE 
  497.            Appends trace messages to the VNDSRVR.TRC file. 
  498.  
  499.  BOTH 
  500.            Displays trace messages in the VNDSRVR window and appends them to 
  501.            the VNDSRVR.TRC file. 
  502.  
  503.  
  504. ΓòÉΓòÉΓòÉ 8. Shutting Down a Vendor Server ΓòÉΓòÉΓòÉ
  505.  
  506. You can use the Vendor Server program VNDKILL to shut down a server. 
  507.  
  508. >ΓöÇΓöÇΓöÇΓöÇΓöÇVNDKILLΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇ>
  509.                 ΓööΓöÇserverΓöÇΓöÿ
  510.  
  511.  
  512. ΓòÉΓòÉΓòÉ 8.1. Parameters ΓòÉΓòÉΓòÉ
  513.  
  514.  server 
  515.            The name of the server you want to shut down. The default value is 
  516.            the name of the local machine. 
  517.  
  518.  
  519. ΓòÉΓòÉΓòÉ 9. Monitoring a Vendor Server ΓòÉΓòÉΓòÉ
  520.  
  521. You can use the VNDMON program stand-alone or in REXX execs to determine 
  522. information about the use of the Vendor Server. 
  523.  
  524. >ΓöÇΓöÇΓöÇΓöÇΓöÇVNDMONΓöÇΓöÇserverΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ>
  525.                       ΓööΓöÇcommandΓöÇΓöÿ
  526.  
  527.  
  528. ΓòÉΓòÉΓòÉ 9.1. Parameters ΓòÉΓòÉΓòÉ
  529.  
  530.  server 
  531.            The name of the server you want to monitor. 
  532.  
  533.  command 
  534.            One of the following query commands: 
  535.  
  536.     MSG mach msg Sends a specified message to the specified machine. Use an 
  537.               asterisk (*) to send the message to all the machines. 
  538.  
  539.     NUMPACKS  Returns the number of packages in use. 
  540.  
  541.     NUMUSERS p Returns the number of users using a given package number or 
  542.               name. 
  543.  
  544.     MAXUSERS p Returns the maximum number of licenses for a given package 
  545.               number or name. 
  546.  
  547.     PACKNAME p Returns the package name associated with a given package number. 
  548.  
  549.     QUERY     Returns OK if VNDSRVR.EXE is running. 
  550.  
  551.     RESOURCE p Returns the resource associated with a given package number or 
  552.               name. 
  553.  
  554.     USER p u  Returns the userid, specified by the user number; using the 
  555.               package specified by the package number or name. 
  556.  
  557.     MACH p u  Returns the machine, specified by the user number or name; using 
  558.               the package specified by the package number or name. 
  559.  
  560.     READ_LIC  Rereads the VNDSRVR.LIC file. 
  561.  
  562.     VER       Returns the version number of VNDSRVR.EXE. 
  563.  
  564.  
  565. ΓòÉΓòÉΓòÉ 10. Troubleshooting ΓòÉΓòÉΓòÉ
  566.  
  567. The following sections give helpful information for troubleshooting Vendor 
  568. Server problems. Detailed Vendor Server information is also provided for 
  569. debugging and configuration purposes. 
  570.  
  571.  
  572. ΓòÉΓòÉΓòÉ 10.1. Understanding the Vendor Server ΓòÉΓòÉΓòÉ
  573.  
  574. The Vendor Server program, VNDSRVR.EXE, is the heart of the dynamic aliasing 
  575. capabilities of Vendor. 
  576.  
  577. The Vendor application running on the user's workstation communicates with 
  578. VNDSRVR via a NetBIOS named pipe or via a TCP/IP remote procedure call (RPC), 
  579. depending on the protocol you use. VNDSRVR can execute administrative level 
  580. network functions because it runs on a server with administrator privileges. 
  581. The Vendor Server can create and share aliases or exported directories 
  582. dynamically and grant and drop access on an individual user basis. VNDSRVR also 
  583. records all package use information in files stored in the DATES subdirectory 
  584. on the license server. 
  585.  
  586. Several files are maintained by the Vendor Server as it operates and tracks 
  587. licensed application usage. These files are necessary for the execution of the 
  588. server and can offer some diagnostic information: 
  589.  
  590.  o Database File - VNDSRVR.DBF 
  591.  
  592.    VNDSRVR.DBF is a flat file database that represents current software program 
  593.    usage. The Vendor Server program, VNDSRVR.EXE, reads information from 
  594.    VNDSRVR.DBF during initialization. Any aliases or exported directories that 
  595.    were created are created again and access to the appropriate users is 
  596.    granted. 
  597.  
  598.    The database file provides the ability to restart the Vendor Server without 
  599.    completely dropping user access to applications. When the Vendor Server 
  600.    restarts, it grants access to attached users. However, it is recommended 
  601.    that you execute the VNDKILL program to terminate VNDSRVR.EXE before 
  602.    restarting the Vendor Server. 
  603.  
  604.    Like any database file, VNDSRVR.DBF can become damaged. You can use a 
  605.    browser to inspect the file to see if DBF file is damaged. Deleting the 
  606.    damaged file and restarting the VNDSRVR.EXE program is the best recovery 
  607.    solution. 
  608.  
  609.    Note:  Access to packages is not carried over a 24-hour period. When 
  610.    VNDSRVR.EXE starts, it does not grant access to users that started 
  611.    applications during the previous day. This helps discourages users from 
  612.    leaving software applications running on their systems when they go home at 
  613.    night. 
  614.  
  615.  o Error Log File - VNDSRVR.ERR 
  616.  
  617.    VNDSRVR.ERR contains date- and time-stamped error log entries. Each entry 
  618.    contains a short description of the error followed by the associated 
  619.    application, followed by the associated user ID, if applicable. The error 
  620.    log file is stored in the same directory as the VNDSRVR.EXE file and can be 
  621.    purged manually at any time using the OS/2 DEL command. 
  622.  
  623.    Refer to Understanding Error Log Entry Descriptions for more information 
  624.    about error log entries. 
  625.  
  626.  o Queue Log File - VNDSRVR.QUE 
  627.  
  628.    VNDSRVR.QUE contains a log of queueing actions. Queuing actions include a 
  629.    user waiting to use a package and a user being freed from the queue. The 
  630.    queue log file is stored in the same directory as the VNDSRVR.EXE file and 
  631.    can be purged manually at any time using the OS/2 DEL command. 
  632.  
  633.  o No Free Licenses Log File - VNDSRVR.FUL 
  634.  
  635.    VNDSRVR.FUL contains a log of users who tried to use packages when all 
  636.    licenses were in use. This shows when and how often the license counts for 
  637.    particular packages were inadequate to satisfy the user population. This log 
  638.    file is stored in the same directory as the VNDSRVR.EXE file and can be 
  639.    purged manually at any time using the OS/2 DEL command. 
  640.  
  641.  o Audit of changes to the VNDSRVR.LIC file - VNDSRVR.AUD 
  642.  
  643.    The VNDSRVR.AUD file audits access attempts to the VNDSRVR.LIC file. The 
  644.    VNDSRVR checks the time stamp of VNDSRVR.LIC when it initializes and when a 
  645.    READ _LIC message is received from the VNDADMIN program. When the time stamp 
  646.    changes (either via VNDADMIN or by manually editing the license counts 
  647.    file), the new license information and the current date are appended to the 
  648.    VNDSRVR.AUD log file. The new VNDSRVR.LIC time stamp is saved in OS2.INI for 
  649.    comparison. This audit log file is stored in the same directory as the 
  650.    VNDSRVR.EXE file. It is recommended that this file not be purged manually at 
  651.    any time. It contains information showing when particular license counts 
  652.    were increased and can be compared against purchasing receipts to prove that 
  653.    valid licenses exist for each application. 
  654.  
  655.  o Vendor Server Trace Option - VNDSRVR.TRC 
  656.  
  657.    You can run the Vendor Server with the trace mode on or off. The default 
  658.    mode is off. To start VNDSRVR with the trace mode on, type: 
  659.  
  660.       VNDSRVR /T
  661.    In trace mode, VNDSRVR echoes to the screen all messages received from 
  662.    Vendor client programs, all functions executed and their associated return 
  663.    codes, and the output messages sent to clients. Several trace options allow 
  664.    tracing to both file, VNDSRVR.TRC, and console. 
  665.  
  666.    Note:  Running VNDSRVR with the trace mode on drastically reduces the speed 
  667.    of execution. Use this mode as a debugging aid only. 
  668.  
  669.  o Specifying Vendor Administrator Workstations - VENDOR.ADMINS 
  670.  
  671.    By default, the Vendor Server program sends send error messages to all 
  672.    Vendor administrator workstations in the Vendor Server's domain. To send 
  673.    error messages to workstations in other domains or on an IP network, you 
  674.    have to tell VNDSRVR.EXE the names of these workstations using the 
  675.    VENDOR.ADMINS environment variable. 
  676.  
  677.    Set VENDOR.ADMINS to the name of one or more workstations separated by 
  678.    commas. 
  679.  
  680.    The following example specifies one workstation on another domain or on an 
  681.    IP network: 
  682.  
  683.       SET VENDOR.ADMINS=wksta
  684.  
  685.    The following example specifies two workstations on another domain or on a 
  686.    IP network: 
  687.  
  688.       SET VENDOR.ADMINS=wksta1,wksta2
  689.  
  690.  
  691. ΓòÉΓòÉΓòÉ 10.2. Understanding Error Log Entry Descriptions ΓòÉΓòÉΓòÉ
  692.  
  693. Where applicable, all error entries in the VNDSRVR.ERR file have the following 
  694. format: 
  695.  
  696. Error_description  Server  Application  User  Workstation  RC
  697. d
  698.  
  699. Many of the function calls issued by VNDSRVR are network functions described in 
  700. the Operating System/2 LAN Server Version 1.2 Application Programmer's 
  701. Reference, S01F-0256. The following list includes error log entries and their 
  702. associated descriptions: 
  703.  
  704.  o ERROR_APP_NOT_SHARED 
  705.  
  706.    Attempted to drop an application resource that was not shared. This can 
  707.    happen when a user is returning a license for an application and the Vendor 
  708.    server has already dropped the application resource. This should not happen 
  709.    unless the client and the server lose communications for a period of time 
  710.    thus causing the server to free the user's license. 
  711.  
  712.  o ERROR_COULD_NOT_SHARE 
  713.  
  714.    This error occurs if the Vendor Server attempts to share a resource but can 
  715.    not. If the error is greater than 2000, type the following command from OS/2 
  716.    to get detailed information regarding the failure: 
  717.  
  718.       HELP NETxxxx
  719.    where xxxx is the return code error number. 
  720.  
  721.  o ERROR_LICENSE_TIMEOUT 
  722.  
  723.    If a user restarts a workstation without stopping a licensed application, or 
  724.    if the user's workstation cannot communicate with the Vendor Server for more 
  725.    than 15 minutes (due to a LAN networking problem), then the Vendor Server 
  726.    frees all licenses used by the user. 
  727.  
  728.  o ERROR_LIC_SERVER_NOT_RESPONDING 
  729.  
  730.    If a Vendor Server cannot communicate with its license server, this error is 
  731.    generated. The license server may actually be unavailable, you are 
  732.    experiencing LAN networking problems, or the user ID running on the Vendor 
  733.    server is not known to the domain to which the license server is defined. 
  734.  
  735.  o ERROR_NETACCESSSETINFO 
  736.  
  737.    After sharing an application resource, the Vendor Server must set the access 
  738.    permissions for the user desiring to use the application. Setting the access 
  739.    permissions is performed by the NetAccessSetInfo() function. This error 
  740.    reports the exact error return code from the NetAccessSetInfo() function. 
  741.    This error code does not occur if you use a TCP/IP Vendor Server. 
  742.  
  743.  o ERROR_NETSHAREADD 
  744.  
  745.    To provide the user with access to an application, the Vendor Server must 
  746.    share a directory as a network resource. This is done by the NetShareAdd() 
  747.    function. This error entry reports the exact error return code from the 
  748.    NetShareAdd() function. This error code does not occur if you use a TCP/IP 
  749.    Vendor Server. 
  750.  
  751.  o ERROR_NETSHARESETINFO 
  752.  
  753.    The NetShareSetInfo() function gives a new user access to an existing shared 
  754.    application. This error entry reports the exact error return code. This 
  755.    error code does not occur when you use the TCP/IP Vendor Server. 
  756.  
  757.  o ERROR_NET_USE 
  758.  
  759.    After a user is given access to an application, the Vendor client program 
  760.    attempts to use the shared resource. If the attempt fails, this error is 
  761.    generated. Note the return code field. Often the use attempt fails with a 
  762.    return code of 5, which indicates that access was denied. When this happens, 
  763.    ensure that the user is known to the Vendor Server domain and that there are 
  764.    no password conflicts. This error code does not occur if you use a TCP/IP 
  765.    Vendor Server. 
  766.  
  767.  o ERROR_OPENING_DBF_FILE 
  768.  
  769.    After every Vendor Server database transaction the Vendor Server writes its 
  770.    database to the VNDSRVR.DBF file. If the Vendor Server cannot open the file, 
  771.    this error is generated. 
  772.  
  773.  o FATAL_ERROR_NO_LIC_FILE 
  774.  
  775.    During startup the Vendor Server must read the VNDSRVR.LIC file. This error 
  776.    occurs if the file does not exist or cannot be read. 
  777.  
  778.  o FATAL_ERROR_BAD_LIC_FILE 
  779.  
  780.    During startup the Vendor Server reads the VNDSRVR.LIC license file. This 
  781.    error occurs if the file does not include the required line at the top of 
  782.    the file: 
  783.  
  784.       LICSERVER = server
  785.  
  786.  
  787. ΓòÉΓòÉΓòÉ 10.3. Understanding Usage Statistics ΓòÉΓòÉΓòÉ
  788.  
  789. Your site may want to bill users for their first-time use of certain 
  790. applications, but the actual billing is not done by Vendor. The Vendor server 
  791. generates logs of all use information. Each site that uses Vendor can process 
  792. daily usage files generated by the Vendor Server and perform billing tasks as 
  793. needed. You may want to back up these files periodically so that they can be 
  794. restored in case of a hardware failure. 
  795.  
  796. Two types of statistics files are generated by the Vendor Server program: 
  797.  
  798.  o The \VENDOR\USEDATA\DATES subdirectory contains usage files for each date on 
  799.    which the Vendor Server runs. The files are stored in the directory under 
  800.    the date on which they were created. For example, the usage file for April 
  801.    9, 1993 are stored in the file 040993.DAT. These files can be processed by 
  802.    whatever means available to create usage statistics. They are created only 
  803.    on license servers. 
  804.  
  805.    The entries written in the 040993.DAT file contain two types of usage 
  806.    information: the date and time when the application was used by a user on a 
  807.    workstation (including some additional billing information) and the date and 
  808.    time when the user stopped using the application. 
  809.  
  810.       04/09/93 10:48  NONE     WPWIN    5.1    JOHNW  FARSIDE  $0.00  1 YKVNS02
  811.       04/09/93 11:14  DROP     WPWIN           JOHNW  FARSIDE           YKVNS02
  812.  
  813.  o The \VENDOR\USEDATA\USERS subdirectory contains first-time usage information 
  814.    files for users who have run each software application. The files are stored 
  815.    in the directory under each unique user ID. For example, the first-time use 
  816.    information for user ID JOHNW is stored in the file JOHNW.DAT. These files 
  817.    are used by the Vendor Server program, VNDSRVR.EXE, to determine if a user 
  818.    has previously used a package. These files are created only on Vendor 
  819.    license servers. 
  820.  
  821.       10/02/92 14:43  NONE     COREL20  2.00A  JOHNW  FARSIDE  $0.00  1 YKVNS03
  822.       04/09/93 11:25  NONE     WPWIN    5.1    JOHNW  FARSIDE  $0.00  1 YKVNS02
  823.       06/21/93 14:14  NONE     123G     1.1    JOHNW  FARSIDE  $0.00  1 YKVNS02
  824.       07/16/93 09:14  NONE     FLG      1.0    JOHNW  FARSIDE  $0.00  1 YKVNS02
  825.       08/04/93 17:31  NONE     DESCRIB4 4.0    JOHNW  FARSIDE  $0.00  1 YKVNS01
  826.  
  827.  
  828. ΓòÉΓòÉΓòÉ 11. Using the Vendor Administration Program ΓòÉΓòÉΓòÉ
  829.  
  830. Use the Vendor administration program (VNDADMIN) to: 
  831.  
  832.  o Install and update the Vendor server 
  833.  
  834.  o Send messages to users 
  835.  
  836.  o Create and update all Vendor server profiles, including: 
  837.  
  838.     - Control file 
  839.  
  840.     - Catalog file 
  841.  
  842.     - Package files 
  843.  
  844.     - License file 
  845.  
  846.  Using VNDADMIN to install Vendor servers and create and maintain profiles 
  847.  helps to ensure that the Vendor server environment is configured correctly. 
  848.  
  849.  To start the VNDADMIN program, open the Vendor Admin group created by the 
  850.  Vendor installation program on the desktop, and then double-click on the 
  851.  Vendor Admin Program icon. 
  852.  
  853.  The Vendor Admin window appears: You can obtain help on any window by pressing 
  854.  the F1 key or by selecting the Help button. 
  855.  
  856.  
  857. ΓòÉΓòÉΓòÉ 12. Selecting a Communication Method ΓòÉΓòÉΓòÉ
  858.  
  859. To select the communication or access method that the Vendor Admin program uses 
  860. to install and manage the Vendor server program (VNDSRVR) on each server: 
  861.  
  862.   1. Select the Servers option from the action bar and then Access Method. 
  863.  
  864.   2. The Vendor Interprocess Communication Method window appears. 
  865.  
  866.   3. Select either NetBIOS or TCP/IP. 
  867.  
  868.   4. Select OK to verify your selection or Cancel to exit the window. 
  869.  
  870.  After you select a method, VNDADMIN saves this information for future 
  871.  instances of the program. 
  872.  
  873.  
  874. ΓòÉΓòÉΓòÉ 12.1. Installing a Vendor Server ΓòÉΓòÉΓòÉ
  875.  
  876. To install a Vendor server: 
  877.  
  878.   1. Select the Servers option from the action bar and then Install Server. 
  879.  
  880.   2. The Vendor Server Installation window appears. 
  881.  
  882.      Note:  If you are running the installation program from a NetBIOS 
  883.      workstation, you must have administrative privileges on the Vendor server. 
  884.  
  885.   3. Select a server from the Server list box or type the name of a server. If 
  886.      you are running the installation program from a LAN server this server 
  887.      will be the default selection in the list box. You can select another 
  888.      server from the list or enter your own. 
  889.  
  890.      Note:  When you install a TCP/IP server, the list contains only the 
  891.      current host name of the server you are running from. You cannot install 
  892.      on a remote server. 
  893.  
  894.   4. For Drive on Server type the drive letter of the Vendor server on which to 
  895.      install the Vendor Server software and on which to create the Vendor 
  896.      resource. 
  897.  
  898.   5. For Path to Control File type the fully qualified Vendor control file 
  899.      name. The control file can reside anywhere, but must be accessible along 
  900.      the DPATH of workstations running the VENDOR.EXE client program. 
  901.  
  902.      The control file tells the Vendor client program which Vendor server to 
  903.      access and which catalog file to load. 
  904.  
  905.   6. Select OK to install the software or Cancel to exit the window without 
  906.      installing. 
  907.  
  908.  If the control, license, catalog, and package files do not exist for each 
  909.  server, VNDADMIN asks if you want to create them now. If you answer Yes, the 
  910.  windows you need for creating these files are displayed. 
  911.  
  912.  
  913. ΓòÉΓòÉΓòÉ 13. Modifying Vendor Server Definitions ΓòÉΓòÉΓòÉ
  914.  
  915. To add, delete, or change a Vendor server: 
  916.  
  917.   1. Select the Servers option from the action bar and then Define Servers. 
  918.  
  919.   2. The Vendor Servers window appears. 
  920.  
  921.   3. Select a server from the list or type the name of the server. 
  922.  
  923.   4. Fill in the appropriate information in the Server Details section: 
  924.  
  925.     o In the Drive with Vendor Resource field enter the drive letter on which 
  926.       the Vendor Resource (alias) will be created. 
  927.  
  928.     o In the Path to Control File field enter the fully qualified name of the 
  929.       control file. The file name must end with VENDOR.CTL. 
  930.  
  931.     o Check This is a License Server if this Vendor Server is a master license 
  932.       server. 
  933.  
  934.   5. To add or change a new definition, select Add. 
  935.  
  936.   6. To delete an existing definition, select Delete. 
  937.  
  938.  Select Save to save the definition in the VNDADMIN.INI file. 
  939.  
  940.  If any server information has been created or changed, the Install Servers 
  941.  window appears. The server list shows all the servers that are currently 
  942.  defined. Select a server and: 
  943.  
  944.   1. Select Install to install or reinstall a server. 
  945.  
  946.      The installation program: 
  947.  
  948.     o Creates the directory structure on the server. 
  949.  
  950.     o Copies the Vendor server programs to the server. 
  951.  
  952.     o Creates and shares a VENDOR alias (NetBIOS). 
  953.  
  954.     o Creates and exports a d:\VENDOR\PACKDATA directory (TCP/IP), where d: is 
  955.       the drive on which the server is installed. 
  956.  
  957.       Note:  You have to start the Vendor server program, VNDSRVR, manually on 
  958.       each Vendor server, and copy the VENDOR.CTL file to the COUIMAGE alias of 
  959.       the image servers. 
  960.  
  961.   2. Select Don't Install to end the program. 
  962.  
  963.  A maximum of 25 Vendor servers can be defined by the VNDADMIN program. 
  964.  
  965.  
  966. ΓòÉΓòÉΓòÉ 14. Editing Files ΓòÉΓòÉΓòÉ
  967.  
  968. You can edit control files, license files, catalog files, and package files. To 
  969. edit a file: 
  970.  
  971.   1. Select File from the action bar and then Open. 
  972.  
  973.   2. The Vendor Admin File Selection Menu appears. 
  974.  
  975.   3. The Vendor servers list contains the names of all the Vendor servers that 
  976.      are defined. 
  977.  
  978.      Select a server to see a list of files associated with that server in the 
  979.      control, license, and catalog file list, and the package file list. 
  980.  
  981.   4. Select a file and then Edit to begin editing, or Cancel to return to the 
  982.      previous window. 
  983.  
  984.  
  985. ΓòÉΓòÉΓòÉ 14.1. Editing Control Files ΓòÉΓòÉΓòÉ
  986.  
  987. The control file provides the Vendor program with the names of the Vendor 
  988. server and the catalog file to use. 
  989.  
  990. The Vendor client program running on user workstations requires that a control 
  991. file be accessible along the DPATH. 
  992.  
  993. To edit a Vendor server control file: 
  994.  
  995.   1. On the Vendor Admin File Selection Menu select a control file and then 
  996.      Edit 
  997.  
  998.   2. The Vendor Admin Control File Editor appears: 
  999.  
  1000.   3. Type the name of the Vendor server in the Server field. 
  1001.  
  1002.   4. Type the name of the catalog file in the Catalog File field. 
  1003.  
  1004.      The catalog file will reside in the directory shared or exported by the 
  1005.      VENDOR alias of the specified server. If the file does not exist, it is 
  1006.      created when you select Save. A default name of CATALOG.CAT is 
  1007.      recommended. 
  1008.  
  1009.   5. Select Save to write the control file or Cancel to leave the window 
  1010.      without making any changes to the file. 
  1011.  
  1012.   6. After the control file is created or modified, copy it to a location in 
  1013.      the user's PATH. 
  1014.  
  1015.  
  1016. ΓòÉΓòÉΓòÉ 14.2. Editing License Files ΓòÉΓòÉΓòÉ
  1017.  
  1018. The VNDSRVR program running on the Vendor server requires the license file to 
  1019. determine which Vendor server is the license server and how many licenses are 
  1020. allocated for each of the packages that are installed. 
  1021.  
  1022. To edit a Vendor server control file: 
  1023.  
  1024.   1. On the Vendor Admin File Selection Menu select a license file and then 
  1025.      Edit. 
  1026.  
  1027.   2. The Vendor Admin License File Editor appears: 
  1028.  
  1029.   3. The name of the current license server appears. 
  1030.  
  1031.      If the license server and the Vendor server are the same, you cannot 
  1032.      change this field. 
  1033.  
  1034.      Note:  It is assumed that the license server was defined on the Vendor 
  1035.      Servers window. 
  1036.  
  1037.   4. The All Packages List shows all packages known to the Vendor Server. 
  1038.  
  1039.      When you select a package from the list, the information in the Selected 
  1040.      Package box changes to show the current information about the selected 
  1041.      package. 
  1042.  
  1043.   5. Update the information and select Update to refresh the list. 
  1044.  
  1045.   6. To delete the license count for a package, select Delete. 
  1046.  
  1047.   7. Select Save to save your changes or Cancel to return to the previous 
  1048.      window. 
  1049.  
  1050.   8. Use the Package field to view the package you selected. This name cannot 
  1051.      be changed. 
  1052.  
  1053.   9. Use the Count field to change the license count for the package. 
  1054.  
  1055.      Valid ranges include numerical values in the range 0-999 or * if there are 
  1056.      no license restrictions. 
  1057.  
  1058.  10. Select Update to refresh the information in the Package List. 
  1059.  
  1060.  11. Select Delete to delete the license count for a package. 
  1061.  The updated license count information will be saved to the license file when 
  1062.  you select the Save button. VNDADMIN informs the Vendor Server to reread its 
  1063.  license count information. 
  1064.  
  1065.  
  1066. ΓòÉΓòÉΓòÉ 14.3. Editing Catalog Files ΓòÉΓòÉΓòÉ
  1067.  
  1068. Use the Vendor Admin Catalog File Editor  dialog to edit a Vendor Server 
  1069. Catalog file. The Catalog file contains a list of package files and 
  1070. descriptions. 
  1071.  
  1072. Note:  Package files should end with the .PKG extension. 
  1073.  
  1074. To edit a catalog file: 
  1075.  
  1076.   1. On the Vendor Admin File Selection Menu select a license file and then 
  1077.      Edit 
  1078.  
  1079.   2. The Vendor Admin Catalog File Editor appears: 
  1080.  
  1081.   3. The Package File list shows all the package files on the server. These 
  1082.      files reside in the directory shared by the Vendor alias or exported 
  1083.      directory of the specified server. If a package file does not exist, it is 
  1084.      created when you select Save. 
  1085.  
  1086.      You might want to create a different package file for all similar 
  1087.      packages. For example, all of the spreadsheet applications, 123/G, 123R3, 
  1088.      and Excel can be contained in the package file SPREAD.CAT or SPREAD.PKG. 
  1089.  
  1090.      To create a new package file, type the name of the new package file in the 
  1091.      Package File field. 
  1092.  
  1093.   4. In the Description field type a new description or change the existing 
  1094.      one. 
  1095.  
  1096.      Note:  The description should be meaningful to users of the type of 
  1097.      applications defined in the package file. 
  1098.  
  1099.   5. Select Add to add the package file information to the Package File list. 
  1100.      Changes are not saved until you select Save. 
  1101.  
  1102.   6. Select Delete to delete a package file from the Package File list. Changes 
  1103.      are not saved until you select Save. 
  1104.  
  1105.   7. Select Cancel to leave without making any changes to the catalog file. 
  1106.  
  1107.  
  1108. ΓòÉΓòÉΓòÉ 14.4. Editing Package Files ΓòÉΓòÉΓòÉ
  1109.  
  1110. A package file contains a list of applications along with all the required 
  1111. information for each application. It is a good idea to group similar 
  1112. applications into one package file with a meaningful description such as "Word 
  1113. Processors" or "Drawing Applications". 
  1114.  
  1115. To edit a package file: 
  1116.  
  1117.   1. On the Vendor Admin File Selection Menu select a package file and then 
  1118.      Edit. 
  1119.  
  1120.   2. The Vendor Admin Package File Editor appears. 
  1121.  
  1122.   3. The Package File field contains the name of the package file currently 
  1123.      being edited. You can change this name before selecting Save to make a 
  1124.      backup copy or a new version of a package file without overwriting the 
  1125.      original. 
  1126.  
  1127.   4. The Package Name list contains all the currently defined packages in the 
  1128.      package file. 
  1129.  
  1130.     o To add a new package, enter the package name, fill in all the necessary 
  1131.       information, and select Add. 
  1132.  
  1133.     o To change information about a currently defined package, select the 
  1134.       package from the list, change the necessary information, and select 
  1135.       Change. 
  1136.  
  1137.     o To delete a package, select the package from the list, and select Delete. 
  1138.  
  1139.       For each package, a directory of the same name is created in the 
  1140.       directory shared by the Vendor alias on the specified server. This 
  1141.       directory is the repository of the license, information, and optional 
  1142.       warning file for this package. 
  1143.  
  1144.       Note: 
  1145.  
  1146.       The short package name is used as a convenience to both users and the 
  1147.       Vendor program. 
  1148.  
  1149.       For each package, a directory of the same name will be created in the 
  1150.       directory shared or exported by the Vendor alias on the specified server. 
  1151.       This directory will be the repository of the license, information, and 
  1152.       optional warning file for this package. (NEW) The .LIC, .INF and .WRN 
  1153.       files with the short package name prefix can be displayed by the Vendor 
  1154.       client. 
  1155.  
  1156.   5. In the Name field enter the full, descriptive name of the package. This 
  1157.      should include the application title as specified by the software vendor 
  1158.      whenever applicable. 
  1159.  
  1160.   6. In the Desc field enter a short description of the package. 
  1161.  
  1162.   7. In the Vendor field enter a the name of the software vendor that supplies 
  1163.      the package. 
  1164.  
  1165.   8. In the Path field enter the drive and path on the Vendor server in which 
  1166.      the actual package has been installed. 
  1167.  
  1168.      This directory will be shared or exported by the Vendor server whenever 
  1169.      the Vendor program requests use of the package. 
  1170.  
  1171.   9. In the Server field type the name of the server on which the package is 
  1172.      installed. 
  1173.  
  1174.      The server specified can be any server on which the Vendor server has 
  1175.      administrative privileges. Usually, however, it is the Vendor server 
  1176.      itself. If this is the case, use the name of the Vendor server, or an 
  1177.      asterisk (*) interchangeably. 
  1178.  
  1179.      Note:  See the Path field for a description of the path on the server in 
  1180.      which the package is installed. 
  1181.  
  1182.  10. In the Access field enter the access permissions for the package. 
  1183.  
  1184.      For LAN Server enter the access permission to use when creating the alias. 
  1185.      Possible NetBIOS permissions include: 
  1186.  
  1187.           R - Read access.
  1188.           W - Write access.
  1189.           C - Create access.
  1190.           X - Execute access.
  1191.           D - Delete access.
  1192.           A - Attribute access.
  1193.           P - Change Permissions access.
  1194.           * - All of above.
  1195.  
  1196.      The TCP/IP access permissions to use when creating the NFSD exported 
  1197.      directory include only: 
  1198.  
  1199.           R - Read access.
  1200.           W - Write access.
  1201.  
  1202.      Note:  Usually, all that is required for an application is RX permissions. 
  1203.      It is generally undesirable to give users write, delete, attribute, or 
  1204.      permissions access, since it is then possible for them to make the package 
  1205.      unusable, or delete it altogether. 
  1206.  
  1207.  11. In the Cost field enter the cost of the package to the user. 
  1208.  
  1209.      When you define a new package, this field is set to a default amount which 
  1210.      represents a cost of nothing. In the United States this would be $0.00. 
  1211.      This field can contain any string up to 9 characters. However, if the 
  1212.      package is to be considered free, this field must be exactly equal to the 
  1213.      default amount which represents a cost of nothing. 
  1214.  
  1215.  12 .In the Version field type the version number of the package. 
  1216.  
  1217.  13. In the Date field type the date the package was installed or upgraded on 
  1218.      the Vendor server. 
  1219.  
  1220.  14. In the Bill field type the billing category for this package. This can be 
  1221.      any number or string that can be processed by billing software. For 
  1222.      example, the billing numbers might be: 
  1223.  
  1224.     o 0 - Free, non-tracked uses 
  1225.  
  1226.     o 1 - Free, tracked uses 
  1227.  
  1228.     o 2 - Pay first use 
  1229.  
  1230.     o 3 - Pay each use For more information on Billing info see Understanding 
  1231.       Usage Statistics 
  1232.  
  1233.       Note:  The actual billing of Vendor software is not addressed by Vendor 
  1234.       programs. It is up to the LAN administrators to make sure the daily usage 
  1235.       statistics are processed, and that software is billed for as needed. 
  1236.  
  1237.  15. In the Install Program field enter the installation program for the 
  1238.      package. The executable or command file specified must reside in the 
  1239.      directory indicated by the Path field. If this field contains None, there 
  1240.      is no installation program for the package. 
  1241.  
  1242.      Some applications do not contain any type of install program. However, 
  1243.      some installation tasks must be performed before the user can use a 
  1244.      specific application through Vendor. See the IBM Network Door/2 
  1245.      Programming Guide for information on writing installation programs. 
  1246.  
  1247.  16. In the Install Program Window Type field select the type of OS/2 session 
  1248.      the installation program should run in. The selections include: 
  1249.  
  1250.     Default   Allow OS/2 on the user's machine to decide what type of session 
  1251.               to use. 
  1252.  
  1253.     FS        Run in a full-screen OS/2 or DOS session. 
  1254.  
  1255.     Win       Run in a windowed OS/2 or DOS session. 
  1256.  
  1257.     PM        Run in Presentation Manager session. 
  1258.  
  1259.     FS/Win    Use either a full-screen or windowed OS/2 or DOS session, 
  1260.               allowing the user to choose. 
  1261.  
  1262.               Note:  Selecting the wrong session can cause Vendor to halt when 
  1263.               running the program. 
  1264.  
  1265.  17. Select the Install 2.0 Setup button to specify OS/2 2.0 setup data to use 
  1266.      when running the installation program on the user's machine. 
  1267.  
  1268.  18. Select the Reboot After Install Required check box to specify if users 
  1269.      need to restart their machines after installing the package. If the box is 
  1270.      checked, the user gets a message stating that the machine should be 
  1271.      restarted. 
  1272.  
  1273.  19. In the Run Program field enter the program or command file to be run when 
  1274.      executing the package. If this field contains None, there is no program 
  1275.      for the package. For many packages, this is an executable provided by the 
  1276.      vendor as part of the application. However, you may want to provide a 
  1277.      front-end program for the regular executable. See the IBM Network Door/2 
  1278.      Programming Guide for information on writing package run programs. 
  1279.  
  1280.  20. In the Run Program Window Type field enter the type of OS/2 session the 
  1281.      Run program should run in. 
  1282.  
  1283.  21. Select the Run Program 2.0 Setup button to specify OS/2 2.0 setup data to 
  1284.      use when running the package on the user's machine. 
  1285.  
  1286.  22. Select the Drive Dependency radio buttons to indicate how sensitive the 
  1287.      package is to the drive letter it will be assigned on the user's machine. 
  1288.  
  1289.      There are three categories: 
  1290.  
  1291.     Independent         The package can be attached to any free drive on the 
  1292.                         user's system. 
  1293.  
  1294.     Same Drive          The user can choose the drive letter during package 
  1295.                         installation, but the package must always use that 
  1296.                         drive letter. 
  1297.  
  1298.     Use Drive:          The package must use the drive letter specified for all 
  1299.                         users. Valid drive letters are between C: and Z:. It is 
  1300.                         advisable to use drive letters below G: to avoid 
  1301.                         conflicts for users with  many devices attached to 
  1302.                         their workstations. 
  1303.  
  1304.  23. Select Save to write all modifications to the package file. 
  1305.  
  1306.  24. Select Add to add the new package description to the package file. 
  1307.  
  1308.  25. Select Change to change the current package description. The actual text 
  1309.      of the button changes, depending on whether the package already exists. 
  1310.  
  1311.      Changes are not saved until you select Save. 
  1312.  
  1313.  26. Select Delete to remove the currently selected package from the package 
  1314.      name list. 
  1315.  
  1316.  27. Select Cancel to leave without making any changes. 
  1317.  
  1318.  
  1319. ΓòÉΓòÉΓòÉ 15. Specifying Setup Data ΓòÉΓòÉΓòÉ
  1320.  
  1321. To select setup data to use when running a package or package installation on a 
  1322. user's machine: 
  1323.  
  1324.   1. The 2.0 Setup window appears when you select one of the two 2.0 Setup... 
  1325.      buttons in the Vendor Admin Package File Editor panel. 
  1326.  
  1327.   2. The Setup Data list box shows all the current settings for the package. 
  1328.  
  1329.     o To add a new value, type the setting name and value in the setting and 
  1330.       value entry fields and select Add. 
  1331.  
  1332.     o To change a value, select it from the list, edit the value, and select 
  1333.       Change. 
  1334.  
  1335.     o To delete a setting, select it from the list, and select Delete. 
  1336.  
  1337.       For a list of DOS or WIN-OS2 Settings that can be specified, see a DOS or 
  1338.       WIN-OS/2 program object in the OS/2 2.0 Command Prompts Folder. 
  1339.  
  1340.   3. Select OK to accept the settings for the selected package or Cancel to 
  1341.      leave the window without making any changes. 
  1342.  
  1343.      The settings are not saved permanently until you select Save in the 
  1344.      Package File Editor window. 
  1345.  
  1346.  
  1347. ΓòÉΓòÉΓòÉ 16. Sending Messages ΓòÉΓòÉΓòÉ
  1348.  
  1349. You can send messages to machines on the current domain or IP network that are 
  1350. running the VENDOR or VNDADMIN programs. 
  1351.  
  1352. It is often helpful to send a message to a user who is having difficulty (as 
  1353. seen by incoming error messages) or to all users when you are about to bring 
  1354. down a Vendor server for maintenance. 
  1355.  
  1356. To send messages: 
  1357.  
  1358.   1. From the Vendor Admin window select Send messages. 
  1359.  
  1360.   2. The Vendor Admin Message Facility window appears. 
  1361.  
  1362.   3. In the Machine Name field enter the machine name to send the message to. 
  1363.      Enter an asterisk (*) to send the message to all machines running the 
  1364.      VENDOR or VNDADMIN program on the current domain or IP network. 
  1365.  
  1366.   4. Enter the message to be sent in the Message field. 
  1367.  
  1368.   5. Check the Send to Administrators Only box to send the message to machines 
  1369.      running the VNDADMIN program on the current domain or IP network only. 
  1370.  
  1371.   6. Select Send to send the message or Cancel to exit without sending a 
  1372.      message. 
  1373.