gtpo1m8sOperations

ZMAIL PATH-Display the Path to an Account

Use this command to examine internal mail structures or file record contents in a TPF Internet mail server database. This command displays the path through the first-level and second-level index to get to the user profile record (UPR) for a specified account.

Requirements and Restrictions

Format




account
is the name of the account for which you want to display the path.

You can specify as many as 30 characters for an account name. The name of an account can consist of any alphanumeric character, underscore (_), hyphen (-), comma (,), semicolon (;), left parenthesis ( ( ), or right parenthesis ( ) ).

Additional Information

Examples

The ZPATH command display provides the following information.

Note:
Not all of the following fields appear in every display.

 HASH VALUE 
is a number calculated for the specified account. This number is used to locate the UPR.

 LEVEL1 RCD 
is the ordinal number of the #MAILxx fixed file record; that is, the first-level index to the UPR.

 LEVEL1 ENTRY 
is the slot number in the fixed file record that contains the file address of either the second-level index to the UPR or the UPR account record.

 LEVEL2 RCD 
is the quotient when the hash value is divided for the first time. This quotient is then divided by the number of slots in the first-level index records to determine LEVEL1 RCD and LEVEL1 ENTRY.

 LEVEL2 ENTRY 
is the slot number in the second-level index to the UPR if the first-level index slot contains a UPR second-level index file address.

 LEVEL1 INDEX FA 
is the file address of the first-level index record for the UPR.

 LEVEL2 INDEX FA 
is the file address of the secound-level index record for the UPR.

 CONTENTION RECORD FA 
is the file address of the contention table record for the UPR. A contention table occurs when 2 user names hash to the same level 2 slot when that level 2 slot is in use.

 USER PROFILE RECORD FA 
is the file address of the UPR for this account.

 END OF PATH, FOUND 
indicates that there is a UPR for the specified account.

 END OF PATH, NOT FOUND 
indicates that there is no UPR for the specified account, but shows the path if that account did exist.

In the following example, the path for account user1000 is displayed:

+--------------------------------------------------------------------------------+
|User:   zmail path user1000                                                     |
|                                                                                |
|System: MAIL0100I 12.46.40 PATH FOR UID user1000                                |
|        HASH VALUE 96937689                                                     |
|        LEVEL1 RCD 00000068 LEVEL1 ENTRY 000001ED                               |
|        LEVEL2 RCD 0000CD0D LEVEL2 ENTRY 0000007F                               |
|        LEVEL1 INDEX FA F40D99A1                                                |
|        LEVEL2 INDEX FA 001653A5                                                |
|        USER PROFILE RECORD FA 08275241                                         |
|        END OF PATH, FOUND                                                      |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

In the following example, the path for account aaaabbbbcccc is displayed:

+--------------------------------------------------------------------------------+
|User:   zmail path aaaabbbbcccc                                                 |
|                                                                                |
|System: MAIL0100I 12.48.08 PATH FOR UID aaaabbbbcccc                            |
|        HASH VALUE 87878786                                                     |
|        LEVEL1 RCD 0000005F LEVEL1 ENTRY 00000070                               |
|        LEVEL2 RCD 0000B9FC LEVEL2 ENTRY 00000127                               |
|        LEVEL1 INDEX FA F40D997D                                                |
|        LEVEL2 INDEX FA 00165381                                                |
|        CONTENTION RECORD FA 0827522D                                           |
|        USER PROFILE RECORD FA 082751C5                                         |
|        END OF PATH, FOUND                                                      |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Related Information

See TPF Transmission Control Protocol/Internet Protocol for more information about TPF Internet mail server support.