2.5.5.1 List File Servers
This use case supports the Access a File in a Workgroup use case (section 2.5.1).
Context of Use: To display a list of file servers available in the workgroup when a User accesses a file via an application.
Goal: To list the available file servers in a workgroup and their properties.
Actors:
Application
Browser Service
File Client
Stakeholders
User
Precondition
None.
Main Success Scenario
Trigger: The Application receives a request from the User to display a list of file servers in the User's workgroup.
The Application directs the file client to contact the local master browser, using the GetBackupListRequest frame ([MS-BRWS] section 3.1.5.1.1) to retrieve the list of backup browsers. The master browser performs the action.
The Application directs the file client to select and establish a communication channel to a backup browser, as specified in [MS-RAP] section 2.1.
The Application directs the file client to contact the backup browser using the procedure described in [MS-RAP] section 3.1.4.12 NetServerEnum2 or [MS-RAP] section 3.1.4.15 NetServerEnum3 to retrieve the list of available servers.
The backup browser performs the action and returns the results to the Application (as described in [MS-BRWS] section 3.3.5.6).
Post Condition
The computers that provide file services are listed.
Extensions
If no response is received from the master browser, the application can attempt to contact the master browser multiple times. Ultimately, the use case ends with failure.
If the communication channel for [MS-RAP] cannot be established, or it becomes disconnected, the application can attempt to establish a connection multiple times with this or with an alternate backup browser. Ultimately, the use case ends with failure.