
TIMINGDESIGNER(R) PROFESSIONAL EDITION FOR UNIX
INSTALLATION INSTRUCTIONS
=========================================================================
=========================================================================
Copyright information appears at the end of this document.


===========================================================
About this document
===========================================================
This document contains complete instructions and reference information
for installing TimingDesigner. It is divided into four parts:

-- Installing TimingDesigner

     Explains how to install TimingDesigner.

-- Customizing the license manager

     Discusses various options available when configuring lmgrd 
     and the license.opt file.

-- License manager error messages

     Gives a detailed listing of error messages and client messages 
     you may encounter when installing and configuring the license 
     manager.

-- MAN pages
     
     Lists the MAN pages for the commands that you use when 
     installing and configuring the license manager.


===========================================================
Installing TimingDesigner
===========================================================

This section describes the TimingDesigner system requirements and 
installation procedures.

----------------------------------
Before you begin
----------------------------------

Before you install TimingDesigner, take a moment to check your system 
configuration.

----------------------------------
Check your hardware and software
----------------------------------

Following is the minimum system configuration needed to install and 
use TimingDesigner:

--  SunSPARC running SunOS 4.x (Solaris 1.x) or SunOS 5.x (Solaris 2.x),
    or HP 9000 Series 700 running HP-UX v8.05 or later

--  At least 8MB of RAM. Smaller amounts of RAM will require larger 
    swap partitions and affect performance

--  At least 10MB of disk space

--  OpenWindows 3.x, or X11R4 or later with most window managers, 
    including the OpenLook Window Manager (olwm), HP VUE Workspace 
    Manager (vuewm), and the Motif Window Manager (mwm)

----------------------------------
Installing TimingDesigner
----------------------------------

These installation instructions are intended for the person performing 
the initial TimingDesigner installation. After TimingDesigner is 
installed, users should refer to the tutorial, to the User's Guide (if 
available), and to the online Help system for additional information 
regarding the use of TimingDesigner.

Note: The installation procedure assumes system administration 
experience on a workstation and some familiarity with SunOS or HP-UX. 
If you do not feel you have the skills to install TimingDesigner, 
please ask your system administrator for assistance.

These instructions assume that you are using the csh shell. If this 
is not the case, be sure to translate the literal commands given to 
the appropriate commands for your shell.

To install this version of TimingDesigner, complete the following 
steps.

1.  Move any previous versions.

    If there is a previous version of TimingDesigner installed, move 
    it to a different directory. For example, if version 1.3 of 
    TimingDesigner were installed in /usr/td, you might want to move 
    the files in /usr/td to /usr/tdv1.3. After you install the 
    current version of TimingDesigner in /usr/td, users of the
    previous version would gain access to the new version automatically.

2.  Specify a directory for TimingDesigner.

    When choosing the installation directory for TimingDesigner, be
    sure to choose a directory which is readable from the hosts of all
    potential TimingDesigner users. Users do not need write access to
    this directory. If you were using a previous version of
    TimingDesigner, use the installation directory of the previous
    version (/usr/td, for example).

    Once you've chosen an installation directory, set the environment
    variable $TDDIR to point to it:

     setenv TDDIR /usr/td

    Be sure the directory exists, and then change to it:

     mkdir $TDDIR
     cd $TDDIR

3.  Extract TimingDesigner.

    *** SunSPARC (SunOS 4.x/Solaris 1.x) ***

     Insert each disk (in any order) and for each one, enter:

          tar xvf /dev/fd0; eject

    *** SunSPARC (SunOS 5.x/Solaris 2.x) ***

     Insert each disk (in any order) and for each one, enter:

          volcheck
          tar xvf /vol/dev/aliases/floppy0
          eject

    *** HP ***

     Insert the tape and enter:

          tar xvf /dev/rmt/0mn

4.  Unpack the TimingDesigner files.

     ./unpack_td

    The distribution is in tar format. The directories and files are
    described below.

    Directories and Files       Contain
    ----------------------      --------------------------------------
     INSTALLATION.*             Installation instructions
     RELEASE_NOTES              Late-breaking news
     app-defaults/
        TimingDesigner          System-wide resource defaults
        HyperHelp               Online Help resource defaults
     bin/
        td                      TimingDesigner startup script
        hyperhelp               TimingDesigner online Help viewer
        td.bin                  TimingDesigner executable
        chrond                  Chronology licensing daemon   
     flexlm/
        bin/                    FLEXlm executables
        man/                    FLEXlm manual pages 
        licenses/             
          license.dat           License file template
     gzip                       File compression utility (SunSPARC only)
     help/                      Online Help files
     license.request            E-Mail license request form
     lib/
        XKeysymDB               X11 Keysym database
        Xp/                     Online Help printing support
        uid/                    Dialog box descriptions
     sample/   
        *.t[dl]                 Sample TimingDesigner files
     stdlib/                    Standard TimingDesigner libraries
     tutorial/                  Tutorial files
     unpack_td                  Script to unpack files
     userlib/                   Override libraries



5.  Modify each user's environment. Add the following initialization
    steps to each user's login files:

     setenv TDDIR /usr/td
     set path = ($path $TDDIR/bin)

    Users may use the command td to run TimingDesigner. You may want
    to examine the script $TDDIR/bin/td for any changes appropriate
    for your site.

    TimingDesigner is now installed in demonstration mode (saving,
    printing, and exporting features are not available). To install
    the full version of TimingDesigner, with all features enabled,
    you need to install the license manager; continue with the 
    section "Installing your license."


===========================================================
Installing your license
===========================================================

This section helps you install and administer TimingDesigner, utilizing
the Highland Flexible License Manager (FLEXlm). If you need additional
installation information, refer to your MAN pages.

----------------------------------
What is a license manager?
----------------------------------

When you start TimingDesigner, it must first check to see if it is
authorized to run. It does this is by contacting the license manager
daemon named lmgrd. lmgrd has the responsibility to track the number
of TimingDesigner sessions concurrently running on your network. If 
the daemon reports that a license is available, you are granted a 
license and TimingDesigner starts with all features enabled. Otherwise, 
it starts in demonstration mode, with the saving, printing, and 
exporting features not enabled.

----------------------------------
License manager components
----------------------------------

The components for a typical Highland Flexible License Manager 
installation consist of:

--  The license file $TDDIR/flexlm/licenses/license.dat

--  The license daemon $TDDIR/flexlm/bin/lmgrd

--  The specific vendor daemon $TDDIR/bin/chrond

--  The application program $TDDIR/bin/td.bin

----------------------------------
License installation procedure
----------------------------------

1.  In order to obtain a license, gather the following information:

     Hostname -- Execute "/bin/uname -n" to obtain this value.
     Hostid (SunSPARC only) -- Execute "/bin/hostid" or 
     "/usr/ucb/hostid" to     obtain this value.

     Station address (HP only) -- Execute "/etc/lanscan" to 
     obtain this value.

     Featureset number -- This information is needed only if you 
     are obtaining a change request for an existing authorization. 
     To find the featureset number, look in the About TimingDesigner
     dialog box under the Help menu or in the 
     $TDDIR/flexlm/licenses/license.dat file.

2.  Obtain authorization codes.

    Fill out an authorization form in "Obtaining authorization." There
    are separate forms for SunSPARC and HP authorizations. Then, fax
    the form to Chronology Technical Support at (206) 869-4229. 
    Or, complete the form in $TDDIR/license.request and E-Mail it to 
    chronco!support@uunet.uu.net.

3.  Install the license information in license.dat.

    Edit the file $TDDIR/flexlm/licenses/license.dat to include the
    license information provided by Chronology Technical Support.

4.  Start the license manager daemon by hand.

    When starting the license manager daemon by hand, check for the
    appropriate feature check out, and observe any error messages.

    Note: On HP machines, this command must be entered as root.

     cd $TDDIR/flexlm/bin
     ./lmgrd -c $TDDIR/flexlm/licenses/license.dat &

    An example of the correct messages are as follows:

     2/10 8:45 (license daemon) FLEXlm (v2.21) started on <hostname>
     2/10 8:45 (License daemon) CONNECTED, master is <hostname>
     2/10 8:45 (license daemon) Started chrond    
     2/10 8:45 (chrond) Server started on <hostname> for:   
     2/10 8:45 (chrond) TimingDesigner

5.  Add the lmgrd command to the system startup files, if desired.

    Note: In the following command, set TDDIR to your TimingDesigner 
    installation directory (/usr/td, for example).

    *** SunSPARC ***

     Insert the following into the file /etc/rc.local
     (SunOS 4.x/Solaris 1.x) or /etc/rc2 (SunOS 5.x/Solaris 2.x):

        #
        # Highland Flexible License Manager  
        #
        TDDIR=/usr/td
        if [ -f $TDDIR/flexlm/bin/lmgrd ]; then
        $TDDIR/flexlm/bin/lmgrd -c $TDDIR/flexlm/licenses/license.dat\
            > /var/log/lmgrd.log &
        echo -n ' lmgrd'
        unset TDDIR
        fi

    *** HP ****

     Insert the following into the file /etc/rc:

        #
        # Highland Flexible License Manager  
        #
        TDDIR=/usr/td
        if [ -x $TDDIR/flexlm/bin/lmgrd ]; then
        set -m
        $TDDIR/flexlm/bin/lmgrd -c $TDDIR/flexlm/licenses/license.dat\
          > /tmp/lmgrd.log &
        unset TDDIR
        fi

6.  Be sure that you understand the various FLEXlm administration commands,
    as described in their MAN pages, $TDDIR/flexlm/man. 

    These commands are stored in $TDDIR/flexlm/bin. In particular, be sure
    to use lmdown to shut down FLEXlm. It performs cleanup functions to
    assure FLEXlm starts back up correctly.

7.  As a final test, run TimingDesigner and confirm that the featureset
    number appears in the About dialog box (under the Help menu):

     $TDDIR/bin/td &

----------------------------------
Obtaining authorization
----------------------------------

It's easy to obtain authorization! Make a copy of an authorization form,
collect the data, and then fax the information to Chronology Corporation 
at (206) 869-4229. Note that there are separate forms for SunSPARC and HP 
authorizations; use the form appropriate to your system. If you have any 
questions about the form, please call Chronology Technical Support.

As an alternative, you can complete the form in $TDDIR/license.request 
and E-Mail it to chronco!support@uunet.uu.net.


TimingDesigner
SunSPARC Authorization Form
===========================
To receive your authorization codes, please fill out the necessary
information, then email this form back to Chronology at
chronco!support@uunet.uu.net.

End User
========
             Name: _______________________________________________
          Company: _______________________________________________
          Address: _______________________________________________
 City, State, Zip: _______________________________________________
            Phone: _______________________________________________
              Fax: _______________________________________________
            Email: _______________________________________________

System Administrator
====================
If different from the End User, please complete:
             Name: _______________________________________________
            Phone: _______________________________________________
              Fax: _______________________________________________
            Email: _______________________________________________

Authorization Codes
===================
How would you like your authorization codes sent?
     Email? (Y/N): _______________________________________________
       Fax? (Y/N): _______________________________________________

License Server Hostname
=======================
Enter the hostname of the machine on which you will execute the license
manager daemon, lmgrd. To find the hostname, execute '/bin/uname -n'.
         Hostname: _______________________________________________

License Server Hostid
=====================
Enter the hostid of the machine on which you will execute the license
manager daemon, lmgrd. To find the hostid, execute '/bin/hostid' or
'/usr/ucb/hostid'.
           Hostid: _______________________________________________

Featureset Number
=================
If this is a change request for an existing authorization, enter the
featureset number of the previous authorization. To find the
featureset number, look in the About TimingDesigner dialog box under
the Help menu, or look in the file $TDDIR/flexlm/licenses/license.dat.
Featureset Number: _______________________________________________



Chronology Corporation
17411 NE Union Hill Road
Redmond, WA 98052
voice: (206) 869-4227
       (800) 800-6494
  fax: (206) 869-4229
email: chronco!support@uunet.uu.net
       chronco!sales@uunet.uu.net




TimingDesigner
HP PA-RISC Authorization Form
===========================
To receive your authorization codes, please fill out the necessary
information, then email this form back to Chronology at
chronco!support@uunet.uu.net.

End User
========
             Name: _______________________________________________
          Company: _______________________________________________
          Address: _______________________________________________
 City, State, Zip: _______________________________________________
            Phone: _______________________________________________
              Fax: _______________________________________________
            Email: _______________________________________________

System Administrator
====================
If different from the End User, please complete:
             Name: _______________________________________________
            Phone: _______________________________________________
              Fax: _______________________________________________
            Email: _______________________________________________

Authorization Codes
===================
How would you like your authorization codes sent?
     Email? (Y/N): _______________________________________________
       Fax? (Y/N): _______________________________________________

License Server Hostname
=======================
Enter the hostname of the machine on which you will execute the license
manager daemon, lmgrd. To find the hostname, execute '/bin/uname -n'.
         Hostname: _______________________________________________

License Server Station Address
==============================
Enter the station address of the machine on which you will execute the
license manager daemon, lmgrd. To find the hostid, execute '/etc/lanscan'.
  Station Address: _______________________________________________

Featureset Number
=================
If this is a change request for an existing authorization, enter the
featureset number of the previous authorization. To find the
featureset number, look in the About TimingDesigner dialog box under
the Help menu, or look in the file $TDDIR/flexlm/licenses/license.dat.
Featureset Number: _______________________________________________



Chronology Corporation
17411 NE Union Hill Road
Redmond, WA 98052
voice: (206) 869-4227
       (800) 800-6494
  fax: (206) 869-4229
email: chronco!support@uunet.uu.net
       chronco!sales@uunet.uu.net



----------------------------------
For further assistance
----------------------------------

If you need further assistance, please contact Chronology Technical 
Support by phone, fax, or E-Mail. Our hours are weekdays from 8:00 a.m. 
to 5:00 p.m., Pacific Time, and the numbers are listed on the copyright 
page of this document.

Before you call, take the time to clarify the problem:

--  Make sure the problem is repeatable.

--  Consult online Help or other documentation to see if help is available.

When you call, please have the following information available:

--  Hardware configuration -- memory capacity, processor type, speed, and
    so forth.

--  Version number -- obtained by going to the Diagram Window's Help menu
    and choosing the About TimingDesigner command.

--  Your featureset number -- listed in the About TimingDesigner dialog
    box under the Diagram Window's Help menu and in the 
    $TDDIR/flexlm/licenses/license.dat file.




===========================================================
Customizing the license manager
===========================================================

This section contains information on how to customize the license manager.

----------------------------------
About lmgrd
----------------------------------

The license daemon (lmgrd) allows the license file location and the 
server-to-server connection timeout interval to be set by the end-user. 
These options are set by command line arguments when starting lmgrd. 
The command line for lmgrd is:

     lmgrd [-c license_file] [-t timeout] -s interval]

where:

     license_file   is the path name to the license file.

     timeout        is the time interval (in seconds) during which 
               daemons must complete connections to each other. 
               The default value is 10 seconds.

     interval  is the logfile timestand interval, in minutes. The 
               default value is 360 minutes.

Note that the license file pathname can also be specified by setting the 
environment variable "LM_LICENSE_FILE" to the file's pathname. The "-c" 
path specification will override the "LM_LICENSE_FILE" environment
variable.

Note 1: Never kill the lmgrd or chrond daemons using the kill command. 
Only use the lmdown utility. Killing the license manager daemons may 
cause problems with the license manager and produce licenses that appear 
checked out when in reality they are not. If this happens, use the 
lmremove utility to return licenses to the license pool.

Note 2: The TCP/IP port used by the license manager in the license.dat 
file on the SERVER line or configured in the /etc/services file is unique. 
If another application is installed that uses the same TCP/IP address, 
there will be a conflict with the address already taken and will cause 
the license manager to fail. Be especially aware of databases and 
network-based applications that automatically install with installation 
scripts. This software may automatically edit the /etc/services file 
and enter a conflicting port entry.

----------------------------------
License manager options file
----------------------------------

Access to TimingDesigner can be customized via the FLEXlm daemon options 
file license.opt. This options file allows licenses to be reserved for 
specified users or groups of users, to allow or disallow use to certain 
people, and to set software timeouts.

In order to use the daemon options capability, create a daemon options 
file and list its pathname as the fourth field on the "DAEMON" line in 
the license.dat file.

A daemon options file consists of lines in the following format:

     RESERVEnumber feature {USER | HOST | DISPLAY | GROUP} name
     INCLUDEfeature {USER | HOST | DISPLAY | GROUP} name
     EXCLUDE feature {USER | HOST | DISPLAY | GROUP} name
     GROUP name <list_of_users>
     TIMEOUT feature timeout_in_seconds
     NOLOG {IN | OUT | DENIED | QUEUED}

The options are described below.

     RESERVE        Insures that TimingDesigner will always be 
               available to one or more users or on one or 
               more host computer systems.

     INCLUDE        Allows specification of a list of users who 
               are allowed access to your software.

     EXCLUDE        Prevents certain people from using TimingDesigner.

     GROUP          Allows the specification of a group of users 
               for use in the other commands.

     TIMEOUT        Allows licenses that are idle to be returned 
               to the free pool, for use by someone else.

     NOLOG          Causes messages of the specified type to be 
               filtered out of the daemon's log output.

Lines beginning with the pound character (#) are ignored, and can be 
used as comments.

For example, the following options file would reserve a copy of feature 
"TimingDesigner" for user "pat," 3 copies for user "lee," and a copy 
for anyone on a computer with the hostname of "terry," and would cause 
QUEUED messages to be omitted from the log file. In addition, user 
"joe" would not be allowed to use the feature "TimingDesigner."

     RESERVE1 TimingDesigner USER pat
     RESERVE3 TimingDesigner USER lee
     RESERVE1 TimingDesigner HOST terry
     EXCLUDE TimingDesigner USER joe
     NOLOG QUEUED

If this data were in the file /usr/local/flexlm/licenses/license.opt, 
then you would modify the license file DAEMON line as follows:

     DAEMON chrond /usr/TimingDesigner/bin/chrond \                        
               /usr/local/flexlm/licenses/license.opt




===========================================================
License manager error messages
===========================================================

All license manager errors should be resolved before proceeding any 
further. Some common configuration errors are as follows:

[BAD CODE for feature-name]

    The specified feature name has a bad encryption code. This indicates 
    that the data on the feature line is incorrect and should be checked
    again. If you have checked it and can find no errors, call Chronology
    Technical Support and ask for verification of the license data for
    this feature.

[hostname: Not a valid server host, exiting]

    The daemon was run on an invalid hostname.

[hostname: Wrong hostid, exiting.]

    The hostid is wrong for "hostname"

[NO DAEMON license, exiting]

    The license daemon logs this message if there are no DAEMON lines
    in the license file. Since there are no vendor daemons to start,
    there is nothing to do.

[No features to serve!]

    The chrond found no features to serve. This could be caused by bad
    data in the license file.

[Unknown host: hostname]

    The hostname specified on a "SERVER" line in the license file does
    not exist in the network database (/etc/hosts).

[UNSUPPORTED FEATURE request: feature by user]

    The user has requested a feature that the vendor daemon does not
    support. This can happen for a number of reasons: the license file
    is bad, the feature has expired, or the daemon is accessing the
    wrong license file.


----------------------------------
License Manager client messages
----------------------------------

[LMGR: Checkout of <feature> failed <lmgr error code>]

    There was a failure in checking out this feature. The error code
    should give you more information.

[LMGR: Error getting config file data]

    This feature is not in the license.dat file.

[LMGR: Lost connection for <feature> re-connection attempt
<x times> of <x total>]

    This message means that the connection between the client and the
    license manager server was lost. This can occur for several reasons
    such as excessive network traffic, the license manager server
    crashed and is re-booting, or the license manager daemon died.
    This error should be traced immediately, especially for large
    install bases, to avoid impacting a large number of end-users.

[LMGR: Lost connection to server for <feature>, exiting...]

    This message is produced after the client has attempted to connect
    to the license manager for each retry and reached the maximum
    number of retries.

[LMGR: Maximum # users for <feature>reached]

    All the licenses are checked out. The LMGR will show you a list
    of all users that are checking out this feature. You will probably
    need to purchase more licenses or check to see if there are any
    dormant check-outs.

[LMGR: RESERVATION for <user> <node> USER : NODE]

    Shows a list of reserved features when maximum reached.

[LMGR: Wrong host for <feature>]

    This feature is tied to execution on a specific host and is not
    on that host.


===========================================================
MAN pages
===========================================================

This section contains information on the commands that you might use 
when installing TimingDesigner or configuring FLEXlm. These pages are 
also online in $TDDIR/flexlm/man.

----------------------------------
license.dat
----------------------------------

Name

     license.dat - license configuration file for FLEXlm licensed 
     applications

Synopsis

     /usr/local/flexlm/licenses/license.dat

Description

     The license.dat file contains the information used by the 
     FLEXlm network licensing package to determine which licenses 
     are available at a particular site. The license.dat 
     file contains the following information:

     --  List of server nodes

     --  List of vendor daemons

     --  List of features enabled for this site

     --  List of featureset lines for this site

     Some of the information in the license file is changeable by 
     the system administrator at the end-user site, allowing him 
     to configure the licensed software to fit into his environment.

     FLEXlm programs and routines find the license file by an 
     algorithm described below in the section "Finding the license 
     file."

     Each line in the license.dat file starts with a keyword which 
     identifies the information on that line. The keyword is one of 
     SERVER, DAEMON, FEATURE, or FEATURESET.

     The SERVER line is of the form:

          SERVER nodename hostid [port-number]

     The hostids from all of the server lines are encrypted into the 
     FEATURE lines, so they can not be changed by the site 
     administrator. The optional port-number field can be changed 
     at any time. This allows the site administrator to select a port
     number which does not conflict with the other services, software 
     packages, or FLEXlm vendors on his system. The site administrator
     can also change the nodename if he wishes, as long as the hostid 
     does not change. On sites with multiple redundant servers, one 
     of the servers is selected as the master node. If the order of 
     the server lines is the same in the license files for all of 
     the redundant servers, then the first server in the list will 
     be the master; otherwise, the server whose name is alphabetically
     first will be the master.

     The DAEMON line is of the form:

          DAEMON daemon-name path options-file

     The site administrator can change the path field, which allows 
     him to place the vendor daemon in any convenient location. The 
     site administrator can also change the location of the 
     options-file, which describes various options that the site 
     administrator can modify (see license.options(8)).

     The FEATURE line describes the features that are enabled for 
     this site. None of the information in the FEATURE line is 
     changeable by the site administrator.

     The FEATURESET line is a vendor-optional line; some vendors may 
     choose to use this line, some may choose not to use it. The 
     FEATURESET line encodes the encryption codes of all of the 
     features for the specified vendor. This line is not changeable 
     by the site administrator.

Finding the license file

     Most programs which read the license.dat file accept a command 
     line option (typically -c) which can be used to specify the 
     location of the license file if other than 
     /usr/local/flexlm/licenses/license.dat. If no command line 
     switch is given, then the value of the environment variable 
     LM_LICENSE_FILE will be used to find the license file. If 
     neither of these are specified, the default location, 
     /usr/local/flexlm/licenses/license.dat, will be used.

     The LM_LICENSE_FILE environment variable can be used to specify 
     a number of different license files. To do this, the environment 
     variable should be set to a single string which contains all of 
     the license file paths separated by colons. For example:

           setenv LM_LICENSE_FILE \
             /usr/local/foo.dat:/u2/flexlm/bar.dat:/u12/lic.dat

Example

     Here is an example of a license.dat file:

          SERVER pat 17003456 1700
          SERVER lee 17004355 1700
          SERVER terry 17007ea8 1700
          DAEMON GSI /etc/mydaemon
          FEATURE great_program GSI 01-jan-1989 10
               1EF890030EABF324 ""
          FEATURE greater_program GSI 01-jan-1989 10
               0784561FE98BA073 ""

     This example illustrates the license file for a single vendor 
     with two features, and a set of three server nodes, any two of 
     which must be running for the system to function.

Files

     /usr/local/flexlm/licenses/license.dat

See also

     lmgrd(1), license.opt(5)


----------------------------------
license.opt
----------------------------------

Name

     license.opt - site administrator options file for 
     FLEXlm-licensed applications

Synopsis

     /usr/local/flexlm/options/license.opt

Description

     The license.opt file contains optional information supplied 
     by the system administrator at the end-user site. This 
     information can be used to tailor the behavior of the license 
     daemons. The options file can contain the following information:

     --  Reserved license information

     --  Logfile control options

     --  License timeout control

     Lines beginning with the pound character (#) are ignored, and 
     can be used as comments.

     There is no default location or name for the options file; it 
     is only active if it has been specified in the license.dat file 
     as the fourth argument on the DAEMON line. Note that if there 
     are multiple DAEMON lines in the license.dat file, then there 
     can be multiple options files, one for each DAEMON line. Not 
     all of the lines in an options file refer to a feature, so the 
     site administrator MUST set up separate options files in order 
     to use the NOLOG and REPORTLOG features.

     Each line in the options file starts with a keyword which 
     identifies the information on that line. The keyword is one of 
     RESERVE, NOLOG, GROUP, INCLUDE, EXCLUDE, TIMEOUT, or REPORTLOG.

     The RESERVE line is of the form:

          RESERVE numlic feature {USER|HOST|DISPLAY|GROUP} name

     The RESERVE command reserves the specified number of licenses 
     for the specified user, host, display, or group. Note that 
     reserving a license decreases the number of generally available 
     licenses.

     The NOLOG line is of the form:

          NOLOG {IN|OUT|DENIED|QUEUED}

     NOLOG causes messages of the specified type to be filtered out 
     of the daemon's log file. Specifying a NOLOG option will reduce 
     the amount of output to the log file, which can be useful in 
     those cases where the log file grows too quickly.

     The GROUP line is of the form:

          GROUP group-name member-list

     The GROUP command is used to define collections of users, which 
     can then be used in RESERVE, INCLUDE, or EXCLUDE commands.

     The INCLUDE and EXCLUDE commands are of the form:

          {INCLUDE|EXCLUDE} feature {USER|HOST|DISPLAY|GROUP} name

     INCLUDE and EXCLUDE are used to specify which users (or hosts, 
     displays, or groups) are allowed to use a particular feature. 
     Any user who is EXCLUDEd from a feature will not be able to use 
     that feature. Specifying an INCLUDE line has the effect of 
     excluding everyone else from that feature; thus, only those 
     users specifically INCLUDEd will be able to use that feature.

     The TIMEOUT line is of the form:
     
          TIMEOUT feature idletime

     The TIMEOUT command is used to set up a minimum idle time after 
     which a user will lose his license if he is not using it. This 
     allows the site administrator to prevent users from wasting a 
     license (by keeping it checked out when they are not using it) 
     when someone else wants a license.

     The REPORTLOG line is of the form:

          REPORTLOG filename

     REPORTLOG tells the daemon that it should create a log file 
     suitable for use with the FLEXlm report writing tools. This log 
     file maintains more detailed information than the standard log 
     file, but is not meant to be human readable. If the filename 
     starts with a plus character (+), the file will be opened in 
     append mode.

Example

     Here is an example of an options file:

          REPORTLOG /usr/adm/gsi.replog
          RESERVE compile USER pat
          RESERVE compile USER less
          RESERVE compile HOST terry
          NOLOG QUEUED

Files

     /usr/local/flexlm/options/license.opt

See also

     lmgrd(1), license.dat(5)

----------------------------------
lmdown
----------------------------------

Name

     lmdown - graceful shutdown of all license daemons

Synopsis

     lmdown [ -c license_file ] [ -q ]

Description

     lmdown sends a message to every license daemon asking it to 
     shut down. The license daemons write out their last messages to 
     the log file, close the file, and exit. All licenses which have 
     been given out by those daemons will rescinded, so that the next 
     time a client program goes to verify his license, it will not be 
     valid.

Options

     -c license_file

          Use the specified license_file. If this switch is not 
          specified, lmdown looks for the environment variable 
          LM_LICENSE_FILE. If that environment variable is not set, 
          lmdown looks for the file /usr/local/flexlm/licenses/
          license.dat. If no -c option is specified, lmdown looks 
          for the environment variable LM_LICENSE_FILE in order to 
          find the license file to use. If that environment 
          variable is not set, lmdown looks for the file 
          /usr/local/flexlm/licenses/license.dat.

     -q

          Quiet mode. If this switch is not specified, lmdown 
          asks for confirmation before asking the license daemons 
          to shut down. If this switch is specified, lmdown will 
          not ask for confirmation.

See also

     lmgrd(1), lmstat(1), lmreread(1)


----------------------------------
lmgrd
----------------------------------

Name

     lmgrd - flexible license manager daemon

Synopsis

     lmgrd [ -c license_file ] [ -t timeout ] [ -s interval ]

Description
     lmgrd is the main daemon program for the FLEXlm distributed 
     license management system. When invoked, it looks for a license 
     file containing all required information about vendors and 
     features.

Options

     -c license_file

          Use the specified license_file. If this switch is not 
          specified, lmgrd looks for the environment variable 
          LM_LICENSE_FILE. If that environment variable is not set, 
          lmgrd looks for the file /usr/local/flexlm/licenses/
          license.dat.

     -t timeout

          Specifies the timeout interval, in seconds, during which 
          daemons must complete their connections to each other. 
          The default value is 10 seconds. A larger value may be 
          desirable if the daemons are being run on busy systems 
          or a very heavily loaded network.

     -s interval

          Specifies the logfile timestamp interval, in minutes. 
          The default is 360 minutes.

Environment

     If no -c option is specified, lmgrd looks for the environment 
     variable LM_LICENSE_FILE in order to find the license file to 
     use. If that environment variable is not set, lmgrd looks for 
     the file /usr/local/flexlm/licenses/license.dat.

See also

     lmdown(1), lmstat(1)


----------------------------------
lmhostid
----------------------------------

Name

     lmhostid - report the hostid of a system

Synopsis

     lmhostid

Description

     lmhostid calls the FLEXlm version of gethostid and displays 
     the results. The output of lmhostid looks like this:

          lmhostid - Copyright (C) 1989, 1990 Highland
               Software, Inc.
          The FLEXlm host ID of this machine is "1200abcd"
Options

     lmhostid has no command line options.


----------------------------------
lmremove
----------------------------------

Name

     lmremove - remove specific licenses and return them to license 
     pool

Synopsis

     lmremove [ -c license_file ] feature user host [ display ]

Description

     lmremove allows the system administrator to remove a single 
     user's license for a specified feature. This could be required 
     in the case where the licensed user was running the software 
     on a node that subsequently crashed. This situation will 
     sometimes cause the license to remain unusable. lmremove will 
     allow the license to return to the pool of available licenses.

Options

     -c license_file

          Use the specified license_file. If this switch is not 
          specified, lmremove looks for the environment variable 
          LM_LICENSE_FILE. If that environment variable is not set, 
          lmremove looks for the file /usr/local/flexlm/licenses/
          license.dat. If no -c option is specified, lmremove looks
          for the environment variable LM_LICENSE_FILE in order to 
          find the license file to use. If that environment 
          variable is not set, lmremove looks for the file 
          /usr/local/flexlm/licenses/license.dat.

See also

     lmstat(1)


----------------------------------
lmreread
----------------------------------

Name

     lmreread - tells the license daemon to reread the license file

Synopsis

     lmreread [ -c license_file ]

Description

     lmreread allows the system administrator to tell the license 
     daemon to reread the license file. This can be useful if the 
     data in the license file has changed; the new data can be 
     loaded into the license daemon without shutting down and 
     restarting it.

     lmreread uses the license file from the command line (or the 
     default file, if none specified) only to find the license daemon 
     to send it the command to reread the license file. The license 
     daemon will always reread the original file that it loaded. If 
     you need to change the path to the license file read by the 
     license daemon, then you must shut down the daemon and restart 
     it with that new license file path.

     You can not use lmreread if the SERVER node names or port 
     numbers have been changed in the license file. In this case, 
     you must shut down the daemon and restart it in order for those 
     changes to take effect.

     lmreread does not change any option information specified in 
     an options file. If the new license file specifies a different 
     options file, that information is ignored. If you need to 
     reread the options file, you must shut down the daemon and 
     restart it.

Options

     -c license_file

          Use the specified license_file. If this switch is not 
          specified, lmreread looks for the environment variable 
          LM_LICENSE_FILE. If that environment variable is not set, 
          lmreread looks for the file /usr/local/flexlm/licenses/
          license.dat. If no -c option is specified, lmreread looks
          for the environment variable LM_LICENSE_FILE in order to 
          find the license file to use. If that environment 
          variable is not set, lmreread looks for the file 
          /usr/local/flexlm/licenses/license.dat.

See also

     lmdown(1)


----------------------------------
lmstat
----------------------------------

Name

     lmstat - report status on license manager daemons and feature 
     usage

Synopsis

     lmstat [ -a ] [ -A ] [-c license_file ] [ -f [feature] ] 
     [ -l [regular_expression] ] [ -s [server] ] [ -S [DAEMON] ] 
     [ -t timeout ]

Description
     lmstat provides information about the status of the server 
     nodes, vendor daemons, vendor features, and users of each 
     feature. Information can be optionally be qualified by 
     specific server nodes, vendor daemons, or features.

     lmlist lists the users of a specific feature, in much the same 
     way as lmstat -f. lmlist does not accept any command line 
     options. In particular, it does not accept the -c option; you 
     must use the LM_LICENSE_FILE environment variable if you want 
     lmlist to use a license file other than 
     /usr/local/flexlm/licenses/license.dat.

Options

     -a

          Display everything.

     -A

          List all active licenses.

     -c license_file

          Use the specified license_file. If this switch is not 
          specified, lmstat looks for the environment variable 
          LM_LICENSE_FILE. If that environment variable is not set, 
          lmstat looks for the file /usr/local/flexlm/licenses/
          license.dat.

     -f [feature]

          List all users of the specified feature(s).

     -l [regular_expression]

          List all users of the features matching the given 
          regular expression.

     -s [server]

          Display the status of the specified server node(s).

     -S [daemon]

          List all users of the specified daemon's features.

     -t timeout

          Specifies the timeout interval, in seconds, during which 
          daemons must complete their connections to each other. 
          The default value is 10 seconds. A larger value may be 
          desirable if the daemons are being run on busy systems 
          or a very heavily loaded network.

Environment

     If no -c option is specified, lmstat looks for the environment 
     variable LM_LICENSE_FILE in order to find the license file to 
     use. If that environment variable is not set, lmstat looks for 
     the file /usr/local/flexlm/licenses/license.dat.

See also

     lmgrd(1)


----------------------------------
lmver
----------------------------------

Name

     lmver - report the FLEXlm version of a library of binary file

Synopsis

     lmver [filename]

Description

     lmver scans the contents of a binary or library file for the 
     FLEXlm version string and displays it. If no argument is 
     given, lmver assumes the filename is "lmgr.a" and attempts 
     to find and display the version from that file.

Options

     lmver has no command line options.

===========================================================
TimingDesigner(R) Professional Edition/Evaluation
Version 2.0 for UNIX
Installation Instructions
Rev. 2.0. February 1994.

Information in this document is subject to change without notice and 
does not represent a commitment on the part of Chronology Corporation. 

This document and the TimingDesigner Evaluation software to which it 
refers may be freely used, copied, and distributed "as is," provided 
that it is used for evaluation purposes only, and provided that the 
notice "Copyright 1991-1994 Chronology Corporation. All rights reserved."
and this paragraph are clearly visible on the copies of the document and 
are contained on the media containing copies of the TimingDesigner 
Evaluation software, and provided that no charge is made for such copies.
You may use the TimingDesigner Evaluation software for evaluation 
purposes for a maximum of 90 days. The TimingDesigner Evaluation software
is a confidential trade secret of Chronology Corporation. You may not 
attempt to decipher, decompile, or modify the TimingDesigner Evaluation 
software, develop passwords or codes or otherwise enable the Save feature 
of the TimingDesigner Evaluation software, or knowingly allow others to 
perform any of these actions. You may not save timing diagrams on 
electronic media with the TimingDesigner Evaluation software. The 
information contained in this document may be incorporated into other 
materials provided that the notice "Portions Copyright 1991-1994 
Chronology Corporation. All rights reserved." is clearly visible on 
such material. You are hereby granted no other rights to this document 
or to the TimingDesigner Evaluation software to which it refers. In 
addition, you are granted no rights to the actual TimingDesigner 
Professional Edition and TimingDesigner Standard Edition software, 
which cannot be used, copied, or distributed unless you have legally 
obtained a written license agreement from Chronology Corporation 
granting such rights.

The TimingDesigner Professional Edition and TimingDesigner Standard 
Edition software are furnished under a license agreement or 
non-disclosure statement. The software may be used or copied only in 
accordance with the terms of the agreement. It is against the law to 
copy the software on any medium except as specifically allowed in the 
license agreement or non-disclosure statement. 

Copyright (C) 1991-1994 Chronology Corporation. All rights reserved.

Portions (C) 1984 Regents of the University of California. All rights 
reserved. Portions (C) 1988-1990 Adobe Systems Incorporated. All rights 
reserved. Portions (C) Globetrotter Software, Inc. All rights reserved.

TimingDesigner is a registered trademark of Chronology Corporation.

UNIX and OpenLook are registered trademarks of UNIX Systems Labs. HP, 
HP-UX, and VUE are registered trademarks of Hewlett-Packard Company. 
The X Window System is a trademark of the Massachusetts Institute of 
Technology. Sun, Solaris, SunOS, and OpenWindows are trademarks of Sun 
Microsystems, Inc. SPARC is a registered trademark of SPARC 
International, Inc. OSF/Motif is a trademark of the Open Software 
Foundation, Inc. Microsoft and MS-DOS are registered trademarks and 
Windows is a trademark of Microsoft Corp. FrameMaker is a registered 
trademark of Frame Technology Corp. PostScript, Display PostScript, 
and Adobe are registered trademarks of Adobe Systems, Inc. TrueType is 
a registered trademark of Apple Computer, Inc. All other brand or 
product names are trademarks or registered trademarks of their respective
companies or organizations, and are used only for explanation and to 
the owners' benefit, without intent to infringe.

Chronology Corporation
17411 NE Union Hill Rd. #100, Redmond, WA 98052 U.S.A.
Tel: (206)869-4227 BBS: (206)869-4228 Fax: (206)869-4229
E-Mail: chronco!sales@uunet.uu.net and chronco!support@uunet.uu.net
