Controls services from a workstation.
OPERATE [servername]
servername - Specifies the name of a server that you want to operate. If you do not supply a server name, OPERATE presents a list of servers from which to choose.
To use the OPERATE command to alter server operation, your name must be in either AdminList@servername@Servers, where servername is the name of the server you want to control or in AdminList@exact-group@org, where exact-group@org is the group in which the service you are operating resides.
The OPERATE command displays menus that allow you to perform these control functions at a server:
MANAGE server logs
DISPLAY server resource usage
RESTRICT user or internetwork access to a server
When you select a service, you can perform the following functions:
START or STOP a service
DISPLAY service status
CONTROL a printer or print queue
CONFIGURE a communications or print service
GENERATE a log report
SPECIFY log message types
LOOK at service users
For more information, refer to Banyan Server Operations Guide.
OS/2
VINES software running on OS/2 workstations supports the OPERATE command.
MSERVICE
Changes a user's password.
PASSWORD
This command works only on the password for the user who is logged in. Administrators can prevent users from being able to change their passwords.
For more information about managing passwords, see Managing VINES Security.
OS/2
VINES software running on OS/2 workstations supports the PASSWORD command.
For more information about using the PASSWORD command, see the User's Guide for DOS and OS/2.
LOGIN, LOGOUT
Activates the menus of the Patch utility, which allows you to control and monitor the patch levels of multiple servers in a network.
PATCH [servername] [/P:pathname] [/L:loglevel]
servername - Specifies the name of the server on which you want to install the patch.
/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 this 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.
/L:loglevel - Specifies the level of logging that goes to the log file, PATCHLG, that is created on your C: drive when you invoke PATCH. The default is Level 2. Level 1 means that no logging will occur. Levels 3, 4, and 5 are for debugging purposes only. Do not use these levels unless instructed to do so by a support person. Each level is more verbose than the preceding level. Levels 4 and 5 are secure in that each write to the log file buffer is immediately written to disk.
If a PATCHLG file already exists on your C: drive, the logging information is appended to that file. If you do not have a C: drive, logging is turned off.
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.
If the drive is a diskette drive, you can apply one patch only. If the drive is a local fixed disk or a network drive, you can select and order multiple patches in a patch set. You can also select multiple servers to which the patch set will be applied. The patch utility runs on the server as a scheduled task.
When you access the Patch utility, a menu displays that lets you choose from the following options:
Install patches
Display patch history
Display pending patches
Cancel pending patches
For more information about using the PATCH utility, see Banyan Server Operations Guide.
BPATCH, PHIST
Sets parameters used by a workstation at login time.
PCCONFIG
Use PCCONFIG to customize a VINES diskette for a specific LAN card or communications port at the workstation.
When you access PCCONFIG, a menu displays that lets you choose from the following configuration options:
Network Card Settings - Presents a list of available LAN card drivers. You can select and set the configuration screen for individual cards.
Login Environment Settings - Lets you select a default communications driver, change or view the login group searchlist, and set the maximum number of network file volumes, open files, Netbios sessions and Netbios commands
Special Software Settings - Lets you load resident Netbios emulation software, load extended resident StreetTalk calls, set a network software interrupt number, and load Named Pipe Support Software.
Communications Settings - Lets you configure special communications settings, including the size of communications buffers, the maximum number of communications sockets, and the maximum number of open SPP (Sequenced Packet Protocol) connections.
Follow the directions displayed at the screen. On-line help is available when you press F1.
Because PCCONFIG writes to the file PCCONFIG.DB, your current directory must contain the file. If the PCCONFIG.EXE program is not on your boot diskette, you can run it from the VINES Files directory (drive Z), regardless of whether you are logged in. Your VINES workstation files and the PCCONFIG program must have the same VINES software revision.
The PCCONFIG program supports Named Pipe applications. For full support of Named Pipe applications on workstations running DOS, you must use PCCOPY to copy a Named Pipe redirector (REDIRNP4) to the boot device of your workstation. This redirector includes Named Pipe software in addition to the standard VINES network software. For details on using Named Pipe applications with OS/2 workstations, see the section on OS/2 workstations in Managing Workstations.
When the workstation boots, settings controlled by PCCONFIG are loaded into workstation memory. Therefore, when you change settings, you must reboot the workstation.
You can use PCCONFIG to enable source-level routing at your workstation. See Managing Workstations for details. Refer to the VINES Token-Ring Bridge Option Guide if you have purchased that option.
For more information about using the PCCONFIG command, see Managing Workstations.
OS/2
Note that some of the functions of the PCCONFIG program do not apply to OS/2 workstations. For details on using the PCCONFIG program for OS/2 workstations, see Managing Workstations.
BAN, NEWREV, PCCOPY, PCNETB
Copies VINES Files to a workstation diskette or fixed disk.
PCCOPY
PCCOPY lets you create a VINES diskette for your workstation's specific type of communications hardware.
The PCCOPY menu allows to you to select combinations of the following types of files to copy:
PCCONFIG files - Files that describe the values set in the PCCONFIG program for the station at which the PCCOPY command is executed
PC Dial-in files - Files required to configure a workstation for use with a modem
Redirector file - DOS redirector, version-specific or REDIR.ALL
LAN drivers - VINES native and interface drivers
LAN diagnostic - Diagnostics programs for LAN cards
The first screen of the program allows you to select from the following options:
Copy PC Configuration Software and/or LAN Drivers
Copy LAN Driver Diagnostics Only
Copy Redirector Only
If you select the first option, you activate another screen that allows you to select one or more of the following items in any combination:
PC configuration software
PC Dial-in software
LAN drivers
LAN drivers and their diagnostics files
Once you have made your selections, press F10. PCCOPY sets the default communications driver to the first LAN card or modem software you selected. The default communications driver is stored in PCCONFIG.DB and is loaded by the BAN command when the workstation boots.
The next screen allows you to select a redirector file. Follow the instructions displayed on the screen. The file you should select depends on which DOS version is loaded in workstation memory and whether you are using an application that uses the Named Pipe application interface.
The redirector files are listed as follows:
REDIRALL.EXE - Supports DOS versions 4.x and greater
REDIR4.EXE - Supports DOS version 4.x and greater
REDIRNP4.EXE - Supports DOS versions 4.x and greater and supports the Named Pipe application interface114
The redirector files vary in size. Each file is made up of a code segment and a data segment.
The REDIRALL.EXE redirector takes up more memory but supports all the versions of DOS that the individual redirectors support together. Individual redirectors take up less memory, but you must make sure that you have the appropriate individual redirector for your DOS revision. You may select more than one redirector. Individual redirectors are invoked before the REDIRALL.EXE redirector.
Before upgrading to another version of DOS, make sure that you have either the REDIRALL.EXE file or the appropriate individual redirector file on your VINES boot disk or diskette.
The next screen prompts you to select a destination drive and pathname to which your selections will be copied. Follow the instructions displayed at the screen. You can copy your selections either to a blank diskette, formatted with DOS boot files, or to a directory on a fixed disk. Since the diskette cannot hold all the software available from PCCOPY, select only the LAN card software or modem software you require.
For more information about using PCCOPY, see Managing Workstations.
Windows
If you run PCCOPY from a DOS window in Windows, and you receive an error statement indicating that the drive is not ready, the DOS window enlarges to a full screen. To return to the window, press ALT-ENTER.
OS/2
To copy VINES Files to an OS/2 workstation diskette, use the VCLIENT command.
BAN, PCCONFIG, REDIRx, VCLIENT
Loads the resident portion of VINES NetbiosTM protocol support software into workstation memory.
PCNETB [/SES:n] [/CMD:n] [/PKT:n] [/NAM:n]
/SES:n - Specifies the maximum number of concurrent sessions (n) that the user can have at one time. The number n must be in the range 1 through 100 (6 is the default).
/CMD:n - Specifies the maximum number of commands (receive requests, etc.) that the user can have outstanding at any one time. The range for n is 1 through 100 (12 is the default).
/PKT:n - Specifies the size of packets, in bytes (n), transferred over sessions. The number n must be in the range 400 through 5600 (400 is the default).
Applications that transfer large amounts of data over Netbios sessions may achieve better throughput with larger packet sizes. However, increasing the packet size increases the amount of memory required for each Netbios session and may not be practical for applications that use a large number of sessions.
The /PKT switch affects the packet size for transmitted session data only. To increase throughput in both directions, change the packet size on both workstations involved in the session.
/NAM:n - Specifies the maximum number of local names (n) that the user can add. The number n must be in the range 1 through 100 (16 is the default).
Before you can run a program that uses the Netbios protocol, you must load the resident portion of the Netbios protocol emulation software into workstation memory. You also can use PCCONFIG to load the resident software instead of using this command. For details, see Managing Workstations.
The number of Netbios sessions and Netbios commands are configurable. If you choose to have PCNETB loaded automatically for you when you log in (through PCCONFIG), you change the default number of sessions and commands by selecting Login Environment Settings from the menu and modifying Maximum Netbios sessions and Maximum Netbios commands. If you choose to load PCNETB yourself, you need to provide the /CMD and /SES switches on the command line to change the default settings.
To modify the maximum number of local names or the packet size used for sessions, you must load PCNETB from the command line, using the /NAM and /PKT switches. These values are not currently configurable through PCCONFIG.
After the PC-resident software is loaded (with either PCNETB or the PCCONFIG settings), use the SETNETB command to access a Netbios service.
For more information, see Managing Workstations.
PCCONFIG, SETNETB
pcnetb /ses:6 /cmd:12
pcnetb - Loads the resident portion of VINES Netbios protocol support software into workstation memory.
/ses:6 - Specifies that the user can have up to 6 concurrent sessions.
/cmd:12 - Specifies that up to 12 commands can be outstanding at once.
Establishes a connection between a print service and a workstation-based network printer.
For parallel printers:
PCPRINT service-name [LPTn] [HOTKEY:x] [D:n] [R:n]
For serial printers:
PCPRINT service-name COMm[:baud [,parity [,databits [,stopbits]]]] [HOTKEY:x]
For serial printers on OS/2:
PCPRINT service-name COMm
Because OS/2 does not support TSRs, the hotkey is not supported in the first two of the above formats for parallel or serial printers. In addition, you set the baud, parity, databits, and stopbits when you install the printer by configuring them through the OS/2 operating system.
service-name - Specifies the StreetTalk name of the print service.
LPTn - Identifies a parallel printer port, where n is 1, 2, or 3. LPT1 is the default.
COMm - Identifies a serial printer port, where m is 1, 2, 3, or 4. COM1 is the default.
baud - Specifies that the line speed can be 9600 (the default), 4800, 2400, 1200, 600, 300, or 110 baud.
parity - Defines parity, where the value can be EVEN (the default), ODD, or NONE.
databits - Specifies the number of bits used to represent each character of data, where the number can be 7 (the default) or 8.
stopbits - Specifies the number of bits used to indicate the end of the serial transmission, where the value can be 1 (the default value) or 2.
HOTKEY:x - Defines the hotkey, where x can be any letter from A through Z and works in conjunction with the ALT key. The default hotkey is ALT-P. The hotkey displays the status of jobs sent over PCPRINT connections.
D:n - Specifies a time delay, during which PCPRINT waits before checking the status of an initializing parallel printer. The time delay, n, is a number from 1 to 65535.
PCPRINT sends reset signals to initialize a parallel printer and set up the connection between them. PCPRINT waits for the amount of time specified by the time delay, and then checks the status to determine if the printer initialized properly. If PCPRINT does not wait long enough before checking the status, the connection between PCPRINT and the printer may not set up properly. The D:n switch can increase the expected time of delay between the reset signal and the status check, giving the printer more time in which to initialize after the signal is sent. Enter a number, n, from 1 to 100. The default value, 15, translates to an approximate two-second to four-second delay.
If you use the D:n switch with the R:n switch, the D:n switch must precede the R:n switch on the command line. Both switches may be used with other PCPRINT switches on the command line.
R:n - Specifies the amount of CPU time given to PCPRINT tasks, where n is a number from 1 to 65535. The default value of 1 is appropriate for most workstations running PCPRINT. The more CPU time you give to PCPRINT, the better its runtime performance, at the expense of other applications running on the workstation. You may want to increase the value if the workstation is devoted solely to running PCPRINT.
If you want to give more CPU time to PCPRINT and do not know how much of an increase to make, experiment with small incremental increases until you are satisfied with the result.
If you use the D:n switch with the R:n switch, the D:n switch must precede the R:n switch on the command line. Both switches may be used with other PCPRINT switches on the command line.
The PCPRINT program is an option that must be purchased separately.
PCPRINT supports up to seven printer ports, depending on the workstation configuration: three parallel ports and four serial ports. You can specify only one print service each time you issue the PCPRINT command.
To run the PCPRINT program, you must be logged in with a StreetTalk name that is listed with the other attributes configured for the destination. See your administrator for assistance.
If you execute PCPRINT from a DOS batch file that contains a LOGOUT command, it is recommended that you insert the DOS PAUSE command before the LOGOUT command to allow PCPRINT to initialize properly. When the command processor encounters the PAUSE command, the system halts the batch file and instructs you to press any key to continue.
If PCPRINT consistently fails to initialize, you may want to increase the delay switch (D:n) value from the default to a value that will give you desirable results. Note that if the delay value is too small, the connection between PCPRINT and the printer may not set up properly.
To display command usage, use PCPRINT without parameters.
For more information about PCPRINT, see Managing VINES Services.
OS/2
VINES software running on OS/2 workstations supports the PCPRINT program. For details on using the PCPRINT program for OS/2 workstations, see Managing Workstations.
SETPRINT
pcprint pcprinter@sales@corp lpt1 hotkey:u D:30 R:50
pcprinter@sales@corp - Establishes a connection between a PCPRINT program and the print service, pcprinter@sales@corp. The service routes print jobs to the PC where the PCPRINT program is running.
lpt1 - Specifies that jobs print at a parallel printer on port lpt1.
hotkey:u - The hotkey ALT-U displays the status of jobs sent over PCPRINT connections.
D:30 - Sets the time delay between the reset signal and the status check to 30 (an approximate 10-second delay), giving the printer more time in which to initialize after the reset signal is sent.
R:50 - Sets the amount of CPU time given to PCPRINT tasks to 50, to improve runtime performance on the workstation that is devoted solely to running PCPRINT.
pcprint pcprint@finance@inc com1:1200,odd hotkey:t
pcprint@finance@inc - Establishes a connection between a PCPRINT program and the print service, pcprinter@finance@inc. The service routes print jobs to the PC where the PCPRINT program is running.
com1:1200,odd - Specifies that jobs print at a serial printer on port com1. The line speed is set to 1200 baud, and the parity is set to odd.
hotkey:t - The hotkey ALT-T displays the status of jobs sent over PCPRINT connections.
Displays the patch history of a server in a network.
PHIST servername [/F]
servername - Specifies the StreetTalk name of the server on which you want a patch history.
/F - Specifies that you want the verbose version of the server patch history. This version contains a description of each patch name applied.
You do not need administrative rights to a server to display its patch history.
If the server you specify is running a version of VINES prior to 5.00, the verbose version of the patch history is the only version returned.
When the PHIST command executes, patch history information is displayed on the screen. To redirect these messages, enter the greater-than symbol (>) followed by a redirected filename on the PHIST command line.
BPATCH, PATCH
Executes a batch file or executable file from the user profile after completion of the login process.
For DOS users:
POSTLOGIN [/DOS] [/LOGOUT] [filespec] [[/C] parms]
For OS/2 users:
POSTLOGIN [/OS2] [/LOGOUT] [filespec] [[/C] parms
For WIN95 users:
POSTLOGIN [/WIN95] [/LOGOUT] [filespec] [[/C] parms]
/DOS - Specifies that the file is executed when the user logs in from the DOS environment.
/OS2 - Specifies that the file is executed when the user logs in from the OS/2 environment.
/WIN95 - Specifies that the file is executed when the user logs in from the WIN95 environment.
/LOGOUT - Specifies that the user is logged out automatically if the .EXE or .COM file (filespec) fails to execute.
filespec - Specifies a valid executable file. If you omit the filespec extension, either the .COM or the .EXE extension is assumed automatically. If you omit the drive or path designators, the POSTLOGIN command uses the search path of the last PATH command executed.
/C - Specifies that the parms argument following this switch is a command or batch file that uses the command interpreter specified by filespec.
parms - Supplies a parameter or list of arguments to the executable file, filespec.
The POSTLOGIN command can be issued from within a user profile only. POSTLOGIN enables administrators to specify the name of the .EXE or .COM file to be run immediately after completion of the login process. In this way, users can log in and start working with a menu system or with an application immediately, instead of typing a command at the DOS or OS/2 command prompt.
You can create a user profile with multiple POSTLOGIN commands using DOS, OS/2, and WIN95 switches. In this way, the same user profile can be used on DOS, OS/2, and Windows 95 workstations. Commands that are not relevant in the current operating system are ignored. If you include a USE command in a user's profile, additional POSTLOGIN commands can be associated with the user. The additional commands reside in the user profile specified with the USE command.
If you specify the POSTLOGIN command without the /DOS, /OS2, or /WIN95 switch, the command attempts to run, regardless of which operating system is loaded. If you have multiple POSTLOGIN commands without any switch in your user profile, only the last of the un-switched commands are processed.
As an option, administrators can specify that VINES is to log the user out of the network automatically if the .EXE program or the .COM program fails for any reason.
To execute a .BAT file, specify either the DOS command interpreter, COMMAND.COM, or the OS/2 command interpreter, CMD.EXE, as the filespec and use the /C switch as a parms parameter. The argument following /C is a command or a filename that is executed by the command interpreter.
For DOS and OS/2 clients with multiple POSTLOGIN commands in a user profile, only the last POSTLOGIN command is processed.
If you have multiple POSTLOGIN commands with the /WIN95 switch in your user profile, all of the POSTLOGIN commands with the /WIN95 switch are processed.
The Windows 95 client supports up to 10 POSTLOGIN commands. The following switch options can be used with /WIN95:
/MIN - Runs the application in a minimized window
/MAX - Runs the application in a maximized window.
/HIDE - Runs the application as a hidden process.
/D:secs - Causes a delay of 'secs' seconds before the next POSTLOGIN command is executed.
/WAIT - Delays execution of the next POSTLOGIN command until the current POSTLOGIN command has finished. This ensures that a series of commands does not execute out of sequence. Login will not complete until the last command with a wait switch has been completed.
The above WIN95 parameters may cause error messages when logging in from DOS or OS/2 workstations. These errors should be ignored.
See Managing Users and StreetTalk for more information.
IF ... ENDIF, LOGIN, LOGOUT, MLOGOUT, USE
postlogin newmenu 1
newmenu - Specifies that the .COM or .EXE file newmenu be executed after login.
1 - Passes the value of 1 to newmenu as a parameter, such as a menu choice.
postlogin /DOS /logout f:\admin\batch\dos\spreadsh.exe
/DOS - Specifies that the executable file be executed after login from the DOS environment.
/logout - Specifies that if the file fails to execute for any reason, the user is logged out and returned to DOS.
f:\admin\batch\dos\spreadsh.exe - Specifies the pathname of the executable file spreadsh.exe to be executed after login
postlogin /OS2 cmd.exe /c f:\admin\batch\os2\spreadsh.cmd
/OS2 - Specifies that the batch file be executed after login from the OS/2 environment.
cmd.exe - Specifies the OS/2 command interpreter CMD.EXE.
/c - Specifies that the rest of the line is a batch file to be executed by the command interpreter.
f:\admin\batch\os2\spreadsh.cmd - Specifies that the batch file spreadsh.cmd be executed after login.
With the commands shown in Example 2 and Example 3, a user can log in and start using the appropriate DOS or OS/2 version of a spreadsheet application immediately, regardless of which operating system is loaded when the user logs in.
Loads the resident portion of the 3270/SNA terminal emulation option into workstation memory.
R3270 [/NUMLUS:n]
/NUMLUS:n - Limits the amount of memory used by the R3270 program, where n specifies the number of concurrent sessions the user can have, and therefore, the bytes of memory the program can use. Each session takes up 5K of memory.
If you issue the R3270 command without this switch, the default (and maximum) number of sessions you can request is 4.
The R3270 and T3270 programs make up the 3270/SNA terminal emulation option. R3270 can also be used by file transfer programs to transfer files between the host computer and workstations on a VINES network.
If you want to exit from emulation and hold sessions, run the R3270 command first.
For more information, see the VINES 3270/SNA Option Guide.
3270, I3270, REL3270, SET3270, SNACFG, T3270
r3270 /numlus:1
r3270 - Limits the number of concurrent sessions to 1.
/numlus:1 - Loads the resident portion of the 3270/SNA terminal emulation option into workstation memory.
Loads Asynchronous Terminal Emulation software into workstation memory.
RASYNCH [/C:connection] [/S:service-name]
/C:connection - Specifies the name of the connection that third-party software uses to establish a session with the host computer, as defined by your administrator. If the name contains a blank character, enclose the name in double quotation marks.
/S:service-name - Specifies the StreetTalk name of the Asynchronous Terminal Emulation service associated with the connection. If the name contains a blank character, enclose the name in double quotation marks.
The RASYNCH command lets you exit emulation while maintaining a session with the host computer. Use this command from DOS before you enter either Banyan Asynchronous Terminal Emulation or third-party emulation. This action allows you to exit emulation without breaking the connection and to later return to that same connection.
You must use the RASYNCH command with the /C and /S switches if you run third-party terminal emulation software that uses Interrupt 14 or
Interrupt 6B. The /C and /S switches specify a connection to the host computer that the third-party software uses to establish a session. Note that you do not have to use these switches if you also intend to use the ASYNCH command. If you use both the ASYNCH and the RASYNCH commands with the /C and /S switches, the ASYNCH command overrides the RASYNCH switches.
If you run Banyan Asynchronous Terminal Emulation software, use the Action Menu to exit terminal emulation while maintaining the connection to the host. To re-enter terminal emulation, type the ASYNCH command from DOS. The program returns to terminal emulation in the same host session as the one suspended earlier.
If you run third-party terminal emulation software, you may be able to use a hotkey to exit terminal emulation while maintaining the connection. See the third-party documentation for details.
Note that when you exit a third-party terminal emulation software program, the connection to the Asynchronous Terminal Emulation service is maintained. As a result, you will be tying up the line. To end the connection with the host, use RASYNCH without switches. (If the connection has already been broken, running RASYNCH again produces a message indicating that RASYNCH is already resident.) Or, use RASYNCH with the /C:connection and /S:service-name switches to close the connection with the host and set a new connection and service name. You can then re-enter terminal emulation (using third-party software) using the new settings.
To release RASYNCH from memory, type RELASYNC from DOS. The RELASYNC command can be used only if you have not loaded another program after RASYNCH. This restriction prevents memory fragmentation and allows DOS to load another program in that area of memory, thereby giving that program free use of the rest of memory.
For more information, refer to the Banyan Asynchronous Terminal Emulation Guide.
ASYNCH, HOSTS, RELASYNC, TASYNCH
rasynch /c:"the vax" /s:vax@ate@corp pcterm
rasynch - Loads Asynchronous Terminal Emulation software into workstation memory.
/c:"the vax" - Specifies the connection the vax. Double quotation marks surround the connection name because it contains a blank character.
/s:vax@ate@corp pcterm - Specifies the service vax@ate@corp.
pcterm - Activates a third-party terminal emulation program that uses Interrupt 14 (excluding the .COM or .EXE extension), and establishes a session with a host computer.
Activates the menus for the REBOOT command, which allows you to reboot a server from a workstation.
REBOOT servername
servername - Specifies the StreetTalk name of the server you want to reboot.
In order to use the REBOOT command, you must be a member of the list AdminList@servername@servers.
The REBOOT command displays menus that allow you to perform the following functions from a workstation:
Schedule a reboot
Show time of a pending reboot
Abort a pending reboot
Show the reboot status log
The REBOOT command does not reboot a target server that is running VINES revision 5.00 or earlier.
For more information on the REBOOT command, refer to Banyan Server Operations Guide.
Loads the VINES DOS redirector into workstation memory.
REDIRx [/A:address] [/C:address] [/D:address] [/E] [/H]
REDIRx - Specifies one of the five versions of the redirector command, depending on the version of DOS loaded in workstation memory and whether you are using an application that uses the Named Pipe application interface. The redirector files are listed below:
REDIRALL.EXE - Supports DOS versions 3.x and greater
REDIR4.EXE - Supports DOS version 4.x and greater
REDIRNP4.EXE - Supports DOS versions 4.x and greater and supports the Named Pipe application interface
The redirector files vary in size. Each file is made up of a code segment and a data segment.
/A:address - Moves the entire redirector to an area of upper memory (the area from 640 KB to 1 MB) that begins at an address specified by the address argument. The memory address is a hexadecimal number from A000 to FFFF.
/C:address - Moves the code segment of the redirector to an area of upper memory (the area from 640 KB to 1 MB) that begins at an address specified by the address argument. The memory address is a hexadecimal number from A000 to FFFF.
/D:address - Moves the data segment of the redirector to an area of upper memory (the area from 640 KB to 1 MB) that begins at an address specified by the address argument. The memory address is a hexadecimal number from A000 to FFFF.
You can use either or both of the /C and /D switches. If you use only one of these switches, the unmoved segment of the redirector remains in low memory.
/E - Specifies that the high-memory area (the area that extends 64 KB beyond 1 MB) is always enabled. It is recommended that you use the /E switch with the /H switch unless performance is adversely affected.
/H - Specifies that the redirector should access the high-memory area, and moves the code segment of the redirector to the high-memory area (the area that extends 64 KB beyond 1 MB). The data segment of the redirector remains in low memory. You do not need to specify a starting memory address with this switch.
This switch is intended for DOS version 4.x. If your workstation is running DOS 5.0 or greater, do not use the /H switch.
Do not use the /H switch with the /A switch or the /C switch.
The redirector accepts file and print requests from users and from user applications and directs them to the network.
Running VINES client software and user applications simultaneously can exhaust the low memory of the workstation. Use the REDIRx command switches to relocate segments of the redirector from the low-memory area of DOS (the area from 0 KB to 640 KB) to the upper-memory area (the area from 640 KB to 1 MB) or the high-memory area (the area that extends 64 KB beyond 1 MB).
For more information on the REDIRx command, see Managing Workstations.
BAN, PCCOPY
redir4 /a:c8e7
/a:c8e7 - Moves the entire REDIR4 redirector into the high-memory area beginning at address C8E7.
redir4 /c:c8e7 /d:d2e8
/c:c8e7 - Moves the code segment of the REDIR4 redirector into the high-memory area beginning at address C8E7.
/d:d2e8 - Moves the data segment of the REDIR4 redirector into the high-memory area beginning at address D2E8.
Releases the R3270 program (and the T3270 program, if resident) from memory if it was the last program loaded into memory.
REL3270
This command can be used only if the R3270 program was explicitly made resident by the AUTOEXEC.BAT file or from the DOS prompt.
Do not use this command if the R3270 program was not the last resident program loaded into memory. DOS may try to use the released space incorrectly. As a result, the next program loaded into memory may not execute correctly.
If R3270 was not the last program loaded into memory, turn off or reboot the workstation to release memory.
For more information, see the VINES 3270/SNA Option Guide.
3270, R3270, T3270
Releases terminal emulation software made resident in workstation memory after either the BASYNCH or the RASYNCH command has been issued.
RELASYNC
This command can be used only if Asynchronous Terminal Emulation software was made resident by either the BASYNCH or the RASYNCH command.
Do not use this command if the Asynchronous Terminal Emulation software was not the last resident program loaded into memory. If another program was loaded into memory after the BASYNCH or the ASYNCH command, either remove the other program, or reboot the workstation to release memory.
See the Banyan Asynchronous Terminal Emulation Guide for more information.
BASYNCH, RASYNCH
Outputs StreetTalk information or user access information to an ASCII file.
For reports of StreetTalk information:
REPORT [STREETTALK [/GROUP:groupname [/SERVER:servername [/OUTPUT:filename]]]] [/?]
For reports of user access (UA) information:
REPORT [UA [/PATH:pathname /OUTPUT:filename]] [/?]
STREETTALK - Allows you to generate a report about the network resources you have defined with StreetTalk. This parameter allows you to bypass the VINES menus.
/GROUP:groupname - Specifies the name of one or more groups, or a StreetTalk pattern on which to base the report.
/SERVER:servername - Specifies the name of the server on which you want StreetTalk activity reported.
/OUTPUT:filename - Specifies the name of the file to which you want the report written.
UA - Allows you to generate a report about the access rights list and the attributes you have defined for a directory or file. This parameter allows you to bypass the VINES menus.
/PATH:pathname - Specifies the directory or file for which information is required. You can use DOS wildcards (? and *) to generate a report for several files in a directory.
/? - Displays command syntax and optional parameters of the REPORT command.
The REPORT command produces printable ASCII files that contain the information you specify.
If you specify REPORT with no parameters, you activate the menus for the REPORT command.
If you specify REPORT STREETTALK with no switches, you are prompted for a filename. The resulting StreetTalk report includes all StreetTalk groups on all servers.
If you specify REPORT UA with no switches, you are prompted for the directory or filename to which you want the report written.
If you specify a group name without an organization, the default is the current organization.
For more information on StreetTalk reports, refer to Managing VINES Security. For more information on User Access reports, refer to Chapter 6 in Managing VINES Security.
OS/2
VINES software running on OS/2 workstations supports the REPORT command.
MGROUP, MORG, MSERVICE, OPERATE, SETARL, SETATTR
report streettalk /server:finance /output:finrep
streettalk - Specifies a StreetTalk report.
/server:finance - Obtains StreetTalk information from the finance server.
/output:finrep - Outputs the StreetTalk information to the file finrep.
report streettalk /group:sales /output:repsales
streettalk - Specifies a StreetTalk report
/group:sales - Obtains StreetTalk information for the group sales.
/output:repsales - Outputs the StreetTalk information to the file repsales.
report ua /path:\acctg\*.new /output:uarep
ua - Specifies a User Access report.
/path:\acctg\*.new - Obtains access rights information and attributes for all the files with the extension .new in the directory acctg.
/output:uarep - Outputs the access rights information and attributes to the file uarep.
Sends a message to another user logged in to a VINES network.
SEND [recipient message]
recipient - Indicates the person or group of people to receive the one-line message. This parameter is specified by one of the following:
StreetTalk name of a user or a list, including the group and organization names if the item is not in the default group. You also can use a nickname. If you specify a list, it cannot contain any other lists. StreetTalk pattern, such as *@Sales@XYZCorp. The asterisk (*) stands for "all," so the message would be sent to everyone in Sales at XYZ Corp. Keyword ALL, which sends the message to all users who share the sender's routing server.
message - Includes a text message of up to 71 characters. Double quotation marks are required if the message contains spaces.
If you type SEND with no parameters, you are prompted for the recipient's name and then the message. In this form of the SEND command, the message does not require quotation marks if it contains blank characters.
Avoid sending to a list that contains another list. If you do, you will receive an error message stating that the recipients are not logged in.
After you enter the first message, it is sent to the recipient and the message prompt is displayed again. To exit the program, press ENTER at the next Message prompt, and again at the To prompt. To exit the SEND program at any time, press CTRL-C. For more information, see the User's Guide for DOS and OS/2.
OS/2
VINES software running on OS/2 workstations supports the SEND command.
Macintosh
The VINES Utilities for Macintosh software includes the Messages application, which allows Macintosh users to send and view messages. For more information, see the VINES User's Guide for Macintosh.
CHAT, LASTMSG, MAIL, MESSAGES, SETMSGS
send janet "Meeting in 10 minutes. - WayneG."
send - User requests to send a message to another user on the network.
janet - Specifies the recipient of the message, Janet (a nickname),
a user in the same StreetTalk group as the sender.
"Meeting in 10 minutes. - WayneG." - Specifies the text of the message. Double quotation marks surround the message because it contains blank characters. The sender included his name within the message text, because the SEND command does not display the sender's name to the recipient.
send
Message Courier
Press ENTER when done.
To: jack wissan@manuf@abcomp
Message: Jack, printer free; start endspool job now. -Jill
Message: ENTER
To: ENTER
send - User requests to send a message to another user on the network.
Message Courier
Press ENTER when done.
To: jack wissan@manuf@abcomp - System prompts for the recipient name and the message.Message: Jack, printer free; start endspool job now. -Jill - User supplies the recipient name and the text of the message. The user omits quotation marks around the message because they are not required in this form of the SEND command. The sender includes her name within the message text, because the SEND command does not display the sender's name to the recipient.
Message: ENTER
To: ENTER - User presses ENTER at both the To prompt and the Message prompt, to exit the SEND program.
Activates 3270/SNA terminal emulation and provides 3270/SNA service from within the user profile.
SET3270 [servicename] [/LU:n] [/PLU:specifier] [/PRINTER:LPTn] [/CLU:n] [/CLU2:n] [/CLU3:n] [/KEYBOARD:filespec] [/ADAPTER:filespec]
SET3270 accepts the same switches and parameters as the 3270 command. See the detailed description of the 3270 command for more information.
With the SET3270 command, you can specify any 3270/SNA service that is available on the network. To use the service, you must have access rights to its logical units.
Any parameters provided by a 3270 command issued from DOS override parameters set by the SET3270 command in the profile. Parameters omitted from the 3270 command use the values set by SET3270 in the profile.
If you use the SET3270 command 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.
See the VINES 3270/SNA Option Guide for more information.
3270, 3270PCKB, HOSTS, I3270, R3270, REL3270, SNACFG
Activates the menus for the Set Access Rights program, which lets you set access rights on directories, subdirectories, and files.
SETARL [DOS-pathname] [/VIEW:file-system] [/?]
DOS-pathname - Specifies the pathname of a DOS directory or a DOS file on a network drive whose access rights you want to manage. To set access rights on a file within your current DOS directory, enter the filename as this parameter. To set access rights on another directory or subdirectory, or on a file in a different directory, enter the complete DOS pathname of the file or directory as this parameter.
If you do not use this parameter, VINES displays the access rights for your current directory.
/VIEW:file-system - Designates the file system view for the directory or file whose access rights you want to manage. The file system views are represented by each file system name, as follows:
VINES - VINES file systems (DOS and OS/2)
MAC - Macintosh file system
If you do not use this switch, VINES displays the VINES file system view.
/? - Displays command syntax and optional parameters of the SETARL command.
One or more of the file system views can be disabled by using the DOS SET VIEWS environmental variable. For instructions, refer to Managing VINES Security.
To manage access rights of directories or files using SETARL, you must be logged in as an administrator of the file service, or as a user who can control the access rights list for the specific directories or files. If you specify SETARL at the DOS prompt with no parameters, the Set Access Rights menu appears and displays the access rights list of your current directory. You can change these settings for the specific directory or change to another directory and manage its access rights.
For more information on SETARL, see Managing VINES Security.
OS/2
VINES software running on OS/2 workstations supports the SETARL command.
Macintosh
The VINES Utilities for Macintosh software includes a utility used to manage access rights. For instructions on how to access the VINES Utilities for Macintosh and manage access rights, see the VINES User's Guide for Macintosh.
SETATTR, SETDRIVE, VFILES
Specifies, from within your user profile, the Asynchronous Terminal Emulation service you want to use with the HOSTS or ASYNCH command.
SETASYNCH service-name [/P:pathspec]
service-name - Specifies the StreetTalk name of the Asynchronous Terminal Emulation service you want to use.
/P:pathspec - Specifies the DOS path specification of drives and/or directories that contain parameter files with the extension .ATP or script files with the extension .ATS.
Use the SETASYNCH command to give users a default Asynchronous Terminal Emulation service in their user profiles. You use the /P switch to set up a default search path for parameter or script files.
The service specified by the SETASYNCH command provides users with all the .ATP and .ATS files in the directories named by the /P switch. Those connections appear on the Select a Connection menu when users execute the HOSTS command. Users then can select connection names associated with a particular service from the menu.
For more information on using SETASYNCH, see the Banyan Asynchronous Terminal Emulation Guide.
ASYNCH, RASYNCH, RELASYNC, TASYNCH
setasynch atelocal@finance@corporate /p:e:\atefiles;e:\
atelocal@finance@corporate - Specifies the service atelocal@finance@corporate is accessed by default when the user executes the HOSTS command or the ASYNCH command.
/p:e:\atefiles;e:\ - Specifies that all files with the extension .ATP or .ATS in the directory \atefiles on drive e, or in the root directory (\) of drive e, appear on the Select a Connection menu.
Displays or changes the attributes of one or more files or directories.
SETATTR [+attribute | -attribute] [DOS-pathnames] [/VIEW:file-system] [/SHOW] [/?]
attribute - Turns on or turns off attributes of a selected file or directory. The attributes are represented by two letters of each attribute name. To turn on an attribute, type a plus sign (+) before the attribute name. To turn off an attribute, type a minus sign (-) before the attribute name.
On a Macintosh system separate multiple attribute switches with a blank character.
DOS-pathnames - Specifies the DOS pathname of one or more directories or files on a network drive whose attributes you want to manage. To set attributes on a file within your current DOS directory, enter the filename. To set attributes on another directory or subdirectory, or on a file in a different directory, enter the complete DOS pathname of the file or directory.
Separate each directory or file from the next with blank spaces. You can use drive letters, pathnames, and DOS wildcard characters (* or ?).
/SHOW - Displays attributes that are currently turned on for a selected file or directory. Attributes that are turned off are not listed.
/? - Displays command syntax and optional parameters of the SETATTR command.
/VIEW:file-system - Designates the file system view (in addition to the VINES view) for the directory or file whose attributes you want to manage. If you do not use this switch, VINES displays the VINES and DOS file system views.
A file system view can be disabled by using the DOS SET VIEWS environmental variable. For instructions, refer to Managing VINES Security.
The file system views are represented by each file system name, as follows:
DOS
DOS - DOS file system
Macintosh
MAC - Macintosh file system
To manage attributes of directories or files using the SETATTR command, you must be logged in as a user who can control the access rights list of the affected directories or files.
When you issue SETATTR with the DOS paths and attribute switches, the command modifies your settings and then displays the updated settings.
If you specify SETATTR with no parameters, the Set Attributes menu appears, displaying the attribute settings of your current directory.
If you make a syntax error when issuing SETATTR, the command displays on-line help that lists the correct syntax for the command.
When you set the DOS Read Only (RO) attribute, VINES sets both RO and No Delete (ND).
The Set Attributes menu displays the current attribute settings. You can change these settings for the specific directory or file listed. Or, you can change to another directory or file and change its settings. Use the following SETATTR functions:
Change path
Edit attributes
Copy attributes
When you change the Sharing attribute for a directory, no existing files are affected; new files in that directory receive that attribute when they are created. To change the Sharing attribute of both existing and new files in a directory, issue the following two SETATTR commands:
SETATTR +SH *.*
SETATTR +SH .
Caution: Valuable data can be lost if you use the Sharing attribute incorrectly. Refer to Managing VINES Security.
For more information on SETATTR, see Managing VINES Security.
OS/2
You can execute the SETATTR command from an OS/2 workstation to modify the attributes of files or directories accessed from DOS workstations. However, do not use the SETATTR command to modify attributes of files or directories that are accessed from OS/2 workstations. Instead, use the DOS and OS/2 ATTRIB command.
SETARL, SETDRIVE, VCOPY, VDIR, VFILES
setattr +ro +nd +nr orgchart.llp e:\public\*.*
+ro +nd +nr - Turns on the Read Only, No Delete, and No Rename attributes for the specified objects.
orgchart.llp - Applies the attributes to the file orgchart.llp in the current directory.
e:\public\*.* - Applies the attributes to all the files in the directory \public on drive e.
setattr e:\public /s
e:\public - Specifies the attributes for all the files in the directory \public on drive e.
/s - Requests a listing of attributes that are currently turned on for the specified objects.
Given the attribute settings applied in Example 1, this SETATTR command displays the listing below.
+RO +ND +NR E:\public\phone.dir
+RO +ND +NR E:\public\pd_hdys.lst
+RO +ND +NR E:\public\employee.hbk