Throughout this manual, the COBOL field names (which are always written as uppercase letters) are used for the communication area and the KDCS parameter area. In C/C++, field names always use lowercase letters.
Since the field names for C/C++ are (unlike those for COBOL) derived from the corresponding English terms, further differences arise between the KB fields and those in the KDCS parameter area, apart from the different cases used.
Throughout this manual, wherever discrepancies arise which go beyond the simple issue of uppercase and lowercase, the C/C++ field name specified immediately following the COBOL field name; the two are separated by a slash. For example: “KCTAG/kcday”.
In the tables on the next few pages, all COBOL field names which differ from C/C++ field names in more than just the case used are shaded gray.
Moreover, you should also note the following points:
in the data structures kcdad.h and kcpad.h, the fields for time specifications in C/C++ are not combined in a group.
In the data structure kcini.h, the field names are structured differently to their counterparts in the COBOL data structure KCINIC (see table on "INIT Initialize program unit"). These data structures allow you to structure the message area for the INIT call with the modifier PU, and for the call with KCLI>0.
On BS2000 systems, the screen function for reading the ID card reader in C/C++ has the symbolic name KCCARDRD.
Field names in the KB header area KCKBKOPF (ca_hdr)
COBOL name | C/C++ name | Meaning |
|---|---|---|
KCBENID | kcuserid | user identification |
KCTACVG | kccv_tac | service: name of the transaction code |
KCTAGVG | kccv_day | start of service: day |
KCMONVG | kccv_month | start of service: month |
KCJHRVG | kccv_year | start of service: year |
KCTJHVG | kccv_doy | start of service: day of the year |
KCSTDVG | kccv_hour | start time of service: hour |
KCMINVG | kccv_minute | start time of service: minute |
KCSEKVG | kccv_second | start time of service: second |
KCKNZVG | kccv_status | service: status information |
KCTACAL | kcpr_tac | program run: name of the transaction code |
KCSTDAL | kcpr_hour | start time of program run: hour |
KCMINAL | kcpr_minute | start time of program run: minute |
KCSEKAL | kcpr_second | start time of program run: second |
KCAUSWEIS | kccard | status of card reader |
KCTAIND | kctaind | transaction indicator |
KCLOGTER | kclogter | logical terminal name |
KCTERMN | kctermn | terminal mnemonic |
KCLKBPB | kclpa | length of program area |
KCHSTA | kchsta | stack level |
KCDSTA | kcdsta | change in stack level |
KCPRIND | kcprind | program indicator |
KCOF1 | kcof1 | OSI TP functional unit |
KCCP | kccp | client protocol |
KCTARB | kctarb | transaction rollback indicator |
KCYEARVG | kccv_year4 | start of service: day of the year, 4-digit |
Field names in the KB return area KCRFELD (ca_rti)
COBOL name | C/C++ name | Meaning |
|---|---|---|
KCRDF | kcrdf | device feature |
KCRLM | kcrlm | input message length |
KCRINFCC | kcrinfcc | return information from INFO CK |
KCVGST | kcpcv_state | service state of partner |
KCTAST | kcpta_state | transaction state of partner |
KCRMGT | kcrmgt | type of message |
KCRSIGN | kcrsign | status of SIGN ON (complete code) |
KCRSIGN1 | kcrsign1 | primary code of SIGN ON |
KCRSIGN21 | — | secondary code of SIGN ON |
KCRCCC | kcrccc | compatible return code |
KCRCKZ | kcrcid | identifier of DC system |
KCRCDC | kcrcdc | return code of DC system |
KCRMF | kcrfn | format name |
KCRPI | kcrpi | service identification |
KCRQN | kcrqn | return queue name |
KCRWVG | kcrwvg | return number waiting vg |
KCRUS | kcrus | return user (SIGN ST, DGET FT) |
KCRQRC | kcrqrc | queue specific redelivery counter |
KCRGTM | kcrgtm | creation time of DGET message |
KCRDPID | kcrdpid | DPUT ID of DGET message |
KCRRC | kcrrc2 | redelivery counter of DGET message |
1 The field KCRSIGN2 is not defined in the C/C++ data structure ca_rti; the secondary code for the SIGN call is defined in the second and third byte of kcrinfcc.
2 There is no field in the C data structure of the appropriate type that can be used directly. The field KCRRC from kcmac.h of type unsigned short must be used.
Field names in the KDCS parameter area KCPAC (kc_pa)
COBOL name | C/C++ name | Meaning |
|---|---|---|
KCOP | kcop | operation code |
KCOM | kcom | operation modification |
KCLA | kcla | length of data area |
KCLKBPRG | kclcapa | length of ca program area |
KCLM | kclm | length of message (segment) |
KCWTIME | kcwtime | waiting time for DGET messages |
KCLPAB | kclspa | length of standard primary area |
KCRN | kcrn | reference name |
KCMF | kcfn | format name |
KCLT | kclt | logical terminal name |
KCUS | kcus | name of user |
KCPA | kcpa | partner application name |
KCOF | kcof | OSI functions |
KCDF | kcdf | device feature |
KCLI | kcli | length of init area |
EXTENT | kcext | extensions for DPUT, APRO and PADM |
KCDPUT | kcdput | extension for DPUT function |
KCMOD | kcmod | DPUT: modifier |
KCTAG | kcday | DPUT: days |
KCSTD | kchour | DPUT: hours |
KCMIN | kcmin | DPUT: minutes |
KCSEK | kcsec | DPUT: seconds |
KCQTYP | kcqtyp | queue type |
KCQMODE | kcqmode | queue mode |
KCAPRO | kcapro | extension for APRO function |
KCPI | kcpi | APRO: process identification |
KCPADM | kcpadm | extension for PADM function |
KCACT | kcact | PADM: action |
KCADRLT | kcadrlt | PADM: lterm name |
KCNORPLY | kcnorply | CTRL: reply message not permitted |
KCMCOM | kcmcom | redefinition for MCOM function |
KCPOS | kcpos | MCOM: destination in positive case |
KCNEG | kcneg | MCOM: destination in negative case |
KCCOMID | kccomid | MCOM: complex identification |
KCSGCL1 | kc_sgcl | extensions for SIGN CL |
KCLANGID 1 | kclangid | language ID of user |
KCTERRID 1 | kcterrid | territorial ID of user |
KCCSNAME 1 | kccsname | character set name of user |
KCGTM | kcgtm | creation time of message (generation time) |
KCQRC | kcqrc | queue-specific redelivery counter |
KCDPID | kcdpid | DPUT ID of message |
1 Only on BS2000 systems