Managing Dynamically-Allocated Storage

The logic of the subprocedures is as follows:

1.DYNA_INIT creates the heap using the ILE bindable API CEECRHP (Crea Heap), storing the heap Id in a global variable HeapId. It alloc

based on

initial value of the array (in this case 100) by calling

API CEEGTST

(Get Heap Storage).

2.DYNA_TERM destroys the heap using the ILE bindable API CEEDSHP (Discard Heap).

3.DYNA_SET sets the value of an element in the array.

Before adding an element to the array, the procedure checks to s sufficient heap storage. If not, it uses operation code REALLOC to additional storage.

4. DYNA_GET returns the value of a specified element. The procedure the caller either the element requested, or zeros. The latter occ requested element has not actually been stored in the array.

To create the module DYNARRAY, type:

CRTRPGMOD MODULE(MYLIB/DYNARRAY) SRCFILE(MYLIB/QRPGLESRC￿)

The procedure can then be bound with other modules using CRTPGM or

CRTSRVPGM.

Figure 57 shows another module that tests the procedures in DYNARRAY.

*=================================================================

*DYNTEST: Test program for DYNARRAY module. *=================================================================

/COPY EXAMPLES,DYNARRI

D X

S

LIKE(DYNA_TYPE)

 

* Initialize the array

 

C

 

CALLP

DYNA_INIT

 

* Set a few elements

 

C

 

CALLP

DYNA_SET (25 : 3)

C

 

CALLP

DYNA_SET (467252232 : 1)

C

 

CALLP

DYNA_SET (-2311 : 750)

 

* Retrieve a few elements

 

C

 

EVAL

X = DYNA_GET (750)

C

'750'

DSPLY

X

C

 

EVAL

X = DYNA_GET (8001)

C

'8001'

DSPLY

X

C

 

EVAL

X = DYNA_GET (2)

C

'2'

DSPLY

X

 

* Clean up

 

 

C

 

CALLP

DYNA_TERM

C

 

SETON

LR

Figure 57. Sample module using procedures in DYNARRAY

126 ILE RPG for AS/400 Programmer's Guide

Page 150
Image 150
IBM AS/400 manual Get Heap Storage, Crtsrvpgm

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.