A.0 The Script Library

A number of scripts are provided in the /OperationsCenter_install_path/database/scripts directory. Table A-1 describes the functions of these scripts. See Section 2.0, Creating and Debugging Scripts for information about customizing scripts or adding your own to the Script Library.

Table A-1 Default Scripts Provided in the Script Library

Script Name

Function

/commands/suppress.fs

Configures the Suppression/Acknowledgement command for an adapter. For details on this command, see Configuring Suppression and Acknowledgement in the Operations Center 5.5 Server Configuration Guide.

/commands/impactreport.fs

A starting point script example that requires configuration and customizing. Creates a new log category and logs a message for every alarm that impacts the selected service model and for each impacted element. Elements reported on can be filtered by specifying a class filter.

/examples/jfcexample.fs

Example of creating user interface scripts with JFC/Swing.

/examples/ticket.fs

Adds a command on the element operations menu to create a trouble ticket. See Section 11.2, Use Case: Gathering Information from the User for Script Invocation on a Server for details.

/jdbc/select.fs

Makes a simple connection and gets a list of tables in the database.

/mail/Action_MailElementAnd AlarmInformation.fs

Used in an automation action that e‑mails element and alarm information.

/mail/Action_MailElementInformation.fs

Used in an automation action that e‑mails element information.

/mail/mail.fs

Companion script supporting automation mail actions.

/mail/mailalarminfo.fs

Companion script supporting alarm information capture and mailing.

/mail/mailelement.fs

Companion script supporting element information capture and mailing.

/pager/Action_PageElement.fs

Used in an automation action to send element information via a paging gateway.

/servlets/dump.fs

Generates dynamic and static content for a Web browser.

/servlets/login.fs

Stores some of the login logic used to access Operations Center. Used with the dump.fs script.

/servlets/navigator.fs

Contains information used to navigate objects in the system. Used with the dump.fs script.

/tests/array.fs

Creates sample array.

/tests/createorgs.fs

Creates organizations dynamically while the Operations Center server is running.

/tests/elementfun.fs

Performs a number of element functions:

  • Simple comparison function for string values.

  • Simple function to write an element.

  • Get a simple element by traversal.

  • Get a complex element by chaining lookup.

  • Find an element.

  • Get a simple organization.

  • Perform some simple property lookups.

/tests/elementproperties.fs

Display element properties.

/tests/frame.fs

Creates a frame.

/tests/hello.fs

Adds the word “Hello” as an element menu command.

/tests/runtimeerror.fs

Creates sample run time error.

/tests/syntaxerror.fs

Creates sample syntax error.

/util/Action_PostAlarmToTec.fs

Used in an automation action to post alarm information to T/EC.

/util/Action_PostToTec.fs

Used in an automation action to post an event message to T/EC.

/util/adapters.fs

A utility to interactively query and manage Operations Center adapters.

/util/exportacls.fs

Exports the access manager to XML.

/util/f2fhelp.fs

Start/stop/status the named f2f adapter on the named server.

/util/fastmatch.fs

A utility to match a given named regular expression with cached compilation for repetitive matching.

/util/forceoff.fs

A utility to terminate Operations Center sessions for a user or group of users.

/util/formula.fs

Loads and logs in to Operations Center.

/util/image2go.fs

Imports an image file and converts it to the Operations Center GO format.

/util/importacls.fs

Imports the access manager to XML.

/util/login.fs

Starts the browser without showing the main user interface, and allows for command line interaction with the Operations Center server.

/util/orb.fs

Initializes the ORB.

/util/orgs.fs

Enables dynamic organization manipulation. Creates a new organization element within Operations Center, modifies an existing organization or deletes an organization.

/util/pause_op.fs

Executes a pop‑up a window in the browser which states YOU ARE IN PAUSE MODE after the Alarms view window has been in Pause mode for an amount of time that exceeds the preset period.

Put both the pause_op and pauseStop_op scripts into the operations store in Operations Center and insert them as client scripts against the Enterprise object. Refer to the comment block at the top of pause_op.fs for more information.

/util/pauseStop_op.fs

Removes the pause_op.fs objects and stops the alarm pause monitoring.

/util/showimpacted.fs

/util/syscheck.fs

Measures memory in Operations Center and outputs to the formula.trc file.

/util/syscheckstop.fs

Stops the syscheck function.

/util/testorgs.fs

Demonstrates how to use orgs.fs.

/util/urlhelp.fs

Obtains the contents of a given URL string, opens the stream and pulls data from it. Prints what was obtained from the stream and closes the stream.

/util/viewbuilderExporter.fs

Exports the organizations at and below the active element.

This script places the output into the /OperationsCenter_install_path/bin directory. The file name is viewbuilderout.xml. This script places a CSV output file also into the /OperationsCenter_install_path/bin directory as viewbuilderout.csv.

/util/wall.fs

A utility to send a message to a user or group of users from Operations Center.

/util/template/login.fs

Starts the browser without displaying the main user interface and allows for command line interaction with the Operations Center server.