Tivoli Header

Administrator's Reference

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:

E
Error. ANR1498E is displayed in the message text.

I
Information. ANR1496I is displayed in the message text.

S
Severe. ANR1499S is displayed in the message text.

W
Warning. ANR1497W is displayed in the message text

message_text (Required)
Specifies the description of the message.

Examples

Task

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. Below 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 148. 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.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]