SEND

LANSA Integrator

SEND

The SEND command sends the current aXes screen data to the aXes terminal server. It is comparable to pressing the ENTER key (by default) or a function key at a 5250 terminal.

Note: You usually need to specify SERVICE_EXCHANGE(*FIELD) in the command string in order to receive the return values into your client program variables named on keywords beginning with RTNxxx. Refer to 5.41.2 Using the AxesTerminalService for more information.

 

                                                          Optional

 

 SEND ------------ SENDKEY -------- ENTER ----------------------->

                                    F1  - F9

                                    F10 - F24

                                    HELP 

                                    PRINT 

                                    PAGE_UP 

                                    PAGE_DOWN

                                    ROLL_UP 

                                    ROLL_DOWN 

 

               >-- CURSORROW ------- cursor row number ---------->

 

               >-- CURSORCOL ------- cursor column number ------->

 

               >-- RTNSIG -- ------- field-name  ---------------->

  

               >-- RTNSCREEN ------- field-name  ----------------|

 

Keywords

SENDKEY

The function key to send. You may use any of the values shown above. If not specified, ENTER is sent.

CURSORROW

The cursor row number to send. If CURSORROW and CURSORCOL are not both specified, the cursor position is unchanged.

CURSORCOL

The cursor column number to send. If CURSORROW and CURSORCOL are not both specified, the cursor position is unchanged.

RTNSIG

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 following the send operation.

RTNSCREEN

The name of a field exchanged between your client program and the JSM that will receive the name of the screen that is present following the send operation. 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.

 

Examples

RDML Example:

DEFINE FIELD(#MYSCREEN) REFFLD(#STD_TEXT)

CHANGE FIELD(#JSMCMD) TO('SEND SENDKEY(F3) RTNSCREEN(MYSCREEN) SERVICE_EXCHANGE(*FIELD)'

USE BUILTIN(JSM_COMMAND) WITH_ARGS(#JSMCMD) TO_GET(#JSMSTS #JSMMSG)

 

RDMLX Example:

define field(#myscreen) reffld(#std_text)

#jsmcommand := 'SEND SENDKEY(F3) RTNSCREEN(MYSCREEN) SERVICE_EXCHANGE(*FIELD)'

use builtin(jsmx_command) with_args(#jsmhandle #jsmcommand) to_get(#jsmstatus #jsmmessage)