com.attachmate.UPG.common
Interface IScreenUPG


public interface IScreenUPG


Method Summary
 void addIScreenListener(IScreenListener inListener)
          Adds the ScreenListener, which allows your application to receive various screen event notifications, to the Screen object.
 void clearCapturedData()
          Clears information from the captured data buffer by setting it to null.
 void Close()
          Closes the current host session.
 int fieldCount(int Type)
          Returns the number of fields of the specified type.
 boolean findField(int inRow, int inCol, int inMode, int inType, int inWrap, MutableInt outRow, MutableInt outColumn, MutableInt outLength, MutableInt outAttribute)
          Searches the screen for the specified field, beginning from the row and column position specified.
 boolean findFieldEx(int inbeginIndex, int inMode, int inType, int inWrap, MutableInt outRow, MutableInt outCol, MutableInt outLength, MutableInt outAttribute)
          Searches the screen for the specified field, beginning from the index (field number) specified.
 boolean findString(java.lang.String inText, int inStartRow, int inStartColumn, MutableInt outRow, MutableInt outColumn)
          Searches the screen for the specified text string, starting at the specified position.
 boolean findStringEx(java.lang.String inText, int inStartRow, int inStartColumn, int inEndRow, int inEndColumn, int inArea, int inWrap, int inDir, MutableInt outRow, MutableInt outColumn)
          Searches the screen for the specified text string, from the specified start position to the specified end position.
 java.lang.String getCapturedData()
          Returns the currently captured data.
 int getColumns()
          Returns the number of columns in the current presentation space (PS).
 void getCursor(MutableInt outRow, MutableInt outColumn)
          Returns the current cursor position.
 int getCursorColumn()
          Returns the column of the current cursor position.
 int getCursorRow()
          Returns the row of the current cursor position.
 boolean getDataCapture()
          Returns the current state of the data capture facility: true if on; false if off.
 java.lang.String getDescription()
          Returns a custom description for the Screen object, if a description was created previously using setDescription.
 java.lang.String getExtPS(int Row, int Col, int PSLength)
          Returns the specified portion of the presentation space in a string format.
 boolean getgetText_Display()
          Returns the current setting of the getText_Display property.
 boolean getKeyboardLocked()
          Returns the current state of the keyboard: true if locked; false if unlocked.
 java.lang.String getLastError()
          Returns a description of the most recent error that occurred.
 int getMaxDataCaptureLength()
          Returns the current maximum buffer size for data captured using the data capture facility.
 int getObjectVersion()
          Returns the version number of the specified Screen object; for example, 3001000 is equivalent to version 3.1.00.
 java.lang.String getOIAContents()
          Returns the data displayed in the OIA portion (status line) of the screen.
 java.lang.String getOIAText()
          Returns the text of the OIA portion (status line) of the screen in a string format.
 int getRows()
          Returns the number of rows in the presentation space (PS).
 int getScreenType()
          Returns the current host type.
 java.lang.String getString(int inStartRow, int inStartColumn, int inLength)
          Returns the visible text from the specified location.
 java.lang.String getStringEx(int inStartRow, int inStartColumn, int inEndRow, int inEndColumn, int inArea, int inWrap, int inAttr, int inFlags)
          Returns text from the specified location, for attributes matching those specified by inAttr.
 java.lang.String getText()
          Returns the text contents of the presentation space (PS) as a string.
 boolean isConnected()
          Returns the state of the Mainframe connection: true if connected; false if unconnected.
 boolean isKeyboardLocked()
          Returns the state of the keyboard: true if locked; false if unlocked.
 boolean Open()
          Opens a host session.
 int putString(java.lang.String inText, int inRow, int inColumn)
          Copies a string of text to the specified position, returning the number of characters written.
 int putStringEx(java.lang.String inText, int inStartRow, int inStartColumn, int inEndRow, int inEndColumn, int inArea, int inWrap, int inModes, boolean inFill)
          Copies a string of text to the specified position, returning the number of characters written.
 void removeIScreenListener(IScreenListener inListener)
          Removes the ScreenListener from the Screen object.
 void sendKeys(java.lang.String inText, int inType)
          Sends characters and special keys to the host session.
 void setCursor(int inRow, int inColumn)
          Sets the cursor position on the presentation space (PS).
 void setCursorColumn(int CursorColumn)
          Sets the column of the cursor position.
 void setCursorRow(int CursorRow)
          Sets the row of the cursor position.
 void setDataCapture(boolean sDCVal)
          Turns the data capture facility on or off.
 void setDescription(java.lang.String description)
          Creates a custom description for the Screen object.
 void setgetText_Display(boolean gtdvalue)
          Turns the getText_Display property on or off.
 void setMaxDataCaptureLength(int dcl)
          Sets the maximum buffer size for data captured using the data capture facility.
 void waitForCursor(int inRow, int inColumn, int wtTime)
          Waits for the cursor to appear at the specified position, for a specified period of time.
 void waitForString(java.lang.String inText, int inRow, int inColumn, int wtTime)
          Waits for the specified text to appear at the specified position, for a specified period of time.
 void waitHostQuiet(int inSettleTime, int wtTime)
          Waits for the host session to be idle for a specified period of time (in milliseconds).
 

Method Detail

addIScreenListener

public void addIScreenListener(IScreenListener inListener)
Adds the ScreenListener, which allows your application to receive various screen event notifications, to the Screen object. (For use with Java-based programming languages only; for COM-based languages, use addIScreenListenerEx.)
Parameters:
inListener - The screen listener to attach to the Screen object.
Example:
 screenObj = (ScreenType) sl.requestScreen(User,Password,WebView);
 if (screenObj != null)
 {
 screenObj.addIScreenListener(this);
    if (screenObj.Open())
    {
 	     ....//Todo: Place your code here
    }
 } 
See Also:
removeIScreenListener(com.attachmate.UPG.screen.IScreenListener)

clearCapturedData

public void clearCapturedData()
Clears information from the captured data buffer by setting it to null. The data capture buffer allows you to save all information being sent to the presentation space (PS) session to a string.
Example:
m_screenObj.clearCapturedData();
See Also:
getCapturedData(), getDataCapture(), getMaxDataCaptureLength(), setDataCapture(boolean), setMaxDataCaptureLength(int)

Close

public void Close()
Closes the current host session.
Example:
m_screenObj.Close()
See Also:
Open()

fieldCount

public int fieldCount(int Type)
Returns the number of fields of the specified type.
Parameters:
inType - Specifies the type of fields to count. Possible values include: FIELDTYPE_ANY, FIELDTYPE_PROTECTED, and FIELDTYPE_UNPROTECTED.
Returns:
The number of fields found of the specified type.
Example:
int fieldCount = m_screenObj.fieldCount(m_screenObj.FIELDTYPE_PROTECTED);

findField

public boolean findField(int inRow,
                         int inCol,
                         int inMode,
                         int inType,
                         int inWrap,
                         MutableInt outRow,
                         MutableInt outColumn,
                         MutableInt outLength,
                         MutableInt outAttribute)
Searches the screen for the specified field, beginning from the row and column position specified. For example, if you set both inRow and inCol to 1, and set inMode to FINDFIELD_NEXT, it will search for the next field that follows the specified screen position. If the specified field is found, returns true and the field's boundaries.
Parameters:
inRow - The row in which to begin searching.
inCol - The column in which to begin searching.
inMode - The field to look for: current, next, or previous (from the specified row and column position). Possible values include: FINDFIELD_CURRENT, FINDFIELD_NEXT, and FINDFIELD_PREVIOUS.
inType - The type of field to search for. Possible values include: FIELDTYPE_ANY, FIELDTYPE_PROTECTED, and FIELDTYPE_UNPROTECTED.
inWrap - Whether or not to wrap to the top of the screen after reaching the end of the screen. Possible values include: WRAP_ON and WRAP_OFF.
outRow - The row where the field was found. If the field is not found, the value is set to zero.
outColumn - The column where the field was found. If the field is not found, the value is set to zero.
outLength - The length of the field that was found. If the field is not found, the value is set to zero.
outAttribute - A value representing the field attribute bits of the specified field. See Field Attributes for a list of field attributes returned for each host type.
Returns:
True or false. If the field is found, the value is set to true; otherwise it is set to false.
Examples:
Java:

int inRow = 1;
int inCol = 1;
int inMode = m_screenObj.FINDFIELD_NEXT;
int inType = m_screenObj.FIELDTYPE_PROTECTED;
int inWrap = m_screenObj.WRAP_ON;
MutableInt outRow = new MutableInt(0);
MutableInt outColumn = new MutableInt(0);
MutableInt outLength = new MutableInt(0);
MutableInt outAttribute = new MutableInt(0);

boolean fieldFound = m_screenObj.findField(inRow, inCol,
   inMode, inType, inWrap, outRow, outColumn,
   outLength, outAttribute );

ASP (VBScript):

set oRow = CreateObject("Mutable.MutableInt")
set oCol = CreateObject("Mutable.MutableInt")
set oLen = CreateObject("Mutable.MutableInt")
set oAttr = CreateObject("Mutable.MutableInt")
dim inMode
dim inType
dim inWrap
oRow = 0
oCol = 0
oLen = 0
inMode = Session("screenObj").FINDFIELD_NEXT
inType = Session("screenObj").FIELDTYPE_PROTECTED
inWrap = Session("screenObj").WRAP_ON
dim findField

findField  = Session("screenObj").findField (1, 1, inMode,
    inType, inWrap, oRow, oCol,oLen, oAttr)

C++:

int inRow = 1;
int inCol = 1;
int inMode = FINDFIELD_NEXT;
int inType = FIELDTYPE_PROTECTED;
int inWrap = WRAP_ON;
MutableInt_Dispatch outRow;
MutableInt_Dispatch outColumn;
MutableInt_Dispatch outLength;
MutableInt_Dispatch outAttribute;
::CLSIDFromProgID(L"Mutable.MutableInt", &clsid);
outRow.CreateDispatch(clsid);
outColumn.CreateDispatch(clsid);
outLength.CreateDispatch(clsid);
outAttribute.CreateDispatch(clsid);

boolean fieldFound = m_screenObj.findField(inRow, inCol,
    inMode, inType, inWrap, outRow, outColumn,
    outLength, outAttribute );
int x = outRow.getInt();
int y = outColumn.getInt();
See Also:
findFieldEx(int, int, int, int, com.attachmate.common.types.MutableInt, com.attachmate.common.types.MutableInt, com.attachmate.common.types.MutableInt, com.attachmate.common.types.MutableInt)

findFieldEx

public boolean findFieldEx(int inbeginIndex,
                           int inMode,
                           int inType,
                           int inWrap,
                           MutableInt outRow,
                           MutableInt outCol,
                           MutableInt outLength,
                           MutableInt outAttribute)
Searches the screen for the specified field, beginning from the index (field number) specified. For example, if you set beginIndex to 1 and set inMode to FINDFIELD_NEXT, it will search for the second field (the next field following field 1). If the specified field is found, returns true and the field's boundaries.
Parameters:
beginIndex - The index of the field from which to begin searching.
inMode - The field to look for: current, next, or previous (from the specified index). Possible values include: FINDFIELD_CURRENT, FINDFIELD_NEXT, and FINDFIELD_PREVIOUS.
inType - The type of field to search for. Possible values include: FIELDTYPE_ANY, FIELDTYPE_PROTECTED, and FIELDTYPE_UNPROTECTED.
inWrap - Whether or not to wrap to the top of the screen after reaching the end of the screen. Possible values include: WRAP_ON and WRAP_OFF.
outRow - The row where the field was found. If the field is not found, the value is set to zero.
outColumn - The column where the field was found. If the field is not found, the value is set to zero.
outLength - The length of the field that was found. If the field is not found, the value is set to zero.
outAttribute - A value representing the field attribute bits of the specified field. See Field Attributes for a list of field attributes returned for each host type.
Returns:
True or false. If the field is found, the value is set to true; otherwise it is set to false.
Examples:
Java:

int beginIndex = 1;
int inMode = m_screenObj.FINDFIELD_NEXT;
int inType = m_screenObj.FIELDTYPE_PROTECTED;
int inWrap = m_screenObj.WRAP_ON;
MutableInt outRow = new MutableInt(0);
MutableInt outColumn = new MutableInt(0);
MutableInt outLength = new MutableInt(0);
MutableInt outAttribute = new MutableInt(0);

boolean fieldFound = m_screenObj.findField(beginIndex,
   inMode, inType, inWrap, outRow, outColumn,
   outLength, outAttribute );

ASP (VBScript):

set oRow = CreateObject("Mutable.MutableInt")
set oCol = CreateObject("Mutable.MutableInt")
set oLen = CreateObject("Mutable.MutableInt")
set oAttr = CreateObject("Mutable.MutableInt")
dim inMode
dim inType
dim inWrap
oRow = 0
oCol = 0
oLen = 0
inMode = Session("screenObj").FINDFIELD_NEXT
inType = Session("screenObj").FIELDTYPE_PROTECTED
inWrap = Session("screenObj").WRAP_ON
dim findField

findField  = Session("screenObj").findField (1, inMode,
    inType, inWrap, oRow, oCol,oLen, oAttr)

C++:

int beginIndex = 1;
int inMode = FINDFIELD_NEXT;
int inType = FIELDTYPE_PROTECTED;
int inWrap = WRAP_ON;
MutableInt_Dispatch outRow;
MutableInt_Dispatch outColumn;
MutableInt_Dispatch outLength;
MutableInt_Dispatch outAttribute;
::CLSIDFromProgID(L"Mutable.MutableInt", &clsid);
outRow.CreateDispatch(clsid);
outColumn.CreateDispatch(clsid);
outLength.CreateDispatch(clsid);
outAttribute.CreateDispatch(clsid);

boolean fieldFound = m_screenObj.findField(beginIndex,
    inMode, inType, inWrap, outRow, outColumn,
    outLength, outAttribute );
int x = outRow.getInt();
int y = outColumn.getInt();
See Also:
findField(int, int, int, int, int, com.attachmate.common.types.MutableInt, com.attachmate.common.types.MutableInt, com.attachmate.common.types.MutableInt, com.attachmate.common.types.MutableInt)

findString

public boolean findString(java.lang.String inText,
                          int inStartRow,
                          int inStartColumn,
                          MutableInt outRow,
                          MutableInt outColumn)
Searches the screen for the specified text string, starting at the specified position. If the text is found, returns true and the start position of the string.
Parameters:
inText - The text to search for.
inStartRow - The row in which to begin searching.
inStartColumn - The column in which to begin searching.
outRow - The row where the string was found. If the string is not found, the value is set to zero.
outColumn - The column where the string was found. If the string is not found, the value is set to zero.
Returns:
True or false. If the string is found, the value is set to true; otherwise it is set to false.
Examples:
Java:

String inText = "PASSWORD";
inStartRow = 1;
inStartColumn = 1;
MutableInt outRow = new MutableInt(0);
MutableInt outColumn = new MutableInt(0);

boolean stringFound = m_screenObj.findString(inText, inStartRow,
   inStartColumn, outRow, outColumn );

ASP (VBScript):

dim inText
inText= "LOGON"
inStartRow = 1
inStartColumn = 1
set outRow = CreateObject("Mutable.MutableInt")
set outColumn = CreateObject("Mutable.MutableInt")
dim stringFound

stringFound = Session("screenObj").findString(inText, inStartRow,
   inStartColumn, outRow, outColumn )

C++:

MutableInt_Dispatch outRow;
MutableInt_Dispatch outColumn;
::CLSIDFromProgID(L"Mutable.MutableInt", &clsid);
outRow.CreateDispatch(clsid);
outColumn.CreateDispatch(clsid);
CString inText = "LOGON";
int inStartRow = 1;
int inStartColumn = 1;

bool stringFound = m_screenObj.findString((LPCSTR)inText, inStartRow,
    inStartColumn, outRow, outColumn );
int x = outRow.getInt();
int y = outColumn.getInt();
See Also:
findStringEx(java.lang.String, int, int, int, int, int, int, int, com.attachmate.common.types.MutableInt, com.attachmate.common.types.MutableInt)

findStringEx

public boolean findStringEx(java.lang.String inText,
                            int inStartRow,
                            int inStartColumn,
                            int inEndRow,
                            int inEndColumn,
                            int inArea,
                            int inWrap,
                            int inDir,
                            MutableInt outRow,
                            MutableInt outColumn)
Searches the screen for the specified text string, from the specified start position to the specified end position. If found, it returns true and the start position of the string. Detected field attributes or hidden fields are treated as spaces.
Parameters:
inText - The text to search for.
inStartRow - The row in which to begin searching.
inStartColumn - The column in which to begin searching.
inEndRow - The row in which to stop searching.
inEndColumn - The column in which to stop searching.
inArea - Not used; set to 0.
inWrap - Whether or not to wrap to the top of the screen after reaching the end of the screen. Possible values include: WRAP_ON and WRAP_OFF.
inDir - The direction to search when looking for the string. When searching backwards, searching begins at the end of the selected area. Possible values include: DIRECTION_BACKWARD and DIRECTION_FORWARD.
outRow - The row where the string was found. If the string is not found, the value is set to zero.
outColumn - The column where the string was found. If the string is not found, the value is set to zero.
Returns:
True or false. If the string is found, the value is set to true; otherwise it is set to false.
Examples:
Java:

String inText = "PASSWORD";
inStartRow = 1;
inStartColumn = 1;
inEndRow = 12;
inEndColumn = 80;
inArea = 0;
inWrap = m_screenObj.WRAP_ON;
inDir = m_screenObj.DIRECTION_FORWARD;
MutableInt outRow = new MutableInt(0);
MutableInt outColumn = new MutableInt(0);

boolean stringFound = m_screenObj.findStringEx(inText, inStartRow,
   inStartColumn,inEndRow, inEndColumn, inArea,
   inWrap, inDir, outRow, outColumn );

ASP (VBScript):

dim inText
inText= "LOGON"
inStartRow = 1
inStartColumn = 1
set outRow = CreateObject("Mutable.MutableInt")
set outColumn = CreateObject("Mutable.MutableInt")
dim stringFound
inEndRow = 12
inEndColumn = 80
inArea = 0
inWrap = Session("screenObj").WRAP_ON
inDir = Session("screenObj").DIRECTION_FORWARD

stringFound = Session("screenObj").findStringEx(inText, inStartRow,
   inStartColumn, inEndRow, inEndColumn, inArea, inWrap, inDir, outRow,
   outColumn

C++:

MutableInt_Dispatch outRow;
MutableInt_Dispatch outColumn;
::CLSIDFromProgID(L"Mutable.MutableInt", &clsid);
outRow.CreateDispatch(clsid);
outColumn.CreateDispatch(clsid);
CString inText = "LOGON";
int inStartRow = 1;
int inStartColumn = 1;
int inEndRow = 12;
int inEndColumn = 80;
int inArea = 0;
int inWrap = WRAP_ON;
int inDir = DIRECTION_FORWARD;

boolean stringFound = m_screenObj.findStringEx((LPCSTR)inText, inStartRow,
    inStartColumn,inEndRow, inEndColumn, inArea,
    inWrap, inDir, outRow, outColumn );
int x = outRow.getInt();
int y = outColumn.getInt();
See Also:
findString(java.lang.String, int, int, com.attachmate.common.types.MutableInt, com.attachmate.common.types.MutableInt)

getCapturedData

public java.lang.String getCapturedData()
Returns the currently captured data. The data capture facility allows you to save all information being sent to the presentation space (PS) session to a string.
Returns:
A string containing the data that is currently captured.
Example:
String gcd = m_screenObj.getCapturedData();
See Also:
clearCapturedData(), getDataCapture(), getMaxDataCaptureLength(), setDataCapture(boolean), setMaxDataCaptureLength(int)

getColumns

public int getColumns()
Returns the number of columns in the current presentation space (PS).
Returns:
The number of columns.
Example:
int numColumns = m_screenObj.getColumns();
See Also:
getRows()

getCursor

public void getCursor(MutableInt outRow,
                      MutableInt outColumn)
Returns the current cursor position.
Parameters:
outRow - The current cursor row.
outColumn - The current cursor column.
Examples:
Java:

MutableInt outRow = new MutableInt(0);
MutableInt outColumn = new MutableInt(0);

m_screenObj.getCursor(outRow, outColumn);


ASP (VBScript):

set outRow = CreateObject("Mutable.MutableInt")
set outColumn = CreateObject("Mutable.MutableInt")
outRow= 0
outColumn = 0

Session("screenObj").getCursor(outRow, outColumn)


C++:

MutableInt_Dispatch outRow;
MutableInt_Dispatch outColumn;
::CLSIDFromProgID(L"Mutable.MutableInt", &clsid);
outRow.CreateDispatch(clsid);
outColumn.CreateDispatch(clsid);

m_screenObj.getCursor(outRow, outColumn);

int x = outRow.getInt();
int y = outColumn.getInt();
See Also:
getCursorColumn(), getCursorRow(), setCursor(int, int), setCursorColumn(int), setCursorRow(int)

getCursorColumn

public int getCursorColumn()
Returns the column of the current cursor position. A value of 1 is the left edge of the screen.
Returns:
The current cursor column.
Example:
int currentCursorColumn = m_screenObj.getCursorColumn();
See Also:
getCursor(com.attachmate.common.types.MutableInt, com.attachmate.common.types.MutableInt), getCursorRow(), setCursor(int, int), setCursorColumn(int), setCursorRow(int)

getCursorRow

public int getCursorRow()
Returns the row of the current cursor position. A value of 1 is the top row of the screen.
Returns:
The current cursor row.
Example:
int currentCursorRow = m_screenObj.getCursorRow();
See Also:
getCursor(com.attachmate.common.types.MutableInt, com.attachmate.common.types.MutableInt), getCursorColumn(), setCursor(int, int), setCursorColumn(int), setCursorRow(int)

getDataCapture

public boolean getDataCapture()
Returns the current state of the data capture facility: true if on; false if off. The data capture facility allows you to save all information being sent to the presentation space (PS) session to a string. The data capture facility is initially set to off until you activate it.
Returns:
True or false. If the data capture facility is on, the value is set to true; otherwise it is set to false.
Example:
boolean gDC = m_screenObj.getDataCapture();
See Also:
clearCapturedData(), getCapturedData(), getMaxDataCaptureLength(), setDataCapture(boolean), setMaxDataCaptureLength(int)

getDescription

public java.lang.String getDescription()
Returns a custom description for the Screen object, if a description was created previously using setDescription.
Returns:
The custom description created for the Screen object.
Examples:
Java:

String description = screenObj.getDescription();

ASP (VBScript):

dim description
description = Session("screenObj").getDescription


C++:

CString description = screenObj.getDescription();
See Also:
setDescription(java.lang.String)

getExtPS

public java.lang.String getExtPS(int Row,
                                 int Col,
                                 int PSLength)
Returns the specified portion of the presentation space in a string format. Each character in the returned string is followed immediately by the extended character and extended color information for that character; as a result, the return string will contain three times the number of presentation space positions (characters) that you specify. See Extended Character and Color Attributes for a list of attributes returned for each Host Type.
Parameters:
inStartRow - The first row from which to retrieve data.
inStartColumn - The first column from which to retrieve data.
inLength - The number of screen positions to return. Ignored when both inStartRow and inStartColumn are zero.
Returns:
A string containing the specified contents of presentation space. The string includes the requested presentation space positions (characters), as well as the extended character and extended color attributes for each character.
Example:
Java:

boolean isUnderscore = false;
boolean isBlinking = false;
boolean isForegroundBlue = false;
boolean isBackgroundYellow = false;

String ps;
ps = ScreenObj.getExtPS(1,1,1000);
char display_character = ps.charAt(0);
char character_Attribute = ps.charAt(1);
char character_color = ps.charAt(2);

// Character attributes
if ((character_Attribute & ScreenObj.Underscore) != 0)
  isUnderscore = true;
if ((character_Attribute & ScreenObj.Blink) != 0)
  isBlinking = true;

// Character color attributes
if ((character_color & ScreenObj.FgBlue) != 0)
  isForegroundBlue = true;
if ((character_color & ScreenObj.BgYellow) != 0)
  isBackgroundYellow = true;


ASP (VBScript):

dim isBlink,isUnderline,isNegative
dim attribs
attribs = screenObj.getExtPS(18,6,10)
attr = mid(attribs,2,1)
if ((attr and screenObj.Blink) <> 0) then isBlink = true
if ((attr and screenObj.Underscore) <> 0) then isUnderline = true
if ((attr and screenObj.Reverse) <> 0) then isNegative = true


C++:

char attribs[50];
char attr;
bool isBlink, isUnderline, isNegative;
attribs = screenObj.getExtPS(18,6,10);
attr = attribs[1];
if ((attr & screenObj.Blink) != 0) isBlink = true;
if ((attr & screenObj.Underscore) != 0) isUnderline = true;
if ((attr & screenObj.Reverse) != 0) isNegative = true;

getgetText_Display

public boolean getgetText_Display()
Returns the current setting of the getText_Display property. If getText_Display is set to true, the getText() method writes the entire text contents of the current presentation space to the Java Console, which can be useful for debugging and diagnostic purposes.
Returns:
True or false. If getText_Display is enabled, the value is set to true; otherwise it is set to false.
Example:
boolean ggTD = m_screenObj.getgetText_Display();
See Also:
setgetText_Display(boolean)

getKeyboardLocked

public boolean getKeyboardLocked()
Returns the current state of the keyboard: true if locked; false if unlocked.
Returns:
True or false. If the keyboard is locked, the value is set to true; otherwise it is set to false.
Example:
boolean isKeyboardLocked = m_screenObj.getKeyboardLocked();

getLastError

public java.lang.String getLastError()
Returns a description of the most recent error that occurred.
Returns:
An integer (error number) plus a text description of the error.
Examples:
Java:

String SDK_Error = screenObj.getLastError();

ASP (VBScript):

dim SDK_Error
SDK_Error = Session("screenObj").getLastError


C++:

CString SDK_Error = screenObj.getLastError();

getMaxDataCaptureLength

public int getMaxDataCaptureLength()
Returns the current maximum buffer size for data captured using the data capture facility. The data capture facility allows you to save all information being sent to the presentation space (PS) session to a string. The default value is 9600 characters, which is the equivalent of 5 screens of data (5 x 1920). Any characters that exceed the specified buffer size are truncated.
Returns:
int The current maximum buffer size (in characters).
Example:
int mdcl = m_screenObj.getMaxDataCaptureLength();
See Also:
clearCapturedData(), getCapturedData(), getDataCapture(), setDataCapture(boolean), setMaxDataCaptureLength(int)

getObjectVersion

public int getObjectVersion()
Returns the version number of the specified Screen object; for example, 3001000 is equivalent to version 3.1.00.
Returns:
The Screen object version.
Examples:
Java:

int objVersion = m_screenObj.getObjectVersion();

ASP (VBScript):

int objVersion = Session("screenObj").getObjectVersion

C++:

int objVersion = m_screenObj.getObjectVersion();

getOIAContents

public java.lang.String getOIAContents()
Returns the data displayed in the OIA portion (status line) of the screen. See OIA Data for a detailed list of OIA data returned for a session.
Returns:
A string containing the data displayed in the OIA portion of the screen.
Examples:
Java:

String tmpstr;
tmpstr = screenObj.getOIAContents();
int conn;
//get connection status
conn = tmpstr.charAt(83);


ASP (VBScript):

dim tmpstr,conn
tmpstr = screenObj.getOIAContents
'get connection status
conn = asc(mid(tmpstr,84,1))


C++:

CString tmpStr;
tmpStr = screenObj.getOIAContents();
int conn;
//get connection status
conn = tmpstr.getAt(83);
See Also:
getOIAText()

getOIAText

public java.lang.String getOIAText()
Returns the text of the OIA portion (status line) of the screen in a string format.
Returns:
The text that appears in the status line.
Examples:
Java:

String OIA = screenObj.getOIAText();

ASP (VBScript):

dim OIA
OIA = Session("screenObj").getOIAText


C++:

CString OIA = screenObj.getOIAText();
See Also:
getOIAContents()

getRows

public int getRows()
Returns the number of rows in the presentation space (PS).
Returns:
The number of rows.
Example:
int numRows = m_screenObj.getRows();
See Also:
getColumns()

getScreenType

public int getScreenType()
Returns the current host type.
Returns:
The current host type.
Example:
int screenType = m_screenObj.getScreenType();

getString

public java.lang.String getString(int inStartRow,
                                  int inStartColumn,
                                  int inLength)
Returns the visible text from the specified location. If inStartRow and inStartColumn are zero, the entire screen is returned.
Parameters:
inStartRow - The first row from which to retrieve data.
inStartColumn - The first column from which to retrieve data.
inLength - The number of screen positions to return. Ignored when both inStartRow and inStartColumn are zero.
Returns:
The text string.
Examples:
Java:

int inStartRow = 1;
int inStartColumn = 1;
int inLength = 12;

String visibleString = m_screenObj.getString (inStartRow,
   inStartColumn, inLength );

ASP (VBScript):

dim inStartRow
dim inStartColumn
dim inLength
inStartRow = 0
inStartColumn = 0
inLength = 12
dim str

str = Session("screenObj").getString (inStartRow,
   inStartColumn, inLength) 

C++:

MutableInt_Dispatch outRow;
MutableInt_Dispatch outColumn;
::CLSIDFromProgID(L"Mutable.MutableInt", &clsid);
outRow.CreateDispatch(clsid);
outColumn.CreateDispatch(clsid);
int inStartRow = 3;
int inStartColumn = 1;
int inLength = 40;
CString visibleString = m_screenObj.getString (inStartRow,
    inStartColumn, inLength);
See Also:
getStringEx(int, int, int, int, int, int, int, int)

getStringEx

public java.lang.String getStringEx(int inStartRow,
                                    int inStartColumn,
                                    int inEndRow,
                                    int inEndColumn,
                                    int inArea,
                                    int inWrap,
                                    int inAttr,
                                    int inFlags)
Returns text from the specified location, for attributes matching those specified by inAttr. If inStartRow and inStartColumn are zero, the entire screen is returned.
Parameters:
inStartRow - The first row from which to retrieve data.
inStartColumn - The first column from which to retrieve data.
inEndRow - The last row from which to retrieve data. Ignored when both inStartRow and inStartColumn are zero.
inEndColumn - The last column from which to retrieve data. Ignored when both inStartRow and inStartColumn are zero.
inArea - Not used; set to 0.
inWrap - Whether or not to wrap to the top of the screen after reaching the end of the screen. Possible values include: WRAP_ON and WRAP_OFF.
inAttr - The type of fields to retrieve. You can connect multiple options with OR to create various combinations. For example, SCREENATTR_UNPROTECTED | SCREENATTR_VISIBLE returns only unprotected, visible fields. Possible values include: SCREENATTR_ANY, SCREENATTR_HIDDEN, SCREENATTR_PROTECTED, SCREENATTR_UNPROTECTED, and SCREENATTR_VISIBLE.
inFlags - Not used; set to 0.
Returns:
The string at the specified location.
Examples:
Java:

int inStartRow = 1;
int inStartColumn = 1;
int inEndRow = 12;
int inEndColumn = 10;
int inArea = 0;
int inWrap = m_screenObj.WRAP_ON;
int inAttr = m_screenObj.SCREENATTR_PROTECTED;
int inFlags = 0;

String matchString = m_screenObj.getStringEx (inStartRow,
   inStartColumn, inEndRow, inEndColumn, inArea,
   inWrap, inAttr, inFlags);

ASP (VBScript):

inStartRow = 1
inStartColumn = 1
inEndRow = 12
inEndColumn = 10
inArea = 0
inWrap = Session("screenObj").WRAP_ON
inAttr = Session("screenObj").SCREENATTR_PROTECTED
inFlags = 0
dim matchString

matchString = Session(“screenObj”).getStringEx (inStartRow,
   inStartColumn, inEndRow, inEndColumn, inArea, inWrap, inAttr,
   inFlags)

C++:

int inStartRow = 1;
int inStartColumn = 1;
int inEndRow = 12;
int inEndColumn = 10;
int inArea = 0;
int inWrap = WRAP_ON;
int inAttr = SCREENATTR_PROTECTED;
int inFlags = 0;
CString matchString = m_screenObj.getStringEx (inStartRow,
    inStartColumn, inEndRow, inEndColumn, inArea,
    inWrap, inAttr, inFlags );
See Also:
getString(int, int, int)

getText

public java.lang.String getText()
Returns the text contents of the presentation space (PS) as a string. The string returned has a CRLF at the end of each line of the screen.
Returns:
A string containing the text of the presentation space.
Example:
String hostText = m_screenObj.getText();

isConnected

public boolean isConnected()
Returns the state of the Mainframe connection: true if connected; false if unconnected.
Returns:
True or false. If the connection is open, the value is set to true; otherwise it is set to false.
Example:
boolean isConnectionOpen = m_screenObj.isConnected();

isKeyboardLocked

public boolean isKeyboardLocked()
Returns the state of the keyboard: true if locked; false if unlocked.
Returns:
True or false. If the keyboard is locked, the value is set to true; otherwise it is set to false.
Example:
boolean isKeyboardLocked = m_screenObj.isKeyboardLocked();

Open

public boolean Open()
Opens a host session. Note: For ALC sessions, Open returns immediately before the host connection has been established. The developer should check for a true value returned by isConnected before calling additional API methods.
Returns:
True or false. If the session is opened (or is currently open) successfully, the value is set to true; otherwise it is set to false.
Example:
boolean open_status = m_screenObj.Open();
See Also:
Close(), isConnected()

putString

public int putString(java.lang.String inText,
                     int inRow,
                     int inColumn)
              throws ProtectedFieldException,
                     InputInhibitedException,
                     TruncatedException
Copies a string of text to the specified position, returning the number of characters written.
Note: putString only copies text (not keystrokes) to the screen, and will overwrite any existing text (it is not affected by enabling Insert mode). To send keystrokes (such as Transmit or Tab), or to insert characters, use sendKeys.
Parameters:
inText - The text to copy to the host.
inRow - The row in which to begin writing.
inColumn - The column in which to begin writing.
Returns:
The number of characters written.
Examples:
Java:

 try
 {
      // putString - Copies a string of text to the host screen

      String inText = "PASSWORD";
      int inRow = 1;
      int inColumn = 1;

      int numCharsPut = m_screenObj.putString (inText, inRow,
         inColumn );
 }
    catch(ProtectedFieldException e)
    {
       System.err.println("ProtectedFieldException " );
       return;
    }
    catch(InputInhibitedException e)
    {
       System.err.println("InputInhibitedException " );
       return;
    }
    catch(TruncatedException e)
    {
       System.err.println("TruncatedException " );
       return;
    }

ASP (VBScript):

inText = "password"
inRow = 5
inColumn = 11
numCharsPut = Session("screenObj").putString (inText, inRow,
   inColumn) 

C++:

 TRY
 {
    CString inText = "text";
    int inRow = 1;
    int inColumn = 1;
    int numCharsPut = m_screenObj.putString (inText, inRow, inColumn );
 }
 CATCH_ALL(e)
 {
    if (e->GetRuntimeClass()->m_lpszClassName == "com.attachmate.emulation.exception.ProtectedFieldException")
    {
    }
    else if (e->GetRuntimeClass()->m_lpszClassName == "com.attachmate.emulation.exception.InputInhibitedException")
    {
    }
    else if (e->GetRuntimeClass()->m_lpszClassName == "com.attachmate.emulation.exception.TruncatedException")
    {
    }
 }
 END_CATCH_ALL
Throws:
ProtectedFieldException - Returned if putString was not able to complete successfully because a protected field was encountered.
InputInhibitedException - Returned if putString was not able to complete successfully because a field with the input inhibited attribute was encountered.
TruncatedException - Returned if there is not enough room in the presentation space to write all of the data specified by putString.
See Also:
ScreenUPG#putStringEx, sendKeys(java.lang.String, int)

putStringEx

public int putStringEx(java.lang.String inText,
                       int inStartRow,
                       int inStartColumn,
                       int inEndRow,
                       int inEndColumn,
                       int inArea,
                       int inWrap,
                       int inModes,
                       boolean inFill)
                throws ProtectedFieldException,
                       InputInhibitedException,
                       TruncatedException
Copies a string of text to the specified position, returning the number of characters written. Similar to putString, but allows additional options. Data can be copied in block or stream mode, and can be copied to multiple unprotected fields. If inFill is true, the area is filled with the text specified by inText. Any characters that exceed the area are truncated.
Note: putStringEx only copies text (not keystrokes) to the screen, and will overwrite any existing text (it is not affected by enabling Insert mode). To send keystrokes (such as Transmit or Tab), or to insert characters, use sendKeys.
Parameters:
inText - The text to copy to the host.
inStartRow - The row at which to begin writing.
inStartColumn - The column at which to begin writing.
inEndRow - The row at which to stop writing.
inEndColumn - The column at which to stop writing.
inArea - Not used; set to 0.
inWrap - Whether or not to wrap to the top of the screen after reaching the end of the screen. Possible values include: WRAP_ON and WRAP_OFF.
inModes - Action to perform when a protected field is encountered while writing the string to the screen. Possible values include: PUTSTRING_SKIP, PUTSTRING_SPAN, and PUTSTRING_STOP.
inFill - When true, the area specified is filled with the string specified by inText.
Returns:
The number of characters written.
Throws:
ProtectedFieldException - Returned if putStringEx was not able to complete successfully because a protected field was encountered.
InputInhibitedException - Returned if putStringEx was not able to complete successfully because a field with the input inhibited attribute was encountered.
TruncatedException - Returned if there is not enough room in the presentation space to write all of the data specified by putStringEx.
Examples:
Java:

 try
 {
      //  putStringEx - Writes to the specified position,
      //  returning the number of characters put

      String inText = "PASSWORD";
      int inStartRow = 1;
      int inStartColumn = 1;
      int inEndRow = 12;
      int inEndColumn = 10;
      int inArea = 0;
      int inWrap =  m_screenObj.WRAP_ON;
      int inModes = m_screenObj.FINDFIELD_NEXT;
      boolean inFill = true;

      int numCharsPut = m_screenObj.putStringEx (inText, inStartRow,
         inStartColumn,inEndRow, inEndColumn, inArea,
         inWrap, inModes, inFill);
 }
    catch(ProtectedFieldException e)
    {
       System.err.println("ProtectedFieldException " );
       return;
    }
    catch(InputInhibitedException e)
    {
       System.err.println("InputInhibitedException " );
       return;
    }
    catch(TruncatedException e)
    {
       System.err.println("TruncatedException " );
       return;
    }

ASP (VBScript):

inText = "password"
inRow = 5
inColumn = 11
inEndRow = 12
inEndColumn = 10
inArea = 0
inWrap = Session("screenObj").WRAP_ON
inModes = Session("screenObj").FINDFIELD_NEXT
numCharsPut = Session("screenObj").putStringEx (inText,
   inRow, inColumn, inEndRow, inEndColumn, inArea, inWrap,
   inModes, true)

C++:

 TRY
 {
    CString inText = "PASSWORD";
    int inStartRow = 1;
    int inStartColumn = 1;
    int inEndRow = 12;
    int inEndColumn = 10;
    int inArea = 0;
    int inWrap =  WRAP_ON;
    int inModes = FINDFIELD_NEXT;
    bool inFill = true;
    int numCharsPut = m_screenObj.putStringEx (inText, inStartRow,
    inStartColumn,inEndRow, inEndColumn, inArea, inWrap, inModes, inFill);
 }
 CATCH_ALL(e)
 {
    if (e->GetRuntimeClass()->m_lpszClassName == "com.attachmate.emulation.exception.ProtectedFieldException")
    {
    }
    else if (e->GetRuntimeClass()->m_lpszClassName == "com.attachmate.emulation.exception.InputInhibitedException")
    {
    }
    else if (e->GetRuntimeClass()->m_lpszClassName == "com.attachmate.emulation.exception.TruncatedException")
    {
    }
 }
 END_CATCH_ALL
See Also:
putString(java.lang.String, int, int), sendKeys(java.lang.String, int)

removeIScreenListener

public void removeIScreenListener(IScreenListener inListener)
Removes the ScreenListener from the Screen object. The Screen object will no longer receive screen event notifications. (For use with Java-based programming languages only; for COM-based languages, use removeIScreenListenerEx.)
Parameters:
inListener - The screen listener to detach from the Screen object.
Example:
 if (screenObj != null)
 {
    screenObj.removeIScreenListener(this);
    screenObj.Close();
 } 
See Also:
addIScreenListener(com.attachmate.UPG.screen.IScreenListener)

sendKeys

public void sendKeys(java.lang.String inText,
                     int inType)
Sends characters and special keys to the host session. Keys are sent to the current cursor position. Keystrokes can be specified in HLLAPI format, which has a special code for each host keystroke, such as "@E" for the host Transmit key, or Braces format, where the key name is surrounded by braces, such as "{Transmit}". See Key Codes for a complete list of codes for each host type.

You can also use sendKeys to send text character strings to the host. Text is sent to the current cursor location. For example, to send the text "logoff" followed by the Transmit key, inText would be "logoff@T". If you are sending a lot of text to the screen, however, it may be more efficient to use putString or putStringEx instead. If an invalid key sequence is detected, no characters or keys are sent.

It is recommended that you follow every sendKey call with a call to one of the Wait methods (for example, WaitForString, WaitHostQuiet, or WaitForCursor). This helps to ensure that the host has completed processing before your application moves on to the next step.
Parameters:
inText - Keys to send to the host. This can be a combination of text characters and host keystrokes, however only one host keystroke can be sent in each call and the host keystroke must be the last key sent. Please see Key Codes for valid codes for each host type.
inType - The format of the host keystrokes included in the string, either HLLAPI format or BRACES format.
Example:
IScreenUPG screenObj = terminal.getSession().getScreen();

// send Transmit key at current cursor position
screenObj.sendKeys("@E",screenObj.KEYTYPE_HLLAPI);

// The next line is equivalent to the line above
screenObj.sendKeys("{Transmit}",screenObj.KEYTYPE_BRACES);
See Also:
putString(java.lang.String, int, int), putStringEx(java.lang.String, int, int, int, int, int, int, int, boolean)

setCursor

public void setCursor(int inRow,
                      int inColumn)
               throws CursorPositionException
Sets the cursor position on the presentation space (PS).
Parameters:
inRow - The row in which the cursor is placed.
inColumn - The column in which the cursor is placed.
Example:
int inRow = 17;
int inColumn = 20;

m_screenObj.setCursor(inRow, inColumn);
See Also:
setCursorColumn(int), setCursorRow(int), getCursor(com.attachmate.common.types.MutableInt, com.attachmate.common.types.MutableInt), getCursorColumn(), getCursorRow()

setCursorColumn

public void setCursorColumn(int CursorColumn)
                     throws CursorPositionException
Sets the column of the cursor position.
Parameters:
cursorcolumn - The column in which the cursor is placed.
Example:
int CursorColumn = 20;

m_screenObj.setCursorColumn(CursorColumn);
See Also:
setCursor(int, int), setCursorRow(int), getCursor(com.attachmate.common.types.MutableInt, com.attachmate.common.types.MutableInt), getCursorColumn(), getCursorRow()

setCursorRow

public void setCursorRow(int CursorRow)
                  throws CursorPositionException
Sets the row of the cursor position.
Parameters:
cursorrow - The row in which the cursor is placed.
Example:
int CursorRow = 17;

m_screenObj.setCursorRow(CursorRow);
See Also:
setCursor(int, int), setCursorColumn(int), getCursor(com.attachmate.common.types.MutableInt, com.attachmate.common.types.MutableInt), getCursorColumn(), getCursorRow()

setDataCapture

public void setDataCapture(boolean sDCVal)
Turns the data capture facility on or off. Valid values are true to turn it on, or false to turn it off. The data capture facility allows you to save all information being sent to the presentation space (PS) session to a string. The data capture facility is initially set to off until you activate it.
Parameters:
sDCVal - Specifies whether to turn the data capture facility on (true) or off (false).
Example:
m_screenObj.setDataCapture(true);
See Also:
clearCapturedData(), getCapturedData(), getDataCapture(), getMaxDataCaptureLength(), setMaxDataCaptureLength(int)

setDescription

public void setDescription(java.lang.String description)
Creates a custom description for the Screen object. The description you enter can be used as a label in a graphical user interface, for example, or as a way to programmatically query the object.
Parameters:
description - The text description that you want to assign to the Screen object.
Examples:
Java:

String description = "First Session Instance";
screenObj.setDescription(description);


ASP (VBScript):

dim description
description = "First Session Instance"
Session("screenObj").setDescription description


C++:

CString description = "First Session Instance";
screenObj.setDescription(description);
See Also:
getDescription()

setgetText_Display

public void setgetText_Display(boolean gtdvalue)
Turns the getText_Display property on or off. Valid values are true to turn it on, or false to turn it off. If getText_Display is set to true, the getText() method writes the entire text contents of the current presentation space to Standard out, which can be useful for debugging and diagnostic purposes.
Parameters:
gtdvalue - Specifies whether to turn the getText_Display property on (true) or off (false).
Example:
m_screenObj.setgetText_Display(false);
See Also:
getgetText_Display()

setMaxDataCaptureLength

public void setMaxDataCaptureLength(int dcl)
Sets the maximum buffer size for data captured using the data capture facility. The data capture facility allows you to save all information being sent to the presentation space (PS) session to a string. The default value is 9600 characters, which is the equivalent of 5 screens of data (5 x 1920). Any characters that exceed the specified size are truncated.
Parameters:
dcl - The number of characters to save in the buffer.
Example:
m_screenObj.setMaxDataCaptureLength(10000);
See Also:
clearCapturedData(), getCapturedData(), getDataCapture(), getMaxDataCaptureLength(), setDataCapture(boolean)

waitForCursor

public void waitForCursor(int inRow,
                          int inColumn,
                          int wtTime)
                   throws TimedOutException
Waits for the cursor to appear at the specified position, for a specified period of time. If inRow is zero, the wait completes when the cursor moves to the specified column. If inColumn is zero, the wait completes when the cursor moves to the specified row. Otherwise, it times out after wtTime (specified in milliseconds).
Parameters:
inRow - The row in which the cursor must appear to satisfy the wait. When inRow is set to zero, the wait is satisfied when the cursor appears in the column specified, regardless of which row the cursor is in.
inColumn - The column in which the cursor must appear to satisfy the wait. When inColumn is set to zero, the wait is satisfied when the cursor appears in the row specified, regardless of which column the cursor is in.
wtTime - The number of milliseconds to wait for the wait condition to be satisfied before timing out.
Throws:
TimedOutException - Returned if WaitForCursor times out.
Examples:
Java:

 try
 {
      int inRow = 17;
      int inColumn = 20;
      int wtTime = 3000;
      m_screenObj.waitForCursor(inRow, inColumn, wtTime);
 }
    catch(TimedOutException e)
    {
        System.err.println("TimedOutException " );
        return;
    }

ASP (VBScript):

inRow = 0
inColumn = 0
wtTime = 5000

Session("screenObj").waitForCursor inRow,inColumn,wtTime


C++:

 TRY
 {
    int inRow = 17;
    int inColumn = 20;
    int wtTime = 3000;
    m_screenObj.waitForCursor(inRow, inColumn, wtTime);
 }
 CATCH_ALL(e)
 {
    AfxMessageBox ("TimedOutException " );
    return;
 }
 END_CATCH_ALL
See Also:
waitForString(java.lang.String, int, int, int), waitHostQuiet(int, int)

waitForString

public void waitForString(java.lang.String inText,
                          int inRow,
                          int inColumn,
                          int wtTime)
                   throws TimedOutException
Waits for the specified text to appear at the specified position, for a specified period of time. If the row and column are zero, it waits for text to appear anywhere on the screen. Otherwise, it times out after wtTime (specified in milliseconds).
Parameters:
inText - The text string to wait for.
inRow - The row in which to look for the string. If the row is set to zero, the wait is satisfied if the string appears in the column specified, regardless of the row.
inColumn - The column in which to look for the string. If the column is set to zero, the wait is satisfied if the string appears in the row specified, regardless of the column.
wtTime - The number of milliseconds to wait for the wait condition to be satisfied before timing out.
Examples:
Java:

 try
 {
     // waitForString - Waits for the specified text to appear at the
     // specified position.

     String inText = "Ready";
     int inRow = 17;
     int inColumn = 20;
     int wtTime = 3000;

     m_screenObj.waitForString(inText, inRow, inColumn, wtTime);
 }
   catch(TimedOutException e)
   {
        System.err.println("TimedOutException " );
        return;
   }

ASP (VBScript):

inText = "LOGON"
inRow = 0
inColumn = 0
wtTime = 5000

Session("screenObj").waitForString inText,inRow,inColumn,wtTime


C++:

 TRY
 {
    CString inText = "UNIX";
    int inRow = 0;
    int inColumn = 0;
    int wtTime = 5000;
    m_screenObj.waitForString((LPCSTR)inText, inRow, inColumn, wtTime);
 }
 CATCH_ALL(e)
 {
    AfxMessageBox("TimedOutException " );
    return;
 }
 END_CATCH_ALL
See Also:
waitForCursor(int, int, int), waitHostQuiet(int, int)

waitHostQuiet

public void waitHostQuiet(int inSettleTime,
                          int wtTime)
                   throws TimedOutException
Waits for the host session to be idle for a specified period of time (in milliseconds). A session is considered to be "quiet" when there has been no activity in the host session for the specified amount of time. This is a synchronous call and does not return until the wait condition is satisfied. Otherwise, it times out after wtTime (specified in milliseconds).
Parameters:
inSettleTime - The amount of time (in milliseconds), that the session needs to be idle before the wait condition is satisfied. The optimum settle time varies depending on the host application response time. For most host applications, a settle time of one to three seconds is sufficient.
wtTime - The number of milliseconds to wait for the wait condition to be satisfied before timing out.
Throws:
TimedOutException - Returned if WaitHostQuiet times out.
Examples:
Java:

 try
 {
     // waitHostQuiet -

     int inSettleTime = 1000;
     int wtTime = 3000;

     m_screenObj.waitHostQuiet(inSettleTime, wtTime);
 }
   catch(TimedOutException e)
   {
       System.err.println("TimedOutException " );
       return;
   }

ASP (VBScript):

inSettleTime = 1000
wtTime = 3000

Session("screenObj").waitHostQuiet inSettleTime, wtTime


C++:

 int inSettleTime = 1000;
 int wtTime = 3000;
 TRY
 {
    this->m_screenObj.waitHostQuiet(inSettleTime, wtTime);
 }
 CATCH_ALL(e)
 {
    AfxMessageBox("TimedOutException " );
    return;
 }
 END_CATCH_ALL
See Also:
waitForCursor(int, int, int), waitForString(java.lang.String, int, int, int)