HP XP P9000 Replication Manager Software 7.6.0-00 Application Agent CLI User Guide

Creating a user script
By specifying a user script when executing the backup command, you can simplify the backup operation
because the commands specified in the user script will execute during the backup operation.
You can enter the desired commands in a user script according to the coding rules for scripts. A user
script file is a file that contains user scripts.
Overview of user scripts
When you specify the -script option in the backup command, and then execute the backup
operation, commands specified in the user script can execute the following processing:
• User pre-processing before the backup command is issued (PRE_PROC)
• User post-processing after the backup command has been issued (POST_PROC)
•
User processing after pair resynchronization (RESYNC_PROC)
#
•
User processing after pair splitting (SPLIT_PROC)
#
•
User processing before the termination process (FINISH_PROC)
#
#
This processing is applicable only when you are backing up an SQL Server database.
The standard output and standard error output from the commands executed in the user script are
output to the Application Agent standard output log (drm_output.log).
Coding rules for user scripts
Coding rules for user scripts
The table below shows the coding rules for user scripts.
Table 70 Coding rules for user scripts
RulesApplicable items
• The character code set must be ASCII.
• Codes lower than 0x20 cannot be used, except for CR (0x0d), LF (0x0a),
and TAB (0x09).
• The linefeed code must be LF (0x0a) or CR+LF (0x0d and 0x0a).
• The length of a single line must not exceed 8 KB.
Overall user script
• Each line must contain only one item.
• Item and section names are not case-sensitive.
• Item and section names must consist of only one-byte characters. Two-byte
characters cannot be used.
• Item names must be separated by a one-byte equal sign (=). One-byte space
and tab characters can be inserted before and after equal signs.
Item and section names
Application Agent CLI User Guide 203