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