|
|
|
|
|
The logFmt command displays and changes the parameters used to display messages and explanation texts, specifically the messages mnemonics and screen width.
Synopsis
logFmt [global] [display | interactive | {opt}={value}...]
Description
Each logging message has a class name and a mnemonic name associated with it. A class name, for example ADMIN001, is the combination of the name of the class, for example, ADMIN, and the index of the message within the class, for example, 001. The mnemonic name is a short composite string of characters that identifies the type of logging message. The mnemonic name for ADMIN001 is ADMIN_MSG. By default the mnemonic names of messages are not displayed when the display messages command is used to examine the logging files. If you want the mnemonic message names to appear, logFmt allows you to alter the system so that they either appear for everyone by default or appear for you specifically.
You can also adjust the width of the screen display. By default the screen width is set to 75 characters. If you have a wider screen, you may wish to specify that more of the screen be used to display messages.
The logFmt command line arguments are described in the following table:
Argument |
Description |
Comments |
global |
Modifier that causes the action specified to operate on the "global" (system wide) parameters that control the behavior of display message |
You must be root if you want to change the global parameters. You can examine the global parameters without being root. |
display |
Verb that causes logFmt to display the current parameters |
If global is specified, the system-wide parameters are displayed. Otherwise, your personal parameters are displayed. |
defaults |
Specifying defaults without the global option causes your personal preferences pertinent to mnemonics and screen width to be removed. You get the system-wide settings. Specifying defaults with the global option causes the system-wide settings to be reset so that mnemonics are off and the default screen width is 75 characters. |
— |
interactive |
Interactively prompts for the parameters controlled by logFmt |
Pressing Enter in response to any query causes the current value to be retained. The current value is displayed within square braces ( [ ] ). |
mnenonics=enable |
Causes mnemonics to be displayed when logging messages are examined with display messages |
— |
mnemonics=disable |
Causes mnemonics to not be displayed when logging messages are examined with display messages |
— |
width=NN |
Causes the screen width to be set, where NN is between 40 and 199 columns |
The default setting is 75. Do not attempt to set the screen width to a value wider than your screen can actually handle, or the display is unpleasant when using display messages. |
When mnemonics are enabled, they also show up when the explain command is used to examine the description of a message. Whether mnemonics are enabled or not, the mnemonic name can always be used to select an explanation using the explain command.
Files
/vs/data/logFmtParms – Global parameters file
${HOME}/.logFmtParms – User's parameter file
/usr/spool/log/textLogFmt – Current default expansion format file
/usr/spool/log/textLogFmt.Mne – Expansion file with mnemonics
/usr/spool/log/textLogFmt.NoM – Expansion file without mnemonics
Examples
The following example enables the mnemonics. This affects only you, and overrides the system-wide setting.
logFmt mnemonics=enable
The following example sets the system wide default so that mnemonics are not displayed. Any user wishing to see mnemonics must personally enable mnemonics. You must be root to execute this command.
logFmt global mnemonics=disable
The following example displays the system wide settings for mnemonics and screen width.
logFmt global display
The following example sets your personal screen width to 130 characters when displaying messages using display messages .
logFmt width=130
See also
