This topic describes the flow control and implemented functions and response codes for the NATURAL data buffer processing API.
Flow of control:
NATCICS Adapter -> Proxy transaction (AASNATC) -> CICS NATURAL nucleus -> NATURAL program <-> AASSUBC. (Note that in the illustration in Generating a Synonym IWAYIVPD is an example of an AASNATC proxy transaction.)
Communication with the Data Mover program requires the following control block: 1 #REQUEST-PARMS 2 #FUNCTION (A2) One of the following: GT,PT,LC,LI 2 #OFFSET (I2) 2 #LENGTH (I2) Length of data for GT or PT functions 2 #RESPONSE-CODE (I4)
The implemented functions are:
1 #EMP-NUM1 (A8) 1 #EMP-SALARY (A6) ................ MOVE 'GT' TO #FUNCTION MOVE 8 TO #LENGTH MOVE 0 TO OFFSET CALL 'AASSUBC' #FUNCTION #EMP-NUM1 MOVE 6 TO #LENGTH CALL 'AASSUBC' #FUNCTION #EMP-SALARY
1 #EMP-NUM1 (A8) INIT <'12345678'> 1 #EMP-SALARY (A6) INIT <' 65000'> ................ MOVE 'PT' TO #FUNCTION MOVE 8 TO #LENGTH MOVE 0 TO OFFSET - FIRST CALL ONLY CALL 'AASSUBC' #FUNCTION #EMP-NUM1 MOVE 6 TO #LENGTH CALL 'AASSUBC' #FUNCTION #EMP-SALARY
MOVE 'LI' TO #FUNCTION CALL 'AASSUBC' #FUNCTION
MOVE 'LC' TO #FUNCTION CALL 'AASSUBC' #FUNCTION
Implemented response-codes:
0 - operation completed successfully.
4 - end-of-data. Cursor positioned beyond the input buffer. Indicates end of input data.
8 - end-of-buff. Cursor position plus requested length for PT operation exceeds the COMMAREA length. Indicates COMMAREA overflow.
Note:
WebFOCUS |