Introduction to the piconfig utility

The piconfig utility is a command-line administration tool for Data Archive. It provides simple and scriptable access to almost all Data Archive configuration tasks and underlying data tables. The piconfig utility is automatically installed on all Data Archive computers and PINS (PI Networking System) nodes.

Note: A PINS node is a PI client computer that does not run a Data Archive server. It can be an interface computer, a client computer, or a computer that runs the PI Management Subsystem.

You can run the piconfig utility in the following ways:

• Interactive: Enter commands one at a time at the command prompt.

• Batch: Input multiple commands by using a source file.

The following steps provide an overview of how you work with the piconfig utility.

1. Open a command window and enter the command:

   piconfig

2. The piconfig executable file is in the folder Program Files\PI\adm. You might want to include this folder in your PATH variable.

3. Access the table you want to work with by using the command:

   @tabl tablename

4. Use the ?tbl command to list available tables.

5. At any time, enter ? to see a list of available commands.

6. Set the required mode of operation by using the command:

   @mode mode

7. Available modes are: Create, Edit, List, Compare, Convert and Delete.

8. Perform required tasks. See piconfig examples, for examples of what you can do with the piconfig utility.

9. To switch to working on another table, use this command again:

   @tabl tablename

10. To end a piconfig session, use the command:

    @exit

11. It is not necessary to use the exit command when you run piconfig in batch mode.

    Note: piconfig commands begin with @ followed by four letters. Any additional letters are truncated when the command is parsed.