z/OS Communications Server: IP Programmer's Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


clnt_control()

z/OS Communications Server: IP Programmer's Guide and Reference
SC27-3659-02

Format

#include <rpc.h>
 
bool_t
clnt_control(clnt, request, info)
CLIENT *clnt;
int request;
void *info;

Parameters

clnt
Indicates the pointer to a client handle that was previously obtained using clntraw_create(), clnttcp_create(), or clntudp_create().
request
Determines the operation (either CLSET_TIMEOUT, CLGET_TIMEOUT, CLGET_SERVER_ADDR, CLSET_RETRY_TIMEOUT, or CLGET_RETRY_TIMEOUT).
info
Indicates the pointer to information used by the request.

Usage

The clnt_control() call performs one of the following control operations:
  • Control operations that apply to both UDP and TCP transports:
    CLSET_TIMEOUT
    Sets timeout (info points to the timeval structure).
    CLGET_TIMEOUT
    Gets timeout (info points to the timeval structure).
    CLGET_SERVER_ADDR
    Gets server’s address (info points to the sockaddr_in structure).
  • UDP only control operations:
    CLSET_RETRY_TIMEOUT
    Sets retry timeout (info points to the timeval structure).
    CLGET_RETRY_TIMEOUT
    Gets retry timeout (info points to the timeval structure). If you set the timeout using clnt_control(), the timeout parameter to clnt_call() is ignored in all future calls.

Return codes

The value 1 indicates success; the value 0 indicates an error.

Context

  • clnt_create()
  • clnt_destroy()
  • clntraw_create()
  • clnttcp_create()
  • clntudp_create()
Parent topic: Remote procedure calls in the z/OS Communications Server environment

Go to the previous page Go to the next page

Notices | Terms of use | Support | Contact z/OS | zFavorites



Copyright IBM Corporation 1990, 2014