Content for TS 51.013 Word version: 16.1.0
6 API Test Plan
6.1 Package sim.access:
6.1.1 Interface SIMView
6.1.2 Class SIMSystem
6.1.3 Class SIMViewException
6.2 Package sim.toolkit
6.2.1 Interface ToolkitConstants
6.2.2 Interface ToolkitInterface
6.2.3 Class EditHandler
6.2.4 Class EnvelopeHandler
6.2.5 Class EnvelopeResponseHandler
6.2.6 Class MEProfile
6.2.7 Class ProactiveHandler
6.2.8 Class ProactiveResponseHandler
6.2.9 Class ToolkitRegistry
6.2.10 Class ViewHandler
6.2.11 Class ToolkitException
6.3 SIM Toolkit Framework
6.3.1 Minimum Handler Availability
6.3.2 Handler Integrity
6.3.3 Applet Triggering
6.3.4 Proactive Command Sending by the STF
6.3.5 Exception Handling
6.3.6 Framework Security Management
6.3.7 Envelope Response Posting
6.3.8 Toolkit Installation
6.3.9 File System Context
6.3.10 Other parts transferred to framework from API
6.3.11 Concatenated SMS
6 API Test Plan Word‑p. 19
6.1 Package sim.access:
6.1.1 Interface SIMView
6.1.1.1 Constants
6.1.1.2 Method select(short fid, byte[] fci, short fciOffset, short fciLength)
6.1.1.3 Method select (short fid) Word‑p. 23
6.1.1.4 Method status Word‑p. 25
6.1.1.5 Method readBinary Word‑p. 27
6.1.1.6 Method updateBinary Word‑p. 30
6.1.1.7 Method readRecord Word‑p. 33
6.1.1.8 Method updateRecord Word‑p. 39
6.1.1.9 Method seek Word‑p. 45
6.1.1.10 Method increase Word‑p. 49
6.1.1.11 Method invalidate Word‑p. 52
6.1.1.12 Method rehabilitate Word‑p. 53
6.1.2 Class SIMSystem Word‑p. 55
6.1.3 Class SIMViewException Word‑p. 56
6.2 Package sim.toolkit
6.2.1 Interface ToolkitConstants
6.2.2 Interface ToolkitInterface Word‑p. 59
6.2.3 Class EditHandler Word‑p. 60
6.2.4 Class EnvelopeHandler
6.2.4.1 Method getEnvelopeTag
6.2.4.2 Method getItemIdentifier Word‑p. 61
6.2.4.3 Method getSecuredDataLength Word‑p. 62
6.2.4.4 Method getSecuredDataOffset Word‑p. 66
6.2.4.5 Method getTheHandler Word‑p. 69
6.2.4.6 Method getTPUDLOffset Word‑p. 70
6.2.4.7 Method getLength Word‑p. 72
6.2.4.8 Method copy Word‑p. 73
6.2.4.9 Method findTLV Word‑p. 75
6.2.4.10 Method getValueLength Word‑p. 76
6.2.4.11 Method getValueByte Word‑p. 77
6.2.4.12 Method copyValue Word‑p. 79
6.2.4.13 Method compareValue Word‑p. 81
6.2.4.14 Method findAndCopyValue(byte tag, byte[] dstBuffer, short dstOffset) Word‑p. 84
6.2.4.15 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte[] dstBuffer, short dstOffset, short dstLength) Word‑p. 86
6.2.4.16 Method findAndCompareValue(byte tag, byte[] compareBuffer, short compareOffset) Word‑p. 89
6.2.4.17 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, byte[] compareBuffer, short compareOffset, short compareLength) Word‑p. 91
6.2.4.18 Method getCapacity Word‑p. 95
6.2.4.19 Method getUserDataLength Word‑p. 96
6.2.4.20 Method getChannelIdentifier Word‑p. 98
6.2.5 Class EnvelopeResponseHandler Word‑p. 100
6.2.5.1 Method getTheHandler
6.2.5.2 Method post Word‑p. 101
6.2.5.3 Method postAsBERTLV Word‑p. 103
6.2.5.4 Method getLength Word‑p. 104
6.2.5.5 Method copy Word‑p. 105
6.2.5.6 Method findTLV Word‑p. 107
6.2.5.7 Method getValueLength Word‑p. 109
6.2.5.8 Method getValueByte Word‑p. 110
6.2.5.9 Method copyValue Word‑p. 111
6.2.5.10 Method compareValue Word‑p. 114
6.2.5.11 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) Word‑p. 116
6.2.5.12 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte[] dstBuffer, short dstOffset, short dstLength) Word‑p. 119
6.2.5.13 Method findAndCompareValue(byte tag, byte[] compareBuffer, short compareOffset) Word‑p. 122
6.2.5.14 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, byte[] compareBuffer, short compareOffset, short compareLength) Word‑p. 124
6.2.5.15 Method appendArray Word‑p. 128
6.2.5.16 Method appendTLV(byte tag, byte value) Word‑p. 130
6.2.5.17 Method appendTLV(byte tag, byte value1, byte value2) Word‑p. 131
6.2.5.18 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short valuelength) Word‑p. 133
6.2.5.19 Method appendTLV(byte tag, byte value1, byte[ ] value2, short value2offset, short value2length) Word‑p. 135
6.2.5.20 Method clear Word‑p. 138
6.2.5.21 Method getCapacity Word‑p. 139
6.2.6 Class MEProfile Word‑p. 140
6.2.6.1 Method check (byte index)
6.2.6.2 Method check (byte [ ] mask, short offset, short length) Word‑p. 141
6.2.6.3 Method check (short index) Word‑p. 142
6.2.6.4 Method getValue (short indexMSB, short indexLSB) Word‑p. 143
6.2.6.5 Method copy (short startOffset, byte[] dstBuffer, short dstOffset, short dstLength) Word‑p. 144
6.2.7 Class ProactiveHandler Word‑p. 146
6.2.7.1 Method getTheHandler
6.2.7.2 Method init Word‑p. 147
6.2.7.3 Method initDisplayText Word‑p. 148
6.2.7.4 Method initGetInkey Word‑p. 151
6.2.7.5 Method initGetInput Word‑p. 154
6.2.7.6 Method send Word‑p. 158
6.2.7.7 Method getLength Word‑p. 160
6.2.7.8 Method copy Word‑p. 161
6.2.7.9 Method findTLV Word‑p. 163
6.2.7.10 Method getValueLength Word‑p. 164
6.2.7.11 Method getValueByte Word‑p. 165
6.2.7.12 Method copyValue Word‑p. 167
6.2.7.13 Method compareValue Word‑p. 169
6.2.7.14 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) Word‑p. 172
6.2.7.15 Method findAndCopyValue(byte tag, byte occurence, short valueOffset, byte[] dstBuffer, short dstOffset, short dstLength) Word‑p. 174
6.2.7.16 Method findAndCompareValue(byte tag, byte[] compareBuffer, short compareOffset) Word‑p. 177
6.2.7.17 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, byte[] compareBuffer, short compareOffset, short compareLength) Word‑p. 180
6.2.7.18 Method appendArray Word‑p. 183
6.2.7.19 Method appendTLV(byte tag, byte value) Word‑p. 185
6.2.7.20 Method appendTLV(byte tag, byte value1, byte value2) Word‑p. 187
6.2.7.21 Method appendTLV(byte tag, byte[] value, short valueoffset, short valuelength) Word‑p. 188
6.2.7.22 Method appendTLV(byte tag, byte value1, byte[] value2, short value2offset, short value2length) Word‑p. 191
6.2.7.23 Method clear Word‑p. 193
6.2.7.24 Method getCapacity Word‑p. 194
6.2.7.25 Method initCloseChannel Word‑p. 195
6.2.8 Class ProactiveResponseHandler Word‑p. 197
6.2.8.1 Method copyAdditionalInformation
6.2.8.2 Method copyTextString Word‑p. 200
6.2.8.3 Method getAdditionalInformationLength Word‑p. 204
6.2.8.4 Method getGeneralResult Word‑p. 206
6.2.8.5 Method getItemIdentifier Word‑p. 208
6.2.8.6 Method getTextStringCodingScheme Word‑p. 210
6.2.8.7 Method GetTextStringLength Word‑p. 212
6.2.8.8 Method getTheHandler Word‑p. 214
6.2.8.9 Method getLength Word‑p. 215
6.2.8.10 Method copy Word‑p. 216
6.2.8.11 Method findTLV Word‑p. 218
6.2.8.12 Method getValueLength Word‑p. 220
6.2.8.13 Method getValueByte Word‑p. 221
6.2.8.14 Method copyValue Word‑p. 222
6.2.8.15 Method compareValue Word‑p. 225
6.2.8.16 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) Word‑p. 227
6.2.8.17 Method findAndCopyValue(byte tag, byte occurence, short valueOffset, byte[] dstBuffer, short dstOffset, short dstLength) Word‑p. 230
6.2.8.18 Method findAndCompareValue(byte tag, byte[] compareBuffer, short compareOffset) Word‑p. 233
6.2.8.19 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, byte[] compareBuffer, short compareOffset, short compareLength) Word‑p. 235
6.2.8.20 Method getCapacity Word‑p. 239
6.2.8.21 Method getChannelIdentifier Word‑p. 240
6.2.8.22 Method copyChannelData Word‑p. 243
6.2.9 Class ToolkitRegistry Word‑p. 247
6.2.9.1 Method allocateTimer
6.2.9.2 Method changeMenuEntry Word‑p. 248
6.2.9.3 Method clearEvent Word‑p. 255
6.2.9.4 Method disableMenuEntry Word‑p. 257
6.2.9.5 Method enableMenuEntry Word‑p. 258
6.2.9.6 Method getEntry Word‑p. 260
6.2.9.7 Method getPollInterval Word‑p. 261
6.2.9.8 Method initMenuEntry Word‑p. 263
6.2.9.9 Method isEventSet Word‑p. 268
6.2.9.10 Method releaseTimer Word‑p. 270
6.2.9.11 Method requestPollInterval Word‑p. 271
6.2.9.12 Method setEvent Word‑p. 273
6.2.9.13 Method setEventList Word‑p. 277
6.2.10 Class ViewHandler Word‑p. 282
6.2.11 Class ToolkitException
6.3 SIM Toolkit Framework Word‑p. 284
6.3.1 Minimum Handler Availability
6.3.1.1 ProactiveHandler
6.3.1.2 ProactiveResponseHandler Word‑p. 292
6.3.1.3 EnvelopeHandler Word‑p. 304
6.3.1.4 EnvelopeResponseHandler Word‑p. 311
6.3.2 Handler Integrity Word‑p. 328
6.3.2.1 ProactiveHandler
6.3.2.2 ProactiveResponseHandler Word‑p. 330
6.3.2.3 EnvelopeHandler Word‑p. 332
6.3.2.4 EnvelopeResponseHandler Word‑p. 356
6.3.3 Applet Triggering Word‑p. 357
6.3.3.1 EVENT_PROFILE_DOWNLOAD
6.3.3.2 EVENT_MENU_SELECTION Word‑p. 358
6.3.3.3 EVENT_MENU_SELECTION_HELP_REQUEST Word‑p. 360
6.3.3.4 EVENT_FORMATTED_SMS_PP_ENV Word‑p. 364
6.3.3.5 EVENT_UNFORMATTED_SMS_PP_ENV Word‑p. 365
6.3.3.6 EVENT_CALL_CONTROL_BY_SIM Word‑p. 367
6.3.3.7 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM Word‑p. 369
6.3.3.8 EVENT_TIMER_EXPIRATION Word‑p. 370
6.3.3.9 EVENT_UNFORMATTED_SMS_CB Word‑p. 372
6.3.3.10 EVENT_EVENT_DOWNLOAD_MT_CALL Word‑p. 373
6.3.3.11 EVENT_EVENT_DOWNLOAD_CALL_CONNECTED Word‑p. 374
6.3.3.12 EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED Word‑p. 376
6.3.3.13 EVENT_EVENT_DOWNLOAD_LOCATION_STATUS Word‑p. 377
6.3.3.14 EVENT_EVENT_DOWNLOAD_USER_ACTIVITY Word‑p. 378
6.3.3.15 EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE Word‑p. 380
6.3.3.16 EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS Word‑p. 381
6.3.3.17 EVENT_UNRECOGNIZED_ENVELOPE Word‑p. 383
6.3.3.18 EVENT_STATUS_COMMAND Word‑p. 384
6.3.3.19 EVENT_FORMATTED_SMS_CB Word‑p. 386
6.3.3.20 EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION Word‑p. 388
6.3.3.21 EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION Word‑p. 389
6.3.3.22 EVENT_FIRST_COMMAND_AFTER_SELECT Word‑p. 391
6.3.3.23 EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE Word‑p. 393
6.3.3.24 EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS Word‑p. 395
6.3.3.25 EVENT_FORMATTED_SMS_PP_UPD Word‑p. 398
6.3.3.26 EVENT_UNFORMATTED_SMS_PP_UPD Word‑p. 401
6.3.4 Proactive Command Sending by the STF Word‑p. 403
6.3.4.1 System Proactive Commands
6.3.4.2 Interaction with GSM commands Word‑p. 404
6.3.4.3 Proactive Command Control Word‑p. 406
6.3.5 Exception Handling Word‑p. 408
6.3.6 Framework Security Management Word‑p. 410
6.3.6.1 Input Data Word‑p. 411
6.3.6.2 Output Data Word‑p. 416
6.3.7 Envelope Response Posting Word‑p. 417
6.3.7.1 EVENT_CALL_CONTROL_BY_SIM
6.3.7.2 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM Word‑p. 420
6.3.7.3 EVENT_UNRECOGNIZED_ENVELOPE Word‑p. 422
6.3.7.4 EVENT_FORMATTED_SMS_PP_ENV
6.3.8 Toolkit Installation Word‑p. 425
6.3.8.1 Timers Allocation
6.3.8.2 Item Identifier Word‑p. 427
6.3.8.3 Item Position Word‑p. 429
6.3.8.4 Maximum Text Length for a menu entry Word‑p. 430
6.3.8.5 Maximum number of menu entries Word‑p. 432
6.3.8.6 Access Domain Word‑p. 433
6.3.8.7 Priority Level Word‑p. 439
6.3.8.8 Channel Allocation Word‑p. 443
6.3.8.9 Minimum Security Level Word‑p. 445
6.3.9 File System Context Word‑p. 446
6.3.9.1 Initial Context
6.3.9.2 Context Preservation (current file) Word‑p. 447
6.3.9.3 Context Preservation (current record pointer) Word‑p. 449
6.3.10 Other parts transferred to framework from API Word‑p. 452
6.3.10.1 A handler is a temporary JCRE Entry Point object
6.3.10.2 Transaction Word‑p. 453
6.3.10.3 Timer Id between Applets Word‑p. 454
6.3.11 Concatenated SMS Word‑p. 455
