IBM AS/400 manual Examples of CALL and CALLB, Operations, Passing Parameters Using PARM, Plist

Using the Fixed-Form Call	Operations
	For more information on operational descriptors, see “Using Operational
	Descriptors” on page 138.
¹	There	are further restrictions that apply when using the CALL	or CALL
	tion	codes. For a detailed description of theseILErestrictions,RPG for	see
	AS/400	Reference.

Examples of CALL and CALLB

For	examples of	using	the	CALL operation,	see:
¹	“Sample Source	for	Debug	Examples” on	page 211, for example of calli
	RPG program.

For examples of using the CALLB operation, see:

¹Figure 45 on page 99, for an example of calling a procedure in a se program.

¹ Figure 56 on page 123, for an example of calling bindable APIs.

¹“CUSMAIN: RPG Source” on page 347, for an example of a main inquiry program calling various RPG procedures.

Passing Parameters Using PARM			and	PLIST
When	you	pass		parameters using fixed-form call,		you must	pass	paramete
the PARM and PLIST operations. All parameters are passed by reference.
specify that an operational descriptor is to be passed and can also
parameter		is	omitted.
Using	the	PARM	operation
The	PARM operation is used to identify the parameters which are pass
received		by a procedure. Each parameter is defined in a separate
You	specify		the name		of the parameter in the	Result	field;	the name
the	same	as	in	the	calling/called procedure.

The Factor 1 and factor 2 entries are optional and indicate variables whose value is transferred to or received from the Result Field entr whether these entries are in the calling program/procedure or the cal program/procedure. Table 12 shows how factor 1 and factor 2 are use

Table

12. Meaning of Factor 1 and Factor 2 Entries in PARM Operation

Status

Factor

1

Factor

2

Incalling

Value

transferred

from

ResultValue

placed

in

Result

Field

procedure

Field

entry upon return.

entry

when

call

occurs.

Incalled

Value

transferred

from

ResultValue

placed

in

Result

Field

procedure

Field entry when call occursentry. upon return.

Note:

The

moves to

either

the

factor

1

entry

or

the result-field ent

when

the called procedure returns normally to its caller. If an

while

attempting to

move

data

to

either

entry, then

the move is

pleted.

150 ILE RPG for AS/400 Programmer's Guide