
======================================================================
                  mkspin -- Spin Conversion Module
             Copyright (c) 1999 by Lucent Technologies
======================================================================


Usage
=====

mkspin [-v -e -m] infile [outfile]

	-v = verbose
	-e = expand only (flattens the hierarchical graph only)
	-m = alternate buffer semantics

infile is a main uce case graph (.ucg) file.

======================================================================

mkspin converts UBET ucg graphs (use case graph) and referenced
message sequence charts (msc) into a Promela model - the
specification language of the Spin model checker.

The conversion requires the presence of basic msc's linked to
the nodes in the ucg graph. The conversion preserves the event
sends and receives in the mscs and the control flow structure
of the ucg graph.


Preparation
===========

Before using mkspin to convert ucg graphs to Spin model,
following requirements must be met.

1. A main ucg graph with referenced msc charts is required.
2. Underlying sub-graphs are optional.
3. Each ucg must have a Start node and a Stop node.


