Use this file- or record-level keyword to start a program on the remote system.
EVOKE([library-/e1e/]program-name [parameter-1...[parameter-255]])
Parameter-1 through parameter-255 can be any of the following:
999.6
-999,6
01587
Four bytes must be added to the length of each of these parameters. An additional 4 bytes must be added if any parameters are specified. These bytes are required by the system.
Use the following formula to determine the total length of the parameters:
4 + (length of 1st parameter + 4) + (length of
2nd parameter + 4)
+ ... (length of nth parameter + 4)
Here is an example of how to use this formula:
EVOKE(LIBRARY1/PROGRAM1 'THIS IS AN EXAMPLE OF
A
CHARACTER STRING' &FIELD1 35)
Assume that &FIELD1 has a length of 10.
4 + (40 + 4) + (10 + 4) + (2 + 4) = 68
This keyword is required when either the SECURITY or SYNLVL keyword is specified. At run time, the SECURITY and SYNLVL keywords are used only when EVOKE is also in effect.
The EVOKE keyword is ignored at run time when CANCEL, CNLINVITE, EOS, FAIL, NEGRSP, RSPCONFIRM, or RQSWRT is in effect. These keywords must have option indicators when they apply to a record for which the EVOKE keyword applies. If a CANCEL, CNLINVITE, EOS, FAIL, NEGRSP, or RQSWRT keyword with no option indicator applies to a record for which EVOKE applies, an error message is issued and the EVOKE keyword is ignored at creation time.
You cannot specify EVOKE with the TIMER keyword.
Option indicators are valid for this keyword and are required if this keyword is specified more than once for each record format or file.
The following example shows how to specify the EVOKE keyword.
|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R RCD
00020A 01 : EVOKE(LIBRARY1/PROGRAM1) (1)
00030A 02 : EVOKE(LIBRARY2/PROGRAM2) (1)
A : :
A : :
00090A R RCD2 EVOKE(&FIELD2/&FIELD1 'ABC' 10.1 +
00100A FIELD3) (2)
00110A FIELD1 10A P
00120A FIELD2 10A P
00130A FIELD3 5B P
A
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.