set_log_type

The set_log_type command specifies the types of information that SNAplus2 records in log files on a particular server. This command can be used to override the default settings specified on set_global_log_type, or to remove the override so that this server reverts to using the default settings. For more information about log files, see “set_log_file”.

SNAplus2 always logs messages for problem events; you can specify whether to log messages for exception and audit events. For more information about logging messages, refer to the HP-UX SNAplus2 Diagnostics Guide.

Supplied Parameters

Parameter name      Type          Length      Default
[set_log_type]
override            constant                  YES
audit               constant                  LEAVE_UNCHANGED 
exception           constant                  LEAVE_UNCHANGED
succinct_audits     constant                  LEAVE_UNCHANGED
succinct_errors     constant                  LEAVE_UNCHANGED

Supplied parameters are:

override

Specifies whether to override the global log types specified on set_global_log_type or to revert to using global log types. Possible values are:

YES: Override the global log types. The log types to be used on this server are specified by the audit and exception parameters, and the choice of succinct or detailed logging is specified by the succinct_* parameters.
NO: Revert to using the global log types. The audit, exception, and succinct_* parameters are ignored.

audit

Specify whether to record audit messages. (SNAplus2 initially sets audit to NO.) Possible values are:

YES: Record audit messages.
NO: Do not record audit messages.
LEAVE_UNCHANGED: Leave audit logging unchanged from the existing definition.

exception

Specify whether to record exception messages. (SNAplus2 initially sets exception to YES.) Possible values are:

YES: Record exception messages.
NO: Do not record exception messages.
LEAVE_UNCHANGED: Leave exception logging unchanged from the existing definition.

succinct_audits

Specifies whether to use succinct logging or detailed logging in the audit log file on this server. Possible values are:

YES: Use succinct logging in the audit log file. Each message in the log file contains a summary of the message header information (such as the message number, log type, and system name), and the message text string and parameters. To obtain more details about the cause of the log and any action required, use the snaphelp utility.
NO: Use detailed logging in the audit log file. Each message in the log file includes a full listing of the message header information, the message text string and parameters, and additional information about the cause of the log and any action required.
LEAVE_UNCHANGED: Leave succinct logging or detailed logging unchanged from the existing definition.

If you are using central logging, the choice of succinct or detailed logging for messages from all computers is determined by the setting of this parameter on the server acting as the central logger. This setting can either be from the set_global_log_type command or from a set_log_type command issued to that server to override the default.

succinct_errors

Specifies whether to use succinct logging or detailed logging in the error log file on this server; this applies to both exception logs and problem logs. Possible values are:

YES: Use succinct logging in the error log file. Each message in the log file contains a summary of the message header information (such as the message number, log type, and system name), and the message text string and parameters. To obtain more details about the cause of the log and any action required, use the snaphelp utility.
NO: Use detailed logging in the error log file. Each message in the log file includes a full listing of the message header information, the message text string and parameters, and additional information about the cause of the log and any action required.
LEAVE_UNCHANGED: Leave succinct logging or detailed logging unchanged from the existing definition.

Returned Parameters

No parameters are returned by SNAplus2 when this command executes successfully.

Error Return Codes

If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.

Parameter Check

If the command does not execute because of a parameter error, SNAplus2 returns the following parameters:

primary_rc

PARAMETER_CHECK

secondary_rc

INVALID_SUCCINCT_SETTING: The succinct_audits or succinct_errors parameter was not set to a valid value.

State Check

No specific state errors, other than those listed in Appendix A “Common Return Codes from snapadmin Commands” occur for this command.

Other Conditions

Appendix A “Common Return Codes from snapadmin Commands” lists combinations of primary and secondary return codes that are common to all commands.