Gets a Screen object for the specified Management and Control Server (MCS) configuration using the specified userid and password as well as the named configuration.


Namespace: SessionLoader
Assembly: SessionLoader (in SessionLoader.dll)

Syntax

Visual Basic (Declaration)
Public Function requestScreen( _ 
   ByVal userid As String,  _ 
   ByVal password As String,  _ 
   ByVal config As String _ 
) As ScreenUPG
C#
public ScreenUPG requestScreen(
   string userid,
   string password,
   string config
)
C++
public:
 ScreenUPG requestScreen(
   String userid,
   String password,
   String config
) sealed 
J#
public ScreenUPG requestScreen(
   string userid,
   string password,
   string config
)
JScript
public  function requestScreen(
   userid : String,
   password : String,
   config : String
) : ScreenUPG

Parameters

userid
A valid user name defined in MCS. The user must have Management console access permission.
password
The password assigned to the user specified with the userid parameter.
config
A valid configuration defined in MCS for the user.

Return Value

A ScreenUPG

Exceptions

Exception TypeCondition
T:SessionException Thrown if the requested session could not be loaded.

Example

[C#]

 Copy Code
            SessionLoader sl = new SessionLoader();
            ScreenUPG screen;
            
            try
            {
                screen = sl.requestScreen("your_userid", "your_password", "your_config");
            }
            catch (SessionException se)
            {
                // Unable to load MCS configuration
                System.out.println(se.getMessage());
            }
            
[VB]
 Copy Code
            Dim sl As SessionLoader.SessionLoader
            Dim screen as ScreenUPG.ScreenUPG
            
            On error resume next
            
            'Get the SessionLoader
            Set sl = CreateObject("SessionLoader.SessionLoader")
            
            'Get the screen object from the specified MCS configuration
            Set screen = sl.requestScreen("your_userid", "your_password", "your_config") 
            

See Also