COSCMD Command

Note: As of version 6.1.00, this command uses a predefined prefix in place of the original "COS" prefix. For more information about these prefixes, see Supporting Multiple Control-O/COSMOS Instances.

This command triggers the COSCMD rule, which changes the information in an Object database according to specified parameters.

The syntax for this command is:

COSCMD cmd dbname select-criteria

where

COS is the special command prefix defined during Control-O installation.
cmd
Action to be performed. Valid values are:

BOUNCE	Set desired status of specified objects to DOWN. When the current status becomes DOWN, set desired status to UP.
CURRDOWN	Set current status of specified objects to DOWN.
CURRUNKN	Set current status of specified objects to UNKNOWN.
CURRUP	Set current status of specified objects to UP.
DEBUGN	Set debug mode to N (No) for the specified objects.
DEBUGY	Set debug mode to Y (Yes) for the specified objects.
DESIDOWN	Set desired status of specified objects to DOWN.
DESIUP	Set desired status of specified objects to UP.
DISPALL	Display detailed information about specified objects. Multiple lines are used to describe each object.
DISPLAY	Display information about specified objects. One line of information is displayed for each object. Default.
MODEF	Set mode of specified objects to FREE.
MODEH	Set mode of specified objects to HELD.
MODEN	Set mode of specified objects to NOPRE.
MODEO	Set mode of specified objects to FORCE_OK.

dbname
Name of the database containing objects on which the command is to be performed. Optional. Valid values are:

name	Name a specific Object database.
ALL	Perform the requested action on objects described in all Object databases. Default.

select-criteria
Selection criteria that determine the objects to be processed by the command. Optional. Valid values are:

fieldname val	Where fieldname is the name of a column in the Object database, and val is a value that appears in that column. Mask characters cannot be specified in this field.
EXCEPTION	Indicates that the command is to process all objects whose current and desired statuses do not match.

A maximum of two selection criteria can be specified. If a value of EXCEPTION is specified, no other selection criteria can be specified.

If more than one selection criterion is specified, the selection criteria have an AND relationship.

If no selection criteria are specified, the requested action is performed on all objects defined in the specified database.

Examples

COSCMD

Display information about all objects that are controlled by Control-O/COSMOS, describing one object per line.

COSCMD DISPLAY ALL EXCEPTION

Display one line of information about each object that is controlled by Control-O/COSMOS, whose current and desired statuses do not match.

COSCMD DISPALL COSSTCOB OBJECT JES2

Display all information (that is, multiple lines) about objects in the COSSTCOB Object database that have a value of JES2 in the OBJECT column.

COSCMD DISPALL COSSTCOB GROUP MYGROUP APPL MYAPPL

Display all information (that is, multiple lines) about objects in the COSSTCOB Object database that have a value of MYGROUP in the GROUP column, and a value of MYAPPL in the APPL column.

Parent Topic

Control-O/COSMOS Commands