Start Session Advise

The Start Session Advise function establishes the link between the client application and Personal Communications. As the data item is changed, the client application receives the changed data of the presentation space (PS), operator information area (OIA), or trim rectangle (TRIMRECT).
DDE Parameter Value
Item PS (pos, len, bCaseSen, "string") PS TRIMRECT (row1, col1, row2, col2) TRIMRECT (pos1, pos2) TRIMRECT OIA

The maximum length of the search string is 255.

Parameter Value Explanation
pos NNNN PS start position of the string search (PS offset)
len NNNN Length of the search string
bCaseSen 1 or 0 Case sensitivity
1
Yes
0
No
"string"   Search string
  • Enclose a string including blanks with double quotation marks.
  • To specify a double quotation mark within the string, enclose the double quotation mark with another set of double quotation marks. Example: This is a double quotation" mark. is specified as "This is a double quotation""" mark."
Note:
An item in the IBM Personal Communications Version 3.1 format is also supported.

To receive a conditional advice when the presentation space is updated, the client application needs to set the advise conditions as well as the foregoing parameter values. The foregoing parameter values can be used when the presentation space is specified as the item name.

Parameter Value Explanation
row1 NN Top-left corner row of the trim rectangle
col1 NN Top-left corner column of the trim rectangle
row2 NN Bottom-right corner row of the trim rectangle
col2 NN Bottom-right corner column of the trim rectangle
pos1 NNNN PS position of the top-left corner of the trim rectangle
pos2 NNNN PS position of the bottom-right corner of the trim rectangle
Note:
An item in the IBM Personal Communications Version 3.1 format is also supported.

The current specified presentation space trim rectangle is used unless the client application specifies the presentation space trim rectangle in the item name parameter. This parameter value can be used when TRIMRECT is specified as the item name.

The client application can use the Personal Communications DDE function by specifying the DDE function (Advise) of the client application with the foregoing item name.