5.2.5 CAPTURE

The CAPTURE command captures a representation of the current aXes Terminal Server screen and returns it in the list provided.

You must provide a list definition containing at least one alphanumeric field in which the captured screen lines are returned. The service command will fill the list with an entry for each screen line captured. The captured screen text will be placed in the first field in the list, which is the only field used.

To exchange field RTNSIG and RTNSCREEN values, you will need to specify the SERVICE_EXCHANGE(*FIELD) in the command string.

Syntax:

Command

Keyword

Value

Developer notes

CAPTURE

RTNSIG

field name

The name of a field exchanged between your client program and the JSM that will receive the screen signature of the screen that is present.

RTNSCREEN

field name

The name of a field exchanged between your client program and the JSM that will receive the name of the screen that is present. The screen name is the user-defined name if an aXes project name was specified on the CONNECT command and a name was assigned to the screen. Otherwise the screen signature is returned.

 

Example

CAPTURE RTNSCREEN(MYSCREEN) SERVICE_EXCHANGE(*FIELD) #WRKLST(LINE)