IBM Tivoli Storage Manager, Version 7.1

ISSUE MESSAGE (Issue a message from a server script)

Use this command with return code processing in a script to issue a message from a server script to determine where the problem is with a command in the script.

Privilege class

Any administrator can issue this command.

Syntax


>>-ISSUE MESSAGE--message_severity--message_text---------------><

Parameters

message_severity (Required)

Specifies the severity of the message. The message severity indicators are:

I: Information. ANR1496I is displayed in the message text.
W: Warning. ANR1497W is displayed in the message text.
E: Error. ANR1498E is displayed in the message text.
S: Severe. ANR1499S is displayed in the message text.

message_text (Required)

Specifies the description of the message.

Example: Issue a message from a server script

Assume you have a script called backupscript that quiesces a client's database, takes a backup of that database, and then restarts the client's database. For illustration, your script results in a non-zero return code. Use the ISSUE MESSAGE command with the message severity and message text. The following is an example of a server script that calls backupscript on the client machine and issues messages based on the return code from backupscript.

issue message i "Starting backup" 
define clientaction nodename action=command objects="c:\backupscript" wait=yes 
if (101) goto qfail 
if (102) goto qwarn
if (103) goto backupf 
if (104) goto restartf 
issue message i "Backup of database complete" 
exit 
qfail: issue message e "Quiesce of database failed"
exit 
qwarn: issue message w "Quiesce of database failed, taking fuzzy backup"

exit 
backupf: issue message e "Backup of database failed"
exit
restartf: issue message s "Database restart failed"
exit

Command: issue message e "quiesce of database failed"

Related commands

Table 1. Commands related to ISSUE MESSAGE
Command	Description
COPY SCRIPT	Creates a copy of a script.
DEFINE SCRIPT	Defines a script to the Tivoli Storage Manager server.
DELETE SCRIPT	Deletes the script or individual lines from the script.
RENAME SCRIPT	Renames a script to a new name.
RUN	Runs a script.
UPDATE SCRIPT	Changes or adds lines to a script.

Feedback