GENLIB_LOINS.3(October 1, 1997) 										   GENLIB_LOINS.3(October 1, 1997)

NAME

       GENLIB_LOINS - add a logical instance to the current figure

SYNOPSYS

       #include <genlib.h>
       void GENLIB_LOINS(model, instance, sig1, sig2, ..., sign, EOL);
       char *model, *instance;
       char *sig1, *sig2, ..., *sign;

ORIGIN

       This  software  belongs	to  the  ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
       Paris, France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr

PARAMETERS

       model		   Name of the model to be logically instanciated

       instance 	   Name to be given to the new instance

       sig1, sig2, ..., sign
			   List of signals to be linked to the implicit connector list of the instance

DESCRIPTION

       LOINS add a logical instance in the actual working figure.  LOINS uses environment variables to choose the file format and the path to  the
       file.
       MBK_IN_LO set up the input file format, the valid ones beeing :
	      hns
	      fne
	      al
	      alx
       MBK_WORK_LIB  set  up the output file path. Any valid unix path is ok.  LOINS look in memory and then, if not found, on disk for the figure
       modelname. This is due to the need to ensure consistency between the model and its ascociated instances.
       The instance is added with the name instance, and each of the signals are connected to an instance connector. The connectors are implicitly
       matched	from  the order of the signal on the list.  This order is the one given in the netlist file, hns or al, or in the sclib documenta-
       tion, for standard cell circuits.

ERRORS

       "GENLIB_LOINS impossible : missing GENLIB_DEF_LOFIG"
	      No figure has been yet specified by a call to DEF_LOFIG. So it isn't possible to add anything. you must call  DEF_LOFIG  before  any
	      other netlist call.
       "GENLIB_LOINS : Bad signal bus name"
	      A signal, described under a bus form, has an illegal syntax.
       "Illegal addloins. Instance insname already exist in figure figname"
	      An instance name must be unique in a given figure at a given hierachy level.
       "Illegal addloins. Instance model is the figure figname itself"
	      A figure cannot be included in itself. Be careful, the check is only made at current hierarchy level.
       "Illegal addloins. Connector number discrepancy between figure modelname and instance insname in figure figname"
	      The number of connector in the model is not equal to the number of signals describing the connectivity during the LOINS call.

EXAMPLE

       #include <genlib.h>
       main()
       {
	    /* Create a figure to work on  */
	    GENLIB_DEF_LOFIG("mycell");
	    /* define interface  */
	    GENLIB_LOCON("i", INPUT, "sig1");
	    GENLIB_LOCON("o", OUTPUT, "sig2");
	    /* Place an instance */
	    GENLIB_LOINS("model","instance", "sig1", "sig2", EOL);
	    /* Save all that on disk */
	    GENLIB_SAVE_LOFIG();
       }

SEE ALSO

       genlib(1), GENLIB_DEF_LOFIG(3), MBK_IN_LO(1), MBK_CATA_LIB(1), MBK_WORK_LIB(1).

BUG REPORT

       This tool is under development at the ASIM department of the LIP6 laboratory.
       We need your feedback to improve documentation and tools.

PROCEDURAL GENERATION LANGUAGE
					     ASIM/LIP6					   GENLIB_LOINS.3(October 1, 1997)