TRANSFER Reference Manual

SET-CURRENT-CONTXT
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–485
SET-CURRENT-CONTXT Operation
For most item-handling UOWs, the TRANSFER delivery system verifies that the
correspondent has access to the item by reading the IFOLDER file to see if the session
has an instance of the item saved in one of the folders for the current depot's session.
With shared folders, a correspondent has read access to an item if it is saved in one of
the correspondent's folders or in a folder owned by a group of which the
correspondent is a member. If the TRANSFER delivery system does not find an
instance of the item in the session's private folders, the TRANSFER delivery system
must determine what groups the session is a member of and look for an instance of the
item in one of the group's folders. This approach can slow performance when the item
being selected is not saved in one of the session’s private folders.
SET-CURRENT-CONTXT provides TISERV more information with which to check
item access. Most item-handling UOWs include no indication of which instance of the
item is being referenced. SET-CURRENT-CONTXT allows clients to specify to the
TRANSFER delivery system what the current folder or depot (for example, the
PUBLIC depot) is to be checked.
SET-CURRENT-CONTXT specifies a depot or folder that is to be searched first when
an item needs to be accessed. This specification remains in effect until the end of the
current IPC or until another SET-CURRENT-CONTXT UOW is issued.
If a folder is specified, it is searched first, then the folder's depot, then the
correspondent's private depot, then the depots of any groups of which the
correspondent is a member.
If a depot is specified, it is searched first, then the correspondent's private depot,
then the depots of any groups of which the correspondent is a member.
If both a depot and a folder exist with the name specified in the CONTEXT-
FOLDER or CONTEXT-DEPOT fields (which redefine one another), the folder is
referenced.
If neither a folder nor a depot is specified, an item is searched for in the usual way,
as if no SET-CURRENT-CONTXT UOW were processed; that is, the
correspondent's private depot is searched first and then the depots of any groups
of which the correspondent is a member are searched.
After a SET-CURRENT-CONTXT UOW is in effect, if a UOW accesses an item that
was not in the depot specified by the SET-CURRENT-CONTXT UOW, but was in a