Tivoli Header

Messages


Chapter 14. Tivoli Data Protection for IBM ESS for R/3 (IDS1000-IDS1999)

This chapter describes the messages issued by Tivoli Data Protection for IBM ESS for R/3. The messages begin with the prefix IDS and are listed in numerical order.

IDS1000EProfile not specified

Explanation: TDP for ESS cannot locate the profile.

User Response: Ensure that a profile is available. Note that the idscntl call must have the following form: <path>/idscntl -p <path>/init<SID>.fcs -f <function>....

IDS1001EFunction not defined

Explanation: An invalid argument has been specified for the -f option of TDP for ESS.

User Response: Ensure that you pass a valid function name with the option -f. Valid functions are: withdraw, flashcopy, password, unmount, and inquire.

IDS1004ESubfunction not defined.

Explanation: An invalid argument has been specified for the -s option of TDP for ESS. This option has been designed for internal idscntl use only and should not be used externally.

User Response: Do not use the -s option with the idscntl call.

IDS1005IStart of idscntl program at: time.

Explanation: TDP for ESS started at time.

User Response: None.

IDS1007IEnd of idscntl program at: time.

Explanation: TDP for ESS ended at time. Control will be returned to either the shell or to brbackup when idscntl was called by brbackup based on the entries split_cmd and resync_cmd in the brbackup profile (e.g., init<SID>.sap)

User Response: None.

IDS1008EParameter <keyword> in the profile file required.

Explanation: The parameter <keyword> in the profile for TDP for ESS could not be found. It must be defined.

User Response: Set the parameter <keyword> and its value in the profile for TDP for ESS.

IDS1009EDirectory path <path> for the IDS control file does not exist.

Explanation: Either the entry for the parameter IDS_CONTROL_FILE is incorrect or the path does not exist.

User Response: Ensure that the parameter IDS_CONTROL_FILE in the profile has a valid path. If the path does not exist, you must create it.

IDS1010EOption -i <backup_list> not specified.

Explanation: The function -f flashcopy requires the specification of the option -i <backup_list> too.

User Response: Ensure that you transfer the list of the files to back up when you call the function -f flashcopy. Note that the idscntl call must in this case have the following form: <path>/idscntl -p <path>/init<SID>.fcs -f flashcopy -i <backup_list> ... When the FlashCopy function runs under the control of the R/3 DBA tool brbackup by means of the split_cmd statement of the R/3 DBA profile, you must ensure that the correct syntax is used there (e.g. "... -i $"). brbackup replaces the "$" character with the name of the list file.

IDS1011EOption -f <function> not specified.

Explanation: idscntl always requires the option -f <function> with a valid function.

User Response: Ensure that the idscntl call has the following form: <path>/idscntl -p <path>/init<SID>.fcs -f <function>....

IDS1014I<subsystem message>

Explanation: TDP for ESS received an information message from the IDS subsystem.

User Response: None.

IDS1015W<subsystem message>

Explanation: TDP for ESS received a warning message from the IDS subsystem.

User Response: None.

IDS1016E<subsystem message>

Explanation: TDP for ESS received an error message from its IDS control part.

User Response: See the subsystem error messages for more information and perform required action.

IDS1016ENeither the primary nor the backup ESS server has been specified.

Explanation: Neither the SHARK_SERVERNAME_PRIMARY nor SHARK_SERVERNAME_BACKUP parameter has been specified in the TDP for ESS profile (init<SID>.fcs).

User Response: Ensure that the profile contains entries for SHARK_SERVERNAME_PRIMARY and SHARK_SERVERNAME_BACKUP and their values form a valid TCP/IP address.

IDS1016I(E)The ESS primary server is down or has an invalid address.

Explanation: The ESS primary server with the TCP/IP address specified in the parameter SHARK_SERVERNAME_PRIMARY is down or cannot be reached.

User Response: If this message appears as a information message, SHARK_SERVERNAME_BACKUP was specified and the connection will be made via its TCP/IP address. Otherwise, this message will appear as an error. Ensure that the profile contains entries for SHARK_SERVERNAME_PRIMARY and SHARK_SERVERNAME_BACKUP and their values form a valid TCP/IP address.

IDS1016EThere is a problem with both ESS copy services.

Explanation: Neither the connection to the ESS primary server nor the one to the ESS backup server is working properly.

User Response: Ensure that the profile contains entries for SHARK_SERVERNAME_PRIMARY and SHARK_SERVERNAME_BACKUP and their values form a valid TCP/IP address. Contact your ESS administrator.

IDS1024IExiting with return code <rc>.

Explanation: The idscntl program issues this message on terminating. The program returns the value 0, or nonzero if the execution of the called function failed.

User Response: If the called function has failed, check for previous error messages.

IDS1025ITime stamp: <current_time>

Explanation: TDP for ESS performs several tasks in sequence (e.g. initiate the FlashCopy of source volumes on the production system and mount file systems on the backup system). Tracking the various time stamps allows analyzing how long each task took.

User Response: None.

IDS1026IStart of idscntl on the production system ...

Explanation: TDP for ESS has issued a call to the production system and is waiting for the end of the execution.

User Response: None.

IDS1027Iidscntl ended on the production system successfully.

Explanation: TDP for ESS has ended the call to the production system successfully.

User Response: None.

IDS1030IFlashcopy started ...

Explanation: The command with the flashcopy function has been issued on the production system, and the program idscntl waits until this action has finished.

User Response: None.

IDS1031IFlashcopy successful.

Explanation: The command for the FlashCopy of the volume pairs has terminated successfully on the production system.

User Response: None.

IDS1032WInformation from TDP for R/3 was not found.

Explanation: The exchange data between TDP for ESS and TDP for R/3 was not found during the execution of the unmount function. Either the TDP for R/3 you have installed does not support TDP for ESS, or TDP for R/3 has failed after a successful FlashCopy and mount.

User Response: Check the run logs of brbackup. This error could have various reasons and should be resolved depending on the specific situation:

Case 1: brbackup has finished successfully.

Result: The backup on disk (FlashCopy target volumes) as well as the one done to the TSM server are valid. However, TDP for ESS cannot show the BACKUPID in its report when using the function inquire.

Reason for warning: It is very likely that TDP for R/3 (AIX version) does not have TDP for ESS support (prior to version 3.1.0.3).

Action: Install the appropriate TDP for R/3 version.

Case 2: brbackup has terminated abnormally.

Result: Check carefully the run log of brbackup for any BKI, ANS or ANR error messages. Most likely, the backup on disk (FlashCopy target volumes) is valid (check with 'idscntl -f inquire' whether PSI is PSI_MOUNT_DONE or PSI_UNMOUNT_DONE), but the backup to the TSM server is invalid.

Cause: Any problems with the network or on the TSM server caused TDP for R/3 running a backup to fail.

Action: Depending on the error message, eliminate the reason for not getting a successful backup to the TSM server.

IDS1033IInformation from TDP for R/3 has been found with BACKUPID <backupid>.

Explanation: The exchange data between TDP for R/3 and TDP for ESS has been found during the execution of the function unmount. The backup on disk (FlashCopy target volumes) as well as to the TSM server are valid. The list of files has been saved in the Tivoli Storage Manager with the BackupID <backupid>.

User Response: None.

IDS1034EEntry <field_name> in the current backup cycle of the IDS control file is missing.

Explanation: The field with the name <field_name> in the current backup cycle was unexpectedly empty.

User Response: Please check for other errors prior to this one.

IDS1035IThe IDS control file exists and a new backup cycle entry has been created.

Explanation: At the start of the function -f flashcopy, TDP for ESS inserts a record in the IDS control file for the new backup cycle. This record will be updated as the status of the new backup cycle changes (e.g. FlashCopy target volumes/filesystems being mounted or unmounted).

User Response: None.

IDS1038IThe IDS control file <ids_control_file> does not exist. It will be created.

Explanation: TDP for ESS will write the first record to the IDS control file specified in the entry IDS_CONTROL_FILE of the profile.

User Response: None.

IDS1039EThe IDS control file has no entry.

Explanation: TDP for ESS has found the IDS control file, but it has no records. This error occurs when you start one of the functions inquire, withdraw or unmount before you have run the flashcopy function for the first time.

User Response: After you run at least one brbackup with a successful flashcopy, the problem will be resolved.

IDS1040EThe IDS control file must be read or inserted before update.

Explanation: TDP for ESS has detected a logical error when processing the IDS control file.

User Response: Contact Tivoli Data Protection for R/3 support.

IDS1042WInfo data from TDP for R/3 /tmp/bki<SID>.ids cannot be read.

Explanation: Before the unmount process, TDP for ESS will read /tmp/bki<SID>.ids, which contains information about the backup that was done by TDP for R/3. Among the information read is:

This message will be issued if TDP for R/3 terminated unsuccessfully for some reason.

User Response: Ensure that TDP for R/3 runs successfully.

IDS1043IThe maximum number of backup cycles in the IDS control file has been reached.

Explanation: The maximum number of backups controlled via the parameter BACKUP_MAX will be exceeded with the new inserted record. If the parameter is not set, the program will use the default value of 30.

User Response: None.

IDS1044IDelete backup cycle with BSEQ_N = <bseq_n> and all associated files ...

Explanation: Since the maximum number of records has been reached, the program will delete the oldest record with the backup sequence number <bseq_n>. In addition, the oldest reports and traces associated with that backup cycle will be deleted.

User Response: None.

IDS1045WDirectory path <directory> for the report files does not exist. Using the current directory.

Explanation: The directory entry of the parameter LOG_TRACE_DIR in the profile could not be found. The current directory will be used for the log and trace files.

User Response: In order to avoid directories cluttered with reports and traces, the parameter LOG_TRACE_DIR should be used, or the directory it specifies must be created if necessary.

IDS1046IStart of listing of importing volume groups/mounting file systems ...

Explanation: After initiating the FlashCopy source/target volumes on the production system, TDP for ESS will make the corresponding target volumes available to the backup host. A list of mount points or volume groups will be shown.

User Response: None.

IDS1047IEnd of listing.

Explanation: Corresponds to start message IDS1046I.

User Response: None.

IDS1048IThe unmount process will be skipped because the progress status indicator (PSI) has a value of 'psi'.

Explanation: When the 'withdraw' function is started, the unmount process will be performed only if the PSI has a value of PSI_MOUNT_STARTED or PSI_MOUNT_DONE.

User Response: Tivoli Data Protection for IBM ESS for R/3: Installation and User's Guide shows the permissible functions depending on the backup progress status indicator.

IDS1050EThe version of the idscntl program must be the same on the backup and production systems.

Explanation: The version of TDP for ESS on the production system is different from the version on the backup system.

User Response: Ensure that you install the same version of TDP for ESS on the production and backup systems. You get the version number when you start idscntl without parameters.

IDS1051IEnter the password for the user <user ID>

Explanation: The password for the user ID <user ID> has to be entered. It will be encoded and stored in a file specified in the parameter CONFIG_FILE. Note that this user ID and password have to be the same on the production and backup systems. The TDP for ESS program idscntl uses the user ID to execute a remote shell on the production system.

User Response: Enter the password for the corresponding user ID.

IDS1052IEnter the password for the user <user ID> again

Explanation: In order to avoid typing errors, you have to enter the password twice.

User Response: Enter the password again.

IDS1053IThe password entry does not match, please try again

Explanation: The two entered passwords are not identical. You must enter the password again.

User Response: Enter the password again. You are permitted three attempts before the program terminates.

IDS1054ENo password stored.

Explanation: The two entered passwords are not identical. You have tried three times, and the passwords were different in each case.

User Response: You must start the idscntl program with the function -f password again. If no password is stored, or it is invalid, idscntl fails when the flashcopy function is used.

IDS1055EThe config file named <config_file> could not be opened. Please call idscntl with the password function to create that file.

Explanation: TDP for ESS is unable to read the configuration file <config_file>.

User Response: This error could have various reasons. Try the following:

1. Call idscntl with the 'password' function to create the file.

2. Check the path of the configuration file. The path must be specified in the profile (parameter CONFIG_FILE).

3. Make sure that the file access permissions are set correctly.

IDS1060IStart of listing of exporting volume groups/unmounting file systems ...

Explanation: A list of unmount points or exporting disk groups will be shown. Due to the usage of the unmount function on the backup host,TDP for ESS will unmount the file systems and export volume groups on the backup host that had been imported or mounted when the TDP for ESS flashcopy function was executed.

User Response: None.

IDS1061IStart the withdraw of the target-source pairs ...

Explanation: The command with a withdraw has been issued from the backup system to the primary Copy Services server on the ESS.

User Response: None.

IDS1062IThe progress status indicator (PSI) is already PSI_UNMOUNT_DONE.

Explanation: TDP for ESS has been called with the function withdraw or unmount, but the PSI value of the latest backup cycle was already updated to PSI_UNMOUNT_DONE in a previous idscntl call.

User Response: None.

IDS1063EParameters LOGON_HOST_PROD/ LOGON_HOST_BACK in profile wrong or missing.

Explanation: Either TDP for ESS is unable to read one of the parameters LOGON_HOST_PROD/ LOGON_HOST_BACK from the profile, or the parameter values are incorrect. Note that these parameters must have the following format:

LOGON_HOST_PROD <hostname> <TCP/IP address> <user ID>

LOGON_HOST_BACK <hostname>

The hostnames must match the respective hostnames of the production and backup systems. TCP/IP address will be used for the communication between the two systems. The user ID specified must match the oracle DBA user ID ('ora<sid>').

User Response: Ensure that the profile contains valid entries for LOGON_HOST_PROD and LOGON_HOST_BACK.

IDS1064EThe parameter <keyword> in the profile is not known.

Explanation: An unknown parameter <keyword> has been found in the profile.

User Response: Check the specified parameter in the profile and try again.

IDS1065EYou cannot run the function 'function' if the progress status indicator (PSI) has a value of 'psi'.

Explanation: The backup cycle was left in a state that does not allow TDP for ESS to start the specified function.

User Response: Tivoli Data Protection for IBM ESS for R/3: Installation and User's Guide shows the permissible functions depending on the backup progress status indicator.

IDS1066EThe option -f flashcopy can only be used on the backup system.

Explanation: You cannot start the flashcopy function on the production system.

User Response: Make sure you start idscntl with the function -f flashcopy on the backup system only. Ensure that the profile contains a valid entry for LOGON_HOST_BACK.

IDS1067EThe options -f flashcopy -s performsplit can only be used on the production system.

Explanation: The option -s was designed for internal idscntl use only and should not be used externally.

User Response: Make sure you issue idscntl -f flashcopy on the backup system only. Ensure that the profile contains valid entries for LOGON_HOST_PROD and LOGON_HOST_BACK. Do not use the -s option with the idscntl call.

IDS1068EThe option -f withdraw can only be used on the backup system.

Explanation: You cannot start the function withdraw on the production system.

User Response: Make sure you start idscntl with the function -f withdraw on the backup system only. Ensure that the profile contains a valid entry for LOGON_HOST_BACK.

IDS1069EThe option -f unmount can only be used on the backup system.

Explanation: You cannot start the function unmount on the production system.

User Response: Make sure you start idscntl with the function -f unmount on the backup system only. Ensure that the profile contains a valid entry for LOGON_HOST_BACK.

IDS1071ETopic named <topicname> could not be found in the file <filename>.

Explanation: TDP for ESS could read the file <filename> but the expected entry for the topic <topicname> was not found.

User Response: When the affected file is the field value of the parameter SHARK_VOLUMES_FILE, you need to check whether the topic name has the format: >>> shark_volumes_set_# where # is a placeholder for the volume set number (1, 2, ..)

When the affected file is another file, you likely have another error prior this one. Otherwise, contact Tivoli Data Protection for R/3 support.

IDS1073ENo target volumes were specified for the set <shark_volumes_set_#> in file <filename>.

Explanation: TDP for ESS has read file <filename> contained in the parameter SHARK_VOLUMES_FILE. The format of the file is correct, but the list of target volumes is missing.

User Response: See the description of the FlashCopy target volumes file in Tivoli Data Protection for IBM ESS for R/3: Installation and User's Guide.

IDS1075ICreating a semaphore for the critical part of importing/exporting ...

Explanation: When multiple production systems run a backup via a single backup system at the same time, TDP for ESS will ensure that the critical parts of the code run for a single instance of the program at a time. These phases are:

  1. when the FlashCopy has been done and resources (volume groups and file systems) are being enabled
  2. before the FlashCopy relationship is withdrawn and resources (volume groups and file systems) are being disabled.

For this synchronization process, a semaphore with the fixed key 0x88886666 will be created.

User Response: None

IDS1076ITrying to set the semaphore for the critical part of importing/exporting ...

Explanation: If the TDP for ESS semaphore is already allocated, the program will wait until it is released. Otherwise, the program will set it and pass into the critical part of the run. Another instance arriving at this point will now have to wait for the release of the semaphore.

User Response: None

IDS1077ISemaphore released.

Explanation: After the program has passed the critical part of the run, the semaphore is released.

User Response: None

IDS1078WThe semaphore could not be created. System error <sys_errno>: <sys_message>.

Explanation: If TDP for ESS could not create the semaphore, the system error number and message will be issued as a warning. The concurrent run of multiple production systems with a single backup system will not work properly.

User Response: Check the system error number and message with your system administrator.

IDS1079WThe semaphore could not be initialized. System error <sys_errno>: <sys_message>.

Explanation: If TDP for ESS could not initialize the semaphore, the system error number and message will be issued as a warning. The concurrent run of multiple production systems with a single backup system will not work properly.

User Response: Check the system error number and message with your system administrator.

IDS1080WThe semaphore could not be allocated. System error <sys_errno>: <sys_message>.

Explanation: If TDP for ESS could not allocate the semaphore, the system error number and message will be issued as a warning. The concurrent run of multiple production systems with a single backup system will not work properly.

User Response: Check the system error number and message with your system administrator.

IDS1081WThe semaphore could not be released. System error <sys_error>: <sys_message>.

Explanation: If TDP for ESS could not allocate the semaphore, the system error number and message will be issued as a warning. The concurrent run of multiple production systems with a single backup system will not work properly.

User Response: Check the system error number and message with your system administrator.

IDS1082EDuplicate target volume 'serial number' was found in the target list.

Explanation: TDP for ESS found a duplicate serial number for an ESS target volume in the file specified in the SHARK_VOLUMES_FILE parameter.

User Response: Ensure that the serial numbers of the target volumes in the file SHARK_VOLUMES_FILE are unique .

IDS1300ECannot read file: <filename>.

Explanation: TDP for ESS is unable to read the data file <filename>. The affected files could be e.g.:

User Response: Check the access permissions of the affected file and try again.

IDS1301ECannot write file: <filename>.

Explanation: TDP for ESS is unable to write to the data file filename. The affected files could be e.g.:

User Response: Check the access permissions of the affected file and try again.

IDS1302EThe environment variable <env_var> must be set.

Explanation: The environment variable <env_var> is required. The following environment variables must be set when running TDP for ESS:
ORACLE_HOME: to the home directory of the user ID
ORACLE_SID: to the R/3 Oracle DB system ID

User Response: Set the missing environment variable and try again.

IDS1303EThe environment variable <env_var> is not correct.

Explanation: This error can occur when the environment variable is set but contains a non-existent directory path.

User Response: Check the value of the environment variable and try again.

IDS1304EFile not found or not accessible: <filename>.

Explanation: The file <filename> was not found or is not accessible to TDP for ESS. The affected files could be: <ORACLE_HOME>/dbs/init<SID>.fcs or the argument value of the option -i (that file contains the list of files to back up).

User Response: Check path, name and the permissions of the file and try again.

IDS1305EThe effective user ID of the process could not be set to the user <userid>.

Explanation: One of the following cases can cause this error:

User Response:

IDS1306EOperating system error <error_no>: <message text>.

Explanation: TDP for ESS encountered an unexpected message error during the execution of a system function. The respective operating system error and message text will be displayed. The message will appear, for example, as a result of

User Response: Check the specific error message.

IDS1452EThis version of Tivoli Data Protection for IBM ESS for R/3 has expired.

Explanation: This is a test version that has expired.

User Response: Order a release version of Tivoli Data Protection for IBM ESS for R/3 or contact your IBM/Tivoli sales representative.

IDS1453WThis version of Tivoli Data Protection for IBM ESS for R/3 will expire in 'number' days.

Explanation: This is a test version with a time limit. It will expire in 'number' days.

User Response: Order a release version of Tivoli Data Protection for IBM ESS for R/3 or contact your IBM/Tivoli sales representative before the version expires.

IDS1454I*** This copy is NOT FOR RESALE. ***

Explanation: This version is not for resale.

User Response: None.

IDS1455ELicense file 'filename' does not exist.

Explanation: The license file 'agentess.lic' was not found where expected.

User Response: Make sure that the 'agentess.lic' file resides in the same directory as the init<SID>.fcs profile.

IDS1456EUnable to access license file 'file name'.

Explanation: Unable to access license file.

User Response: Make sure the access permissions allow read/write access.

IDS1457ELicense file 'file name' contains invalid data/checksum.

Explanation: The license file is invalid.

User Response: Make sure you have the right agentess.lic file installed.


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