Appendix C - ATE Commands Reference
This appendix contains detailed descriptions of all the ATE commands.
Activates asynchronous terminal emulation.
ASYNCH [/S:service-name] [/E:terminal-type] [/C:connection] [/F:parmfile] [/O:pathname]
/C:connection - Specifies the name of the asynchronous connection you want to use. You may use a connection name or an alternate connection name. (An alternate name is another name for the connection that you assign using the Name a Connection screen.) Only the connection names associated with the given StreetTalk name (specified with the /S switch) are available. If the connection name contains a blank character (a space), put the name in double quotation marks.
/E:terminal-type - Allows you to override the emulation terminal type that is set for the connection.
Choose the closest terminal type from the following list:
IBM3101
TTY
VT52
VT100
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.
/F:parmfile - Specifies the file that contains the parameters you want to set for the following functions: communications, terminal settings, data capture, and print settings.
/O:pathname - Specifies the pathname of the executable file associated with the DOS command that invokes the third-party software. It is recommended that you use the /O switch with third-party terminal emulation software that uses only Interrupt 14 or Interrupt 6B. Do not specify the .COM or .EXE extensions. You do not have to specify the full pathname if the executable file is in your DOS search path.
If you use the /C switch with the /O switch, you should specify a connection configured with a terminal type of TTY. If you use the /E switch with the /O switch, the /E switch is ignored.
/S:service-name - Specifies the StreetTalk name of the ATE 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, put 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. SETASYNCH is the user profile command that sets up user access to an ATE service. See the SETASYNCH command entry in "Setting Up Access Through User Profiles" in Chapter 5.
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).
Note that the parameters that are set last may override any of the same parameters set previously.
Loads ATE 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 software specified by the EMULATION command uses the BANV interface to communicate with BASYNCH. To release BASYNCH from memory, use the RELASYNC command.
Specifies whether Banyan ATE software or third-party terminal emulation software handles the interaction between the user and the host.
EMULATION [TASYNCH] [pathname]
TASYNCH - Specifies Banyan ATE 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 the EMULATION command in the user's profile if the user always executes RASYNCH and invokes the third-party program.
The EMULATION command determines if the Set Up A Dial-out Connection menu choice can be used at the HOSTS command's Select A Connection menu. If a user's profile specifies Banyan ATE software for handling the host access, the menu choice is available. Otherwise, the menu choice is not available.
Loads the ATE software into workstation memory. (You then can issue a command to run third-party software.)
RASYNCH [/C:connection] [/S:service-name]
This example shows the sequence of two commands that you issue from DOS to load RASYNCH, run a third- party terminal emulation program (PCTERM) that uses Interrupt 14, and establish a session with a host computer. Do not specify the .COM or .EXE extension of the terminal emulation program.
/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, put the name in double quotation marks.
/S:service-name - Specifies the StreetTalk name of the ATE service associated with the connection. If the name contains a blank character, put the name in double quotation marks.
This command lets you exit emulation while maintaining a session with the host computer. Use this command from DOS before you enter either ATE or third-party emulation. Then, you can exit emulation without breaking the connection and 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 RASYNCH command with the /C and /S switches, the ASYNCH command will override the RASYNCH switches.
If you run Banyan ATE 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 are running 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.
When you exit from a third-party terminal emulation software program, the connection (to the ATE 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 the RASYNCH command with the /C and the /S 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.
Make sure that the connection specified in the RASYNCH command was configured with the TTY terminal type. Consult your administrator.
For third-party terminal emulation software that uses the BANV interrupt, use the BASYNCH command from DOS to make terminal emulation software resident. A previous section describes the BASYNCH command.
Releases terminal emulation software made resident in workstation memory after the BASYNCH or the RASYNCH command has been issued.
RELASYNC
This command can be used only if the ATE software was made resident by the BASYNCH or the RASYNCH command.
Do not use this command if the ATE software was not the last resident program loaded into memory. If another program was loaded into memory after the BASYNCH or ASYNCH command, either remove the other program, or reboot the workstation to release memory.
You will receive the following message, which tells you that the RELASYNC command completed successfully:
Resident asynch software has been removed from memory
Specifies the ATE service you want to use with the HOSTS or ASYNCH command from within your user profile.
SETASYNCH service-name [/P:pathspec]
service-name - Specifies the StreetTalk name of the ATE 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 ATE 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 HOST command. Users then can select connection names associated with a particular service from the menu.
Returns you to a held ATE session.
TASYNCH
You must run RASYNCH first, before you start a session with ASYNCH or HOSTS. Suspend the session and return to DOS, then run TASYNCH to return to the session.
ASYNCH, HOSTS, RASYNCH, RELASYNC