Programmatically creates a Citadel database with the name specified by database name in the directory specified by database path on the computer specified by computer name.


icon

Inputs/Outputs

  • ci32.png timeout (30 s)

    timeout specifies the maximum time, in seconds, that this VI waits for reading data from the Citadel database. The default is 30. A timeout value of less than or equal to 0 specifies no timeout, which means this VI waits indefinitely until this VI receives data from the Citadel database.

  • cstr.png computer name

    computer name specifies the computer on which to create the database. If you do not wire this parameter, computer name defaults to the local computer.

  • cstr.png database name

    database name is the name of the database this VI creates.

    If you do not wire this parameter, this VI uses the database path to generate a database name, replacing all non-alphanumeric characters with underscores. For example, a database path of C:\data1\data2\database generates the database name C__data1_data2_database.

  • cpath.png database path

    database path is the file path to the directory in which to create the database.

  • cerrcodeclst.png error in (no error)

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • ipath.png database URL out

    database URL out returns the computer name and the database name that specify where the Citadel database resides. The format is \\computer\database.

  • ibool.png created

    created returns TRUE if this VI created a new database and returns FALSE if this VI did not create a new database.

  • ierrcodeclst.png error out

    error out contains error information. This output provides standard error out functionality.

  • Create Database Details

    If the specified database name already exists at the specified database path, this VI does nothing. If detached Citadel database files exist at the specified database path, this VI attaches the Citadel database files to the database name. You might need to attach a database that was previously detached or a database that was manually copied to the specified database path. If a database with the specified database name already exists in a different directory or a database of a different name exists at the specified database path, this VI returns an error.

    Refer to the Measurement & Automation Explorer Help for Historical Data Viewer, available by selecting Help»Help Topics»Historical Data Viewer in Measurement & Automation Explorer, for more information about creating, attaching, and detaching Citadel databases.