Target Buffer

OUTPUT:CHAR(*)

This is output buffer that contains the information requested by the command string (if any).

Length of Target Buffer

INPUT:BINARY(4)

The length of the target buffer provided to receive the API output.

Length of Response

OUTPUT:BINARY(4)

The actual length of the information returned in the target buffer.

Error Code

I/O:CHAR(*)

The structure in which to return error information. For the format of the structure and for details on how to process API errors, see the programming topic in the AS/400 Information Center.

CGII0200 Format

Offset

Offset

Type

Field

Decimal

Hexadecimal

 

 

 

 

 

 

0

0

BINARY(4)

Bytes returned

 

 

 

 

4

4

BINARY(4)

Bytes available

 

 

 

 

8

8

CHAR(20)

Continuation handle

 

 

 

 

28

1C

BINARY(4)

Offset to first variable entry

 

 

 

 

32

20

BINARY(4)

Number of variable entries returned

 

 

 

 

36

24

CHAR(*)

Reserved

 

 

 

 

 

 

BINARY(4)

Length of variable entry (See note)

 

 

 

 

 

 

BINARY(4)

Length of variable name (See note)

 

 

 

 

 

 

CHAR(*)

Variable name (See note)

 

 

 

 

 

 

BINARY(4)

Length of variable value (See note)

 

 

 

 

 

 

CHAR(*)

Variable value (See note)

 

 

 

 

 

 

CHAR(*)

Reserved (See note)

 

 

 

 

Note: These fields contain variable entry information and are repeated for each variable entry returned.

Field descriptions

Bytes returned The number of bytes of data returned.

Bytes available The number of bytes of data available to be returned. All available data is returned if enough space is available.

Continuation handle The handle that is returned when more data is available to return, but the target buffer is not large enough. The handle indicates the point in the repository that the retrieval stopped. If the handle is used on the next call to the API (using the -againflag), the API returns more data starting at the point that the handle indicates. This field is set to blanks when all information is returned.

Chapter 2. Application Programming Interfaces 35

Page 44 Page 46
Page 45
Image 45
IBM AS/400E manual Length of Target Buffer
Page 44 Page 46

AS/400E specifications

The IBM AS/400E, now more commonly known as IBM i, is a robust and versatile midrange server that has been designed to provide a comprehensive computing solution for businesses of all sizes. First introduced in the late 1980s, the AS/400 series has undergone multiple enhancements and rebranding, with the AS/400E being one of the notable iterations. This powerful platform is closely associated with IBM's commitment to reliability, scalability, and integrated business solutions.

One of the main features of the AS/400E is its highly integrated architecture that combines hardware and software into a cohesive system. This integration allows for seamless operations, reducing the complexity typically associated with managing disparate systems. The system is powered by IBM's proprietary OS/400 operating system, which has evolved into IBM i, featuring advanced capabilities like object-oriented programming, integrated database management, and security features that are essential for enterprise environments.

A key characteristic of the AS/400E is its robust database support, primarily through the use of DB2 for i. This integrated database management system enables efficient data handling and retrieval, facilitating real-time business analytics and reporting. Furthermore, the platform supports a variety of programming languages, including RPG, COBOL, and Java, making it flexible for developers who require diverse tools for application development.

The AS/400E is also known for its exceptional reliability and uptime, making it a preferred choice for critical business applications in industries such as finance, healthcare, and manufacturing. This reliability is backed by advanced error detection and correction mechanisms, as well as redundancy features that help prevent data loss and minimize downtime.

In terms of scalability, the AS/400E can effortlessly expand to accommodate growing business demands. Organizations can increase processing power by adding more resources without significant disruption. This scalability, combined with the system’s built-in virtualization capabilities, allows businesses to optimize resource usage and streamline operations.

Security is another defining feature of the AS/400E. The platform incorporates various layers of security measures, including user authentication, encryption, and comprehensive auditing capabilities, ensuring that sensitive business data is protected against unauthorized access.

Overall, the IBM AS/400E remains a powerful tool in the enterprise computing landscape, providing businesses with an integrated, reliable, and secure solution for their technological needs. Its enduring popularity is a testament to its capability to evolve with changing business requirements while maintaining its core attributes of high performance and stability.
Top Page Image Contents