fmu_connect(3)                      CLIX                      fmu_connect(3)



  NAME

    fmu_connect, fmu_disconnect - Connects/disconnects to remote FMU server

  LIBRARY

    INC Library (libinc.a)

  SYNOPSIS

    char *fmu_connect(
      char *node );

    char *fmu_disconnect(
      void );

  PARAMETERS

    node   Specifies the node to connect to or disconnect from.  The node
           parameter must have the following format, where nodename can be a
           string or network address, username and password are strings, and
           periods are the required delimiters:

           nodename [.username [.password]]

           The username and password parameters may be required depending on
           the nodename specified.

  DESCRIPTION

    The fmu_connect() function connects with the remote File Management
    Utility (FMU) server on the node specified, allowing other FMU functions
    to be used.

    The fmu_disconnect() function ends the connection to the FMU server.

  EXAMPLES

    1.  To connect to node ingr using the username sample and the password
        pass:

        fmu_connect (ingr.sample.pass)


    2.  To connect to node 0013498.08-00-36-AB-12-00 using the username sample
        and the password pass:

        fmu_connect (0013498.08-00-36-AB-12-00.sample.pass)


  CAUTIONS



  2/94 - Intergraph Corporation                                              1

  fmu_connect(3)                      CLIX                      fmu_connect(3)



    Connection can only be established for one node at a time.  Attempting to
    connect to another node automatically disconnects the previous connection.

    Any nodename specified must be in the local Intergraph clearinghouse.

    Server resources are wasted if fmu_disconnect() is not called before
    exiting.

  RETURN VALUES

    Upon successful completion, a null pointer is returned.  Otherwise, a
    pointer to an error message is returned.

  ERRORS

    The fmu_connect() and fmu_disconnect() functions fail if the following is
    true:

    INC-SP, Network request timeout
           An error message indicating that the timeout expired before the
           Sequence Packet Protocol (SPP) request had been processed.

    In addition, any of the diagnostics for the following functions may also
    be returned:  t_open(), t_bind(), t_accept(), t_listen(), t_rcv(),
    t_snd(), clh_lkp_node().

  RELATED INFORMATION

    Commands:  fmu(1)

    Functions:  fmu_send(3), fmu_receive(3), sni_connect(3)























  2                                              Intergraph Corporation - 2/94