<ENTRY NAME=card_name
    MARKABLE=boolean
    TITLE=card_title
    BOOKMARK=markURL
    FORMAT=format_specifier
    DEFAULT=default_value
    KEY=var
    NOECHO=boolean
    EMPTYOK=boolean >

    actions
    display_content

</ENTRY>

An entry card displays content followed by an entry line in which the user enters data. To define an entry card, you use an <ENTRY> statement. The statement specifies the format for data entered by the user and a variable to which the value in the field is stored. It can also specify a default value.

Syntax

NAME=card_name   A name for the card. Other cards can specify this name as a destination.  
MARKABLE=boolean   Flag specifying whether the card can be marked. To allow the card to be marked, specify TRUE. The default value is determined by the MARKABLE option for the deck (see <HDML>). Always set the MARKABLE option to FALSE for cards that execute or confirm transactions that the user might not want to repeat. If you set the MARKABLE option to TRUE, it implicitly sets the PUBLIC option to TRUE, allowing other URLs to link directly to the card.  
TITLE=cardtitle   The default bookmark name that appears when the user marks the card.  
BOOKMARK=markURL   The URL the phone adds to the bookmark list if the user marks the card. If you do not specify the BOOKMARK option, the phone adds the URL of the current card to the bookmark list.  
FORMAT=format_specifier   A format specifier for the data the user enters. It uses a combination of the following: A: any uppercase alphabetic character or punctuation (no numbers) a: any lowercase alphabetic character punctuation (no numbers) N: any numeric character (no symbols) X: any numeric, symbolic, or uppercase alphabetic character or punctuation x: any numeric, symbolic, or lowercase alphabetic character or punctuation M: any alphabetic character (of any case), and any numeric or symbolic character. If it is preceded by a number or * specifier, the first character the user enters is uppercase by default (the user can change it to lowercase) m: any alphabetic character (of any case), and any numeric or symbolic character. If it is preceded by a number or * specifier, the first character the user enters is lowercase by default (the user can change it to uppercase) To allow a number of instances of a particular character, precede the character with a single digit number. To allow unlimited instances, precede it with an asterisk (*). For example, the specifier 3X allows the user to enter three numeric uppercase or alphabetic characters; *X allows the user to enter any number of numeric uppercase or alphabetic characters. Note that you can use this type of specifier (e.g. 3X or *X) only once in a formatting string and only at the end of the string. You can also use the format specifier to automatically insert characters into the entry field. Precede each character you want to automatically insert with a backslash. The default format is *M (any number of mixed case alphabetic and numeric characters). The FORMAT option is discussed more in the text below.  
DEFAULT=default_value   A string that appears in the entry field when the UP.Phone first displays the card. The user can edit the string. The default value can be formatted text or a variable containing text. If the variable specified by the KEY option has a value, it overrides the value specified by the DEFAULT option.  
KEY=var   The name of the variable to which the UP.Phone stores the data entered by the user. If the specified variable already has a value, the value appears as the default in the entry field.  
NOECHO=boolean   If NOECHO is set to TRUE, the phone hides text the user enters. After the user enters a character, the phone displays it as an asterisk (*) The default is FALSE.  
EMPTYOK=boolean   If you set EMPTYOK to TRUE, the phone accepts empty input, even if you have specified a format with the FORMAT option. The default is FALSE.  
actions   The actions to execute when the user presses a function key. For more information on specifying actions, see <ACTION>.  
display_content   The formatted text message to display above the entry line.  

To instruct the UP.Phone to automatically add characters to the entry field, include them in the format string. Precede each character with a backslash. As the user reaches the position of each character, the UP.Phone adds it automatically. For example, if you specify the following string:

\(NNN\)\ NNN\-NNNN

the UP.Phone adds the left parenthesis to the entry field immediately. After the user types three characters, the UP.Phone automatically adds the right parenthesis and a space. Users can not edit the automatically added characters.