TECHNICAL BULLETIN #191 - Rev 1.00 (9/24/96) ============================================================================== TITLE : ASPECT Command Changes PRODUCT : Procomm Plus 4.x ============================================================================== Procomm Plus 4.0 has followed the standard of its predecessors and expanded upon the ASPECT language base that was begun with PROCOMM PLUS for DOS 2.01. This document discusses the commands that are new to this version. NEW GENERAL COMMANDS DLGEXISTS id [intvar] Sets SUCCESS true if the dialog box with the associated id exists. The optional integer variable is assigned the value of 1 if the dialog exists, or 0 otherwise. $CONNECTOPEN This integer variable returns 1 if a connection is open and zero otherwise. When a connection is open, you can read and write to the communications port provided no other activity (such as a file transfer) prevents it. $NEWSSTATUS (0 idle, 1 busy) An integer that returns 1 when news is being retrieved and zero when the News Client is idle. $COMPANY String variable containing the company name entered during the installation of Procomm Plus. NEW SET/FETCH COMMANDS SET/FETCH MODEM FAXXMIT off | on Specifies whether or not a modem can be used for sending faxes. This command corresponds to the Use this modem/connection to send faxes check box in the Setup, System, Modem Connection dialog. fetch returns 0 for OFF, 1 for ON. SET/FETCH MODEM ACCEPTCALL data | fax off | on Enables or disables auto-answer for data connections. This command corresponds to the Accept data calls check box in Setup, System, Modem Connection. fetch returns 0 for OFF, 1 for ON. SET/FETCH MODEM AUTOANSWER off | pw | other Enables or disables auto-answer for data and fax connections. This command will always return OFF for all "direct connect" connections and .dlc connections like Telnet. This command corresponds to the Incoming call handling for current modem connection option button group in Setup, System, Modem Connection. fetch returns 0 for OFF, 1 for PW or 2 for OTHER. SET/FETCH PORT HARDFLOW off | on Enables or disables hardware flow control, which is sometimes referred to as RTS/CTS flow control. fetch returns 0 for OFF or 1 for ON. SET/FETCH PORT DROPDTR off | on Determines whether Procomm Plus will drop the RS-232 DTR signal to disconnect. Fetch returns 0 for OFF or 1 for ON. SET/FETCH DIAL LOCATION string (DFV) Specifies the location name appearing in the Current Location field in the Setup, System, Dialing Options dialog. fetch returns the current location in a string. SET/FETCH DUPLEX FULL | HALF (D) Switches the duplex setting between full duplex and half duplex. In full duplex, data is not displayed to the screen as it is sent. In half duplex, Procomm Plus displays characters as they are sent. This command corresponds to the Duplex menu item on the Terminal window Data menu. fetch returns 0 for FULL or 1 for HALF. SET/FETCH BREAKLEN integer (0 to 9999 in 10ths of a second) (D) Specifies the amount of time that Procomm Plus issues a break signal when the break command is used. Values range from 0 to 9999 in tenths of a second. fetch returns the break length for the current connection. SET/FETCH WWW ANIMATE off | on Specifies whether the stop sign Action Bar icon should be displayed as an animation or a standard static graphic. This command corresponds to the Animate stop sign on Action Bar field in the Setup Internet, Web Options panel. fetch returns 0 for OFF or 1 for ON. SET/FETCH NEWS PROMPTHEADERS prompt | always Specifies whether Procomm Plus will prompt for header retrieval. This command corresponds to the Prompt if number of headers... field in the Properties panel of the Setup, Internet, News dialog. fetch returns a zero for OFF and a 1 for ON. SET/FETCH DIALENTRY COUNTRY string (DFV) Specifies the contents of the Country edit field for the selected Connection Directory entry. fetch allows an optional string variable which is assigned the dialing code for the current Country selection. This command is valid only for Data, Fax and Voice entries. SET/FETCH LARGEICONS off | on LARGEICONS On determines whether or not the user will see large or small icons on all of their user screens. This command sets large icons on for all the built in utilities. SET/FETCH ASPECT EXITACTION PROMPT | HALT ASPECT EXITACTION determines whether or not the user is prompted to exit all parent scripts, if any, when the current script is stopped when the user presses the running man icon or selects Script Stop from the menu. It also determines whether the user is prompted to exit all active scripts when PW is shutdown. The default action is PROMPT which displays a message box prompt to the user. HALT stops all running scripts without prompting the user. This setting is ignored when ASPECT CONTROL is ON. SET/FETCH ASPECT CTRLBREAK OFF | ON SET ASPECT CTRLBREAK ON allows a Ctrl-Break key pressed while in Terminal or Telnet mode to abort a dead-end command such as PAUSE, WAITFOR, etc. The default setting is ON. (Note: This functionality was separated out from ASPECT CONTROL). NEW DATA COMMANDS COMMANDMODE off | on Switches the modem on the current connection to command mode. This command is equivalent to the Modem Command Mode item on the Terminal window Data menu. It fails for non-TAPI connections, or if the TAPI connection could not be opened. NEW KEYWORDS IN PW4 $COMPANY DLGEXISTS SYSTEMBROWSER $CONNECTOPEN EXITACTION TOOLTIPS $NEWSSTATUS FAXXMIT ACCEPTCALL PROMPTHEADERS ANIMATE LARGEABARS CHECKGROUPS LOCATION COMMANDMODE LOGOFF COUNTRY MULTIPLEWINDOWS CTRLBREAK PW DIALNUMBERONLY SHUTDOWN REMOVED ASPECT COMMANDS As with all changes or improvements, not everything from the previous version is still applicable in the new version. ASPECT has lost some of its commands in the development cycle from PROCOMM PLUS (3.0) to Procomm Plus (4.0) SYSTEM CONNECTION SET/FETCH STATEMENTS MODEM PORT port | index | string | NONE MODEM DROPDTR HANGUP of | on MODEM DROPDTR BETWEENCALLS off | on MODEM PACING off | on MODEM S7CMD off | on MODEM SPEAKER VOLUME low | medium | high MODEM SPEAKER MODE off | on | onuntilcd | offdial [string] MODEM DIALSPEED fast | slow | disabled MODEM CALLERID ENABLE string MODEM CALLERID DIABLE string MODEM CALLERID NUMBERPREFIX string MODEM CALLERID NAMEPREFIX string MODEM CALLWAITOFF PREFIX string MODEM CALLWAITOFF SUFFIX string MODEM DISTINCTRING ENABLE string MODEM DISTINCTRING DISABLE string MODEM DISTINCTRING RINGMSG index (`A' to `D') string MODEM DIALCMD TONE string MODEM DIALCMD PULSE string MODEM CMDSUFFIX string MODEM AUTOANSOFF string MODEM DIALCMD SLOW string MODEM DIALCMD FAST string MODEM HANGUP string DIALING OPTIONS SET/FETCH COMMANDS DIAL OPTIONS index | string (Dialing options named table) DIAL AREACODE string DIAL LDPREFIX string DIAL LDLINEOUT string DIAL LOCLINEOUT string DIAL COUNTRYCODE string DIAL INTLPREFIX string DIAL USEPHONECARD string DIAL DIALACCFORLD string DIAL DIALACALWAYS string DIAL METHOD tone | pulse DIAL WAITCNT integer (2 to 255) DIAL CALLWAITING off | on DIAL CALLWAITOFF string DIAL CALLERID off | on (block caller ID) DIAL CALLERIDOFF string DIAL CODE index (`A' to `J') string ANSWER OPTIONS SET/FETCH COMMANDS MODEM DISTINCTRING {ACTION index none | data | fax | datafax} {SCRIPTFILE index filename | none} (index is `A' to `D') PHONE CARD SET/FETCH COMMANDS PHONECARD SERVICENUM string PHONECARD CARDNUM string PHONECARD PINNUM string PHONECARD MISCNUM string PHONECARD DIAL indes (1 to 5) completed | entrynum | servicenum | cardnum | pinnum | miscnum PHONECARD DELAY index (1 to 5) integer (0 to 99) PHONECARD INTLPREFIX string PHONECARD LD PREFIX string PHONECARD DIALACFORLD off | on DATA MODEM CONNECTION SET/FETCH COMMANDS DATA INIT string DATA BAUDRATE baudrate DATA HARDFLOW off | on DATA SENDCR off | on DATA ERRORCORRECT index | current DATA AUTORELIABLE string DATA V42string DATA MNP4 string DATA V23 string DATA NOERRORCORRECT string DATA PROPRIETARY index string (index 1) DATA PROPRIETARY index string (index 2) DATA CNCTMSG LOCKED string DATA AUTOBAUD off | on DATA CNCTMSG baudrate | V23 string DATA NOCNCTMSG index (1 to 5) string PORT SETTINGS SET/FETCH COMMANDS PORT DUPLEX full | half PORT BREAKLEN integer (0 to 999 in 10ths of a second) FAX CONNECTION SET/FETCH COMMANDS FAX CONNECTION index | string | CURRENT | FIRST FAX DROPDTR off | on INTERNET CONNECTION SET/FETCH COMMANDS INTERNET LOGONNAME string INTERNET PASSWORD string INTERNET COUNTRYCODE string INTERNET AREACODE string INTERNET PHONENUMBER string INTERNET SCRIPTFILE filename | NONE INTERNET CALLTYPE internal | local | longdistance | Intl INTERNET DATA CONNECTION index | string INTERNET ERRORCORRECT index INTERNET PHONECARD TYPE index | string | NONE | CURRENT INTERNET PARITY None | Odd | Even | Mark | Space INTERNET DATABITS integer (7 or 8) INTERNET STOPBITS integer (1 or 2) INTERNET PROTOCOL SLIP | PPP INTERNET CSLIPCOMPRESS off | on INTERNET IPADDRESSTYPE Fixed | Dynamic INTERNET IPADDRESS string INTERNET SUBNETMASK string INTERNET GATEWAYADDRESS string INTERNET DNSADDRESS string INTERNET DNSADDRESS ALTERNATE string WWW STYLE SET/FETCH COMMANDS WWW STYLE index |string WWW OPTIONS SET/FETCH COMMANDS WWW HOMEPAGE string WWW MULTIPLECONNECT off | on WWW RMOUSE off | on WWW VIEWGRAPHICS off | on WWW REFORMAT All | Each WWW PAGEUPDATE Never | Once | Always CONNECTION DIRECTORY SET/FETCH COMMANDS DIALENTRY CALLTYPE Internal | Local | Longdistance | Intl DIALENTRY COUNTRYCODE string REMOVED SYSTEM VARIABLES $PWTCPACTIVE (0 or 1 depending on whether the PW TCP stack is actively connected to the Internet.) $DATACONNECT $DIALOPTIONS $FAXCONNECT $INTERNETCONNECT $PHONECARD $WWWSTYLE KEYWORDS IN PW 3.X BUT NOT IN 4.0 $DATACONNECT COUNTRYCODE NUMBERPREFIX $DIALOPTIONS CSLIPCOMPRESS OFFDIAL $FAXCONNECT DATAFAX ONUNTILCD $INTERNETCONNECT DELAY PACING $PHONECARD DIALACALWAYS PAGEUPDATE $PWTCPACTIVE DIALACFORLD PHONECARD $SFILENAME DIALCMD PINNUM $WINMODE DIALSPEED PPP $WINVER DISTINCTRING PROPRIETARY $WWWSTYLE DNSADDRESS PULSE ENTRYNUM REFORMAT ALTERNATE ERRORCORRECT RESTART AUTOANSOFF EXPAND RINGMSG AUTOBAUD HIGH S7CMD AUTORELIABLE HOMEPAGE SENDCR BETWEENCALLS ICONLABELS SERVICENUM CALLERIDOFF INTERNAL SHORTPATH CALLTYPE INTLPREFIX SLIP CALLWAITING IPADDRESSTYPE SLOW CALLWAITOFF LDLINEOUT SPEAKER CARDNUM LDPREFIX SUBNETMASK CMDSUFFIX LOCKED SUFFIX CODE LOCLINEOUT TONE COM1 LOW USEPHONECARD COM2 MEDIUM V23 COM3 MISCNUM V42 COM4 MNP4 VIEWGRAPHICS COM5 MNP5 VOLUME COM6 MODE WAITCNCT COM7 MULTIPLECONNECT WWWSTYLE COM8 NAMEPREFIX COM9 NOCNCTMSG COMPLETED NOERRORCORRECT ============================================================================== To ensure that you have the latest version of this document, compare its revision number to that of the same document on any of our support sites. This technical bulletin may be copied and distributed freely as long as it is distributed in its entirety and it is not distributed for profit. Copyright (c) 1996 Quarterdeck All rights reserved. ==============================================================================