Writing Filers so they integrate with Access

For a Filer to integrate with Access, it needs to provide a Share menu option, and take appropriate action when the option is chosen. This is done using a SWI interface to ShareFS.

These SWIs are subject to change as the range of Acorn networking products is expanded and updated, so we don't document them here. Should you wish to write a Filer to integrate with Access, you should contact Acorn Customer Services.

* Commands

*Desktop_ShareFSFiler

Command to start up ShareFS Filer

Syntax

*Desktop_ShareFSFiler

Parameters

None

Use

*Desktop_... commands are used by the Desktop to start up ROM-resident Desktop utilities that appear automatically on the icon bar. However, they are for internal use only, and you should not use them; use *Desktop instead.

Related commands

*Dismount

Ensures that it is safe to finish using a remote shared disc

Syntax

*Dismount :disc_name

Parameters

disc_name - the name of the remote shared disc

Use

*Dismount ensures that it is safe to finish using a remote shared disc by closing all its files, unsetting all its directories and libraries, and discarding its local caches. *Dismount is useful before finishing sharing a particular disc. However, the *Shutdown command is usually to be preferred, especially when switching off the computer.

Syntax

Parameters

-protected - causes the directory to be shared protected, rather than the default of unprotected

-cdrom - indicates that the shared directory is on a CD-ROM

-noicon - prevents an icon appearing for the shared disc

Use

*Share makes a local directory available as a shared disc. If no name is given for the shared disc, then the name of the directory is used, or - for the root directory - the name of the disc itself.

If the directory is shared unprotected, then remote users have read and write access to all objects beneath it. If the directory is shared protected, then remote users' access to an object beneath it is determined by that object's public access attributes.

Example

*Share ADFS::Maths.$ Maths -protected

Related commands

*Shares, *UnShare

*ShareFS

Selects the Shared Filing System as the current filing system

Syntax

*ShareFS

Parameters

None

Use

*ShareFS selects the Shared Filing System as the filing system for subsequent operations. Remember that it is not necessary to switch filing systems if you use the full pathnames of objects. For example, you can refer to ADFS objects (on a local disc) when ShareFS is the current filing system.

Example

*ShareFS

Related commands

*ADFS, *Net, *RAM, *ResourceFS

*ShareFSIcon

Adds an icon to the icon bar for a remote shared disc

Syntax

*ShareFSIcon disc_name

Parameters

disc_name - the name of the remote shared disc

Use

*ShareFSIcon adds an icon to the icon bar for a remote shared disc.

Example

*ShareFSIcon Maths

Related commands

None

*ShareFSWindow

Changes or reports the size of the ShareFS transmission window

Syntax

*ShareFSWindow [size]

Parameters

size - the size of the ShareFS transmission window

Use

*ShareFSWindow changes the size of the ShareFS transmission window, or - with no parameter - reports its current size. You should not change the size unless you know what you are doing.

Example

*ShareFSWindow
Current ShareFS window size: 2

Related commands

None

*Shares

*Shares lists the local directories currently made available as shared discs

Syntax

*Shares

Parameters

None

Use

*Shares lists the local directories currently made available as shared discs, showing the full *Share command with which it was shared.

Example

*Shares
Share ADFS::Maths.$ Maths -protected

Related commands

*Share

*UnShare

*UnShare makes a local directory no longer available as a shared disc

Syntax

*UnShare disc_name

Parameters

disc_name - the name of the remote shared disc

Use

*UnShare makes a local directory no longer available as a shared disc.