TRANSFER Reference Manual

GET-FOLD-ENTRY-INFO
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–255
RETN-CODE-DETAIL
is an error number returned by a subsystem other than the TRANSFER delivery
system or is a further qualification of an error detected by the TRANSFER delivery
system.
UNSAVE-TIME
is the time of day and date when the item is automatically removed from the
folder. These values are returned in timestamp (absolute) format; if this field is set
to 0, no unsave time was specified when the item was saved. For further
information about UNSAVE-TIME, see the SAVE-ITEM-B00 UOW description.
SIMPLE-ITEM-NAME
is the name associated with the item identified by ITEM-ID and FOLDER-NAME.
If this field is filled with blanks, no name is associated with the item.
GET-FOLD-ENTRY-INFO Operation
You can use this UOW to retrieve item name and item unsave time associated with an
item in a specified folder (information that is currently available through the GET-
ITEM-NAME UOW). In addition, the name of the correspondent that saved the item
in the folder is also returned.
For items saved in folders on TRANSFER versions prior to C20, the correspondent
name can be blank. The session must have read authority to the contents of the folder
named in the FOLDER-NAME field, and the item ID supplied must correspond to an
item saved in that folder. Specifically, if the folder is private, then the session user
must be the depot owner. If the folder is a shared bulletin board, then the session must
be a member of the group that owns the folder.
In addition to returning the item name, the unsave time and the ID of the item are also
returned.
A blank item name in the response indicates that the item is unnamed.