Table

11.

RPG Parameter Passing Methods

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Passing

 

By

Reference

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

ILE

RPG

prototype

D

proc

PR

 

 

 

 

 

 

 

 

 

 

 

 

D

 

parm

1A

 

 

 

 

 

 

 

 

 

 

 

 

C

 

CALLP proc(fld)

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

ILE

C

 

 

 

 

void proc(char *parm);

 

 

 

 

 

 

 

 

 

 

 

 

proc(&fld);

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

ILE

COBOL

 

 

CALL PROCEDURE "PROC" USING BY REFERENCE PARM

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

RPG

non-prototyped

C

 

CALL

'PROC'

 

 

 

 

 

 

 

 

 

 

 

 

C

 

PARM

 

FLD

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

ILE

CL

 

 

 

 

CALL PROC (&FLD)

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Passing

 

By

Value

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

ILE

RPG

prototype

D

proc

PR

 

 

 

 

 

 

 

 

 

 

 

 

D

 

parm

1A

VALUE

 

 

 

 

 

 

 

 

 

 

 

C

 

CALLP proc('a')

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

ILE

C

 

 

 

 

void proc(char parm);

 

 

 

 

 

 

 

 

 

 

 

 

proc('a');

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

ILE

COBOL

 

 

CALL PROCEDURE "PROC" USING BY VALUE PARM

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

RPG – non-prototyped

N/A

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

ILE

CL

 

 

 

 

N/A

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Passing

 

By Read-Only Reference

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

ILE

RPG

prototype

D

proc

PR

 

 

 

 

 

 

 

 

 

 

 

 

D

 

parm

1A

CONST

 

 

 

 

 

 

 

 

 

 

 

C

 

CALLP proc(fld)

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

ILE

C

 

 

 

 

void proc(const char *parm);

 

 

 

 

 

 

 

 

 

 

 

proc(&fld);

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

ILE

COBOL

 

 

N/A

1

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

RPG – non-prototyped

N/A

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

ILE

CL

 

 

 

 

N/A

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Notes:

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1. Do

 

not

confuse passing

by read-only reference

with COBOL's

passing

BY

CONTENT. In RPG

terms, to

pass

Fld1 by

content,

you

would

code:

 

 

 

 

C

 

 

 

PARM

 

Fld1

TEMP

 

 

 

 

 

 

Fld1

is

protected

from

being

changed,

but TEMP

is

not.

There

is no

expe

the

parameter

will

not

 

be changed.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

For information on the data types supported by different HLLs, consul priate language manual.

Interlanguage

Calling Considerations

 

 

 

 

 

 

 

1. When returning a 1-byte character value to or

from ILE C or I

returned

value must

be

declared

in a

special

way.

For ILE CL, declare the returned value

as a 2-byte character a

%SUBSTRING

to obtain

the

actual

returned value.

 

DCL &RET2 TYPE(*CHAR) LEN(2)

 

 

 

 

DCL &RET1 TYPE(*CHAR) LEN(1)

 

 

 

 

CALLPRC RPGPROC RTNVAL(&RET2)

 

 

 

 

CHGVAR &RET1 VALUE(%SUBSTRING(&RET2 1 1))

 

 

 

 

 

 

Chapter

10.

Calling

Programs and

Procedures147

Page 171
Image 171
IBM AS/400 manual Interlanguage, Calling Considerations, To obtain Actual Returned value

AS/400 specifications

The IBM AS/400, now known as the IBM iSeries, is a midrange computer system that has been a cornerstone of enterprise computing since its introduction in 1988. Designed to provide a robust platform for business applications, the AS/400 is celebrated for its reliability, scalability, and integrated database capabilities.

One of the key features of the AS/400 is its Integrated Operating Environment, which blends hardware and software resources seamlessly. This integration allows businesses to execute diverse workloads, ranging from traditional applications to modern web-based services, all on a single platform. The operating system, OS/400 (now IBM i), offers a rich set of APIs and tools for developers, simplifying application development and management.

Another standout characteristic of the AS/400 is its built-in database, DB2 for i. This powerful relational database management system allows for efficient data handling and provides advanced features such as support for SQL, XML, and JSON, making it easier for businesses to manage their data and integrate it with other systems. The database's tight integration with the operating system enables high performance and security.

In terms of scalability, the AS/400 can accommodate small businesses as well as large enterprises, with the ability to support hundreds of users simultaneously. Its architecture allows for easy upgrades in hardware, meaning that organizations can scale their systems without replacing the entire infrastructure.

Security is another critical attribute of the AS/400. With a sophisticated security model, it offers built-in user authentication, access control, encryption, and auditing capabilities to protect data and applications from unauthorized access.

The AS/400 also supports multiple programming languages, including RPG, COBOL, Java, and PHP, giving organizations the flexibility to choose the development tools that best fit their needs. This diversity helps maintain legacy applications while also developing new ones that leverage modern technologies.

Moreover, the platform supports both traditional green-screen interfaces and modern graphical user interfaces, allowing organizations to transition smoothly into contemporary user experience paradigms.

Overall, the IBM AS/400 stands out as a resilient, flexible, and secure computing platform that enables organizations to effectively manage their business operations, streamline processes, and adapt to changing market demands. Its unique combination of integrated features and capabilities ensures that it remains relevant in today's fast-paced technology landscape.