The name of the URL for the proxy request and the body of the request are in the default CCSID of the job.

void

HTTPD_LINKAGE

HTTPD_proxy(

unsigned char *handle, unsigned char *url_name, unsigned long *name_length, unsigned char *request_body, unsigned long *body_length,

long *return_code);

/* i;

handle (NULL right now) */

/* i;

url for the proxy request */

/* i;

length of the url */

/* i;

body of the request */

/* i;

length of the body */

/* o;

return code */

Note: Once an HTTPD_ function returns, it is safe for you to free any memory you passed with it.

Return codes

The server fills in the return code parameter with one of these values depending on the success of the request.

-1HTTPD_UNSUPPORTED

The function is not supported.

0HTTPD_SUCCESS

The function succeeded, and the output fields are valid.

1HTTPD_FAILURE The function failed.

2HTTPD_INTERNAL_ERROR

The function encountered an internal error and cannot continue processing this request.

3HTTPD_PARAMETER_ERROR

You may have added one or more incorrect parameters. For example, the variable you tried to extract is unknown.

4HTTPD_STATE_CHECK

The function is not valid in this step.

5HTTPD_READ_ONLY

Returned only by HTTP_set(). The application can not set the variable.

6HTTPD_BUFFER_TOO_SMALL

Returned only by HTTPD_extract(). The provided buffer was too small.

7HTTPD_AUTHENTICATION_FAILED

Returned only by HTTPD_authenticate(). Examine the HTTP_RESPONSE and HTTP_REASON variables for more information.

8HTTPD_EOF

Returned only by HTTPD_read(). This return code indicates the end of the request body.

9HTTPD_ABORT_REQUEST

The request has been aborted because the client has provided an entity that did not match the condition that is specified by the request.

Chapter 7. Writing Server API programs 119

Page 129
Image 129
IBM AS/400E manual Return codes, Httpdparametererror

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.