TS_CAPTURE

LANSA Composer

TS_CAPTURE

The TS_CAPTURE activity captures a representation of the current aXes Terminal Server screen and returns it in the AXCAPTURE list.  The screen capture is a simple text representation.  5250 display attributes (such as underlining of input fields) are not represented.

The most common use for the TS_CAPTURE activity is for diagnostic purposes, especially while designing a process that uses the aXes terminal server.  You can use the LOGLIST activity with the list returned in the AXCAPTURE parameter to include the screen capture in the processing sequence log.

INPUT Parameters:

AXHANDLE : Required

This parameter must specify the connection handle value that identifies the aXes terminal server session from which the screen representation is captured.  The connection handle value is returned by the TS_CONNECT activity.

OUTPUT Parameters:

AXSCREEN :

Upon successful completion this parameter contains the current aXes 5250 screen name or signature.  The screen name is the user-defined name if an aXes project name was specified on the TS_CONNECT activity and a name was assigned to the screen.  Otherwise the screen signature is returned.

AXCAPTURE :

Upon successful completion, this parameter provides a list of captured aXes screen image lines.  The number of lines in the list depends on the display attributes of the current 5250 screen shown in the aXes terminal server session, but is most commonly 24 or 27.