Reference Guide › Utilities › secons Utility › secons Utility—Manage CA ControlMinder Tracing

secons Utility—Manage CA ControlMinder Tracing

The secons utility manages CA ControlMinder tracing. Tracing lets you monitor operating system events. CA ControlMinder can accumulate a file of messages reporting operating system events that you can then display.

This command has the following format:

secons [-t+] [-t-] [-tt] [-ts] [-tc] [-tv [size] [-file fileName]]

secons -m message

secons -send heartbeat

secons -pupm trace {enable | disable | clear}

‑m message

Adds a text message to the trace file.

‑t+

Enables tracing, which causes the CA ControlMinder engine (seosd) to dump messages that specify its operations and actions to the trace file.

‑t‑

Disables tracing, which stops the CA ControlMinder engine seosd from dumping messages to the trace file.

‑tc

Clears the trace file, removing all records from it.

Note: You can use this option whether seosd is running.

‑ts

Displays the current tracing status.

‑tt

Toggles the tracing status.

‑tv [size] [-file fileName]

Displays a real-time trace output. The utility displays the last size KB (by default, 2 KB) of the trace file and keeps the session open so that any new trace messages added to the file are displayed. This is similar to the UNIX tail -f command.

Use Ctrl+C to stop this operation.

Note: You can use this option whether seosd is running. Use the full_year configuration setting to select whether you want to display the year in four digits (the default, yes) or two digits.

size

Specifies the size, in kilobytes, of the portion of the file you want to display, starting from the end. Specify 0 to show the entire trace file. If you do not specify this option, secons uses the default, 2 KB.

-file fileName

Reads fileName instead of ACInstallDir/log/seosd.trace.

-send heartbeat

Specifies to send a heartbeat to the CA ControlMinder Server immediately.

-pupm trace {enable | disable | clear}

Valid for the SAM Agent

Specifies tracing options on the SAM Agent during runtime. You do not need to restart CA ControlMinder to modify the trace options.

Limits: enable, enables tracing; disable, disables tracing; clear, clears the trace file.

Important! The trace options that you specify apply to the current session only. After CA ControlMinder restarts the trace option is set according to the OperationMode token in the PUPMAgent section.