CAS Programming Interface ($CACALL) › Action=EDIT Class=DATA

Action=EDIT Class=DATA

This statement displays text in edit mode. The EDIT DATA function provides editing facilities for up to 9999 lines of text, each of up to 256 characters in length. When a user requests help, help text associated with the specified application ID and function name is displayed.

This statement has the following format:

&CONTROL SHRVARS=($ED)
-EXEC $CACALL      OPT=ACTION
                   ACTION=EDIT
                   CLASS=DATA
                   PARMS='APPL=application id
                           FUNC=function name
                           [TITLE=title]
                           [LINECNT={0 | n}]
                           [LINELEN={256 | n}]
                           [MAXLINES={9999 | n}]
                           [EDTLINES=n]
                           [TOPEXIT={YES | NO}]
                           [MESSAGE=message]
                           [USERFUNC=function]
                           [LINETOP={1 | n}]
                           [LMARGIN={1 | n}]
                           [RMARGIN=n]'

• APPL=application id

  A required parameter giving the application identifier.

• FUNC=function name

  A required parameter indicating the function being performed.

• TITLE=title

  An optional parameter giving the title to be displayed at the top of the panel. The default is CAS : Text Editor.

• LINECNT={0 | n}

  A required parameter giving the number of lines of text. The default is 0, and the range is 0 through 9999.

• LINELEN={256 | n}

  An optional parameter indicating the maximum line length. The default is 256, and the range is 1 through 256.

• MAXLINES={9999 | n}

  An optional parameter indicating the maximum number of lines of text that can exist. The default is 9999, and the range is 1 through 9999.

• EDTLINES=n

  An optional parameter giving the number of lines that can be edited. If specified, the first n lines can be edited. If not specified, the number of lines that can be edited defaults to the value of the LINECNT parameter—that is, all lines can be edited. The range is 0 to the value in LINECNT.

• TOPEXIT={YES | NO}

  An optional parameter indicating whether executing the BACKWARD command—when the display is positioned at the top of the text—ends the text display and causes control to be returned to the caller. The default is NO.

• MESSAGE=message

  An optional parameter specifying a message to be displayed on line 3 of the panel, on initial entry.

• USERFUNC=function

  An optional parameter specifying the logical function being performed (for example, Update). If specified, the function is displayed on line 4 of the panel as Function=function. function must not be longer than eight characters.

• LINETOP={1 | n}

  An optional parameter specifying the number of the line to be displayed as the first line of text, on initial entry. The default is 1, and the range is 1 through the value in LINECNT.

• LMARGIN={1 | n}

  The left margin (in characters) used by the text editor. The default is 1, and the range is 1 through the value in LINELEN.

• RMARGIN=n

  The right margin (in characters) used by the text editor. The default is the lesser of the value in LINELEN and the logical screen width. The range is the value of LMARGIN plus 20 to the value in LINELEN.