Logs you in to VINES and activates your workstation as a component of the network.
LOGIN [username] [/QUIET:n] [/BD] [/#:name | /#:number] [/CSCRIPT:file] [/DSCRIPT:file] [/SPEED:rate] [/V:file]
username - Specifies the StreetTalk name for a user. If you do not supply a username, the system prompts you for it. Nicknames are allowed. After supplying the correct username, you must supply the correct password to complete the login.
/QUIET:n - Suppresses one or more login screens from displaying, where n is the number 0, 1, or 2. To suppress both login screens, specify 0. To suppress only the first login screen, specify 1. To suppress only the second login screen, specify 2.
These switches apply to dial-in sessions only:
/BD - Specifies blind dialing. The switch instructs an auto-dial modem to begin dialing, whether or not it detects a dial tone.
/#:name - Specifies the settings defined for the connection name, where name is defined in the SETDIAL.DB file.
/#:number - Specifies the telephone number to use for this dial-in session.
/CSCRIPT:file - Specifies the script file, file, to use to start this dial-in session.
/DSCRIPT:file - Specifies the script file, file, to use to end this dial-in session.
/SPEED:rate - Specifies one of the following line speeds you want to use for this dial-in session: 1200, 2400, 4800, or 9600.
/V:file - Displays the Script Interpreter screen, which provides information about the script file that operates the modem at the start of the dial-in session.
If you supply a filename with this switch, the data from the Script Interpreter is written to that file instead of to the screen.
How you log in to VINES depends on how your system administrator has set up your working environment. Check with your system administrator for login details.
Windows
If you are a Windows user, refer to the login instructions in the VINES User's Guide for Windows.
OS/2
If you are an OS/2 user, refer to the login instructions in the User's Guide for DOS and OS/2.
Macintosh
If you are a Macintosh user, refer to the login instructions in the VINES User's Guide for Macintosh.
BAN, LOGOUT, MLOGOUT, PCCONFIG, SETDIAL
login /quiet:2
Enter your login name: Thea
Password:
login - User requests to log in to the network.
/quiet:2 - Specifies that the LOGIN command display the first login screen, but suppress the second screen (the user profile processing screen).
Enter your login name: - System prompts for a login name and password.
Thea - User supplies the correct login name, Thea (a nickname).
Password: - User supplies the correct login password to complete the login. The system does not echo the password as the user types it
login /#:chicago /speed:9600
/#:chicago - Starts a dial-in session using the phone number and other connection settings that are defined for the connection name, chicago, except for the line speed.
/speed:9600 - Sets the line speed to 9600 bps, overriding the line speed that is specified for chicago.
Sets parameters for the login environment from the user profile.
LOGINMODE [SILENT] [ABORT]
SILENT - Keeps messages from being displayed during login.
Macintosh
The following messages always appear on
a Macintosh workstation, even if the SILENT switch is chosen:
Connecting to the Banyan network...
You are logged in to the Banyan network...
Getting your profile...
The following messages also appear, as required by software operations:
Login was not completely successful...logging you out.
Cannot change your password: Banyan error message.
ABORT - Aborts the user's login attempt if any one of the services specified in the user's profile is not available.
LOGINMODE can be issued from within a user profile only. It should be the first entry in the user profile.
To make effective use of the ABORT switch, administrators should prevent users from editing their own user profiles. For details, see Managing Users and StreetTalk.
OS/2
VINES software running on OS/2 workstations supports the LOGINMODE command.
Logs you out of VINES and enables you to use your workstation in local mode.
LOGOUT [HOLD] [/?]
HOLD - Applies to dial-in sessions only. The HOLD parameter logs you out, but does not disconnect the modem phone line.
/? - Displays command syntax of the LOGOUT command.
You should end every session on the network with the LOGOUT command. If you leave your workstation logged in, other users have access to system resources available to your user name.
Windows
If you are a Windows user, refer to the logout instructions in the VINES User's Guide for Windows.
OS/2
The LOGOUT command works identically in the OS/2 and DOS environments. To log out of VINES from the OS/2 prompt, type logout and press ENTER. Note that if you have multiple OS/2 sessions open, each of which is running VINES applications, all of the VINES applications will exit when you log out from any OS/2 session. For more information, refer to the logout instructions in the section on OS/2 workstations in Managing Workstations.
Macintosh
If you are a Macintosh user, refer to the logout instructions in the VINES User's Guide for Macintosh.
In a dial-in session, issuing the LOGOUT command with no parameters logs you out of VINES and terminates the connection to the modem.
LOGIN, POSTLOGIN
Activates the menus for the Intelligent Messaging mail program.
The Mail Main menu displays all the messages in your current mail folder on the lower portion of your screen. At the Mail Main menu you can select the following functions:
Read a message
Compose a message
Manage folders
Answer a message
Send a message
FIle a message/attachment
Print a message
FOrward a message
Delete a message
Use the arrow keys on your keyboard to select a function. You also can type the unique initial letters of each function name to activate a Mail function (for example, type FO to activate the FOrward function). After you have typed the letters, press ENTER to select the desired function.
Refer to the Intelligent Messaging User's Guide for instructions on using Intelligent Messaging mail. For instructions on installing and managing Intelligent Messaging mail, refer to the Intelligent Messaging Administrator's Guide.
Macintosh
VINES software running on Macintosh workstations support VINES Mail. Refer to VINES Mail for Macintosh User's Guide for instructions on installing and using Mail for a Macintosh workstation.
OS/2
VINES software running on OS/2 workstations supports VINES Mail.
MMAIL, SETMAIL, vnsmail
Copies VINES software for the OS/2 workstation from either the VINES Master Diskettes or VINES drive Z.
MAKEVCLI master | drivers | combo [source] [dest]
master - Creates a VINES OS/2 Master Diskette that contains all VINES software required for a workstation except for the LAN driver software.
drivers - Creates a Drivers Diskette that contains the LAN driver software.
combo - Creates a single diskette that combines the software from the Master and Drivers diskettes. To use this parameter, your diskette must have enough storage capacity to fit all of the software.
source - Specifies the source drive from which VINES Files should be copied. If you do not specify a source, MAKEVCLI uses the source files in drive Z. The software revision of the resulting diskette will match the software revision of the source files.
dest - Specifies the destination drive to which software files should be copied. If you do not specify a destination, MAKEVCLI attempts to copy the software to the diskette in drive A.
If you use the dest parameter, you must also specify the source parameter. Otherwise, MAKEVCLI mistakes the destination parameter for the source parameter and reports that it could not locate the source files.
You must specify only one of the of the type parameters: master, drivers, or combo.
For more information on using MAKEVCLI, see the section on OS/2 workstations in Managing Workstations.
format a:
makevcli mastermakevcli master - Creates a VINES Master Diskette on an OS/2-formatted diskette in drive A. Because the user omitted the source parameter, MAKEVCLI uses the source files on drive Z.
setdrive q "vines files@labnet-1@servers" /Root:\os2\usa
makevcli master qsetdrive q "vines files@labnet-1@servers" /Root:\os2\usa - Maps drive Q to the OS/2 subdirectory of the VINES Files service on the server labnet-1.
makevcli master q - Copies the files from drive Q. Because the user omitted the dest parameter, MAKEVCLI copies the files to the diskette in drive A.
Displays the VINES System Management menu.
MANAGE
The VINES System Management menu lets you select from a list of administrative functions.
You can bypass this menu and go directly to one of the functions, by entering a VINES command. The VINES commands and their functions are as follows:
MSERVICE Manage services.
MUSER Manage users.
MLIST Manage lists.
MNICK Manage nicknames.
MGROUP Manage groups.
MORG Manage organizations.
For more information, refer to Managing Users and StreetTalk.
OS/2
VINES software running on OS/2 workstations supports the MANAGE command.
MGROUP, MLIST, MNICK, MORG, MSERVICE, MUSER
Activates the menus for configuring an asynchronous terminal service.
MASYNCH /S:service-name
/S:service-name - Specifies the StreetTalk name of the asynchronous terminal service you want to configure. The service must already exist.
Using the MASYNCH command is equivalent to choosing the function, CONFIGURE service, when managing an asynchronous terminal emulation service on the Control a Service menu.
You must be an administrator with proper privileges to use MASYNCH. For more information, see the Banyan Asynchronous Terminal Emulation Guide.
OS/2
VINES software running on OS/2 workstations supports the MASYNCH command.
ASYNCH, MSERVICE, SETASYNCH
Accesses the menus for managing StreetTalk attributes.
MATTR object-name [/v:avd_file]
object-name - Specifies the StreetTalk name of the object whose attributes you want to manage.
/v:avd_file - Specifies the path to the Attribute Value Definition (AVD) file template you want to use. This switch is case-sensitive and must be entered as a lower-case letter: /v.
If you omit this parameter, VINES uses the VINES.AVD file in the Messages subdirectory on the drive Z to which you are currently connected.
Attributes are fields of information that are associated with a particular StreetTalk name. For example, user attributes could be telephone numbers, street addresses, building numbers, cities, etc. Printer attributes could be physical locations, available fonts, etc.
Using the MATTR command is equivalent to choosing the function MANAGE attributes when managing a user, list, group, or service from the MANAGE menus.
If the object is in your group, you can enter just the item part of the StreetTalk name. Nicknames are allowed.
You must be an administrator with proper privileges to use MATTR. For more information, see Managing Users and StreetTalk.
OS/2
VINES software running on OS/2 workstations supports the MATTR command.
MGROUP, MLIST, MSERVICE, MUSER
Lets you decompile and compile Attribute Value Definition (AVD) files.
To decompile the binary file:
MAVD /d input-filename [/o:output-filename]
To compile one or more source files to
the binary file:
MAVD source-file1 [source-file2] [source-file3] [source-filen] /o:output-filename
/d - Decompiles the binary file specified by input-filename. This switch is case-sensitive and must be entered as a lower-case letter: /d.
input-filename - Specifies the path to the Attribute Value Definition (AVD) file you want to decompile. The AVD file that VINES uses by default is stored in the Messages subdirectory on the drive Z to which you are currently connected.
/o:output-filename - Specifies the path to the output file that contains the AVD file template. This switch is optional when you decompile a binary file; if you omit the output-filename, an error message displays. The output-filename is required when you compile an ASCII source file.
The switch is case-sensitive and must be entered as a lower-case letter: /o.
source-file1, source-file2, source-file3, and source-filen - Specifies one or more source files to be compiled to the AVD file specified by the /o switch. The maximum number of source files you can specify is 10.
Attributes are fields of information that are associated with a particular StreetTalk name. For example, user attributes could be telephone numbers, street addresses, building numbers, cities, etc. Printer attributes could be physical locations, available fonts, etc. The labels associated with attributes are stored in a binary file called an Attribute Value Definition (AVD) file.
The MAVD command can be used to generate a custom AVD file from source or to decompile an existing AVD file to its original source. When you decompile an existing AVD file, you convert it to text format. In text format, you add, delete, or edit collections or individual attributes. Once you finish editing the file, you recompile it to convert it back to binary format. In binary format, the file can be accessed by STDA and StreetTalk management programs for display as attribute labels.
To use the MAVD command, you must have access rights to the directory specified by the /o switch. If you omit the /o switch when decompiling a binary file, the output is directed to the screen. For more information, see Managing Users and StreetTalk.
OS/2
VINES software running on OS/2 workstations supports the MAVD command.
MATTR, MGROUP, MLIST, MSERVICE, MUSER
mavd /d z:\messages\vines.avd /o:f:\admin\vines.txt
/d - Specifies that the source AVD file is to be decompiled (converted from binary format to text format).
z:\messages\vines.avd - Specifies the AVD file to be decompiled (in this case, the AVD file that VINES uses by default, vines.avd).
/o:f:\admin\vines.txt - Specifies the pathname of the text output file vines.txt.
mavd f:\admin\vines.txt /o:z:\messages\vines.avd
f:\admin\vines.txt - Specifies that the source text file is to be compiled (converted from text format to binary format).
/o:z:\messages\vines.avd - Specifies the pathname of the binary output file vines.avd.
Activates the VINES Messages application, which allows you to view messages received by your workstation and send messages to other network users.
MESSAGES
The VINES Messages application lets you view, send, and manage messages.
Windows
Both OS/2 and Windows workstations support the VINES Messages Application. The way you activate the VINES Messages Application depends on how your system administrator has configured the OS/2 or Windows software to run on your workstation. For details on how to use the Messages application, see the section on OS/2 workstations in Managing Workstations or the VINES User's Guide for Windows.
Macintosh
The VINES Utilities for Macintosh software includes the Messages application. For instructions on how to access the VINES Utilities for Macintosh and activate the Messages application, see the VINES User's Guide for Macintosh.
SEND, SETMSG
Activates the menus for managing groups.
MGROUP
MGROUP lists all the groups in the current default organization. You can select a group to manage, add a group, and search for other groups.
If you need help, type MGROUP. When the menu appears, press F1 to access on-line help. For more information, see Managing Users and StreetTalk.
OS/2
VINES software running on OS/2 workstations supports the MGROUP command.
MANAGE, MATTR
Activates the menus for managing lists.
MLIST
MLIST displays all the lists in the current default group. You can select a list to manage, add a list, and search for other lists.
If you need help, type MLIST. When the menu appears, press F1 to access on-line help. For more information, see Managing Users and StreetTalk.
OS/2
VINES software running on OS/2 workstations supports the MLIST command.
MANAGE, MATTR
Forcibly logs a user out of VINES.
MLOGOUT username
username - Specifies the StreetTalk name for a user. Nicknames are allowed. If the StreetTalk name contains blank characters, enclose the name in double quotation marks. Optionally, you can specify more than one user name. Separate each user name from the next with a blank character.
MLOGOUT logs the specified user out of the network from every workstation from which the user is currently logged in. The command displays a forced logout message, followed by the normal logout message.
To log a user out of VINES using MLOGOUT, you must be logged in as an administrator of the user's group.
To use the MLOGOUT command, your workstation must be running VINES 4.11 or greater.
For more information on using MLOGOUT, see Managing Users and StreetTalk.
OS/2
VINES software running on OS/2 workstations supports the MLOGOUT command.
LOGIN, LOGOUT, POSTLOGIN
Activates the Intelligent Messaging Mail Management program.
MMAIL
MMAIL provides administrators with comprehensive management features for users of an Intelligent Messaging mail service. These features include changing mailbox settings, managing mailboxes, moving mailboxes, and emptying mailboxes.
Refer to Chapter 2 and Chapter 3 of the Intelligent Messaging Administrator's Guide for instructions on using MMAIL.
OS/2
VINES software running on OS/2 workstations supports the MMAIL command.
MAIL, MSERVICE, MUSER, OPERATE
Activates the menus for the VINES Network and Systems Management (VNSM) program.
MNET [servername]
servername - Specifies the name of the server from which you want to retrieve network management statistics and information. Optionally, you can specify more than one server name. Separate each server name from the next with a blank character.
If you do not supply a server name, the MNET command presents a list from which you can choose one or more servers.
When you access the VINES Network and Systems Management program, a menu displays that lets you choose from options to display a variety of system and network management information. You can view the following information:
System Information
CPU utilization Run and swap queue and table information Buffer and memory statistics File system and disk usage statistics
Network Information
Interface and protocol statistics Topology information (neighbors and routes) Service statistics Route tracing between servers
For details, see Monitoring and Optimizing Servers.
OS/2
VINES software running on OS/2 workstations supports the MNET command.
Activates the menus for managing nicknames.
MNICK
MNICK displays all the nicknames in the current default group. You can select a nickname to manage, add a nickname, find nicknames for a complete name, or search for other nicknames.
If you need help, type MNICK. When the menu appears, press F1 to access on-line help. For more information, see Managing Users and StreetTalk.
OS/2
VINES software running on OS/2 workstations supports the MNICK command.
MANAGE
Activates the menus for managing organizations.
MORG
MORG displays all the organizations in the network. You can select an organization to manage or add a new organization.
If you need help, type MORG. When the menu appears, press F1 to access on-line help. For more information, see Managing Users and StreetTalk.
OS/2
VINES software running on OS/2 workstations supports the MORG command.
MANAGE
Activates the menus for managing services.
MSERVICE [service-name]
service-name - Specifies the StreetTalk name of the service you want to manage. This parameter lets you bypass the Select a Service menu and access the service management functions directly.
If you do not specify service-name, MSERVICE displays all the services in the current default group. You can select a service to manage, add a service, or search for other services.
If you need help, type MSERVICE. When the menu appears, press F1 to access on-line help. For more information, see Planning a Banyan Network, Managing VINES Services.
OS/2
VINES software running on OS/2 workstations supports the MSERVICE command.
MANAGE, MATTR
Activates the menus for managing users.
MUSER [username] [/A /F:pathname | /D]
username - Specifies the StreetTalk name of the user you want to manage.
/A - Adds the user specified by username. You must also use the /F switch to specify the file that contains the user profile for this user.
/F:pathname - Specifies the name of the file containing the user profile for username, the name of a user to be added with the /A switch.
/D - Deletes the user specified by username.
If the user is in your group, you can enter just the item part of the StreetTalk name. Nicknames are allowed, except with the /A switch.
If you execute MUSER without the username parameter, the command displays all the users in the current default group. You can select a user to manage, add a user, or search for other users.
If you need help, type MUSER. When the menu appears, press F1 to access on-line help. For more information about managing users, see Planning a Banyan Network and Managing Users and StreetTalk.
OS/2
VINES software running on OS/2 workstations supports the MUSER command.
MANAGE, MATTR
muser richard knox /a /f:rkprof
richard knox /a - Adds the user Richard Knox to VINES. StreetTalk appends the default group and organization to the user name.
/f:rkprof - Gives Richard Knox the user profile contained in the file /f:rkprof.
muser richard knox /d
muser richard knox /d - Deletes the user Richard Knox from VINES. StreetTalk appends the default group and organization to the user name.
Displays the StreetTalk database.
NAMES
The StreetTalk database displays information about users, nicknames, file volumes, printers, lists, groups, organizations, and servers.
You cannot manage anything displayed through this command.
If you need help, type NAMES. When the menu appears, press F1 to access on-line help. For more information, refer to Managing Users and StreetTalk.
OS/2
VINES software running on OS/2 workstations supports the NAMES command.
Updates network software for the workstation.
NEWREV [/I | /L | /O | /?]
You can use one of the following switches:
/I - Lists the VINES revisions available on servers within a one-hop LAN link and allows a user to upgrade workstation software. If the user is logged in to the network, and no nearby server is running the same revision of VINES as the workstation, the system asks the user to run NEWREV using this switch.
/L - Lists the VINES revisions available on nearby servers but does not allow a user to upgrade workstation network software.
/O - Displays a list of available revisions of VINES software. A workstation user can choose to upgrade or downgrade to a particular version.
/? - Displays command syntax and optional parameters of the NEWREV command.
Any user can run the NEWREV command, but administrators should control when users do so.
The NEWREV command must be run from the drive that contains the user's VINES boot disk or diskette.
The NEWREV command used with no switch automatically upgrades network software to the highest available revision of VINES software.
All switches except /? display the language of the server under the Location heading. For example, the location "USA" indicates that the server is running the default English messages. Location information is useful in a multilingual network because it allows you to select a specific language, using the /O switch.
Switches other than /? also display configuration information, specified by your administrator, under the Configuration heading. This information is useful because it can help you determine which server you should use. For example, your administrator might specify "Finance Server" as configuration information to indicate which server the Finance department uses. As a member of the Finance department, you would select the specific server with the /O switch.
The listing of servers and revisions on a large network may vary each time you execute NEWREV, because the command waits only a short time for all servers to respond. If a server does not respond in the time allowed by NEWREV, it will not be listed.
Workstation users do not have to upgrade their network software when a server's software is upgraded. As long as a matching version can be found on one server, users can participate in the VINES network. The server that provides VINES Files to a workstation must be connected to that workstation by a zero-hop or one-hop LAN link. If no matching version can be found at login, the system runs the NEWREV command automatically.
If the server that maintains your StreetTalk name is upgraded while you are logged in, you receive a message telling you to run NEWREV. When you run NEWREV, the program may display an error statement and quit. If this happens, you must reboot your workstation and run NEWREV again.
The NEWREV command sets the default communications driver in the PCCONFIG.DB file. To change this driver, run PCCONFIG. To override it, use switches or the BAN command.
If your boot diskette is a low-capacity (360K bytes) diskette and already contains the PCCONFIG.EXE file, you will not be able to fit the PCCONFIG.EXE and PCCONFIG.MSB program files on it. Therefore, when you run NEWREV, it deletes the PCCONFIG program files (but not PCCONFIG.DB) if it determines that deleting them would provide sufficient space on the diskette. You can then run PCCONFIG from a network VINES Files directory (drive Z). For details, see Managing Workstations.
Whenever an administrator upgrades the software on a server used for dial-in, all diskettes used to dial in to that server also must be upgraded. For details, see the PC Dial-in Option Guide.
For more information about the NEWREV command, see Planning a Banyan Network.
OS/2
VINES software running on OS/2 workstations supports the NEWREV command.
BAN, LOGIN, SHOWREVS, WNEWREV
newrev
newrev - Automatically upgrades network software to the highest available revision of VINES.
newrev /l
newrev /l - Lists all the VINES revisions available on the network and the servers on which each is located.