Start Triggered Cache Manager Server (QzhtStrTCMServer) 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 QzhtStrTCMServer API to start the triggered cache manager servers. The API is a callable service implemented as an ILE entry point within the QZHTINOPS *SVRPGM 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 used to pass information used to start existing 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 started (left justified and padded with blanks if necessary). The value must specify an server name, or be one of the special values described below.

Special values and their meanings are as follows:

*AUTOSTART
QZHT_AUTOSTART_CHAR: All triggered cache manager servers having the autostart property set to ’1’ (QZHT_YES, QZHT_TRUE, QZHT_ENABLED) are started.
*ALL
QZHT_ALL_CHAR: All triggered cache manager servers are started.

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.
TCM7101 E
User QTCM is not authorized to the configuration file for triggered cache manager server &1.
TCM7190 E
A configuration file for the triggered cache manager server &1 was not found.
TCM7390 E
Triggered cache manager server &1 not found.
TCM74C0 E
Triggered cache manager server name is not valid.
TCM73C3 E
Triggered cache manager server &1 is active.