CALL_3GL

LANSA Composer

CALL_3GL

This activity calls a program. The program may be an RPG, COBOL or Control Language program or written using some other 3GL supported on IBM i. This activity is only supported on IBM i servers.

The activity can pass and receive up to 9 parameters, according to the requirements of the specified program. All parameters are passed as A(256). The called program should treat the parameters as character data and must not attempt to address more than 256 bytes for each parameter.

It is the user's responsibility:

- to ensure that the program is available in the library list at execution time

- to ensure that the executing job has the necessary authorities to make the call

- to specify at least the number of parameters expected by the called program

- to ensure that the called program is appropriate for the purpose.

INPUT Parameters:

PGM : Required

This parameter specifies the name of the program to call.

LIB : Optional

This parameter can specify the name of the library containing the program to call. If it is not specified, the processing sequence will use the library list to locate the program.

INPUT and OUTPUT Parameters:

PARM01PARM02
PARM03

PARM04

PARM05

PARM06

PARM07

PARM08

PARM09
: Optional

These parameters can be used to pass and receive up to nine parameters to/from the called program. The parameters are passed and received as character variables of length 256. The activity will pass and receive the number of parameters (up to nine) for which you specify values or alternate variable names. If used, they must be specified contiguously (the activity stops looking after the first parameter whose value is not specified).