HTPA001 E

Input parameter &1 not valid.

HTPA104 E

Server configuration &1 not found or is unreadable.

HTPA105 E

Unable to update server configuration &1.

CPF9802 E

Not authorized to object &2 &3.

Read a Configuration File into Memory (QzhbOpenConfig) API

Required Parameter Group:

 

 

1

name

Input

Char(10)

2

writelock

Input

Binary(4)

3

cfg

Output

Binary(4)

4

errcode

I/O

Char(*)

Threadsafe: Yes

Use the QzhbOpenConfig API to read a configuration file into memory. A handle to the memory copy of the file is returned, and is used in subsequent API calls to manipulate directives within the file. When the copy of the file is no longer required, the QzhbCloseConfig API is used to free it and optionally write the altered contents out.

Authorities and locks

To invoke this API with a writelock value of 0, the user must have the following authorities:

v*EXECUTE authority to the QUSRSYS library

v*OBJOPR and *READ authority to the QUSRSYS/QATMHTTPC file

To invoke this API with a writelock value of 1, the user must have the following authorities:

v*EXECUTE authority to the QUSRSYS library

v*OBJOPR, *OBJMGR, *ADD, and *DLT authority to the QUSRSYS/QATMHTTPC file

Required parameter group

name INPUT:CHAR(10)

The name of the configuration file you want to read into memory. The name can be up to 10 characters long (padded with blanks).

writelock INPUT:BINARY(4)

The value 0 (false) or 1 (true). If the value is 1, an exclusive read object lock is obtained on this member of the QUSRSYS/QATMHTTPC file. No other user can update the configuration while the lock is in place. The lock is released when the QzhbCloseConfig API is called. If the value is 0, no lock is placed on the member.

Chapter 2. Application Programming Interfaces 45

Page 55
Image 55
IBM AS/400E manual Read a Configuration File into Memory QzhbOpenConfig API, Writelock INPUTBINARY4

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.