IBM AS/400E manual Configuration APIs, Convert URL to Path QzhbCvtURLtoPath API

Error messages

CPF24B4 E

Severe Error while addressing parameter list.

CPF3C17 E

Error occurred with input data parameter.

CPF3CF1 E

Error code parameter not valid.

Configuration APIs

The configuration APIs are in *SRVPGM QZHBCONF in library QHTTPSVR. ILE C programs must include header file QHTTPSVR/H(QZHBCONF).

While each individual API lists its own authorities, the following authorities are needed to run all configuration APIs:

v*OBJOPR, *READ, *ADD, and *EXECUTE to the QUSRSYS library

v*READ, *ADD, *DELETE, *EXECUTE, *OBJOPR, *OBJEXIST, and either *OBJMGT or *OBJALTER to the QUSERSYS/QATMHTTPC file

v*READ, *ADD, *DELETE, *EXECUTE, *OBJOPR, *OBJEXIST, and either *OBJMGT or *OBJALTER to the QUSERSYS/QATMHTTPA file

Note: The QUSERSYS/QATMHTTPA file is the administration (ADMIN) server configuration file.

Convert URL to Path (QzhbCvtURLtoPath) API

Required Parameter Group:
1	Name of Configuration	Input	Char(10)
2	The URL	Input	Char(*)
3	Length of the URL	Input	Binary(4)
4	Path to physical resource	Output	Char(*)
5	Length of path available	Input	Binary(4)
6	Actual length of path	Output	Binary(4)
7	PATH_TRANSLATED	Output	Char(*)
8	Length of PATH_TRANSLATED	Input	Binary(4)
	available
9	Actual length of	Output	Binary(4)
	PATH_TRANSLATED
10	QUERY_STRING	Output	Char(*)
11	Length of QUERY_STRING	Input	Binary(4)
	available
12	Actual length of	Output	Binary(4)
	QUERY_STRING
13	Error Code	I/O	Char(*)

Threadsafe: Yes

Use the QzhbCvtURLtoPath to convert a URL into the physical resource the webserver serves as a result of a request of this URL. All character input and output data will be in the CCSID of the job.

Authorities and locks

v*EXECUTE authority to the QUSRSYS library

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

38Web Programming Guide V4R5