EVOKE (Evoke) Keyword for Intersystem Communications Function Files

Use this file- or record-level keyword to start a program on the remote system.

The format of the keyword is:

EVOKE([library-/e1e/]program-name [parameter-1...[parameter-255]])

The program-name can be any one of the following:

program-name
This is the name of the program to be started on the remote system. The name is syntax-checked at creation time for a valid AS/400 object name.
'character-string-1'
This is the name of the program to be started on the remote system. The name you specify must be in a format acceptable to the remote system because the character string will not be syntax-checked.
&field-name-1
The specified field contains the name of the program to be started on the remote system. The field name must be a valid field you have specified in the record format and must be a character field (data type of A). The name you specify must be in a format acceptable to the remote system.

The optional library-name can be any one of the following:

library-name/
This is the name of the library that contains the program to be started on the remote system. The name is syntax-checked at creation time for a valid AS/400 object name. For this keyword, *CURLIB and *LIBL are not valid names. If either one needs to be specified, a quoted character string should be used.
'character-string-2'/
This is the name of the library that contains the program to be started on the remote system. The name you specify must be in a format acceptable to the remote system because the character string will not be syntax-checked.
&field-name-2/
The specified field contains the name of the library that contains the program to be started on the remote system. The field name must be a valid field you have specified in the record format and must be a character field (data type of A). The name you specify must be in a format acceptable to the remote system.
Note:
If the remote system is an AS/400 system and no library was specified, the library list will be used to search for the program.

Parameter-1...parameter-255 can be any of the following:

'character-string-3'
This is a character string that is passed to the program on the remote system. The character string must be in a format acceptable to the remote system because it will not be syntax-checked.
[&]field-name-3
This is the name of the field that contains the data you want passed to the program on the remote system. The field name must be a valid field you have specified in the record format.
numeric-value-3
This is a numeric value that is passed to the program on the remote system. The numeric value can be a negative or positive value (signed or unsigned). A decimal point of , or . is optional. No decimal alignment will be performed. Leading zeros will not be suppressed. The data is sent as a zoned decimal value. The following are all valid numeric values:


999.6
-999,6
01587