dsstestlocation - DSS 6 | Data Source Solutions Documentation

Documentation: dsstestlocation - DSS 6 | Data Source Solutions Documentation

dsstestlocation

Usage

  • <b>dsstestlocation</b> [<b>-R</b><em>url</em>] [<b>-l</b><em>x</em>]... [<b>-v</b>] <em>hub</em> Test all or specific locations on hub.
  • <b>dsstestlocation</b> [<b>-R</b><em>url</em>] [<b>-l</b><em>x</em>]... [<b>-v</b>] <em>hub chn</em> Test all or specific locations in channel chn on hub.

Description

Command dsstestlocation tests the connection to a location.

Options

This section describes the options available for command dsstestlocation.

Parameter Description
-lx

Test locations specified by x. If this option is not supplied, then dsstestlocation will test all locations within the channel.

Values of x may be one of the following:

  • loc: Only location loc.
  • l1-l2: All locations that fall alphabetically between l1 and l2 inclusive.
  • !loc: All locations except loc.
  • !l1-l2: All locations except for those that fall alphabetically between l1 and l2 inclusive.

    Character '!' can be treated as a special (reserved) character in certain shells. Therefore, use single quotes (' ') or a backslash (\) when specifying the location(s) to be excluded. For example:

    dsstestlocation -l '!myloc' myhub

    dsstestlocation -l !myloc myhub

  • pattern: All locations matching the specified pattern. Pattern matching can be done using the special symbols *, ? or [characters], where '*' is any sequence of characters, '?' matches any character (exactly one), and '[]' matches a selection of characters. For example:

    • 'loc*' matches location names starting with 'loc'.
    • '*loc' matches location names ending with 'loc'.
    • 'loc?' matches location names 'loc1', 'loc2', 'loc3', but not 'loc12'.
    • 'a[c0-9]' matches location names with first letter 'a' and second letter 'c' or a digit.
    • 'a*|b*' Multiple patterns may be specified. In this case, the pattern matches location names starting with 'a' and 'b'.
  • @filename: All locations listed in filename (a .txt file containing location names, one per line).
Several -lx instructions can be supplied together to dsstestlocation.
-Rurl

Remote hub server. Access the hub server running on a remote machine, via the REST interface.

This option is required for remote CLI access. When using this option, command dsslogin should be run first, for authentication.

-v Display location properties discovered by DSS when it connects to a location.

Examples

This section provides examples of using the dsstestlocation command.

Example 1. Test specific locations

The following command tests all locations starting with src:

dsstestlocation -l 'src*' myhub
Example 2. Test locations from a file

The following command tests all locations listed in file mylocs.txt:

dsstestlocation -l @mylocs.txt myhub