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
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.