Choose -- choose network file server

Syntax      Choose [options...] name...

Description Choose non-interactively mounts the specified AppleShare volumes.
            Each name takes the form:

            [zone]:server:volume

            The zone name is always optional and defaults to the current zone.
            A server name must be preceeded by (at least) a colon.  The volume
            name must be separated from the server name by a colon.  Note that
            with the zone name omitted, the server/volume name combination
            appears much like a GS/OS pathname.

            When mounting file server volumes, both the server name and volume
            name are required.  If any portion of the zone/server/volume name
            contains a space or semi-colon character, the entire entity name
            must be quoted (to prevent the APW shell from getting confused).

            Server and volume passwords are case-sensitive.  More than one
            server and volume may be mounted with a single command, but the
            server and volume passwords must be the same for each, since at
            most one password of each type may be specified on the command
            line.

            Instead of specifying the entity name on the command line, you may
            use the -f option to specify a filename of a file in which the
            necessary information has been stored.  You may also use the -w
            option to open an interactive window to specify the necessary
            parameters and (optionally) store them into a file which may be
            used with the -f option.  See the discussion of these options
            below.

Input       None.

Output      None.

Diagnostics Errors are written to diagnostic output.

            Various confusing messages (such as "No AFPLogin call has been
            successfully made for this session") are usually the result of a
            missing or mis-types password.

Status      The following status codes may be returned:

            0   No errors
            1   Syntax error on command line
            2   System error (such as Out Of Memory)
            -1  Abort (Command-.)

Options     -f[ile] filename
                Specify the name of a file that contains the necessary server
                mount parameters.  (A file may be produced while in the
                interactive window; see the -w option.)  The filename may
                contain APW wildcard characters.

                The -f option can not be used when an entity name is specified
                on the APW command line

            -guest
                Log in as a guest instead of with a user name.

            -p[rogress]
                Display program copyright and progress information during
                execution.

            -pw password
                Specify the server log-in password.  The server password
                defaults to the value of the shell variabls "{ServerPassword}".

            -u[ser] name
                Specify the user name for the server log-in.  This option has
                precedence over the shell variable "{User}", but not over any
                user name saved in a Choose document file.  If no valid user
                name is found, -guest is assumed.

            -vp password
                Specify the volume log-in password.  The volume password
                defaults to the value of the shell variable "{VolumePassword}".

            -w[indow]
                Open an interactive, desktop-style window to be used to enter
                the necessary log-in information.  This will initialize the
                full desktop environment so that the Control Panel NDA can be
                used to "point & click" your way to the server volume, and then
                enter the information into the fields within the window.  Once
                the information is set, you can click on the "Mount" button to
                mount the file server, and/or the "Save" button to save the
                information in a file which can then be used with the -f
                option.

                If -w is specified on the command line with no -f option and no
                entity names, the window will be opened immediately for your
                use.  If a -f filename or entity name is specified, the window
                will only be opened if the server log-in fails for some reason.

                Once into the window environment, simply type the requested
                information into the various fields in the window.  Once this
                is complete, click on the "Mount" button or press the RETURN
                key to perform the server log-in.  Click on the "Save" button
                or press Command-S to save the log-in information into a file.
                During this process, various messages will appear within the
                top portion of the window letting you know how things are
                going.

                This window environment can be used for more than just mounting
                file servers.  For example, if you needed to get to the Control
                Panel to select your current printer device, you could use a

                    Choose -w

                command to simply open up the desktop environment, which will
                give you access to the NDA menu (which is where the Control
                Panel NDA "lives").

Examples        Choose :Fern's.World:Pasta

                Mounts the volume :Pasta: on the server Fern's.World located in
                the current zone, using the default user name, server password,
                and volume password.


                Choose "Development Tools:DSG Server:Almost APW:" -guest

                Mounts the volume :Almost APW: on the server DSG Server in the
                Development Tools zone as a guest.

                Choose -w -f Green.Public

                Mounts the network entity specified in the file Green.Public,
                with the user name, server password, and volume password also
                specified in the file.  If there is any problem in performing
                the log-in, the interactive window will be opened with the
                fields initialized to the values contained within the file.
                This will allow you to modify the field values and try the
                log-in again, then save the modified parameters back into the
                file. (This is useful when the zone of a particular entity has
                changed.)


See Also        Eject, which can be used to UnMount server volumes, and
                Online, which can be used to list currently mounted volumes.
