The QUSRBRM.ADD_HISTORY_SYNC procedure allows you to add history syncing between systems.

Parameters

QUSRBRM.ADD_HISTORY_SYNC (SYSTEM_NAME=> system-name, ASP_NAME=> asp-name, CHANGE_SYSTEM_NAME=> change-system-name)

Note: All parameters are required.

system-name (required)

Specifies the system to sync backup history from.

Possible values are:

system-name

A valid system name.

Note: The system name format is nnnnnnnn.ssssssss where nnnnnnnn is the network identifier and ssssssss is the local location name.

asp-name (required)

Specifies the auxiliary storage pool device name to synchronize backup history from.

Possible values are:

asp-name	The auxiliary storage pool device name to synchronize backup history from.
*SYSBAS	Synchronize backup history from *SYSBAS backups. This is a system (1) or basic user (2-32) auxiliary storage pool.

change-system-name (required)

Specifies whether to change the system name on the synced history records to match the new system.

Possible values are:

NO	Keep the original system name on the synced history records.
YES	Change the system name on the synced history records to match the new system.

Examples:

To sync backup history from *SYSBAS on system APPN.SYSTEMB to the current system without changing the system name on the history records:

call QUSRBRM.ADD_HISTORY_SYNC(SYSTEM_NAME=>'APPN.SYSTEMB', ASP_NAME=>'*SYSBAS', CHANGE_SYSTEM_NAME=>'NO')

To sync backup history from *SYSBAS on system APPN.SYSTEMB to the current system and change the system name on the history records:

call QUSRBRM.ADD_HISTORY_SYNC(SYSTEM_NAME=>'APPN.SYSTEMB', ASP_NAME=>'*SYSBAS', CHANGE_SYSTEM_NAME=>'YES')

To sync backup history from ASP PRIMARY on system APPN.SYSTEMB to the current system and change the system name on the history records:

call QUSRBRM.ADD_HISTORY_SYNC(SYSTEM_NAME=>'APPN.SYSTEMB', ASP_NAME=>'PRIMARY', CHANGE_SYSTEM_NAME=>'YES')

Error Messages

The following SQL States and error messages may be returned by this procedure.

U0001	System name is not valid.
U0002	All parameters required when adding.
U0003	ASP Name not valid. Must be *SYSBAS or a valid ASP name.
U0004	Change System Name not valid. Must be YES or NO.
U0010	Error message returned by HSTUPDSYNC
U9999	Illegal execution.