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 NameLengthDescription
TTT3Tag (always = 040)
LLL3Length of the following data
Required1Data is required when ENTER or a virtual button is pressed (0=No, 1=Yes)
Title10-38 (MX915)
0-40 (MX925)
Title 1
FS1Field separator (Hex 1C)
Title20-38 (MX915)
0-40 (MX925)
Title 2
FS1Field separator (Hex 1C)
Title30-38 (MX915)
0-40 (MX925)
Title 3
FS1Field separator (Hex 1C)
ButtonEDesc0-8Descriptor for first button position (from left) on bottom (E)
FS1Field separator (Hex 1C)
ButtonFDesc0-8Descriptor for second button position on bottom (F)
FS1Field separator (Hex 1C)
ButtonGDesc0-8Descriptor for third button position on bottom (G)
FS1Field separator (Hex 1C)
ButtonHDesc0-8Descriptor for fourth button position on bottom (H)
FS1Field separator (Hex 1C)
Choice10-45 (MX915)
0-47 (MX925)
radio button Text for Choice 1
FS1Field Separator (Hex 1C)
Choice20-45 (MX915)
0-47 (MX925)
radio button Text for Choice 2
FS1Field Separator (Hex 1C)
Choice30-45 (MX915)
0-47 (MX925)
radio button Text for Choice 3
FS1Field Separator (Hex 1C)
Choice40-45 (MX915)
0-47 (MX925)
radio button Text for Choice 4
FS1Field Separator (Hex 1C)
Choice50-45 (MX915)
0-47 (MX925)
radio button Text for Choice 5
FS1Field Separator (Hex 1C)
ChoiceMax0-45 (MX915)
0-47 (MX925)
radio button text for last Choice

Response

Field 5001

Field NameLengthDescription
TTT3Tag (always = 040)
LLL3Length of the following data
ActionButton3If 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
FS1Field separator (Hex 1C)
DatavarIf 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 #, ValueDescription
0001,36Transaction Type
0011,14125040000User Data. See Appendix F for the use of this field.
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 1FSChoice 2FSChoice 3FSChoice 4FSChoice 5FSChoice 6FSChoice 7FSChoice 8FSChoice 9

sample screen with four radio buttons

Response

API Field #, ValueDescription
0001,36Transaction Type
0011,14125040000?V142.18.65_2.18.1User Data. See Appendix F for the use of this field.
5001,040005777FS5Non-Financial Data
    040=Tag
    005=Length of data
    777=Enter key pressed
    5=Radio button (Choice) 5 pressed