DATASAVE

With the DATASAVE statement, you can save data specified manually or data in a buffer by placing it in a save or user area. With the TEXT operand of the DATASAVE statement, you can save data specified manually in hexadecimal or EBCDIC format or data generated with data field options.

The following example illustrates two DATASAVE statements:

SAVE1  DATASAVE  AREA=3,LOC=B+80,   Specifies the data to be saved and
                 LENG=100           the area it is to be saved in.
SAVE2  DATASAVE  AREA=U+0,          Uses a data field option to generate
                 TEXT=($ID,8$)      data to be saved.

In the preceding example, SAVE1 saves 100 bytes of data at an offset of 80 into the buffer and places it in device save area number 3. SAVE2 generates the 8-character name of the terminal associated with this deck and places the name in the device user area.

If you code the TEXT operand on the DATASAVE statement without specifying any data, WSim performs a clear function on the area defined by the AREA operand. For dynamic save areas, the storage associated with the save area is released for other uses.

SAVEA  DATASAVE  AREA=5,TEXT=()   Specifies that WSim perform a clear
*                                 function on device save area 5.

For more information about the clear function, see the WSim Script Guide and Reference.

You can retrieve data saved in a save or user area with the $RECALL$ data field option, as discussed in Inserting data into a message.