Remove Triggered Cache Manager Data Source Description (QzhtRmvTCMDataSourceDesc) 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/QZHTINCONF
Threadsafe: Yes

Use the QzhtRmvTCMDataSourceDesc API to remove data source descriptions associated with triggered cache manager servers. Trigger handler descriptions currently referencing the removed data source descriptions are not changed, however they are no longer valid after the servers are started. The API is a callable service implemented as an ILE entry point within the QZHTINCONF *SRVPGM in the QTCM *LIB.

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

Authorities and locks

Required parameter group

request variable
INPUT: CHAR(*)

The variable used to pass the information used to remove a data source description. See Description identity formats for more information.

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 the Request variable data. The following values must be used:
  • DSDP0100: Basic information format for configuration descriptions.
Note: See Description identity formats for more information.
error code
I/O: CHAR(*)

The structure in which to return error information.

DSDP0100 format

Offset Type Field
Dec Hex
0 0 Char(32) Server name
32 20 Char(32) Data source description name

Field descriptions

Note: Data source descriptions are added using default values for all unspecified values according to the type specified by Data source type). See other data source description formats for details regarding these default values.
Data source description name
The name used by the new data source description (left justified and padded with blanks if necessary).
Note: An escape message is sent if the description is removed while being referenced by trigger handler descriptions.
Server name
The name used to identify the triggered cache manager server for which the description is removed (left justified and padded with blanks if necessary).

Error messages

TCM7001 E
User &1 is not authorized.
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 specified format.
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 triggered cache manager server &1 was not found.
TCM72C0 E
Triggered cache manager &1 name is not valid.
TCM72C3 E
Value passed to offset &1 is not valid.
TCM74C0 E
Triggered cache manager server name is not valid.