EZBTMIC1 or EZBTMIC4 parameters

Token
The name of a record containing a token describing a TCP⁄IP management interface data buffer.
Bufptr

The address of a buffer into which the TCP⁄IP management data buffer is copied. Allocate the buffer by using the size provided in field tmii_bufsz in the Initialization record (tmi_init) that is sent to the application by the server.

The bufptr parameter is a 12-byte structure describing the address of the buffer: 
Bufptr        DS 0F           /* Buffer pointer */
Buf_alet      DC F'0'         /* Buffer ALET, or 0 */
Buf_addr_hi   DC F'0'         /* Highword of 64bit bufptr */
Buf_addr      DC A(0)         /* Lowword of 64bit bufptr */

If the buffer is in a data space, then Buf_alet is the ALET of the data space; otherwise it is 0. If the buffer is in 64-bit storage, then Buf_addr_hi and Buf_addr contain the 64-bit address of the buffer. If the buffer is in 24-bit or 31-bit storage, then Buf_addr_hi contains zeros and the buffer address in Buf_addr. To improve performance, place the buffer on a page boundary.

This buffer can represent the following information:
  • When the token is a TmiHr_PktTok token, the data buffer contains the unformatted packet trace data records (SYSTCPDA or SYSTCPOT).
  • When the token is a TmiHr_SmfTok token, the data buffer contains SMF records (SYSTCPCN, SYSTCPSM, SYSTCPER or SYSTCPES).
Return_value
Returned parameter. The name of a fullword in which the TMI buffer copy service returns the results of the request:
  • >0: The data buffer has been successfully copied into the application buffer. The return value is the number of bytes of data that has been copied into the buffer. This length does not include the trailing halfword of zeros in the buffer.
  • -1: The system could not complete the request, for reasons such as the data buffer being no longer valid. See Return_code and Reason_code for more details.
Return_code
Returned parameter. The name of a fullword in which the TMI buffer copy service stores the return code. The TMI buffer copy service returns Return_code only if Return_value is -1. The TMI buffer copy service can return one of the following values in the Return_code parameter:
Return_value Return_code Meaning
>0 0 The request was successful.
-1 EACCES The application is not authorized.
-1 EBADF The token provided to locate a buffer is not a valid token.
-1 EFAULT The address is incorrect.
-1 EINVAL The token provided to locate a buffer does not specify a valid data buffer.
-1 EILSEQ The data buffer described by token has been overwritten and is no longer available.
Reason_code
The name of a fullword in which the TMI buffer copy service stores the reason code.

The TMI buffer copy service returns Reason_code only if Return_value is -1. The reason code contains diagnostic information and is described in z/OS UNIX System Services Messages and Codes.