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


Common request requirements

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

All the requests require a RCCHeader structure that is defined as the first structure in the RequestResponseBuffer storage area that is passed as input to the request. You must set the following fields in the RCCHeader before invoking a request:
  • RCHREye
  • RCHRVer
  • RCHRRequest - Set this field to the request constant.
  • RCHRLen
  • RCHRNum
Table 1 shows the RCCHeader layout of these fields. The RCHRToken field is returned by the RCCOpen request and must be provided in the RCCHeader structure that is specified as input to all other requests. The RCCHeader structure is followed by one or more additional structures that are specific to the request.
Table 1. RCCHeader structure
Offset Field Length Format Description
0(X'0') RCHREye 4 EBCDIC RCHR eyecatcher
4(X'4') RCHRVer 1 Binary Version
5(X'5') RCHRRequest 1 Binary Request type:
  • 1 - RCCOpen
  • 2 - RCCSetFilters
  • 3 - RCCStart
  • 4 - RCCGetRecords
  • 5 - RCCStop
  • 6 - RCCClose
6(X'6') RCHRLen 2 Binary Length of RCCHeader structure
8(X'8') RCHRNum 2 Binary Number of additional input structures. This value does not include the RCCHeader structure.
10(X'A')   6 Binary Reserved
16(X'10') RCHRToken 16 Binary Token that is returned by the RCCOpen request
32(X'20')   16 Binary Reserved

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014