DIR
Function
Returns a list of containers and leaf items. Also returns a summary of how many files and folders, the last modified dates, and the disk usage assigned to the container. The REPLY command is required. The index number is also returned for use with the BYINDEX keyword.
Syntax
DIR path|DESKTOP userID path +lbpsdr
Parameters
path |
The location of the object, relative to the administrator’s Desktop. Separate the components of the path with colons. The PATHCHAR command can be used to change the default path character. |
DESKTOP userID path |
The path relative to the user's Desktop. |
l |
Include leaf items. |
b |
Include containers. |
p |
Full path displayed. |
s |
Include size (per item). |
d |
Include date (per item). |
r |
Include reference number (per item). |
Example
To retrieve a summary of container, you would enter
REPLY
DIR "general conferences:employee lounge" +bl
The server would return:
Contents of: "general conferences:employee lounge"
[B:0] "Message Storage" ""
[B:1] "Away Today" "Faculty"
[B:2] "Employee Calendar" ""
[L:4] "Susan Bram" "Customer Update"
[L:5] "Susan Bram" "Fire Drill Procedures"
[L:6] "Susan Bram" "Welcome Paul Chu"
Summary:
Files: 3 Size: 64 kb Last file modified on: 2004/05/17 08:40:26
Folders: 3 Last folder modified on: 2002/06/11 13:41:45
The BYINDEX keyword can be used to work with any of the above items. For example, to protect the message "Welcome Paul Chu", you would send the following command.
PUT PROPERTIES BYINDEX 6 "General conferences:employee lounge" 1016 6 1
The BYINDEX number is only valid until a addition or deletion occurs. A new message posted to the conference would change all the index numbers.
To retrieve a list items on Susan Bram's Desktop, you would enter:
REPLY
DIR DESKTOP SUSAN "" +lpb
The server would return:
Contents of: DESKTOP sbram ""
[B:0] "MailBox" ""
[B:1] "Calendar" ""
[B:2] "Help" ""
[B:3] "My Web Site" ""
[B:4] "Contacts" ""
[B:5] "Profile" ""
[B:6] "My Documents" ""
[B:7] "School Area" "Model Desktop"
[B:8] "Student Area" "Model Desktop"
[B:9] "Susan Bram's Student Portfolio" ""
[B:10] "Employee Lounge" "Model Desktop"
Summary:
Files: 0 Size: 0 kb Last file modified on:
Folders: 11 Last folder modified on: 2004/05/12 20:08:36
| 