This document is designed to help you prevent inconsistencies within the directory synchronization system.
The functions covered are the upload, download and import of addresses to/from the central directory, the renaming of the transport service node name and the directory synchronization maintenance.
Provided is the online error message which may be displayed when one of the functions is invoked, the reason for the error message and how you can resolve the problem.
This document covers the following topics:
The following section describes the online error messages which may appear on your terminal when you invoke the Upload/Download functions. If the resulting log message, when online or in batch mode, differs from the online error message, that log message is also given.
- Log Message Online/Batch:
Run time error during execution
Error: nnnn: Name: Program-name on line: line-number
where nnnn is the error number, which can be 3055, 3017, 3061, or 3148
- Description/Cause:
If the LFILE parameter is not set or incorrect, the system writes a log message and stops the upload procedure.
The Upload/Download functions can be invoked online as well as in batch. During batch execution, the system will not try to set the central directory file assignment. Therefore, if the LFILE parameter is not correct, the batch utility is stopped and a message is displayed. When the Upload/Download functions are invoked online, the LFILE parameter is automatically set by the directory synchronization maintenance system.
- Solution:
Using the correct LFILE parameter, restart the upload/download procedure.
- Description/Cause:
The existence of your directory synchronization administration data, which is specified with the Directory Synchronization Maintenance function, is checked. If the administration data is not found, the system writes a log message and stops processing.
- Solution:
Install the directory synchronization. Then, create your Con-nect directory synchronization administration data with the Directory Synchronization Maintenance function and restart the Upload/Download function.
- Description/Cause:
The existence of your Con-nect node in the central directory is checked. If a record of your Con-nect node is not found, the system writes a log message and stops processing.
- Solution:
Your central directory administrator must add a record for your Con-nect node in the central directory.
- Description/Cause:
The Con-nect DBID and FNR you defined with the Directory Synchronization Maintenance function are compared against the values specified for your Con-nect node in the central directory. In the case of batch mode, your LFILE parameter currently used is compared.
If the settings do not match, the system writes a log message and stops processing.
This check is performed to insure that no two Con-nect nodes with the same name overwrite existing address records in the central directory. If a second node with the identical name and DBID/FNR starts an upload, it would overwrite existing address records with its own addresses.
- Solution:
Your central directory administrator must correct the DBID/FNR for your Con-nect node in the central directory, or you must change the name of your Con-nect node.
- Description/Cause:
It is checked whether or not your Con-nect node, as defined in the central directory, is permitted to upload/download addresses.
If your Con-nect node is not authorized to upload/download addresses, the system writes a log message and stops processing.
Additionally, the synchronization abilities, as defined in the central directory, for your Con-nect node is updated in your directory synchronization maintenance data. (You can display your synchronization abilities with the Directory Synchronization Maintenance function.)
- Solution:
Your central directory administrator must modify your Con-nect node's record in the central directory to upload (to use the Upload function), download (to use the Download function) or up/download (to use both the Upload and Download functions).
- Description/Cause:
It is checked whether your Con-nect node was renamed. If a previous transport service node name for your Con-nect node is still specified on the "Directory Synchronization Maintenance" screen, the system writes a log message and stops processing.
- Solution:
Using the Define Local Node function, rename your transport service node name.
The above error messages pertain only to the Upload function.
- Description/Cause:
The MRU Transaction Counter on your Con-nect node is compared against the value of the MRU Transaction Counter for your node's record in the central directory. If the value for both transaction counters is not equal, the system writes a log message and continues processing.
- Situation 1:
Either the MRU Transaction Counter on your Con-nect node or the counter in the central directory is blank. For example, this may occur when the Con-nect directory synchronization administration data is deleted and added again.
- Solution:
In this case, no online error message is displayed, since a total upload is automatically performed when the Upload function is started
- Situation 2:
On your Con-nect node the MRU Transaction Counter is less, but not blank, than the central directory's MRU Transaction Counter. For example, this may occur when an Adabas backup is restored on your Con-nect node.
- Solution:
Restart the Upload function on your Con-nect node.
- Situation 3:
Central directory's MRU Transaction Counter is less (but not blank) than your Con-nect's MRU Transaction Counter. For example, this may occur when a backup is restored to the central directory database.
This means that subsequent upload processes will use the (now smaller) Next Transaction ID and Alias from the central directory's administration data when new address records are uploaded. If this node uploads again, it will overwrite the address record with its own data, even though this transaction ID may already be in use for another Con-nect node.
To prevent this situation, the addressee names (with a status other than New) on the Con-nect node currently uploading and the address records in the central directory are compared. If an address is not found on the central directory, the status for the address on the Con-nect node is changed to CentDel.
If the initial upload of an address to the central directory results in a duplicate synchronization address, the synchronization address is incremented until a new one is found. This also sets the Next Alias in the central directory's Administration Data Maintenance function.
- Solution:
An upload from all participating Con-nect nodes is required to refresh the central directory.
This error message pertains only to the Upload function.
- Description/Cause:
The existence of the central directory administration data is checked.
If the central directory administration data does not exist, the system writes a log message and stops processing.
The name of the central directory administration record is taken from the entry on your Con-nect's "Directory Synchronization Maintenance" screen. A problem will occur if: the central directory administration record cannot be found, the record is not defined as Node Type Central, or the central directory name is not identical to that specified with the central directory's Administration Data Maintenance function.
- Solution:
Install the central directory or change the name defined as the central directory with the Directory Synchronization Maintenance function.
This error message pertains only to the Upload function.
- Description/Cause:
It is checked whether or not another Con-nect node is currently uploading addresses to the central directory.
If another Con-nect node is currently uploading addresses, the directory synchronization system writes the node name and current transaction counter to a log message and stops processing.
- Solution:
Try to restart the Upload function later or, if a Con-nect node is blocking the upload procedure, ask your central directory administrator to force the Con-nect node out of the Upload function.
If the execution of the Upload function is forced out by your central directory administrator while a Con-nect node is uploading, the Con-nect node will receive a response code and its process will stop. In that case, the interrupted process can be restarted later.
The above error message pertains only to the Upload function.
- Description/Cause:
Your Con-nect node's data defined in the central directory is placed on hold when it is read with the Upload function.
This situation can occur when multiple nodes start uploading simultaneously. In this case, the node's data remains on hold until either the node is entered as currently uploading in the central administration record, or the upload of the node's data is forced (while another node is still active).
If a response code is received because another node began uploading first, the system writes a log message and stops processing.
- Solution:
Try to restart the Upload function later or, if a Con-nect node is blocking the upload procedure, ask your central directory administrator to force the Con-nect node out of the Upload function.
This section describes solutions to problems you might encounter when renaming your transport service node name with the Define Local Node function.
This section covers the following topics:
New Transport Service Node Name: NODE1 Node Name currently used by the NODE0 Directory Synchronization: The Central Directory and the Node Name cannot be modified. Check your Directory Synchronization Installation. |
- Description/Cause:
It is checked whether the central directory is available, your Con-nect node is not registered in the central directory, or whether your Con-nect node has been defined a synchronization ability which does not allow modifications to the node name (e.g. Renamed). When one of the above situations occurs, the system stops processing and the screen above is displayed.
- Solution:
Contact your central directory administrator.
New Transport Service Node Name: NODE2 Node name currently used by the NODE1 Directory Synchronization but not in the Central Directory: Node Name last updated in the Central Directory: NODE0 The Central Directory and the Node Name cannot be modified. Check your Directory Synchronization Installation. |
- Description/Cause:
It is checked whether the previous modification terminated successfully.
If the last modification did not terminate successfully (e.g. the network was not available) and the network is currently not available, the system stops processing and displays the above screen.
- Solution:
Press PF3 to quit and perform the Define Local Node function when the network is available.
The previous update to the current Node Name is pending. A new Transport Service Node Name cannot be accepted until the current Node Name is updated. Perform the update. Node Name currently used by the Directory Synchronization but not in the Central Directory: NODE1 Node Name last updated in the Central Directory: NODE0 The update will modify 111 addresses in the Central Directory and 123 remote users. |
- Description/Cause:
The current transport service node name on your Con-nect node is compared against the node name defined in the central directory (i.e. did the last modification terminate successfully).
If the last modification did not terminate successfully, the system requires you to complete the last modification before you can continue. The system stops processing and displays the above screen.
- Solution:
Press PF5 to confirm the previous modification and then select the Define Local Node function again, to modify your transport service node name with the new node name.
- Description/Cause:
It is checked whether or not a directory synchronization data record exists for your local Con-nect node. If no record is available, the system writes a log message and stops processing.
- Solution:
Using the Directory Synchronization Maintenance function, define your directory synchronization administration data.
- Description/Cause:
It is checked whether or not a transport service node name is defined for your Con-nect node. If no node name is found, the system writes a log message and stops processing.
- Solution:
Using the Define Local Node Name function, define a transport service node name for your Con-nect node.
- Description/Cause:
It is checked whether the transport service node name (defined with the Define Local Node function) and the transport service node name defined in your directory synchronization administration data are identical. If they are not identical, the system stops processing and writes a log message.
- Solution:
Quit from the current screen. Contact your central directory administrator for your old transport service node name. Then, select the Directory Synchronization Maintenance function and press PF4 to erase the directory synchronization administration data. Enter Y to confirm the erasure in the resulting window. With the Define Local Node function, change your transport service node name to the node name you obtained from your central directory administrator. Then, redefine your directory synchronization administration data, using the node name you obtained from your central directory administrator. Once the above steps are completed, you can then rename your transport service node name with the new node name (using the Define Local Node function).
- Description/Cause:
The existence of your transport service node name is checked in the directory synchronization data record. If no node name is found, the system stops processing and writes a log message.
- Solution:
Using the Directory Synchronization Maintenance function, specify your transport service node name.
- Description/Cause:
The node name specified with the Define Local Node function is syntactically wrong.
- Solution:
Use only alphanumeric characters.
- Description/Cause:
It is checked whether or not your Con-nect's node name is defined in the central directory. If it is not defined in the central directory, or the central directory was not available (i.e. the network was down), the system stops processing and writes a log message.
- Solution:
Check whether the network is available. If it is available, ask your central directory administrator to add your Con-nect node to the central directory. Otherwise, wait until the network is available to rename your transport service node name.
- Description/Cause:
It is checked whether you have sufficient authorization to modify your transport service node name. In this case, the status of your node in the central directory does not allow modifications.
- Solution:
Contact your central directory administrator.
- Description/Cause:
It is checked that the modified node name will be unique within the central directory. If the node name already exists, the system stops processing and writes a log message.
- Solution:
Rename your transport service node name, using a different node name.
- Description/Cause:
The central directory was unable to provide the total number of addresses, from your Con-nect node, that are currently stored in the central directory. This indicates in the most of the cases that the network is not available.
- Solution:
Rename your transport service node name when the network is available.
- Description/Cause:
The modification of your transport service node name in the central directory was incomplete and the reference to your previous node name was lost (e.g. previous node name was erased from the central directory's administration data maintenance).
- Solution:
Contact your Software AG representative.
- Description/Cause:
Your directory synchronization administration data record cannot be read.
- Solution:
Try to rename your transport service node name later.
The following section describes the online error message which may appear on your terminal and a solution to the problem, when you invoke the Directory Synchronization Maintenance function.
- Description/Cause:
As a prerequisite, your transport service node name must be defined. When Con-nect is installed, your transport service node name is not automatically defined.
- Solution:
Use the Define Local Node function on the "Administration - External Mail Nodes" screen to define your Con-nect's transport service node name. Then, using the Directory Synchronization Maintenance function, redefine your directory synchronization maintenance data and press PF5 to save the data.
The following section describes the online error message which may appear on your terminal when you invoke the Import function, and a solution to the problem.
- Log Message Online:
Mail method of external node is not equal to original.
- Log Message Batch:
Mail method of external node is not equal to original Node: Node-name Alias: Directory-synchronization-alias CD-ID: Central-directory-name
The above log message is recorded only when the log level is 1, 2 or 3.
- Description/Cause:
The Import function adds external addresses to cabinet SYSCNT on your Con-nect node. If a suitable external node does not exist on your Con-nect, the address cannot be imported.
- Solution:
In the case of addressee types address, bulletin board, cabinet and name, an external node of type A (Con-nect) must be added. The name must be the same name of the originating Con-nect node.
In the case of addressee type external, an external node with the same node type and name as on the originating node must be added on your Con-nect node, using the Add Mail Node function. See Add a Mail Node.