End Triggered Cache Manager Server (QzhtEndTCMServer) 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 request variable Input Char(*)
2 length of request variable Input Binary(4)
3 Request variable format Input Char(8)
4 error code I/O Char(*)
Library Name/Service Program: QTCM/QZHTINOPS
Threadsafe: Yes

Use the QzhtEndTCMServer API to end triggered cache manager servers. The API is a callable service implemented as an ILE entry point within the QZHTINOPS *SRVPGM in the QTCM *LIB.

The QTCM/H(QZHTINCONF) header file includes ILE C prototypes for this API.

Authorities and locks

None.

Required parameter group

request variable
INPUT: CHAR(*)

The variable user ID to pass information used to end active triggered cache manager servers.

length of request variable
INPUT: BINARY(4)

The number of bytes that the calling program provides for Request variable.

request variable format
INPUT: CHAR(8)

The format name of Request variable data. The following values must be used:

  • INNP0100: Basic server name format.
error code
I/O:CHAR(*)

The structure in which to return error information.

INNP0100 format

Offset Type Field
Dec Hex
0 0 Char(32) Server name

Field description

Server name
The name used to identify which triggered cache manager server is stopped (left justified and padded with blanks if necessary). The value must specify a server name, or be one of the special values described below.

Special values and their meanings are as follows:

*ALL
QZHT_ALL_CHAR: All triggered cache manager servers are to stopped.

Error messages

TCM7030 E
Severe error occurred while addressing parameter list.
TCM7031 E
Request variable format is not valid.
TCM7033 E
Length of request variable is not valid for the format specified.
TCM703E E
Error code parameter is not valid.
TCM70F0 E
Unknown error occurred while processing request.
TCM7390 E
Triggered cache manager server &1 not found.
TCM73C0 E
Triggered cache manager server &1 is not active.
TCM7401 E
User QTCM is not authorized to server data for triggered cache manager server &1.
TCM74C0 E
Triggered cache manager server name is not valid.