Reference Guide › Utilities › secons Utility › secons Utility—Manage CA Access Control Tracing

secons Utility—Manage CA Access Control Tracing

The secons utility manages CA Access Control tracing. Tracing lets you monitor operating system events. CA Access Control 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 -pupm trace {enable | disable | clear}

‑m message

Adds a text message to the trace file.

‑t+

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

‑t‑

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

‑tc

Clears the trace file, removing all records from the it.

Note: You can use this option whether or not 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 or not 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.

-pupm trace {enable | disable | clear}

Valid for the PUPM Agent

Specifies tracing options on the PUPM Agent during runtime. You do not need to restart CA Access Control to modify the trace options.

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

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