Parameters

opcode
AP_RAPI_CLIENT_INDICATION
primary_rc
AP_OK
data_lost
Specifies whether any previous client indications have been lost. If CS/AIX detects a condition that prevents it from sending an indication (for example an internal resource shortage), it indicates this by setting the data_lost parameter on the next indication after the condition has cleared. Possible values are:
AP_YES
One or more previous client indications were lost. Later fields in this VCB may be set to zeros.
AP_NO
No previous client indications were lost.
reason
Specifies the status change that has occurred for this client. Possible values are:
AP_RAPI_CLIENT_CONNECTED
The client has started and has connected to this CS/AIX server as its controller server.
AP_RAPI_CLIENT_DISCONNECTED
The client has stopped and has disconnected from the CS/AIX server.
sys_name
The fully-qualified system name of the client (such as newbox.this.co.uk).
rapi_client_origin_ip_addr
The IP address of the client.
rapi_client_origin_ip_addr.family
The type of TCP/IP address specified for the client. Possible values are as follows. (These are standard TCP/IP values rather than AP_* values defined by CS/AIX.)
AF_INET
IPv4 address, specified as a dotted-decimal address (such as 193.1.11.100).
AF_INET6
IPv6 address, specified as a colon-hexadecimal address (such as 2001:0db8:0000:0000:0000:0000:1428:57ab or 2001:db8::1428:57ab).
Note: The values AF_INET and AF_INET6 are taken from a system header file, and are not standard AP_* values defined by CS/AIX. The system header file is /usr/include/sys/socket.h on an AIX server or client, and /usr/include/linux/socket.h on a Linux client.

If your NOF application needs to test against these values, you should use #include to include this system file in addition to the nof_c.h header file.

rapi_client_origin_ip_addr.ip_addr.ipv4_addr
This field is used only if the family parameter is set to AF_INET. The IPv4 (dotted-decimal) address of the client computer.
rapi_client_origin_ip_addr.ip_addr.ipv6_addr
This field is used only if the family parameter is set to AF_INET6. The IPv6 (colon-hexadecimal) address of the client computer.
rapi_client_adj_ip_addr
The IP address through which the client attaches to CS/AIX. This may not be the same as rapi_client_origin_ip_addr if one of the following is true.
  • The client connects through a Web server.
  • The client connects through a TCP/IP proxy or NAT router, such as the Linux iptables tool.
  • The client has multiple IP addresses.
rapi_client_adj_ip_addr.family
The type of TCP/IP address through which the client attaches to CS/AIX. Possible values are as follows. (These are standard TCP/IP values rather than AP_* values defined by CS/AIX.)
AF_INET
IPv4 address, specified as a dotted-decimal address (such as 193.1.11.100).
AF_INET6
IPv6 address, specified as a colon-hexadecimal address (such as 2001:0db8:0000:0000:0000:0000:1428:57ab or 2001:db8::1428:57ab).
Note: The values AF_INET and AF_INET6 are taken from a system header file, and are not standard AP_* values defined by CS/AIX. The system header file is /usr/include/sys/socket.h on an AIX server or client, and /usr/include/linux/socket.h on a Linux client.

If your NOF application needs to test against these values, you should use #include to include this system file in addition to the nof_c.h header file.

rapi_client_adj_ip_addr.ip_addr.ipv4_addr
This field is used only if the family parameter is set to AF_INET. The IPv4 (dotted-decimal) address through which the client attaches to CS/AIX.
rapi_client_adj_ip_addr.ip_addr.ipv6_addr
This field is used only if the family parameter is set to AF_INET6. The IPv6 (colon-hexadecimal) address through which the client attaches to CS/AIX.
rapi_client_adj_port
The IP port number through which the client attaches to CS/AIX.