In order to download addresses from the central directory, you must create a profile for each node in your network from which you want to obtain information. By creating a profile, you can delimit the addressee types you wish to download, how the addresses are downloaded, the security levels which will apply for the addresses and where the addresses will be stored when they are imported to your Con-nect node.
This document covers the following topics:
When you select the Directory Synchronization Maintenance function, the screen below is displayed.
5:40 PM * * * C O N - N E C T 3 * * * 14.Feb.94
Cabinet LS Directory Synchronization Maintenance OLAP
Select a Function: _ Directory Synchronization Maintenance
_ De-Install Directory Synchronization
_ Add Profiles
_ Maintain Profiles
_ Maintain Log Information
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Quit DMain DeIns AProf MProf MLog
Mark item(s) from the list above or press a PF-key
|
You select the function you want with any character and press ENTER to access that function.
This section covers the following topics:
Information which is required to maintain your directory synchronization is partially provided automatically and partially provided by you. It is very important that you ensure that the information pertaining to the central directory is correct. If not, any attempt to upload and/or download will result in an error message.
5:41 PM * * * C O N - N E C T 3 * * * 14.Feb.94
Cabinet LS Directory Synchronization Maintenance OLAP07
Central Directory Name: DAEFCOC_
Central Directory DBID: 180 Central Directory FNR: 12_
Transport Service Node Name: CEDARRP Mod. TS Node Name:
CON-NECT DBID: 180 CON-NECT FNR: 30
Synchronization Abilities: B up/download Version: 1.1
Log Level: 3 Transaction Limit: 50__
Set Addresses for Upload: AUTO Addr. _ Bull. _ Cab. _ Ext. _ Name _
MRU Transaction Counter: 000000000000000000000056591
MRD Transaction Counter: 000000000000000000000056600
Date Last Uploaded: 19940209 Date Last Downloaded: 19940209
Time: 15:51:24.5 Time: 16:14:48.7
Date Modified: 19940209 Time Modified: 16:14 Author ID: LS
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Quit Erase Save RsMRU RsMRD Cancl
Make the required changes and press a PF-key
|
- Central Directory Name
Name of the central directory.
Do not modify this field unless your central directory administrator has informed you that the name has been changed. Additionally, this field is not used to switch to another central directory.
If you modify the central directory name on this screen, a confirmation window is displayed and you are informed that the uploaded and imported addresses stored in cabinet SYSCNT will be modified. Enter Y and press ENTER to confirm, or press ENTER to cancel the modification.
- Central Directory DBID
Database ID of central directory. This field along with the Central Directory FNR field defines the LFILE parameter used by the central directory. The LFILE parameter is assigned when you press PF3 or PF5 and when the upload and download functions are started with the administration programs.
Do not modify this field unless your central directory administrator informs you that it has been modified.
The value you specify here is not verified until you perform an upload or download. If the DBID is not correct, a Con-nect error message is displayed. Therefore, it is important to ensure that you specify the correct DBID.
- Central Directory FNR
File number of central directory. This field along with the Central Directory DBID field defines the LFILE parameter used by the central directory. The LFILE parameter is assigned when you press PF3 or PF5 and when the upload and download functions are started with the administration programs.
Do not modify this field unless your central directory administrator informs you that it has been modified.
The value you specify here is not verified until you perform an upload or download. If the FNR is not correct, Con-nect error message is displayed. Therefore, it is important to ensure that you specify the correct FNR.
- Transport Service Node Name
Automatically provided. Name of your local transport service node.
- Mod. TS Node Name
Automatically provided when you rename your transport service node with the Define Local Node function. See Transport Service Node ID.
Previous transport service node name, which is displayed until all addresses defined to the transport service are modified on the central directory. The modification process can take some time. If, however, the previous node name remains for more than a couple of hours, see Define Local Node Function - Rename Transport Service Node Name.
- Con-nect DBID
Automatically provided. Database ID of your local Con-nect node.
- Con-nect FNR
Automatically provided. File number of your local Con-nect node.
Note:
The values in fields Con-nect DBID and Con-nect FNR are verified with the information stored in the central directory each time you perform an upload or download.- Synchronization Abilities
Automatically provided via the Central Directory Maintenance function (maintained by your central directory administrator). Indicates how your Con-nect node interacts with the central directory. See Central Directory.
U Permitted to upload local addresses to central directory. D Permitted to download addresses from the central directory. B Permitted to upload and download addresses to/from the central directory. - Version
Automatically provided. Version of the directory synchronization programs used on your Con-nect node to upload and/or download addresses.
- Log Level
Designates the type of event that will cause a record to be written to the log file. The values used are:
0 Default. Log significant events (e.g. uploads, downloads) which occur. 1 Log events that are traced by the system. It is recommended that log level one should only be used when additional information is required. 2 Log all programs that are traced. It is recommended that log level two should only be used when additional information is required. 3 Log all events that occur. It is recommended that log level three should only be used when additional information is required. - Transaction Limit
The value is used by the upload and download processes to determine the number of addresses which are read before an end of transaction is performed.
- Set Addresses for Upload
Determines whether new addresses in your SYSCNT cabinet will be automatically (Auto) or manually (Manl) set for upload to the central directory. Default - Auto. You mark the addressee type(s) you want to adhere to this rule.
Standalone cabinets must always be uploaded manually.
For example, if you have specified automatic upload for addressee type Cabinet and you add a shared cabinet, the next time you perform the Upload Addresses function, this cabinet will be automatically uploaded to the central directory. You need not manually set it for upload.
If you display the shared cabinet with the Upload Address Maintenance function before performing an upload, the status of the cabinet will be blank, even though it has been automatically set for the next upload.
- MRU Transaction Counter
Automatically incremented with each upload. Last transaction number assigned to local address during upload procedure to the central directory. The number displayed here is also recorded in the central directory. It is also used to verify that the central directory and your local node are synchronized.
You can reset this field to 0 with PF6. See Reset Upload Transaction Counter.
- MRD Transaction Counter
Automatically incremented. Transaction number assigned to last address downloaded from the central directory. The number displayed here is also recorded in the central directory. It is also used to verify that the central directory and your local node are synchronized.
You can reset this field to 0 with PF7. See Reset Download Transaction Counter.
- Date Last Uploaded
Date last upload occurred.
- Time Last Uploaded
Time last upload occurred.
- Date Last Downloaded
Date last download occurred.
- Time Last Downloaded
Time last download occurred.
- Date Modified
Date of last modification.
- Time Modified
Time of last modification.
- Author ID
Identifies user who made last modifications.
To save your modifications, press PF5. If you have modified the central directory name on your Con-nect node, a confirmation window is displayed. It shows the number of addresses in your SYSCNT cabinet that will be modified if you confirm the modification. To confirm the modification, enter Y, or press ENTER to cancel the modification.
You can press PF4 to de-install the directory synchronization. As a result, a confirmation window is displayed. Enter Y and press ENTER to de-install, or press ENTER to cancel. In contrast to the De-Install Directory Synchronization function, only the maintenance data displayed on this screen is deleted. The synchronization profiles, downloaded records and cabinets uploaded to the central directory are not deleted. See De-Install Directory Synchronization.
You can reset the upload transaction counter to zero to force a total upload to the central directory. To reset the transaction counter, press PF6 and with the next upload, the system will perform a total upload.
You can reset the download transaction counter to zero to force a total download from the central directory. To reset the transaction counter, press PF7 and with the next download, the system will perform a total download.
When you select the De-Install Directory Synchronization function, the resulting window displays the total number of synchronization profiles, downloaded addresses and maintenance data (defined with the Directory Synchronization Maintenance function) stored on your Con-nect node that will be deleted when the directory synchronization is de-installed. It also displays the total number of addresses you have imported to your Con-nect node. The imported addresses will not be deleted from your node, however, they will be unlinked from the central directory. This means that any modifications made to the addresses on the central directory will not be updated on your Con-nect node.
If you want to delete only the maintenance data, see Directory Synchronization Maintenance.
5:44 PM * * * C O N - N E C T 3 * * * 14.Feb.94
Cabinet LS Directory Synchronization Maintenance OLAP70
Select a Function: _ Directory Synchronization Maintenance
+------------------------------------------+
! The Directory Synchronization will ! ion
! be de-installed! !
! !
! 80 Synchronization Objects !
! will be deleted. !
! 97 Synchronization Addresses !
! will be unlinked. !
! Imported Addresses are not deleted. !
! !
! Enter Y to confirm: N !
! !
! Press ENTER to continue !
+------------------------------------------+
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Quit DMain DeIns AProf MProf MLog
Make the required changes and press a PF-key
|
To de-install, enter Y and press ENTER.
To cancel the de-install, press ENTER.
This section covers the following topics:
When the download function is performed, only the addresses which correspond with the delimiting factors (node and addressee type) of a profile you have defined will be downloaded from the central directory.
The Add Profiles function is used to create the profiles. When you select this function, all nodes which interact with the central directory and the possible addressee types are displayed.
5:17 PM * * * C O N - N E C T 3 * * * 14.Feb.94
Cabinet LS Directory Synchronization - Add Profiles OLIP90
Node Name Address Cabinet Ext.Address Bulletin Board Last Name
--------- ------- ------- ----------- -------------- ---------
ATLANTA _ _
BOSTON _ _
CEDARRPS
DENVER _ _ _ _
SEATTLE _ _ _ _ _
Position to Node Name ________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Menu Quit - + -- ++
Select by marking with any character
|
If you have previously created a profile for an addressee type on a particular node, the column for that addressee type is empty and you are unable to select the addressee type. You can use the Maintain Profiles function to display, modify or delete a previously created profile. See Maintain Profiles.
Mark the addressee types you want for each node and press ENTER. The resulting screen, as shown below, is displayed for each addressee type and node you selected.
5:32 PM * * * C O N - N E C T 3 * * * 14.Feb.94
Cabinet LS Directory Synchronization - Add Profile OLIP90
Download Import Rule Syntax
CD Name: DAEFCOC_
Node Name: DENVER__ #1 #2 ...
Addressee Type: Cabinet_____________ #1 Mail ID
Date Last Downloaded: 0000-00-00 00:00:00.0 #2 Node Name
Highest Transaction ID: 0 #3 Last Name
(Set to zero with RESET PF-key) #4 First Name
Import #5 CD Name
Include First/Last Name: X (Mark to include) #6 Alias
Separator: . #7 Addressee
Import Rule: #1 #2___________________________________
Exception Import Rule: #6______________________________________
Batch Import Mode: X Automatic _ Controlled
Target Cabinet: SYSCNT__
Folder: Work___________
File: _______________
Security Levels: 7 Read 7 Modify 7 Copy 7 Print
(Original security levels used when blank)
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Menu Quit Cancl
Make the required changes and press a PF-key
|
The values displayed here are automatically provided:
- CD Name
Name of the central directory.
- Node Name
Name of node to which this profile applies.
- Addressee Type
Type of addressees which are to be downloaded.
- Date Last Downloaded
Date and time of last download.
- Highest Transaction ID
Each time an address is uploaded to the central directory, whether for the first time or when modified, a transaction ID is assigned to the address.
The number displayed here is the highest transaction ID which has been downloaded to your local Con-nect node. The next time you perform a download, the system will use this number as an indicator to begin downloading the address with the next highest transaction ID.
The values you specify here determine, for example, how each downloaded addressee is imported to your SYSCNT cabinet and how the imported addressee is uniquely identified on your Con-nect node.
Note:
Import rules and exception
import rules can also be defined with user exit USR0060C. Once you execute
USR0060C, the fields Include First/Last Name, Separator, Import Rule and
Exception Import Rule are not displayed in the "Directory Synchronization - Add
Profile" screen. USR0060C can be either performed online or in batch mode. For
further information, see User Exit
USR0060C.
- Include First/Last Name
Pertains only to addressee type Cabinet. Designates whether the first and last name of a private cabinet will be additionally used to create the address' nickname. If this field is blank, the first and last name will not be used.
- Separator
Separator character. A unique nickname is created for each imported address. The values which are used to create this nickname are determined in the "Import Rule" field below. The separator character that you specify here is inserted between the different values. A separator character can be, for example, the dollar sign ($), or comma (,).
You cannot use the asterisk (*) as a separator and, depending upon your environment, there may be other characters which cannot be used.
Default is: " " (blank).
- Import Rule
Defines which address information is used to create the address' nickname on your local node. If you specify more than one value here they must be separated by a blank. For example #2 #3.
If you have specified a separator character in the field above, this character will be used to separate the values when the mail ID is created; it is not entered here.
Note:
When adding a profile for addressee type bulletin board, it is recommended that you use the defaults for this field.The following values can be specified:
#1 Addressee's user ID. #2 Node name from which address originates. #3 Addressee's last name. #4 Addressee's first name. #5 Name of central directory from which address was downloaded. #6 A unique ID which is assigned by the system to each addressee uploaded to the central directory. #7 The addressee's name, which can be one of the following: the description or name of a cabinet, user's full name, nickname, bulletin board or external address. - Exception Import Rule
Used to override the import rule, if in this case the import rule would create a duplicate nickname.
- Batch Import Mode
Determines whether or not the addresses are imported in batch mode. You can select one of the following options:
Automatic Address data is automatically imported to your Con-nect node when you run utility B20002 "Directory Synchronization - Download". Controlled All addresses which correspond to this profile are not imported during the execution of utility B20002 "Directory Synchronization - Download". You must download the addressees online (using the directory synchronization administration Download Addresses function). - Target Cabinet
Cabinet to which addresses are imported - this is always cabinet SYSCNT.
- Folder
Folder in target cabinet to which addresses are imported.
- File
File in target cabinet to which addresses are imported.
- Default Security Level
Security levels (read, modify, copy, print) assigned to each address when they are imported to your local node. If, in the case of addresses of type address and external, the security levels are left blank, the security levels assigned to the addresses on the originating node are used. See Cabinet Profile.
When you have completed your specifications, press PF3 to save the profile.
To define the next addressee type, press PF4.
This section covers the following topics:
The Maintain Profiles function is used to maintain the profiles you created with the Add Initial Profile function.
5:50 PM * * * C O N - N E C T 3 * * * 23.Feb.95
Cabinet LS Directory Synchronization - Maintain Profiles OLIP92
Cmd Node Name Addressee Type Date Last Downloaded Mode CD Name
--- --------- -------------------- --------------------- --------- ---------
__ BOSTON Address 1994-02-09 16:37:50.1 AUTO DAEFCOC
__ DENVER Address 1994-02-09 16:37:50.3 CNTL DAEFCOC
__ DENVER Bulletin 1994-02-09 16:37:50.4 CNTL DAEFCOC
__ DENVER Cabinet 1994-02-09 16:37:50.5 CNTL DAEFCOC
__ SEATTLE Name 1994-02-09 16:37:50.6 CNTL DAEFCOC
__ SEATTLE External 1994-02-09 16:37:51.0 CNTL DAEFCOC
Cmd: Position to Node ________ CD Name DAEFCOC
DI Display MO Modify ER Erase
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Quit Add ErAll - + -- ++
Mark item(s) from the list above with a command or press a PF-key
|
You can display, modify or erase each profile displayed on this screen.
- Node Name
The transport service node responsible for uploading the address to the central directory.
- Addressee Type
Type of addressee that will be imported. It can be one of the below:
Name Con-nect user. Address Nickname. Cabinet Private, shared, standalone, or public cabinet. Bulletin Bulletin board. External External address. - Date Last Downloaded
Date and time last download was performed.
- (Batch Import) Mode
Indicates how the addresses are imported to your SYSCNT cabinet in batch mode.
AUTO Addresses which pertain to this profile are imported automatically. CNTL Addresses will only be imported on line so that you can control the import of each address. - CD Name
Name of central directory.
- Position to Node
If you wish to begin the list starting with a particular node, enter the node name in this field and press ENTER. As a result, the list is restarted with the node you specified.
Additionally, you can press PF4 to add a new profile. As a result, you are returned to the "Directory Synchronization - Add Profiles" screen. See Add Profiles.
To display the profile of an addressee type, enter DI in the Cmd column for the appropriate node name and addressee type, and press ENTER.
To erase the profile of an addressee type, enter ER in the Cmd column for that profile, and press ENTER. As a result, a confirmation window is displayed. You can either confirm (Y) or cancel (N) the deletion of each marked profile individually, or you can enter an asterisk (*) to confirm the deletion of all marked profiles.
To erase all profiles displayed on this screen, press PF6. As a result, a confirmation window is displayed. Enter Y and press ENTER to erase all profiles, or press ENTER to cancel.
To modify the profile of an addressee type, enter MO in the Cmd column for the appropriate node name and addressee type, and press ENTER. As a result, the screen below is displayed.
6:06 PM * * * C O N - N E C T 3 * * * 14.Feb.94
Cabinet LS Directory Synchronization - Modify Profile OLIP92
Download Import Rule Syntax
CD Name: DAEFCOC_
Node Name: DENVER__ #1 #2 ...
Addressee Type: Bulletin____________ #1 Mail ID
Date Last Downloaded: 1994-02-09 16:37:50.4 #2 Node Name
Highest Transaction ID: 000000000000000000000056600 #3 Last Name
(Set to zero with RESET PF-key) #4 First Name
#5 CD Name
Import #6 Alias
Separator: . #7 Addressee
Import Rule: #2 #7___________________________________
Exception Import Rule: #6______________________________________
Batch Import Mode: _ Automatic X Controlled
Target Cabinet: SYSCNT__
Folder: Work___________
File: DENVER ADDR____
Security Levels: 7 Read 7 Modify 7 Copy 7 Print
(Original security levels used when blank)
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Quit Reset Cancl
Make the required changes and press a PF-key
|
Notes:
With the exception of the target cabinet, you can modify all information pertaining to the Import Addresses function. You cannot modify the information pertaining to the download function with the exception of the Highest Transaction ID field.
To reset the highest transaction ID to zero you press PF6. This forces the system to perform a total download with the next download. This means that, if you have erased previously uploaded addresses from your node, these addresses will be again downloaded. See Erase Imported Addresses from Your Con-nect Node.
Once you have completed your modifications, press PF3 to save your changes.
If you have marked several addressee types for modification, you can press PF4 to display the next addressee type.
Depending upon the log level you specified with the Directory Synchronization Maintenance function, either all significant events that occur, or only specific events are recorded in the log record. See Directory Synchronization Maintenance.
The log information is used to facilitate problem determination and general supervision. To avoid excessive disk space usage, you should occasionally delete obsolete log data.
6:11 PM * * * C O N - N E C T 3 * * * 14.Feb.94
Cabinet LS Directory Synchr. - Maintain Log Information OLLP03
Cmd Msg. Nr. Program Log Time Log Message Node Name
--- -------- -------- --------------------- ------------------------ ---------
__ 5087 OLPN06 1994-01-25 13:00:54.2 Program OLPN06 started at RESTON
__ 5087 OLPN06 1994-01-25 13:00:54.5 Program OLPN06 started at RESTON
__ 5087 OLAN21 1994-01-25 13:02:51.0 Program OLAN21 started at RESTON
__ 5087 OLPN06 1994-01-25 13:02:51.2 Program OLPN06 started at RESTON
__ 5030 OLUP01 1994-01-26 10:24:39.6 Upload utility has been c RESTON
__ 5110 OLIN05 1994-01-26 10:26:33.7 Address cannot be importe RESTON
__ 5087 OLIP92 1994-01-26 10:26:46.6 Program OLIP92 started at RESTON
__ 5110 OLIN05 1994-01-26 10:29:13.4 Address cannot be importe RESTON
__ 5110 OLIN05 1994-01-26 10:29:13.7 Address cannot be importe RESTON
__ 5110 OLIN05 1994-01-26 10:29:13.8 Address cannot be importe RESTON
__ 5110 OLIN05 1994-01-26 10:29:13.9 Address cannot be importe RESTON
__ 5110 OLIN05 1994-01-26 10:29:46.3 Address cannot be importe RESTON
__ 5124 OLIN05 1994-01-26 10:29:56.4 0 addresses imported - 37 RESTON
__ 5087 OLIP92 1994-01-26 10:34:55.5 Program OLIP92 started at RESTON
Cmd: Position to Current Node Name ALSBACH_ Log Time _______________
DI Display ER Erase TO Top YYYYMMDDHHMMSST
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Quit ErAll - + -- ++
Mark item(s) from the list above with a command or press a PF-key
|
- Msg. Nr.
Message number.
- Program
Name of program which generated the log record.
- Log Time
Date and time log record was created.
- Log Message
Information used for tracing.
- Node Name
Node on which event occurred.
- Position to Current Node Name
By default, the log messages recorded on your node are displayed. If, for example, you have modified your node name, you can enter the name of your previous node name to display the log records that were created with this node.
- Log Time
If you want to begin the list with logs created on a particular day and/or time, enter the date and time in this field and press ENTER. As a result, the list is restarted with log records which occurred since the time you specified.
You can mark any log record with ER in the Cmd column to erase the record from the file. As a result, a window is displayed where you are asked to confirm the erasure; enter Y and press ENTER. To cancel the erasure, press ENTER.
Additionally, you can mark each log record item with DI in the Cmd column to obtain extended information about the record. As a result, a screen similar to the one below is displayed.
5:02 PM * * * C O N - N E C T 3 * * * 14.Feb.95
Cabinet LS Directory Synchr. - Display Log Information OLLP03
Program OLUP01 Message Number 5030
Log Time 1994-11-21 10:14:50.4 Function UPLOAD
Node ECUADOR
Log Message Log Level Threshold 1 Logged with level
Upload utility has been completed
Records Synchronized 0 Node ECUADOR
1
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Quit Cancl
Press a PF-key
|
The information displayed here is used to assist the Software AG staff if additional information is required.