EZBRCIFR parameters

RequestResponseBuffer

Supplied parameter.

Type:

Character

Length:

Variable

The name of the storage area that contains the input structures for a request. The input must be in the format of a request header structure (RCCHeader) that is followed by one or more input structures that are specific to the request. Table 1 shows the files in which the structures that are used for the requests are defined.

Table 1. Request structure definition files
File name	Language and type	Installed location
EZBRCIFA	Assembler macro	SEZANMAC
EZBRCIFC	C/C++ header	SEZANMAC and the z/OS® UNIX /usr/include file system directory

Rule: For C/C++ applications, the LANGLVL(EXTENDED) compiler option must be specified because of the definition of anonymous unions in header file EZBRCIFC.

See Real-time control NMI: Requests for a description of the input structures for each request.

RequestResponseBufferLength

Supplied parameter.

Type:

Integer

Length:

Fullword

The name of a fullword that contains the length of all the input structures in RequestResponseBuffer.

ReturnValue

Returned parameter.

Type:

Integer

Length:

Fullword

The name of a fullword in which the EZBRCIFR interface returns one of the following values:

0: The request is successful.
-1: The request is not successful.

ReturnCode

Returned parameter.

Type:

Integer

Length:

Fullword

The name of a fullword in which the EZBRCIFR interface stores the return code (errno). The EZBRCIFR interface returns the ReturnCode value only if the ReturnValue value is -1. Table 1 provides all the common return codes. Return codes that are specific to each request are provided under the request. See z/OS UNIX System Services Messages and Codes for a description of the return codes.

ReasonCode

Returned parameter.

Type:

Integer

Length:

Fullword

The name of a fullword in which the EZBRCIFR interface stores the reason code (errnojr). The EZBRCIFR interface returns the ReasonCode value only if the ReturnValue value is -1. The ReasonCode value further qualifies the ReturnCode value. Table 1 provides all the reason codes for the common return codes. Reason codes that are specific to each request are provided under the request. See z/OS UNIX System Services Messages and Codes for a description of the reason codes.