CONVERSE

After you have built a 3270 data stream in map-out variable (for example with BUILDMAP OUT statement), use this instruction to display it on the screen. If map contain digitable fields, these are written in map-in variable (also a string 2000 bytes long ), coded in 3270 inbound data stream format. map-in can be the same variable map-out (if you want lose the builded 3270 outbound datastream).

Input send key is coded in Hilmas variable $AID.

Hilmas variable $MAPLEN is used as map length (and is automatically filled by BUILDMAP); use LEN= to override this variable.

MAP= and MAPSET= are CICS only parameters and can be used if you have already defined a traditional CICS map and mapset (without using BUILDMAP but with old DFH macros compiled in a separate load module....) but you want use CONVERSE instruction instead of EXEC CICS SEND MAP and EXEC CICS RECEIVE MAP.

CONVERSE in CICS environment is by default conversational, that is program is suspended (and remain in main storage) waiting for user's next send key; this instruction can be changed in pseudo-conversational using parameter PSEUDO=YES in PROGRAM statement, in a transparent manner. In this way program running CONVERSE finishes with an automatic RETURN TRANSID, and restart after a send key filling the CONVERSE map-in variable and running the following statements.

	Parameter Name	Mode	Type	coding	Remark
1	map-out	Input	String	C or X	contains outbound 3270 datastream
2	map-in	Output	String	C or X	contains inbound 3270 datastream
	MAP=				CICS only
	MAPSET=				CICS only
	LEN=$MAPLEN	Input	Integer	F or H

 

Examples