This function is valid in all steps, however not all variables are.

The CCSID of the name of the value to set and the buffer which contains the value depends upon the step and the CGI mode. For all steps except Service, these parameters are in the default CCSID of the job. For the Service step, if you are not setting a variable with the ″HTTP″_prefix, then the default CCSID of the job is used. For setting variables prefixed by ″HTTP_″ in the Service step, the CGI output mode determines the CCSID to be used. For %%MIXED%% mode, both are in EBCIDIC 37. For other CGI modes, they are in the default CCISID of the job.

void

 

 

HTTPD_set(

 

 

unsigned char *handle,

/* i; handle

*/

unsigned char *name,

/* i; name of the value to set */

unsigned long *name_length,

/* i; length of the name */

unsigned char *value,

/* i; buffer containing the value */

unsigned long *value_length,

/* i; length

of value */

long *return_code);

/* o; return

code */

HTTPD_file()

Sends a file to satisfy this request. Valid only in PreExit, Service, NameTrans, Error, and DataFilter steps.

The name of the file to send is in the default CCSID of the job.

void

 

HTTPD_file(

 

unsigned char *handle,

/* i; handle */

unsigned char *name,

/* i; name of file to send */

unsigned long *name_length, /* i; length of the name */ long *return_code); /* o; return code */

HTTPD_exec()

Runs a script to satisfy this request. Valid in PreExit, Service, NameTrans, and Error steps.

The name of the script to run is in the default CCSID of the job.

void

 

HTTPD_LINKAGE

 

HTTPD_exec(

 

unsigned char *handle,

/* i; handle */

unsigned char *name,

/* i; name of script to run */

unsigned long *name_length,

/* i; length of the name */

long *return_code);

/* o; return code */

HTTPD_read()

This function reads the body of the client’s request. It uses HTTPD_ extract for headers. This function is valid only in the PreExit, Service, and Data Filter steps.

For the Service step, the data CCSID is determined by the CGI mode. For %%MIXED%% the data is in the default job CCSID and any encoded sequences are the EBCIDIC representation of the ASCII character. For %%EBCIDIC%% and %%EBCIDIC_JCD%% modes, the data is in the default CCSID of the job (including the escape sequences). For %%BINARY%% mode, no conversion is performed. For all other steps, this is the default job CCSID.

void

 

HTTPD_read(

 

unsigned char *handle,

/* i; handle */

unsigned char *value,

/* i; buffer in which to place data */

unsigned long *value_length,

/* i/o; buffer size/length of data */

long *return_code);

/* o; return code */

Chapter 7. Writing Server API programs 117

Page 126 Page 128
Page 127
Image 127
IBM AS/400E manual HTTPDexec, HTTPDread
Page 126 Page 128

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