RAS commands

RAS commands
	Knozall AutomationWizard ras_commands.htm RAS Commands for AutomationWizard %System[WinRAS, Dial, PbEntryName, username, password ] %System[WinRAS, Hangup, connid ] %System[WinRAS, Enumconnections ] %System[WinRAS, FreeConnections, connid ] %System[WinRAS, NumConnections, enumid ] %System[WinRAS, ConnectionInfo, enumid, position, conninfo ] %System[WinRAS, Dial, PbEntryName, username, password ] Description Dial and connect to a remote server. Syntax %System[“WinRAS, Dial, PBEntryName, username, password”] Where: PbEntryName: specifies the phonebook entry name username: specifies the username password: specifies the password Returns RAS connection id number (referred to as connid ) which must be used in most RAS calls. failure returns 0 Example %ras = %System["WinRas, Dial, internet, username, password"] %System[WinRAS, Hangup, connid ] Description Hang up a RAS connection Syntax %System[“WinRAS, Hangup, connid”] Where connid: ras connection id Example %tmp = %System["WinRas, Hangup, ", %ras] %System[WinRAS, Enumconnections ] Description Enumerate all active RAS connections. Syntax %System[“WinRAS, Enumconnections”] Returns %$: enumeration id number (referred to as enumid) that must be used in all enum commands or 0 if there are no connections Remarks You must call FreeConnections when you are finished with the results Example %enumid = %System["WinRas, EnumConnections"] %System[WinRAS, FreeConnections, connid ] Description Frees the results retrieved by the Enumconnections command Syntax %System[“WinRAS, FreeConnections, connid”] Where: enumid: enumeration id Example %tmp = %System["WinRas, FreeConnections, ", %enumid] %System[WinRAS, NumConnections, enumid ] Description Returns the number of connections Syntax %System[“NumConnections, enumid Where: enumid: enumeration id Example %numconnections = %System["WinRas, NumConnections, ", %enumid] %System[WinRAS, ConnectionInfo, enumid, position, conninfo ] Description Gets connection parameters retrieved by the EnumConnections command. Syntax %System[“WinRAS, ConnectionInfo, enumid, position, conninfo”] Where: enumid: enumeration id position: start at 0, increment for next connection conninfo: "Does_Exist" $%: returns “Yes” or 1 if there is a connection at position and “No” or 0 if there isn't a connection at position "connid" %: returns connection id of this connection to be used in the other RAS commands "entryname" $: returns the phonebook entry name of this connection Returns Depends on conninfo, always returns "Not_Found" for $ or -1 for % if no more connections left. Example %connid = %System["WinRas, ConnectionInfo, ", %enumid, ", 0, connid"]
		Last updated 11/11/2009 ©2009 Knozall Software, Inc., (800) 333 8698 (520) 426-3859 9386 N. Linnet Road, Casa Grande, Arizona 85294