Command Reference
The Command Reference describes Banyan networking commands that you can issue from the DOS prompt of a DOS, Windows, or OS/2 client workstation, from the system prompt of a StreetTalk for Windows NT server with client workstation software installed, or from a user profile. Macintosh workstations also support some commands. Information marked with an icon is specific to the particular workstation. Unmarked information is generic and relates primarily to DOS and Windows 3.1 workstations. Unmarked commands may work from Windows 95 client workstations, Windows NT workstations, or the system prompt of StreetTalk for Windows NT servers with these limitations:
StreetTalk for Windows NT server software does not support some functionality that the commands implement (for example, asynchronous terminal emulation service). StreetTalk Explorer functionality is a replacement for VINES commands. StreetTalk Explorer can be installed on Windows 95, Windows NT, and StreetTalk for Windows NT.
Macintosh
!ALIASES creates a Macintosh alias when the mounted volume name for NetWare servers is different from the StreetTalk name.
!ALIASES
Because StreetTalk names can be longer than alias names, two different StreetTalk names can map to a common alias name. In this case, only the first alias is created.
Macintosh
!AT_PRINTER makes a specified AppleTalk print service available to a Macintosh user.
!AT_PRINTER printer-name zone-name
printer-name - The AppleTalk name of an AppleTalk network printer or print service.
zone-name - The AppleTalk name of the zone in which the AppleTalk network printer or print service resides.
The !AT_PRINTER command supports native AppleTalk printers and print services on servers running VINES 5.0 or greater.
You must enter the !AT_PRINTER command from within your user profile.
Do not use !AT_PRINTER if your server contains patch 5.52(5)-VNS-EF-1; use SETPRINT.
Macintosh
!AT_VOLUME assigns AppleTalk zones and servers to network file volumes and maps a user's drive to a specific path in a network file volume.
!AT_VOLUME volume-name servername zone-name [/TIME: t] [/RETRY: r]
volume-name - Specifies the AppleTalk name of a network file volume.
servername - Specifies the AppleTalk name of a server.
/TIME: t - Specifies the number of times the connection should be attempted.
/RETRY: r - Specifies how long to wait between retries in 8/60 second units. This parameter is only needed for unusual network configurations where lengthy delays exist.
The !AT_Volume command mounts AppleShare volumes on Macintosh servers and VINES volumes on 5.0 volumes or greater. Volumes on AppleShare servers mounted using !AT_VOLUME are not dismounted when the user logs out.
You must enter the !AT_VOLUME command from within a user profile.
Do not use !AT_VOLUME if your server contains patch 5.52(5)-VNS-EF-1; use SETDRIVE.
Specifies the StreetTalk Directory Assistance (STDA) database you want to use with Intelligent Messaging mail from within your user profile.
!SETSTDA [servername /ALT | servername /NOALT] | [/OFF]
servername /ALT - Specifies which server retrieves the STDA database each time you press F2 or the STDIRECT hotkey from within mail. If the STDA service cannot be accessed on the server specified by servername, the program finds the next available STDA service. This is the default.
servername /NOALT - Specifies which server retrieves the STDA database each time you press F2 from within mail. If the STDA service cannot be accessed on the server specified by servername, the program does not substitute the next available STDA service in its place.
/OFF - Prevents the user from accessing STDA while working in mail. If the user presses F2, the user accesses Mail's catalog of StreetTalk names.
The !SETSTDA command can be issued only from within a user profile command. The command is not necessary in a user's profile for the user to access and use STDA. The !SETSTDA command is used to specify the STDA database used with mail.
No system message displays the !SETSTDA settings when you log in.
Macintosh
To specify the STDA database that a Macintosh user accesses with Network Mail for Macintosh, the administrator must include the !SETSTDA command in the user's profile.
OS/2
To specify the STDA database that an OS/2 user accesses with mail, the administrator must include the !SETSTDA command in the user's profile.
STDIRECT, STDOFF, XSTD, Managing Users and StreetTalk.
!setstda "server two" /alt
"server two"- Specifies that server two retrieves the STDA database.
/alt - If server two is unavailable, the next available server retrieves the STDA database.
!setstda /off
!setstda /off - Prevents the user from accessing STDA while working in Intelligent Messaging mail.
Activates 3270/SNA terminal emulation.
3270 [service-name] [/LU:n] [/PLU:specifier] [/PRINTER:LPTn] [/CLU:n] [/CLU2:n] [/CLU3:n] [/KEYBOARD:filespec] [/ADAPTER:filespec]
service-name - Specifies the StreetTalk name for a 3270/SNA emulation service.
/LU:n - Specifies the number, n, from 2 to 97, of a display logical unit (LU). If this logical unit is not in use, the system will attach the LU to the user's workstation. If the display LU is in use, the workstation cannot act as a terminal unless you issue this command again with a different number. If you omit a number, the service tries to find an available display LU that the user can access. If you omit this switch, you get one display LU by default.
/PLU:specifier - Identifies the workstation as a printer logical unit (LU). The specifier can be a number from 2 to 97, the word NEXT, or a blank. This switch provides a print session with the host.
If you specify NEXT, the 3270/SNA service attaches to the logical unit that is numbered one greater than the display logical unit. You must set up the logical units to alternate between display LU and printer LU. For example, if logical unit 2 is a display LU, then unit 3 is a printer LU, unit 4 is a display LU, unit 5 is a printer LU, and so on. (See Example 3.)
If you do not specify either a number or NEXT, the 3270/SNA terminal emulation service attaches to the next available printer logical unit.
If you specify the /PLU switch, you can use only two of the three additional display sessions, /CLU:n and /CLU2:n. Entering emulation automatically provides one display session. Each workstation can have a maximum of four sessions (that is, four display sessions, or three display sessions and one print session).
/PRINTER:LPTn - Specifies the number of the printer port on the workstation to be used for the print session specified by the /PLU switch. The n value must be 1, 2, or 3. This value also can be set by an adapter file.
To set up multiple host sessions, you must specify switches in the following order:
1. /LU:n
2. Either /CLU:n or /PLU:n
3. /CLU2:n
4. /CLU3:n
If you do not use the proper order, you receive only one display session.
/CLU:n, /CLU2:n, and /CLU3:n - Provide additional display sessions while in 3270 emulation, where /CLU:n, /CLU2:n, and /CLU3:n are specified in consecutive order. The optional n specifies the number of a display logical unit (LU). If you omit the number, the service uses the next available display logical unit. You must have access rights to these devices.
If you also specify the /PLU switch, you may use only two additional display sessions, /CLU:n and /CLU2:n.
/KEYBOARD:filespec - Indicates the keyboard definitions file used in 3270 emulation, where filespec is a valid DOS file specification that names the file created by the KB3270 program. If you omit a keyboard file, the service uses default mappings.
/ADAPTER:filespec - Indicates the adapter file used in 3270 emulation, where filespec is a valid DOS file specification that names the adapter settings file created by the GA3270 program. If you omit an adapter file, the service uses defaults for a monochrome display or a CGA display.
To provide 3270/SNA service in the user profile, use the SET3270 command. The SET3270 command accepts the same switches and parameters as the 3270 command. Note that any parameters provided by a 3270 command issued from DOS will override any parameters provided by SET3270 in the profile. Parameters omitted from the 3270 command use the values set by the SET3270 command in the user profile.
With the 3270 command, you can specify any 3270/SNA service that is available on the network. To use the service, a user must have access rights to its logical units.
The range of numbers you can specify on the /LU and /PLU switches varies. For details, see the VINES 3270/SNA Option Guide.
3270PCKB, GA3270, HOSTS, I3270, R3270, REL3270, SNACFG
3270
3270 - Activates 3270/SNA emulation, using the service and any other settings in the user profile.
3270 ibmsna@production@manuf /clu
ibmsna@production@manuf - Activates 3270/SNA terminal emulation, using the service ibmsna@production@manuf.
/clu - Lets the user access any two available display logical units (LU).
3270 ibmsna@finance@corporate /lu:2 /printer:lpt3 /plu:next /clu:1/keyboard:french.kbd /adapter:ega.dat
ibmsna@finance@corporate - Activates 3270/SNA terminal emulation, using the service ibmsna@finance@corporate.
/lu:2 - Lets the user access display LU2.
/printer:lpt3 - Sends output from the printer LU to workstation port LPT3.
/plu:next - Lets the user access printer LU3.
/clu:1 - Lets the user access any available LU for an additional display session.
/keyboard:french.kbd - The file french.kbd provides keyboard definitions.
/adapter:ega.dat - The file ega.dat provides adapter attribute settings.
Enables the keys on the 3270 workstation keyboard to function as labeled during 3270/SNA emulation.
3270PCKB
The 3270PCKB command is memory-resident. It must be run before activating 3270 emulation. By default, the 3270 workstation keyboard (which is different from the workstation keyboard) works as a workstation keyboard in emulation. If you load this program first, the 3270 workstation keys function as they are labeled.
For more information, see the VINES 3270/SNA Option Guide.
GA3270
Activates Asynchronous Terminal Emulation.
ASYNCH [/S:service-name] [/E:terminal-type] [/C:connection] [/F:parmfile] [/O:pathname]
/S:service-name - Specifies the StreetTalk name of the Asynchronous Terminal Emulation service. If the service is in the same group and organization as your login name, you can supply only its item name. If the service name contains a blank character, enclose the name in double quotation marks.
If you omit the service name, the default asynchronous terminal service is used from your user profile, provided you have a SETASYNCH command in your profile.
/E:terminal-type - Overrides the terminal type set for the connection. The possible choices are as follows:
TTY
VT1000
VT52
IBM 3101
If you do not specify the terminal type, the system uses the default terminal type for the connection name or parameter file, as set up by your administrator. If your administrator has assigned no default terminal type, the system uses the TTY terminal type.
SETASYNCH is the user profile command that sets up user access to an Asynchronous Terminal Emulation service. See the SETASYNCH command entry in this reference.
The connection can automatically execute a script file. If you also specify a parameter file with the /F:parmfile switch, the settings are executed in the following order:
1. Settings specified from /F and any script commands in /F
2. Settings specified from the script file associated with the connection
3. Settings specified from the script file with the same filename as the parameter file (that is, with the extension .ATS)
4. Note that the parameters that are set last override any of the same parameters set previously.
See the Banyan Asynchronous Terminal Emulation Guide for more information.
EMULATION, HOSTS, MASYNCH, RASYNCH, RELASYNC, SETASYNCH, TASYNCH
asynch
asynch - Activates the Action Menu with no connection defined. The user can use the service in only one way: by dialing out manually from Banyan Terminal Emulation menus. A service must be set in the user profile using the SETASYNCH command.
asynch /s:"remote vax@finance@home office"
asynch - Activates the Action Menu with no connection defined, using the specified service. By default, the user's workstation emulates a VT100 terminal. The user can use the service in only one way: by dialing out manually from VINES terminal emulation menus.
/s:"remote vax@finance@home office" - Specifies the service remote vax@finance@home office. Double quotation marks surround the service name because it contains a blank character. Because the user used the /S switch, no service needs to be specified in the user profile.
asynch /c:"vax direct"
asynch - Activates terminal emulation using the specified configured connection. A service must be set in the user profile using the SETASYNCH command.
/c:"vax direct" - Specifies the connection vax direct. Double quotation marks surround the connection name because it contains a blank character.
asynch /s:"vax host@finance@home office" /c:"vax direct"
asynch - Activates terminal emulation using the specified service and configured connection.
/s:"vax host@finance@home office" - Specifies the service vax host@finance@home office. Double quotation marks surround the service name because it contains a blank character. Because the user used the /S switch, no service needs to be specified in the user profile.
/c:"vax direct"- Specifies the connection vax direct. Double quotation marks surround the connection name because it contains a blank character.
Loads VINES software into workstation memory and connects a workstation to a VINES network.
BAN [/drivername] [/DRIVERS] [/NL] [/NC] [/?]
The switches are used primarily for diagnostic purposes.
/drivername - Overrides the default driver in the PCCONFIG.DB file, and loads the software associated with the network card described by drivername. For a list of drivers, use the /DRIVERS switch.
/DRIVERS - Displays a list of acceptable arguments for the drivername parameter.
/NL - Loads VINES software into workstation memory, but does not start the login sequence. Before login, the user's drive Z is mapped to the PCINIT subdirectory. To connect to the network, the user must specify the LOGIN command. After login, the user's drive Z is mapped to VINES Files.
/NC - Examines appropriate communications hardware in the workstation without initializing the communications environment.
/? - Displays command syntax and optional parameters of the BAN command.
If you do not specify any switches, the BAN command loads VINES software using the LAN or network driver defined in PCCONFIG.DB, and starts the login process.
For more information on using BAN, see Managing Workstations.
For information on using BAN with the PC Dial-in option, see the PC Dial-in Option Guide.
OS/2
For OS/2 workstations, BAN does not run automatically at boot time. To execute BAN each time the workstation boots, include the command in the OS/2 STARTUP.CMD file. This file is the equivalent to the DOS AUTOEXEC.BAT file. For more information on including the BAN command in the OS/2 STARTUP.CMD file, see the section on OS/2 workstations in Managing Workstations.
LOGIN, PCCONFIG, PCCOPY
Loads VINES terminal emulation software into workstation memory and enables third-party software that uses the BANV interrupt to establish sessions with the host.
BASYNCH
For third-party software that uses the BANV interrupt, you can establish sessions with the host by first issuing the BASYNCH command, and then issuing the command that runs the third-party software.
If you use the BASYNCH command, you can use the EMULATION command to establish sessions with the host only if the emulation package specified by the EMULATION command uses the BANV interface to communicate with BASYNCH. To release BASYNCH from memory, use the RELASYNC command.
Refer to the Banyan Asynchronous Terminal Emulation Guide for more information.
EMULATION, RELASYNC
Allows you to run a non-interactive utility that controls the patch levels of multiple servers in a network.
BPATCH [servername] [hh:mm:ss] [/P:pathname]
servername - Specifies the name of the server on which you want to install the patch.
hh:mm:ss - Specifies a time to install the patch. Use a value in 24-hour time in the format Hour:Minutes:Seconds. If you do not use this switch, the default time for the patch installation is as soon as possible.
/P:pathname - Specifies the pathname where the patch source files are stored.
If you have copied all of the patch sources to the fixed disk of your workstation or to a network drive, use the /P switch to indicate the drive and pathname, so that the Patch utility recognizes where the patches are stored.
If the directory where the patches are stored is the top-level directory on the patch diskette that you have inserted into drive A of your workstation, you do not have to use this switch.
You can execute the BPATCH command from the command line or from within a batch file. The batch file can specify multiple servers, each on a separate line.
You can organize and store multiple versions of patches in separate directories on a local fixed disk or on a network drive, and then use the /P switch to indicate the pathname of the directory that contains the version you want to install.
When the BPATCH command executes, information about the patch and the patch process is displayed on the screen. To redirect these messages, enter the greater-than symbol (>) followed by a redirected filename on the BPATCH command line.
PATCH, PHIST
Prints a file on a network printer.
BPRINT filename [/P:printq] [/B:bannertext | /NB] [/FORMS:paperformat]
filename - Specifies the name of the DOS file you want to print. If the file is not a DOS (ASCII-based) file, it prints with visible control characters.
You must have access to the file. The filename can be a DOS pathname, such as N:\mydir\reports.doc.
If the file is a UNIX file on a UNIX Connectivity File Service (UCFS), you must first convert the file to DOS format by using TODOS.
/P:printq - Specifies the StreetTalk name for a print service or specifies a port. The port must be assigned to a print service. If the service name contains spaces, enclose the name in double quotation marks.
If the UNIX user does not use the /p switch and specify either a print service or a port, the UNIX environment variable PRINTQ is used to determine the print service. (See the following "Notes" section.)
/B:bannertext - Specifies the job title. If the title contains spaces, enclose the text of the title within double quotation marks (for example, /B:"Status Report"). The title appears on the SETPRINT listing of jobs in the print queue.
If you do not specify /B, the job title becomes either the title specified by the previous SETPRINT /B command, or the first 15 characters of the filename.
/NB - Disables printing of a banner page.
/FORMS:paperformat - Specifies the paper format name, such as Standard or Letterhead, defined by your system administrator.
The paper format that you name in this switch must be one that is currently defined for the print service and is currently loaded for the destination.
If you have a print service where FORMS type is other than STANDARD, the desired FORMS type must be defined using the /FORMS:paperformat switch along with the BPRINT command.
The FORMS type is required even if the correct /FORMS:paperformat is defined in the BPRINT command line of the user profile. The paperformat argument specified in a BPRINT profile command is accepted, but ignored for subsequent BPRINT commands.
It should become the default, but currently is not treated as the default.
Depending on how your system administrator has set up paper formats, you may be able to use this switch to specify the destination where the print job will be sent. Ask your system administrator for help.
bprint g:\mydir\newfile
g:\mydir\newfile - Spools the specified file to the print queue specified in the user profile, with the job title of g:\mydir\newfil (the first 15 characters of the filename).
bprint f:\mydir\myfile.doc /nb
f:\mydir\myfile.doc - Spools the specified file to the print queue specified in the user profile.
/nb - Specifies that the file print without a banner.
bprint /p:"fast printer@sales@suntech"
/p:"fast printer@sales@suntech" - This user profile command specifies that any file printed with the BPRINT command goes to the print queue fast printer@sales@suntech. Double quotation marks surround the print queue name because it contains a blank character.
bprint g:\mydir\report.doc /p:"fast printer@sales@suntech" /b:"Jan File"
g:\mydir\report.doc - Spools the specified file to the specified print queue.
/p:"fast printer@sales@suntech" - Specifies the print queue fast printer@sales@suntech. Double quotation marks surround the name because it contains a blank character.
/b:"Jan File" - Specifies that the file print with a job title of Jan File. Double quotation marks surround the job title because it contains a blank character.
To set a default print queue, it is recommended that you include the BPRINT command with the /P switch in the user profile. If the BPRINT command is not included in your user profile, and you do not specify a print queue when you issue the BPRINT command, you are notified with a screen message that you must specify a print queue and the file does not print.
If you issue the BPRINT command with the /P switch, the print queue you specify becomes the default print queue until you either log out or re-issue the BPRINT command with the /P switch.
For more information on BPRINT, see the User's Guide for DOS and OS/2 and Managing Users and StreetTalk.
OS/2
VINES software running on OS/2 workstations supports the BPRINT program. For more information about printing from an OS/2 workstation, see the section on OS/2 workstations in Managing Workstations.
ENDSPOOL, SETPRINT, VINES
Starts an interactive dialog at the workstation with up to four other users logged in to the network.
CHAT [username]
username - Specifies the StreetTalk name of the user with whom you want to chat.
If you type CHAT and include the user's StreetTalk name, the CHAT screen is displayed and CHAT automatically attempts to call the user.
If you type CHAT without a user name, the CHAT screen is displayed. You then identify the user with whom you want to CHAT.
If the user is in your group, you can type just the item part of the user's StreetTalk name. If the user is not in your group, you must type the complete StreetTalk name. Nicknames are allowed.
Type CHAT to answer a CHAT request from another user. If you are already in CHAT, press F3. Use the function keys to activate the various features of CHAT. On-screen help is available when you press F1.
See the User's Guide for DOS and OS/2 for more information.
VINES software running on OS/2 workstations supports the CHAT command.
MAIL, SEND, USERS
Specifies whether Banyan Asynchronous Terminal Emulation software or third-party terminal emulation software handles the interaction between the user and the host.
EMULATION [TASYNCH] [pathname]
TASYNCH - Specifies Banyan Asynchronous Terminal Emulation software to handle the interaction between the user and the host. TASYNCH is the default setting for the EMULATION command.
pathname - Specifies the pathname of the executable file associated with the DOS command that invokes the third-party software. Typically, this file has a .COM or a .EXE extension that you do not specify. You do not have to specify the full pathname if the executable file is in your search path.
The EMULATION command can appear only in the user profile. The EMULATION profile command lets the user execute the HOSTS command to access the host, using the specified terminal emulation software package.
Do not include the EMULATION command in a user's profile unless the server that maintains the user's group is upgraded to at least VINES version 4.0. If the server is running a previous version of VINES, EMULATION fails to execute during login and generates an error message.
If the user is running third-party terminal emulation software that uses the BANV interrupt, you may include the EMULATION command in the user's profile only if the emulation package specified by the EMULATION command uses the BANV interface. Do not include EMULATION in the user's profile if the user always executes RASYNCH and invokes the third-party program.
The EMULATION command determines if the function, Set Up A Dial-out Connection, can be used at the HOSTS command's Select A Connection menu. If a user's profile specifies Banyan Asynchronous Terminal Emulation software for handling the host access, the function is available. Otherwise, the function is not available.
See the Banyan Asynchronous Terminal Emulation Guide for more information.
ASYNCH, HOSTS, RASYNCH
emulation f:\pcprog\pcterm
f:\pcprog\pcterm - Specifies the third-party terminal emulation program, pcterm, that handles the user's interaction with the host (excluding the .COM or .EXE extension). The directory of the executable file (f:\pcprog) is specified, because the executable file is not in the user's search path.
emulation pcterm
pcterm - Specifies the third-party terminal emulation program, pcterm, that handles the user's interaction with the host (excluding the .COM or .EXE extension). Because the directory of the executable file (f:\pcprog) is included in the users search path, only the name of the executable file is specified
emulation tasynch
tasynch - Specifies that VINES asynchronous terminal emulation software handles the user's interaction with the host. TASYNCH is the default EMULATION setting.
Spools numerous print requests to a print queue as one print job.
ENDSPOOL
Use ENDSPOOL if you have numerous print requests that you want to send to the printer as one print job, without interruptions. Follow this procedure:
1. Use SETPRINT to access the Modify Job Profile screen.
2. For the specified print queue, type infinite in the End Spooling Delay field. You must reset this field later if you do not wish to continue using ENDSPOOL.
3. From your application, send the files to print.
4. Exit your application.
5. Type ENDSPOOL. The print requests are spooled to the printer as one print job.
BPRINT, SETPRINT
Creates and edits adapter files for use while in 3270 emulation.
GA3270
The GA3270 command lets you create an adapter file, identify the display adapter you are using, and control how color that is sent from the mainframe appears on your workstation during emulation. The command also lets you set up the print session and control how the status line appears.
See the VINES 3270/SNA Option Guide for more information.
3270, 3270PCKB, I3270, SET3270
Displays the Select a Connection menu for host communications.
HOSTS [/A:asynchterm-servicename] [/S:sna-servicename]
/A:asynchterm-servicename- Specifies the StreetTalk name of an asynchronous terminal emulation service. All connections defined for that service appear on the Select a Connection menu.
/S:sna-servicename- Specifies the StreetTalk name of a 3270/SNA terminal emulation service that appears on the Select a Connection menu.
If you issue the HOSTS command with no parameters, the asynchronous connections and the 3270/SNA services that are defined in the user profile are displayed.
For the ASYNCH command, HOSTS displays parameter files that are located in the current directory or in your path. The path can be specified with the SETASYNCH command in your user profile.
It is recommended that you use the HOSTS command with third-party terminal emulation software that supports only Interrupt 14 or Interrupt 6B.
The EMULATION command determines if the Set Up a Dial-out Connection function is available from the HOSTS command's Select a Connection menu. If a user's profile specifies Banyan Asynchronous Terminal Emulation software for handling the host access, the function is available. Otherwise, the function is not available.
For more information, refer to the Banyan Asynchronous Terminal Emulation Guide.
3270, ASYNCH, EMULATION, SETASYNCH
Initializes the 3270/SNA terminal emulation environment.
I3270 [service-name] [/LU:n] [/PLU:specifier] [/PRINTER:LPTn] [/CLU:n] [/CLU2:n] [/CLU3:n] [/KEYBOARD:filespec] [/ADAPTER:filespec]
The syntax, parameters, and function of I3270 are the same as those of the 3270 command. See the detailed description of the 3270 command for more information, or refer to the VINES 3270/SNA Option Guide.
To activate resident emulation with a hotkey, run the following 3270/SNA programs:
R3270 to load the resident portion of 3270/SNA into workstation memory I3270 to initialize the environment T3270 /RES to load the transient portion
See the VINES 3270/SNA Option Guide for an example.
To set up multiple host sessions, you must specify the switches in the following order:
1. /LU:n
2. Either /CLU:n or /PLU:n
3. /CLU2:n
4. /CLU3:n
Otherwise, you receive only one display session.
3270, R3270, T3270
Executes conditional processing of user profile commands.
IF [WORKSTATION | CONNECTION] [= | NOT=] [workstation-value | connection-value] command
ENDIF
WORKSTATION - Specifies that the condition is based on the type of workstation logged in on the network.
This parameter can be abbreviated WORK.
CONNECTION - Specifies that the condition is based on the type of connection that exists between the workstation and the VINES network.
= - Specifies that the condition is based on equality. The condition is true when the WORKSTATION is equal to the specified workstation-value or when the CONNECTION is equal to the specified connection-value. Do not put any blank space between the = and the parameter value.
NOT= - Specifies that the condition is based on inequality. The condition is true when the WORKSTATION is not equal to the specified workstation-value or when the CONNECTION is not equal to the specified connection-value.
Enter the NOT= parameter as one string without blank spaces.
workstation-value - Specifies the type of workstation logged in on the network:
DOS - DOS and Windows workstations
DOS - DOS workstation
OS2 - OS/2 workstation.
MAC - Macintosh workstation
WIN95 - Windows 95 Workstation (Banyan Enterprise Client for Windows 95 versions 7.32(0) and greater)
ALL - Any of the above workstations. Using this argument is equivalent to executing a user profile command outside of an IF statement.
The "IF WORK=WIN95" statement is only recognized on Banyan Enterprise Client for Windows 95 versions 7.32(0) and greater. Banyan clients still execute all statements contained in an "IF WORK=DOS" block, so that current profiles aill continue to be parsed as expected.
The "IF WORK=WIN95" statement causes error messages during profile parsing if encountered on DOS, OS/2, WIN NT, and earlier versions of the Banyan Enterprise Client for Windows 95. To prevent these errors, prefix the conditional "IF WORK=WIN95" block with the "!*!" string, as in the following example:
-- This block does not need the leading "!*!" string
IF WORK = DOS
statement 1
statement 2
statement 3
ENDIF
-- This block needs the leading "!*!" string to prevent error messages
!*! IF WORK = WIN95
!*! statement 1
!*! statement 2
!*! statement 3
!*! ENDIF
The above "!*! IF" block is not processed on previous versions of Windows 95 clients, including Windows 95 versions prior to 7.32(0).
Macintosh
connection-value - Specifies the type of connection that exists between the workstation and the VINES network:
LAN - Workstation connected to the VINES network over a local area network
DIALIN - Workstation remotely connected to the VINES network over PC Dial-in lines. VINES PC Dial-in, as supported for DOS, is not supported for Windows 95 clients.
ALL - Any of the above connections. Using this argument is equivalent to executing a user profile command outside of an IF statement.
command- Specifies one or more commands to execute if the condition is true. Begin each command on its own line. A command can span more than one line.
ENDIF - Specifies the end of the IF statement. You must end every IF statement with an ENDIF statement. Begin the ENDIF statement on its own line. Any text that follows an ENDIF statement on the same line is ignored. You can follow the ENDIF statement with text that serves as a comment, as long as the text appears on the same line as the ENDIF statement.
IF statements can be issued from within a user profile only. Note that IF statements are not necessary in a user's profile for the user to access resources.
IF statements allocate memory efficiently by allowing conditional processing of user profile commands. When a user logs in to the network, only the resources appropriate to the workstation or the network connection are mapped.
The IF statement first tests the specified condition. If the condition is true, IF executes the specified commands. If the condition is false, IF ignores the specified commands. Commands that appear outside of an IF statement are executed in all conditions.
You can nest IF statements. A user profile can have a maximum of three nested IF statements.
You can nest USE commands within IF statements. IF statements must begin and end within a single profile: they cannot span several profiles.
It is recommended that the SETMAIL command in user profiles appear outside an IF conditional statement. If multiple occurrences of the SETMAIL command appear in a user profile, only the last SETMAIL statement is executed. Similarly, user profile commands that set a service that remains active when the user is not logged in should appear outside of an IF conditional statement. Examples of these are third-party calendar or reminder services.
From any client, you can insert the IF conditional statement in a user profile only if the user's group is on a server running VINES 5.x or greater.
For more information on using IF statements, refer to Planning a Banyan Network and Managing Users and StreetTalk.
MUSER, USE
if work = dos
cd t:\jims\dosstuff
endifif work = dos - The IF statement tests the condition: is the workstation that is logged in to the network a DOS workstation? If the condition is true, IF executes the CD command. If the condition is false, IF ignores the CD command.
endif - The ENDIF statement ends the IF statement.
if work = os2
setdrive o: os2files@17425@servers
setprint lpt1 /p:gr_printer@ArtDept@XYZCorp
endifif work = os2 - The IF statement tests the condition: is the workstation that is logged in to the network an OS/2 workstation? If the condition is true, IF executes the SETDRIVE command and the SETPRINT command. If the condition is false, IF ignores the SETDRIVE and SETPRINT commands.
endif - The ENDIF statement ends the IF statement.
if connection not= dialin
path z:;t:\jims\bin
endif not= dialin
setmsgs /wait:4if connection not= dialin - The IF statement tests the condition: is the workstation not logged in to the network over dial-in lines? If the condition is true, IF executes the PATH command. If the condition is false, IF ignores the PATH command.
endif not= dialin - The ENDIF statement ends the IF statement. The text not= dialin is a comment added by the administrator for readability; it is ignored by the IF statement.
setmsgs /wait:4 - Because the SETMSG command appears outside of the IF statement, the SETMSG command is executed in all conditions.
if work = all
setcolor on 25 17
endifUsing this IF statement is equivalent to executing a SETCOLOR command outside an IF statement. The SETCOLOR command is executed in all conditions.
Enables or disables a workstation's ability to respond to INT 2F requests.
INT2F [state]
state - To emulate the response of the IBM"PC Network Program to the INT 2F function b800 (installation check), type ON. To disable the workstation's response to INT 2F requests, type OFF.
Use this command to control the workstation's response to INT 2F requests while using any application written for the IBM PC Network Program. Some applications require that the response be disabled.
Issuing the INT2F command without the state parameter displays the current setting of the workstation.
If you make a syntax error when issuing INT2F, the command displays on-line help that lists the correct syntax for the command.
Activates the VINES menus for creating keyboard definition files used during 3270/SNA emulation.
KB3270
Use this program to control which 3270 functions are invoked by keys on the workstation keyboard while using VINES 3270/SNA emulation. You can control program attention and program function key mapping, as well as control access to international character sets and on-screen character echo. You can change the 3270/SNA hotkey.
See the VINES 3270/SNA Option Guide for details.
Displays the last three messages received by your workstation.
LASTMSG
The LASTMSG command displays the messages from your current login session. For example, if you have received only one message during your current login session, the LASTMSG command displays only that one message. If you log out and then log in again, the command displays a message stating that you received no messages.
Use the MESSAGES command in Windows.
OS/2
VINES software running on OS/2 workstations supports the LASTMSG command.
MESSAGES, SETMSGS