Creates a new cluster.


icon

Inputs/Outputs

  • cgenclassrntag.png database in —

    database in is the parent database object. database in can be an existing file. You can create a new database in memory by specifying :memory: for database in and create an entire hierarchy of objects in memory, without using a file on the disk.

  • cstr.png cluster name —

    cluster name is the name of the cluster to create. The name must be unique for all clusters in a database. Lowercase letters (a–z), uppercase letters (A–Z), numbers, and the underscore (_) are valid characters for the name. The space ( ), period (.), and other special characters are not supported within the name. The name must begin with a letter (uppercase or lowercase) or underscore, and not a number. The name is limited to 128 characters.

  • cerrcodeclst.png error in (no error) —

    The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

  • igenclassrntag.png database out —

    database out is a copy of the database in parameter. You can use this output to wire the VI to subsequent VIs.

  • igenclassrntag.png cluster out —

    cluster out is the I/O name of the newly created cluster object.

  • ierrcodeclst.png error out —

    The error out cluster passes error or warning information out of a VI to be used by other VIs. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

    • Description

    This VI creates an XNET cluster object. It is an instance of the XNET Database Create Object poly VI.

    The cluster name input becomes the Name (Short) property of the created object. This is distinct from the string contained within cluster out, which uses the syntax described in XNET Cluster I/O Name.

    The cluster object is created and remains in memory until the database is closed. This VI does not change the open database file on disk. To save the newly created object to the file, use the XNET Database Save VI.