# Specifying Keywords With `keywords`

The test suite may provide keywords that you can use on the command line to restrict the set of tests to be run. Use the `keyword` command to specify the keywords used to filter the tests that are run.

> jtharness ... [initial-setup-commands] ... `-keywords` expression ... [task-command] ...

See About the Command-Line Examples for a description of the use of > jtharness in the following example.

See Command-Line Overview for a detailed description of the command line structure.

Refer to the test suite documentation for a list of supported keyword expressions and logical operators.

When creating a command string that specifies keywords, include the commands in the following sequence:

1. Include the commands required to set up a configuration.

> See Set-up Commands for a description of the commands.

2. Include the commands to specify keywords used (`keywords` expression).
3. (Optional) Include a task command (such as `runtests`).

> See Task Commands for the commands that you can include.

## Detailed Example of `keywords` Command

In the following example, myconfig`.jti` and myexcludelist`.jtx` represent file names that might exist on your system.

Command Options Format Example:

> jtharness `-config` myconfig`.jti` `-keywords interactive -runtests`

See Formatting a Command for descriptions and examples of other command formats that you can use.

Copyright © 2004, 2011, Oracle and/or its affiliates. All rights reserved.