System Administration Guide: Advanced Administration

Administering ttymon Port Monitors

Use the sacadm command to add, list, remove, kill, start, enable, disable, enable, and remove a ttymon port monitor.


Note –

You must be superuser to perform the following procedures.


How to Add a ttymon Port Monitor

To add a ttymon port monitor, type the following:


# sacadm -a -p mbmon -t ttymon -c /usr/lib/saf/ttymon -v `ttyadm
-V` -y "TTY Ports a & b"

-a

The add port monitor flag.

-p

Specifies the pmtag mbmon as the port monitor tag.

-t

Specifies the port monitor type as ttymon.

-c

Defines the command string used to start the port monitor.

-v

Specifies the version number of the port monitor.

-y

Defines a comment to describe this instance of the port monitor. 

How to View ttymon Port Monitor Status

To see the status of a ttymon port monitor, type the following:


# sacadm -l -p mbmon

-l

The list port monitor status flag.

-p

Specifies the pmtag mbmon as the port monitor tag.

Example—Viewing ttymon Port Monitor Status


# sacadm -l -p mbmon
PMTAG  PMTYPE  FLGS RCNT STATUS    COMMAND
mbmon  ttymon  -    0    STARTING  /usr/lib/saf/ttymon #TTY Ports a & b

PMTAG

mbmon

Identifies the port monitor name, mbmon.

PMTYPE

ttymon

Identifies the port monitor type, ttymon.

FLGS

-

Indicates whether the following two flags are set: 

d, do not enable the new port monitor, or

x, do not start the new port monitor. There are no flags set in this example.

RCNT

0

Indicates the return count value. A return count of 0 indicates that the port monitor is not to be restarted if it fails.

STATUS

STARTING

Indicates the current status of the port monitor. 

COMMAND

/usr/lib/saf ...

Identifies the command used to start the port monitor. 

#TTY Ports a & b

Identifies any comment used to describe the port monitor. 

How to Stop a ttymon Port Monitor

To kill a ttymon port monitor, type the following:


# sacadm -k -p mbmon

-k

The kill port monitor status flag.

-p

Specifies the pmtag mbmon as the port monitor tag.

How to Start a ttymon Port Monitor

To start a killed ttymon port monitor, type the following:


# sacadm -s -p mbmon

-s

The start port monitor status flag.

-p

Specifies the pmtag mbmon as the port monitor tag.

How to Disable a ttymon Port Monitor

Disabling a port monitor prevents new services from starting, without affecting existing services.

To disable a ttymon port monitor, type the following:


# sacadm -d -p mbmon

-d

The disable port monitor status flag.

-p

Specifies the pmtag mbmon as the port monitor tag.

How to Enable a ttymon Port Monitor

Enabling a ttymon port monitor allows it to service new requests.

To enable a ttymon port monitor, type the following:


# sacadm -e -p mbmon

-e

The enable port monitor status flag.

-p

Specifies the pmtag mbmon as the port monitor tag.

How to Remove a ttymon Port Monitor

To remove a ttymon port monitor, type the following:


# sacadm -r -p mbmon

-r

The remove port monitor status flag.

-p

Specifies the pmtag mbmon as the port monitor tag.


Note –

Removing a port monitor deletes all the configuration files associated with it. Port monitor configuration files cannot be updated or changed using sacadm. To reconfigure a port monitor, remove it and add a new one.