Prototype
subroutine EcsConnect( string:SessionShortName )
Description
Connects to a specified session.
Parameters
SessionShortName |
Input |
A single character string in the range A to Z denoting the Emulator session to connect. If necessary the string will be converted to uppercase. |
Return Value
ECS_E_NOTINIT |
Not initialized - command was ignored |
ECS_E_SESSNAME |
Invalid session name |
ECS_E_INUSE |
Session is already in use |
ECS_E_ERRORFREE |
No errors were generated |
Example
###********************************
### Action to connect to a session
###********************************
action Connect is
copy text of SessionName_SB in Connect_DB to ShortSessionName_SV
call EcsConnect ( ShortSessionName_SV )
copy errorlevel to ErrorLevel_IV
copy "EcsConnect" to Call_SV
if ( ErrorLevel_IV = ECS_E_ERRORFREE ) then
copy "Connect was successful" to Message_SV
action DisplayMessage
enable item EmulatorChoice in Primary_GR
else
action DisplayError
end if
make Connect_DB invisible
make Connect_DB temporary
