z/VM: CP Commands and Utilities Reference - z/VM - IBM

SET LOGMSG
SET LOGMSG
►►
Set
Authorization
Purpose
LOGmsg
Operands
Usage Notes
nn
NULL
text
Privilege Class: B
1278 z/VM: CP Commands and Utilities Reference
*
Use SET LOGMSG to:
v Set the log message line you specify to the text you enter on the command line.
v Delete a specified line from the log message.
v Delete the entire log message.
The SET LOGMSG setting is temporary and disappears with any reset other than a
warm start.
Note: If you enabled the file-based LOGMSG support using the FEATURES
statement in the system configuration file, you cannot use the SET LOGMSG
command to alter the log message. In this case, you need to edit log
message files on CP-accessed minidisks and notify CP of the changes using
the CPACCESS command.
nn is the line number in the log message you want changed. The variable nn is a
decimal number between 0 and 50.
* text
is the text that you want placed at line nn of the log message. If you want the
line automatically displayed on each user’s console during logon, you must
precede the text with an asterisk (*). The maximum number of bytes per line is
76, which includes blanks and the asterisk, if specified. In DBCS, if text is
longer than 76 bytes, CP truncates the text to 76 bytes, but the SO/SI pair will
be maintained. You can use mixed DBCS strings as message text. If line nn
already has text, it is replaced. Otherwise, the text is inserted for line nn.
NULL
indicates that the current text for line nn is deleted from the log message. If
NULL is not preceded by a line number, the entire log message is deleted.
1. CP only sends the response and redisplayed input lines to the terminal, not to
the virtual machine.
2. If you do not specify any operands after SET LOGMSG, the system prompts
you to enter a line of text. This line of text is inserted into the log message after
the last line that already has text. For example, if the highest line number in the
log message to have text is 37, the new line of text is inserted at line 38. If line
50 already has text defined, you receive an error message and the text is not
inserted.
►◄