Tag 040 - Radio Buttons

Simplify supports a Radio Buttons Message. The Request displays a screen with radio buttons, up to three lines of text (Title fields). and an optional row of up to four virtual buttons on the bottom of the screen. The maximum number of characters in all radio button descriptors combined is 2034. The customer can select one radio button and/or one virtual button. A field in the Request (Required) determines whether the Enter key or a virtual button is accepted when no radio button is selected.

Title fields should be used in order, starting with Title1. If this is insufficient, Title2 should be used for the additional text, and if necessary Title3.

A virtual button will only be displayed/active if data is entered in the descriptor field (ButtonNDesc) for the button (N = E through H, from left to right). The field separator for each button descriptor must be present even if the field is null. Note that pressing the Enter key is not required after pressing a virtual button.

The following details are device-specific:

MX 915 – The maximum length of each radio button descriptor (Choice field) is 45. The maximum length of each Title field is 38. The maximum length of each virtual button descriptor is 9. The maximum number of radio buttons displayed on the screen is 9 if only Title1 is used and there are no virtual buttons. This maximum is reduced to 8 if Title2 is used and to 7 if all three Title fields are used. If any virtual buttons are present, these limits are reduced by 1.

MX 925 – The maximum length of each radio button descriptor (Choice field) is 47. The maximum length of each Title field is 40. The maximum length of each virtual button descriptor is 12. If there are no virtual buttons, the maximum number of radio buttons displayed on the screen is 9. If any virtual buttons are present, this maximum is reduced to 8.

One field in the Radio Buttons Response (ActionButton) will indicate whether Enter, Cancel or a virtual button was pressed. Another field (Data) indicates the radio button selected by the customer (if any). Note that the four virtual button positions on the bottom of the screen (positions E through H) return values of 5, 6, 7 and 8 (from left to right) in the Response.

Radio Buttons Message Format

Request

Field 5001

Field Name Length Description
TTT 3 Tag (always = 040)
LLL 3 Length of the following data
Required 1 Data is required when ENTER or a virtual button is pressed (0=No, 1=Yes)
Title1 0-38 (MX915)
0-40 (MX925)
Title 1
FS 1 Field separator (Hex 1C)
Title2 0-38 (MX915)
0-40 (MX925)
Title 2
FS 1 Field separator (Hex 1C)
Title3 0-38 (MX915)
0-40 (MX925)
Title 3
FS 1 Field separator (Hex 1C)
ButtonEDesc 0-8 Descriptor for first button position (from left) on bottom (E)
FS 1 Field separator (Hex 1C)
ButtonFDesc 0-8 Descriptor/field separator for second button position on bottom (F)
FS 1
ButtonGDesc 0-8 Descriptor/field separator for third button position on bottom (G)
FS 1
ButtonHDesc 0-8 Descriptor/field separator for fourth button position on bottom (H)
FS 1
Choice1 0-45 (MX915)
0-47 (MX925)
Choice 1
Field separator (Hex 1C)
FS 1
Choice2 0-45 (MX915)
0-47 (MX925)
radio button text/field separator for Choice 2
FS 1
Choice3 0-45 (MX915)
0-47 (MX925)
radio button text/field separator for Choice 3
FS 1
Choice4 0-45 (MX915)
0-47 (MX925)
radio button text/field separator for Choice 4
FS 1
Choice5 0-45 (MX915)
0-47 (MX925)
radio button text/field separator for Choice 5
FS 1
ChoiceMax 0-45 (MX915)
0-47 (MX925)
radio button text for last Choice
See above for the maximum number of radio buttons depending on the length of the button descriptors.

Response

Field 5001

Field Name Length Description
TTT 3 Tag (always = 040)
LLL 3 Length of the following data
ActionButton 3 If field 11 Completion Code = 000 (success), returns code for key pressed by customer:
5=Button E
6=Button F
7=Button G
8=Button H
777=Enter (green) key
888=Cancel (red) key
FS 1 Field separator (Hex 1C)
Data var If ActionButton = 777 (Enter) or 5, 6, 7 or 8 (virtual button), returns selected item using index of 1 to nn(= number of selections).

Sample Radio Buttons Message

Request

The following request tells Simplify to display the screen shown below:

API Field #, Value Description
0001,36 Transaction Type
0011,14125040000 User Data
5001,[see value below] Non-Financial Data
    040=Tag
    147=Length of data
    1= Data required when ENTER or a virtual button is pressed
    Select from one of the options=Title1
    ButtonE=Descriptor for virtual button position E (etc.)
    Choice 1=Descriptor for radio button 1 (etc.)

5001,0401471FSSelect from one of the optionsFSFSFSButtonEFSButtonFFSButtonGFSButtonHFSChoice 1FSChoice2FSChoice
3FSChoice 4FSChoice 5FSChoice 6FSChoice 7FSChoice 8FSChoice 9

Response

API Field #, Value Description
0001,36 Transaction Type
0011,14125040000?V142.18.65_2.18.1 User Data
5001,040005777FS5 Non-Financial Data
    040=Tag
    005=Length of data
    777=Enter key pressed
    5=Radio button (Choice) 10 pressed