IBM AS/400E manual HTTPDreversetranslate, HTTPDtranslate, HTTPDset

This password is associated with a user that is defined in a validation list (*VLDL) or the password for a user profile on the AS/400 system.

IBM HTTP Server for AS/400 does not allow access to the PASSWORD variable if authorization is configured which uses AS/400 user profiles and passwords for authentication.

To prevent an application from obtaining an AS/400 user profile password, HTTPD_extract() is sensitive to the type of protect setups that are currently configured. If a protection setup is configured with a password file of %%SYSTEM%% (protection requiring AS/400 user profile password), HTTP_extract() for PASSWORD returns HTTP_PARAMETER_ERROR and sets the value parameter to *CONFLICT. Otherwise, HTTP_extract() returns the appropriate value.

HTTPD_reverse_translate()

Translates a file system path to a URL. Valid in all steps.

The name of the file system object and the buffer containing the URL are in the default CCSID of the job.

void

HTTPD_reverse_translate( unsigned char *handle, unsigned char *name, unsigned long *name_length, unsigned char *value, unsigned long *value_length,

long *return_code);

/* i; handle (NULL right now) */

/* i; name of the file system object */ /* i; length of the name */

/* o; buffer which contains the URL */ /* i/o; size of buffer/length of URL */ /* o; return code */

HTTPD_translate()

Translates a URL to a file system path. Valid in all steps.

The CCSID for QUERY_STRING 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, the CGI mode determines the CCSID. For the %%MIXED%% CGI mode, these fields are in EBCIDIC CCSID 37. For all other CGI modes, these fields are in the default CCSID of the job.

void
HTTPD_translate(
unsigned char	*handle,	/* i; handle (NULL right now) */
unsigned char	*name,	/*	i; name of the URL */
unsigned long	*name_length,	/*	i; length of the name */
unsigned char	*url_value,	/*	o; buffer containing translated URL */
unsigned long	*url_value_length,	/* i/o; buffer size/length of translated URL */
unsigned char	*path_trans,	/* o; buffer containing PATH_TRANSLATED */
unsigned long	*path_trans_length,/*		i/o; size of buffer/length of PATH_TRANSLATED */
unsigned char	*query_string,	/* o; buffer containing QUERY_STRING */
unsigned long	*query_string_length,/* i/o; size of buffer/length of QUERY_STRING */
long	*return_code);	/*	o; return code */

HTTPD_set()

Sets the value of a variable associated with this request. The valid variables you can use for the name parameter are the same as those are used by the CGI program.

Note that you can also create variables with this function. If any variables you create are prefixed by ″HTTP_″, they are sent as headers in the response, without the ″HTTP_″ prefix. For example, if you want to see a Location header, use HTTPD_set() with the variable name

HTTP_LOCATION.

116Web Programming Guide V4R5