Script Settings

Click Add New Script to create a new item in those listed at the top of this screen, or select and item and click the Edit icon to its right to alter it. When you create a new script, you must select either Embedded CLI or Perl. Embedded CLI scripts are command-line interface (CLI) interactions. See Perl Scripts for more about using Perl.

Clicking the Delete icon removes a selected item. Notice that the up/down buttons to the right of the list allow you to re-order selected items (they run from top first to bottom last).

See Attribute Appearance and Validation for a description of what constitutes a valid attribute.

Name -- Enter an identifier for the script you are creating or altering.

Target Filter -- Click the plus (+) to create a filter that describes the target for this script. For example, this filter could confine the action of the configured script to devices from a certain vendor, or only devices with an operating system version later than a certain number. Since you can have several scripts, those Adaptive CLIs with a single label (“Show Users,” for example) could therefore contain several scripts with syntax appropriate to a variety of devices and operating systems.

Adaptive CLI supports only filters that select the Managed Equipment type of device.

Attribute Delimiter -- The delimiter(s) you select from the pick list here surround the attributes you designate as mandatory. See Adaptive CLI Script Language Syntax for more about these.

Optional Attribute Delimiter -- The delimiter(s) you select from the pick list here surround the attributes you designate as optional. See Adaptive CLI Script Language Syntax for more about these.

All but Delete open a script editor with the following panels:

Script Content

Error Conditions

Continue Pattern

Attributes Extraction

Script Content

On the left, you can enter text, Search by clicking the magnifying glass, and use Cut, Copy, Paste, Undo, Jump to Line #, reformat. The Attributes appear under Target Params on the right of this text entry screen. Double-click an attribute to insert it unless you are writing a Perl script; this feature does not work for Perl. Right-click the previously-configured attributes in this panel to designate them as Mandatory, Optional, Not Applicable or Non Configuration in a context menu that appears when you right-click.

Open Manage Network Manager does not send Non Configuration attributes to the device with the script. These are comments that can serve to remind users of critical information. For example, you can make Non Configuration boolean attributes into a checklist for someone executing a script, and the history of this script can record whether Open Manage Network Manager made these checks when the script ran.

Notice that the Search also permits Regular expressions.

You can also enter two types of script language here. See Adaptive CLI Script Language Syntax for a description of the internal If capabilities. If you need more elaborate scripting, you can also use Perl scripts to send text to devices. See Perl Scripts for a description of those capabilities.

Error Conditions

The error condition lets you configure errors for your script.Check Continue on Error under the Global Condition Options, if you want the script to not stop when it encounters an error. Click Add new error conditions to configure a condition at the bottom of this screen with the following fields:

Error Pattern -- Enter a regular expression for the error.

Error Type -- Select from the pick list of options (Error, Warning, Ignore).

Line checking -- Select from the pick list (Unlimited, Disabled (Skip error condition), Specific number of lines). If you select a specific number of lines, enter the number of lines of the script output to check for the pattern specified, after each command execution. An error message is most likely to appear immediately right after the command is invoked.

Continue Pattern

Like Error Conditions, this screen lets you enter conditions to which script execution can respond. The Continue Pattern editor operates like the Error Conditions editor, but has slightly different fields.

Continue Pattern -- If you expect the device output of a script to prompt to continue, you may add a Continue Pattern with a regular expression to parse.

Answer -- This field specifies the Answer to the Continue Pattern prompt.

Send New Line -- For some devices, a single key response without a new line would be sufficient; in such cases, you may need to uncheck the Send New Line option.

Max Occurrences -- Indicates the maximum number of times respond to a prompt. The default value zero (0) indicates no limit.

Attributes Extraction

To support Adaptive Service and Active Monitor functions, Adaptive CLI provides a way for the user to define output schema attributes. This tab is active only if you have configured schema attributes to store values previously in the Attributes portion of this editor.

This lets you Add, Edit or Delete extracted attributes, like Error Conditions’s editor. To clarify configured Attributes, Parse Algorithms, and Parse Expressions accompany scripts, they appear in a table. Use the Add button to create more Value Extractions, and the Edit or Delete buttons to the right of listed patterns to alter or remove them.

Configure Value Extractions with the following fields:

Attribute Name -- This field specifies the name of the extracted attribute. To specify the output value of an attribute, select it from the provided list.

Attribute Type -- The data type of the attribute extracted. Only schema attributes of simple type String, Integer, Long, Float, Double, and Boolean are available to choose from.

Parse Algorithm -- Select from the pick list (Extract, Match). For match algorithm, the result is either true or false for the Boolean attribute type, 0 or 1 for numeric types, or “true” or “false” for String type.

Currently, Active Performance Monitor supports only numeric types.

Parse Expression -- Enter a regular expression for Parse Expression and the Parse Algorithm (Extract or Match) used when evaluating the device output on a given script execution.

See Regular Expressions for more information about what is these expressions can do.

Click Apply to accept your edits, or Cancel to abandon them. Click Add new attribute extraction to add more such patterns to your script.