STAMOD   

Equivalent PK functions: PK_SESSION_start

STAMOD ( kijon, nchars, jfilnm, usrfld, world, kivrsn, ifail )
==============================================================

  Starts the modeller

Receives:
  KI_cod_logical           *kijon          --- flags whether to write journal
                                           --- file or not
 <KI_int_nchars>           *nchars         --- number of characters in journal
                                           --- file name (used only if kijon is
                                           --- set to true)
  KI_chr_filename           jfilnm[nchars] --- name of journal file
  int                      *usrfld         --- size of user fields (in integers)

Returns:
  KI_tag_entity            *world          --- world
  int                      *kivrsn         --- version number of interface being
                                           --- invoked
  KI_cod_error             *ifail          --- failure indicator

Specific errors:
  KI_cant_open_jrnl         Journal file could not be opened
  KI_bad_filename           Character string is not a valid file name
  KI_bad_user_field_size    User field length is negative or longer than maximum
  KI_incorrect_mc_conf      Machine configuration not authorised for Parasolid
  KI_modeller_not_stopped   STAMOD already called since the last call to STOMOD

Description:
  This routine starts up the modeller and must be called before any other. It
  may not then be called again until STOMOD has been called. If the journal
  flag 'kijon' is set to true then journal records will be sent to the specified
  file for each call to the interface.

  The length (in integers) of user fields may also be specified. The maximum
  length is 16 integers; specifying a length of zero will result in no user
  fields being allocated. Note that in order to receive an archived part with
  its user fields, it is necessary that the user field length for the current
  session be the same as when the part was archived.

  The world entity (which contains all loaded assemblies and bodies) is
  returned.

  The interface parameters are initialised: see SEINTP for documentation of
  the default values.

  The version number of the kernel is returned in 'kivrsn'; when read as a
  decimal integer it is of form Mmmbbb, where M is the major version number
  of Parasolid, mm is the minor version number and bbb is the build number,
  which identifies when the copy of Parasolid currently being run was
  compiled.  The entire version number should always be quoted in any
  correspondence with your supplier of Parasolid.

  On platforms where it is possible to vary the machine configuration in ways
  that would affect Parasolid (eg, the format of floating point numbers or the
  endian-ness of numbers) the modeller will not be started if the current
  configuration is not recognised as being safe. In this case the ifail
  KI_incorrect_mc_conf will be returned.