Delete a Server Instance (QzuiDeleteInstance) API

Important: Information for this topic supports the latest PTF levels for HTTP Server for i5/OS . It is recommended that you install the latest PTFs to upgrade to the latest level of the HTTP Server for i5/OS. Some of the topics documented here are not available prior to this update. See http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm Link outside Information Center

for more information.

Required Parameter Group:
1	name	Input	Char(10)
2	errcode	I/O	Char(*)
Threadsafe: Yes

Use the QzuiDeleteInstance API to delete a server instance.

Authorities and locks

*EXECUTE authority to the QUSRSYS library
*OBJOPR, *OBJEXIST, *DLT and either *OBJMGT or *OBJALTER authority to the QUSRSYS/QATMHINSTC file

Required parameter group

name: INPUT:CHAR(10)
The server instance name you want to delete. The name can be up to 10 characters long (padded with blanks).

errcode: I/O:CHAR(*)
The structure in which to return error information.

Error messages

CPF3CF1 E: Error code parameter not valid.

HTPA001 E: Input parameter &1 not valid.

HTPA101 E: Server instance &1 not found or is unreadable.

HTPA102 E: Unable to update server instance &1.

CPF9802 E: Not authorized to object &2 &3.