ZCOM Tables and Data Structures

Response Records

RPTYPE - Expected response type

This field contains the type of response the waiter is expecting. The LDM sets up the response type when it initializes the record. This field is validated when a response is returned. Currently, it may contain one of the values in Table 3-26.

Table 3-26

Response Type Field

 

 

 

 

 

 

Symbol

Value

Meaning

 

 

 

ZCOM_RPTYPE_BUFFER

1

Buffer completion response

 

 

 

ZCOM_RPTYPE_REMOTE

2

Remote completion response

 

 

 

ZCOM_RPTYPE_IRR

3

Interface request response

 

 

 

 

A buffer completion response is returned when a local request (e.g. port configuration) is completed. A remote completion response is returned when a remote API request is processed in the remote system. An interface request response is returned when ZCOM has completed an interface control request.

RPNODE - Remote node

This contains the remote node number for a remote completion response. It is initialized by the LDM before a remote request is sent, and is used to validate the returned response.

RPSEQN - Request/Response sequence number

For remote and interface requests, the LDM generates and stores a request sequence number in this field. This number is used to validate the returned response.

RPEXPT - Response expiration timeout value

This filed contains the expiration time (Coordinated Universal Time, in seconds) of an outstanding request. The LDM generates a timeout response if the current time exceeds this value. Currently, only the remote completion response uses this field to trigger timeout processing.

RPCODE - Return status or error code

When a response is received, the response status or error code is temporarily stored in this field. The value is then picked up by the waiting process when it resumes execution.

Chapter 3

99