6.2.5 Class EnvelopeResponseHandler

11.133GPPRelease 1999Test specification for Subscriber Interface Module (SIM) Application Programme Interface (API) for Java cardTS

6.2.5.1 Method getTheHandler

Test Area Reference: API_2_ERH_GTHD.

6.2.5.1.1 Conformance requirement:

The method with following header shall be compliant to its definition in the API.

public static EnvelopeResponseHandler getTheHandler()

throws ToolkitException

6.2.5.1.1.1 Normal execution

  • CRRN1: The method shall return the single system instance of the EnvelopeResponseHandler class.
  • CRRN2: The EnvelopeResponseHandler is a Temporary JCRE Entry Point Object ( see Javacard 2.1 Runtime Environment (JCRE) Specification [12]).

6.2.5.1.1.2 Parameter errors

No requirements.

6.2.5.1.1.3 Context errors

  • CRRC1: The method shall thrown ToolkitException (HANDLER_NOT_AVAILABLE) if the handler is busy.
  • CRRC2: After the first invocation of the ProactiveHandler.send method the EnvelopeResponseHandler is no more available

6.2.5.1.2 Test suite files

Test Script: API_2_ERH_GTHD_1.scr

Test Applet: API_2_ERH_GTHD_1.java

Load Script: API_2_ERH_GTHD_1.ldr

Cleanup Script: API_2_ERH_GTHD_1.clr

Parameter File: API_2_ERH_GTHD_1.par

6.2.5.1.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

getTheHandler twice

The returned objects shall be the same

2

Verify that getTheHandler returns an EnvelopeHandler

getTheHandler

The reference returned shall be an EnvelopeResponseHandler (checkcast)

3

Verify the returned value is not null

getTheHandler

The reference returned shall not be null.

4

getTheHandler, then send a proactive command, and then, appendTLV

ToolkitException HANDLER_NOT_AVAILABLE is thrown

6.2.5.1.4 Test Coverage

CRR number

Test case number

N1

1, 2, 3

N2

To be checked in Framework tests and insert here cross reference

C1

To be checked in Framework tests and insert here cross reference

C2

4

6.2.5.2 Method post

Test Area Reference: API_2_ERH_POSTB.

6.2.5.2.1 Conformance requirement

The method with following header shall be compliant to its definition in the API.

public void post(byte statusType)

throws ToolkitException

6.2.5.2.1.1 Normal execution

  • CRRN1: When the method is called, the toolkit applet can continue it’s processing (e.g. prepare a proactive command).
  • CRRN2: The byte statusType is SW1 of the status.
  • CRRN3: If the send method is called after a post method, the posted data are the first sent to the ME.
  • CRRN4: The SIM Toolkit Framework shall take the optional Application Data posted by the triggered toolkit applet if present, secure and send the response packet the SIM Toolkit Framework will return the response APDU defined by the toolkit applet.

6.2.5.2.1.2 Parameter error

No requirements.

6.2.5.2.1.3 Context errors

  • CRRC1: The method shall thrown ToolkitException (HANDLER_NOT_AVAILABLE) if the handler is busy.

6.2.5.2.2 Test suite files

Specific triggering: Call control

Test Script: API_2_ERH_POSTB_1.scr

Test Applet: API_2_ERH_POSTB_1.java

Load Script: API_2_ERH_POSTB_1.ldr

Cleanup Script: API_2_ERH_POSTB_1.clr

Parameter File: API_2_ERH_POSTB_1.par

6.2.5.2.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

getTheHandler and then post

(the handler is empty)

9000

2

Fill the handler ( appendTLV to have bytes in it )and then post data with status 9F

9FFD data are retrieved with GET RESPONSE command

3

Verify that after a post the handler is no more available

appendTLV, post and then appendTLV

ToolkitException HANDLER_NOT_AVAILABLE is thrown on the second appendTLV

4

construct the response (appendTLV with 0x10 data) and post it with status 9E and then send a display text

9E12 and posted data retrieved by a GET RESPONSE with status 9113 and display text retrieved by a FETCH

5

Verify that it is possible to send a proactive command after a post

getTheHandler and post , then send a display text

91 13 and display text is retrieved by a FETCH

6

Verify it is not possible to post after a proactive command

getTheHandler, appendTLV, send a display text, post.

ToolkitException HANDLER_NOT_AVAILABLE is thrown

7

Verify that the handler is no more available after a post

getTheHandler, appendTLV, post with status 9E, post with status 9F

ToolkitException HANDLER_NOT_AVAILABLE is thrown

9E12 and posted data retrieved by a GET RESPONSE

6.2.5.2.4 Test Coverage

CRR number

Test case number

N1

3, 4, 7

N2

1, 2, 4, 7

N3

4, 5

N4

To be checked in Framework tests and insert here cross reference

C1

6

6.2.5.3 Method postAsBERTLV

Test Area Reference:API_2_ERH_POSTBB.

6.2.5.3.1 Conformance Requirement

The method with following header shall be compliant to its definition in the API.

public void postAsBERTLV(byte statusType,

byte tag)

throws ToolkitException

6.2.5.3.1.1 Normal execution

  • CRRN1: When the method is called, the toolkit applet can continue it’s processing (e.g. prepare a proactive command) the SIM Toolkit Framework will return the response APDU defined by the toolkit applet.
  • CRRN2: The byte statusType is SW1 of the status
  • CRRN3: If the send method is called after a postAsBERTLV method, the posted data are the first sent to the ME.
  • CRRN4: The byte tag is the BER Tag at the beginning of the simple TLV list.

6.2.5.3.1.2 Parameter errors

No requirements.

6.2.5.3.1.3 Context errors

  • CRRC1: The method shall thrown ToolkitException (HANDLER_NOT_AVAILABLE) if the handler is busy.

6.2.5.3.2 Test suite files

Specific triggering: Call control

Test Script: API_2_ERH_POSTBB_1.scr

Test Applet: API_2_ERH_POSTBB_1.java

Load Script: API_2_ERH_POSTBB_1.ldr

Cleanup Script: API_2_ERH_POSTBB_1.clr

Parameter File: API_2_ERH_POSTBB_1.par

6.2.5.3.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

getTheHandler and then postAsBERTLV

(the handler is empty)

9F02 data are retrieved with GET RESPONSE command, the tag shall be 33 and the length is 00

2

Fill the handler and then postAsBERTLV the data with status 9F, and tag 33

9FFF data are retrieved with GET RESPONSE command, the tag shall be 33

3

appendTLV, postAsBERTLV and then appendTLV

ToolkitException HANDLER_NOT_AVAILABLE is thrown on the second appendTLV

4

construct the response (appendTLV with 0x10 data) and postAsBERTLV it with status 9E, tag 75 and then send a display text

9E14 and posted data retrieved by a GET RESPONSE the tag shall be 75 with status 9113 and display text retrieved by a FETCH

5

getTheHandler and postAsBERTLV, then send a display text

9E02 and posted data retrieved by a GET RESPONSE the tag 33 (and the length 00) with status 9113 and display text is retrieved by a FETCH

6

Verify it is not possible to postAsBERTLV after a proactive command

getTheHandler, appendTLV, send a display text, postAsBERTLV.

ToolkitException HANDLER_NOT_AVAILABLE is thrown on the postAsBERTLV

7

Verify that the handler is no more available after a postAsBERTLV

getTheHandler, appendTLV(with data length = 0x10, postAsBERTLV with status 9E, tag 56, postAsBERTLV with status 9F, tag 28

ToolkitException HANDLER_NOT_AVAILABLE is thrown on the second postAsBERTLV

9E14 and posted data retrieved by a GET RESPONSE the tag shall be 56 with status 9000

6.2.5.3.4 Test Coverage

CRR number

Test case number

N1

3, 4, 7

N2

1, 2, 4, 7

N3

4, 5

N4

2, 4, 7

C1

6

6.2.5.4 Method getLength

Test Area Reference: API_2_ERH_GLEN.

6.2.5.4.1 Conformance requirement

The method with following header shall be compliant to its definition in the API.

public short getLength()

throws ToolkitException

6.2.5.4.1.1 Normal execution

  • CRRN1: returns the length in bytes of the TLV list.

6.2.5.4.1.2 Parameter errors

No requirements.

6.2.5.4.1.3 Context errors

  • CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException.HANDLER_NOT_AVAILABLE.

6.2.5.4.2 Test Suite files

Specific triggering: Unrecognized Envelope

Test Script: API_2_ERH_GLEN_1.scr

Test Applet: API_2_ERH_GLEN_1.java

Load Script: API_2_ERH_GLEN_1.ldr

Cleanup Script: API_2_ERH_GLEN_1.clr

Parameter File: API_2_ERH_GLEN_1.par

6.2.5.4.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

Clear the handler

getLength()

Result of getLength() is 0

2

appendTLV with length of 7

getLength()

Result of getLength() is 9

3

Clear the handler and appendTLV with Length of 250

getLength()

Result of getLength() is 253

4

Build a 7Fh Envelope response handler

getLength()

Result of getLength() is 81h

5

Build a 80h Envelope response handler

getLength()

Result of getLength() is 83h

NOTE: Test case 3 is limited to 253 and not 256 because the current GSM 03.19 [7] is not clear enough on this point. So this test allows the two possible implementations.

6.2.5.4.4 Test Coverage

CRR number

Test case number

N1

1, 2, 3, 4, 5

C1

Does not apply for Envelope response handler

6.2.5.5 Method copy

Test Area Reference: API_2_ERH_COPY_BSS.

6.2.5.5.1 Conformance requirement

The method with following header shall be compliant to its definition in the API.

public short copy(byte[] dstBuffer,

short dstOffset,

short dstLength)

throws java.lang.NullPointerException,

java.lang.ArrayIndexOutOfBoundsException,

ToolkitException

6.2.5.5.1.1 Normal execution

  • CRRN1: copies the simple TLV list contained in the handler to the destination byte array.
  • CRRN2: returns dstOffset + dstLength.

6.2.5.5.1.2 Parameter errors

  • CRRP1: if dstBuffer is null a NullPointerException is thrown.
  • CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, an ArrayIndexOutOfBoundsException is thrown.
  • CRRP3: if dstLength is greater than the length of the simple TLV List, an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUNDARIES.

6.2.5.5.1.3 Context errors

  • CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException HANDLER_NOT_AVAILABLE.

6.2.5.5.2 Test Suite files

Specific triggering: Unrecognized Envelope.

Test Script: API_2_ERH_COPY_BSS_1.scr

Test Applet: API_2_ERH_COPY_BSS_1.java

Load Script: API_2_ERH_COPY_BSS_1.ldr

Cleanup Script: API_2_ERH_COPY_BSS_1.clr

Parameter File: API_2_ERH_COPY_BSS_1.par

6.2.5.5.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

appendTLV with value length of 7

NULL as parameter to dstBuffer

NullPointerException is thrown

2

dstOffset  dstBuffer.length

dstBuffer.length = 5

dstOffset = 5

dstLength = 1

ArrayIndexOutOfBoundsException is thrown

3

dstOffset < 0

dstBuffer.length = 5

dstOffset = -1

dstLength = 1

ArrayIndexOutOfBoundsException is thrown

4

dstLength > dstBuffer.length

dstBuffer.length = 5

dstOffset = 0

dstLength = 6

ArrayIndexOutOfBoundsException is thrown

5

dstOffset + dstLength > dstBuffer.length

dstBuffer.length = 5

dstOffset = 3

dstLength = 3

ArrayIndexOutOfBoundsException is thrown

6

dstLength < 0

dstBuffer.length = 5

dstOffset = 0

dstLength = -1

ArrayIndexOutOfBoundsException is thrown

7

dstLength > length of the simple TLV list

dstBuffer.length = 10

dstOffset = 0

dstLength = 10

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

8

Successful call, dstBuffer is the whole buffer

dstBuffer.length = 9

dstOffset = 0

dstLength = 9

Result of copy() is 9

9

Compare the buffer

Result of arrayCompare() is 0

10

Successful call, dstBuffer is part of a buffer

dstBuffer.length = 15

dstOffset = 3

dstLength = 9

Result of copy() is 12

11

Compare the whole buffer

Result of arrayCompare() is 0

12

Successful call, dstBuffer is part of a buffer

dstBuffer.length = 15

dstOffset = 3

dstLength = 6

Result of copy() is 9

13

Compare the whole buffer

Result of arrayCompare() is 0

14

Successful call, copy with length =0

dstBuffer.length = 15

dstOffset = 15

dstLength = 0

Result of copy() is 15

6.2.5.5.4 Test Coverage

CRR number

Test case number

N1

9, 11, 13

N2

8, 10, 12, 14

P1

1

P2

2, 3, 4, 5, 6

P3

7

C1

Does not apply for Envelope response handler

6.2.5.6 Method findTLV

Test Area Reference: API_2_ERH_FINDBB.

6.2.5.6.1 Conformance requirement

The method with following header shall be compliant to its definition in the API.

public byte findTLV(byte tag, byte occurrence)

throws ToolkitException

6.2.5.6.1.1 Normal execution

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer):

  • CRRN1: the method is successful if the required occurrence exists then the corresponding TLV becomes current.
  • CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag is set.
  • CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension Required flag is not set.
  • CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and TLV_NOT_FOUND is returned.
  • CRRN5: The search method is comprehension required flag independent.

6.2.5.6.1.2 Parameter errors

  • CRRP1: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException BAD_INPUT_PARAMETER.

6.2.5.6.1.3 Context errors

  • CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException HANDLER_NOT_AVAILABLE.

6.2.5.6.2 Test Suite files

Specific triggering: Unrecognized Envelope.

Test Script: API_2_ERH_FINDBB_1.scr

Test Applet: API_2_ERH_FINDBB_1.java

Load Script: API_2_ERH_FINDBB_1.ldr

Cleanup Script: API_2_ERH_FINDBB_1.clr

Parameter File: API_2_ERH_FINDBB_1.par

6.2.5.6.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

append the handler with TLVs:

81 03 11 22 33

82 02 99 77

Invalid input parameter

Occurrence = 0

ToolkitException.BAD_INPUT_PARAMETER is thrown

2

Search 1st TLV

Tag = 01h

Occurrence = 1

Result is TLV_FOUND_CR_SET

3

Call the getValueLength() method

Result is 03h

4

Search 2nd TLV

Tag = 02h

Occurrence = 1

Result is TLV_FOUND_CR_SET

5

Call the getValueLength() method

Result is 02h

6

Select a TLV (tag 02h)

Search a wrong tag

Tag = 03h

Occurrence = 1

Result is TLV_NOT_FOUND

7

Call the getValueLength() method

ToolkitException.UNAVAILABLE_ELEMENT is thrown.

8

Search a tag with wrong occurrence

Tag = 01h

Occurrence = 2

Result is TLV_NOT_FOUND

9

Call the getValueLength() method

ToolkitException.UNAVAILABLE_ELEMENT is thrown.

10

Append a TLV with tag=02h

Search the TLV

Tag = 02h

Occurrence = 2

Result is TLV_FOUND_CR_NOT_SET

11

Append a TLV with tag=04h

Search the TLV

Tag = 04h

Occurrence = 1

Result is TLV_FOUND_CR_NOT_SET

12

Search tag 81h

Tag = 81h

Occurrence = 1

Result is TLV_FOUND_CR_SET

13

Search tag 84h

Tag = 84h

Occurrence = 1

Result is TLV_FOUND_CR_NOT_SET

6.2.5.6.4 Test Coverage

CRR number

Test case number

N1

3, 5

N2

2, 4

N3

10, 11

N4

6, 7,8, 9

N5

12, 13

P1

1

C1

Does not apply for Envelope response handler

6.2.5.7 Method getValueLength

Test Area Reference: API_2_ERH_GVLE.

6.2.5.7.1 Conformance requirement

The method with following header shall be compliant to its definition in the API.

public short getValueLength()

throws ToolkitException

6.2.5.7.1.1 Normal execution

  • CRRN1: gets and returns the binary length of the value field for the last TLV element which has been found in the handler.

6.2.5.7.1.2 Parameter errors

No requirements.

6.2.5.7.1.3 Context errors

  • CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException HANDLER_NOT_AVAILABLE.
  • CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException UNAVAILABLE_ELEMENT.

6.2.5.7.2 Test Suite files

Specific triggering: Unrecognized Envelope.

Test Script: API_2_ERH_GVLE_1.scr

Test Applet: API_2_ERH_GVLE_1.java

Load Script: API_2_ERH_GVLE_1.ldr

Cleanup Script: API_2_ERH_GVLE_1.clr

Parameter File: API_2_ERH_GVLE_1.par

6.2.5.7.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

appendTLV 02 02 02 02

findTLV with TAG 03

getValueLength()

ToolkitException.UNAVAILABLE_ELEMENT is thrown

2

appendTLV with TAG 0D and length 00

Search TLV 0Dh

getValueLength()

Result is 00h

3

Clear the handler and append TLV with TAG 0D and length 02

Search TLV 0Dh

getValueLength()

Result is 02h

4

Clear the handler and append TLV with TAG 0D and length 0x7F

Search TLV 0Dh

getValueLength()

Result is 7Fh

5

Clear the handler and append TLV with TAG 0D and length 0x80

Search TLV 0Dh

getValueLength()

Result is 80h

6

Clear the handler and append TLV with TAG 0D and length 0xF1

Search TLV 0Dh

getValueLength()

Result is F1h

6.2.5.7.4 Test Coverage

CRR number

Test case number

N1

2, 3, 4, 5, 6

C1

Does not apply for EnvelopeResponseHandler

C2

1

6.2.5.8 Method getValueByte

Test Area Reference: API_2_ERH_GVBYS.

6.2.5.8.1 Conformance requirement

The method with following header shall be compliant to its definition in the API.

public byte getValueByte(short valueOffset)

throws ToolkitException

6.2.5.8.1.1 Normal execution

  • CRRN1: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 byte).

6.2.5.8.1.2 Parameter errors

  • CRRP1: if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUNDARIES.

6.2.5.8.1.3 Context errors

  • CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException HANDLER_NOT_AVAILABLE.
  • CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException UNAVAILABLE_ELEMENT.

6.2.5.8.2 Test Suite files

Specific triggering: Unrecognized Envelope.

Test Script: API_2_ERH_GVBYS_1.scr

Test Applet: API_2_ERH_GVBYS_1.java

Load Script: API_2_ERH_GVBYS_1.ldr

Cleanup Script: API_2_ERH_GVBYS_1.clr

Parameter File: API_2_ERH_GVBYS_1.par

6.2.5.8.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

appendTLV 82 02 81 82, appendTLV 81 03 11 22 FE

findTLV with TAG 03

getValueByte(0)

ToolkitException.UNAVAILABLE_ELEMENT is thrown

2

Search TLV 01h

getValueByte(3)

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

3

Search TLV 01h

getValueByte(2)

Result is FEh

4

Search TLV 02h

getValueByte(0)

Result is 81h

5

appendTLV with TAG 0D, Length 0x7E, Value: 00, 01, …, 7D

getValueByte(7D)

Result is 7Dh

6

clear the handler, appendTLV with TAG 0D, Length 0x80, Value: 00, 01, …, 7F

getValueByte(7E)

Result is 7Eh

7

getValueByte(7F)

Result is 7Fh

8

clear the handler, appendTLV with TAG 0D, Length 0xF1, Value: 00, 01, …, F0

getValueByte(F0)

Result is F0h

6.2.5.8.4 Test Coverage

CRR number

Test case number

N1

3, 4, 5, 6, 7, 8

P1

2

C1

Does not apply for EnvelopeResponseHandler

C2

1

6.2.5.9 Method copyValue

Test Area Reference: API_2_ERH_CPYVS_BSS.

6.2.5.9.1 Conformance requirement

The method with following header shall be compliant with its definition in the API.

public short copyValue(short valueOffset,

byte[] dstBuffer,

short dstOffset,

short dstLength)

throws java.lang.NullPointerException,

java.lang.ArrayIndexOutOfBoundsException,

ToolkitException

6.2.5.9.1.1 Normal execution

  • CRRN1: copies a part of the last TLV element which has been found, into a destination. buffer.
  • CRRN2: returns dstOffset + dstLength.

6.2.5.9.1.2 Parameter errors

  • CRRP1: if dstBuffer is null NullPointerException is thrown.
  • CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative ArrayIndexOutOfBoundsException is thrown.
  • CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUNDARIES.

6.2.5.9.1.3 Context errors

  • CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException HANDLER_NOT_AVAILABLE.
  • CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException UNAVAILABLE_ELEMENT.

6.2.5.9.2 Test Suite files

Specific triggering: Unrecognized Envelope.

Test Script: API_2_ERH_CPYVS_BSS_1.scr

Test Applet: API_2_ERH_CPYVS_BSS_1.java

Load Script: API_2_ERH_CPYVS_BSS_1.ldr

Cleanup Script: API_2_ERH_CPYVS_BSS_1.clr

Parameter File: API_2_ERH_CPYVS_BSS_1.par

6.2.5.9.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

appendTLV with TAG: 0D and length 16

Select Text String TLV

copyValue() with a null dstBuffer

NullPointerException is thrown

2

dstOffset  dstBuffer.length

dstBuffer.length = 5

dstOffset = 5

dstLength = 1

ArrayIndexOutOfBoundsException is thrown

3

dstOffset < 0

dstBuffer.length = 5

dstOffset = -1

dstLength = 1

ArrayIndexOutOfBoundsException is thrown

4

dstLength >dstBuffer.length

dstBuffer.length = 5

dstOffset = 0

dstLength = 6

ArrayIndexOutOfBoundsException is thrown

5

dstOffset + dstLength >dstBuffer.length

dstBuffer.length = 5

dstOffset = 3

dstLength = 3

ArrayIndexOutOfBoundsException is thrown

6

dstLength < 0

dstBuffer.length = 5

dstOffset = 0

dstLength = -1

ArrayIndexOutOfBoundsException is thrown

7

clear the handler, appendTLV with TAG: 0D and length 6

Select Text String TLV

valueOffset  Text String Length

valueOffset = 6

dstBuffer.length = 15

dstOffset = 0

dstLength = 1

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

8

valueOffset < 0

valueOffset = -1

dstBuffer.length = 15

dstOffset = 0

dstLength = 1

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

9

dstLength > Text String length

valueOffset = 0

dstBuffer.length = 15

dstOffset = 0

dstLength = 7

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

10

valueOffset + dstLength > Text String length

valueOffset = 2

dstBuffer.length = 15

dstOffset = 0

dstLength = 5

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

11

Initialize the handler

copyValue()

ToolkitException.UNAVAILABLE_ELEMENT is thrown

12

clear the handler, appendTLV with TAG: 0D and value: 04 00 01 … 0F

Select Text String TLV

Successful call

valueOffset = 0

dstBuffer.length = 17

dstOffset = 0

dstLength = 17

Result of copyValue() is 17

13

Compare buffer

buffer = 04 00 01 … 0F

Result is 00h

14

initialize dstBuffer

dstBuffer = 55 55 … 55

Successful call

valueOffset = 2

dstBuffer.length = 20

dstOffset = 3

dstLength = 12

Result of copyValue() is 15

15

Compare buffer

buffer =

55 55 55 01 02

03 04 05 06 07

08 09 0A 0B 0C

55 55 55 55 55

Result is 00h

16

Successful call, copyValue with length =0

dstBuffer.length = 20

dstOffset = 20

dstLength = 0

Result of copyValue() is 20

6.2.5.9.4 Test Coverage

CRR number

Test case number

N1

13, 15

N2

12, 14, 16

P1

1

P2

2, 3, 4, 5, 6

P3

7, 8, 9, 10

C1

Does not apply for EnvelopeResponseHandler

C2

11

6.2.5.10 Method compareValue

Test Area Reference: API_2_ERH_CPRVS_BSS.

6.2.5.10.1 Conformance requirement

The method with following header shall be compliant to its definition in the API.

public byte compareValue(short valueOffset,

byte[] compareBuffer,

short compareOffset,

short compareLength)

throws java.lang.NullPointerException,

java.lang.ArrayIndexOutOfBoundsException,

ToolkitException

6.2.5.10.1.1 Normal execution

Compares the last found TLV element with a buffer:

  • CRRN1: returns 0 if identical.
  • CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer.
  • CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer.

6.2.5.10.1.2 Parameter errors

  • CRRP1: if compareBuffer is null NullPointerException shall be thrown.
  • CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength is negative ArrayIndexOutOfBoundsException shall be thrown.
  • CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUNDARIES.

6.2.5.10.1.3 Context errors

  • CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException HANDLER_NOT_AVAILABLE.
  • CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException UNAVAILABLE_ELEMENT.

6.2.5.10.2 Test Suite files

Specific triggering: Unrecognized Envelope.

Test Script: API_2_ERH_CPRVS_BSS_1.scr

Test Applet: API_2_ERH_CPRVS_BSS_1.java

Load Script: API_2_ERH_CPRVS_BSS_1.ldr

Cleanup Script: API_2_ERH_CPRVS_BSS_1.clr

Parameter File: API_2_ERH_CPRVS_BSS_1.par

6.2.5.10.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

appendTLV with TAG: 0D and length 16

Select Text String TLV

compareValue() with a null compareBuffer

NullPointerException is thrown

2

compareOffset  compareBuffer.length

compareBuffer.length = 5

compareOffset = 5

compareLength = 1

ArrayIndexOutOfBoundsException is thrown

3

compareOffset < 0

compareBuffer.length = 5

compareOffset = -1

compareLength = 1

ArrayIndexOutOfBoundsException is thrown

4

compareLength >compareBuffer.length

compareBuffer.length = 5

compareOffset = 0

compareLength = 6

ArrayIndexOutOfBoundsException is thrown

5

compareOffset + compareLength >compareBuffer.length

compareBuffer.length = 5

compareOffset = 3

compareLength = 3

ArrayIndexOutOfBoundsException is thrown

6

compareLength < 0

compareBuffer.length = 5

compareOffset = 0

compareLength = -1

ArrayIndexOutOfBoundsException is thrown

7

appendTLV with TAG: 0D and length 6

Select Text String TLV

valueOffset  Text String Length

valueOffset = 6

compareBuffer.length = 15

compareOffset = 0

compareLength = 1

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

8

valueOffset < 0

valueOffset = -1

compareBuffer.length = 15

compareOffset = 0

compareLength = 1

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

9

compareLength > Text String length

valueOffset = 0

compareBuffer.length = 15

compareOffset = 0

compareLength = 7

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

10

valueOffset + compareLength > Text String length

valueOffset = 2

compareBuffer.length = 15

compareOffset = 0

compareLength = 5

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

11

Initialize the handler

compareValue()

ToolkitException.UNAVAILABLE_ELEMENT is thrown

12

appendTLV with TAG: 0D and value: 04 00 01 … 0F

Select Text String TLV

Initialize compareBuffer

compareBuffer =

04 00 01 … 0F

Compare buffers

valueOffset = 0

compareOffset = 0

compareLength = 17

Result is 00h

13

Initialize compareBuffer

compareBuffer =

04 00 01 02 03

04 05 06 07 08

05 0A 0B 0C 0D

0E 10

Compare buffers with same parameters

Result is -1

14

Initialize compareBuffer

compareBuffer =

03 00 01 … 0F

Compare buffers with same parameters

Result is +1

15

Initialize compareBuffer

compareBuffer =

55 55 55 01 02

03 04 05 06 07

08 09 0A 0B 0C

55 55 55 55 55

Compare buffers

valueOffset = 2

compareOffset = 3

compareLength = 12

Result is 00h

16

Initialize compareBuffer

compareBuffer =

55 55 55 02 01

03 04 05 06 07

08 09 0A 0B 0C

55 55 55 55 55

Compare buffers with same parameters

Result is -1

17

Initialize compareBuffer

compareBuffer =

55 55 55 01 02

03 04 05 06 07

08 09 0A 0A 0D

55 55 55 55 55

Compare buffers with same parameters

Result is +1

18

Successful call, compareValue with length =0

compareBuffer.length = 15

compareOffset = 15

compareLength = 0

Result of compareValue() is 0

6.2.5.10.4 Test Coverage

CRR number

Test case number

N1

12, 15, 18

N2

13, 16

N3

14, 17

P1

1

P2

2, 3, 4, 5, 6

P3

7, 8, 9, 10

C1

Does not apply for EnvelopeResponseHandler

C2

11

6.2.5.11 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset)

Test Area Reference: API_2_ERH_FACYB_BS.

6.2.5.11.1 Conformance requirement

The method with following header shall be compliant to its definition in the API.

public short findAndCopyValue(byte tag,

byte[] dstBuffer,

short dstOffset)

throws java.lang.NullPointerException,

java.lang.ArrayIndexOutOfBoundsException,

ToolkitException

6.2.5.11.1.1 Normal execution

  • CRRN1: looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into a destination buffer.
  • CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is no longer defined.
  • CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the copied value is returned.
  • CRRN4: The search method is comprehension required flag independent.

6.2.5.11.1.2 Parameter errors

  • CRRP1: if dstBuffer is null NullPointerException shall be thrown.
  • CRRP2: if dstOffset would cause access outside array bounds ArrayIndexOutOfBoundsException shall be thrown.

6.2.5.11.1.3 Context errors

  • CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException HANDLER_NOT_AVAILABLE.

6.2.5.11.2 Test Suite files

Specific triggering: Unrecognized Envelope.

Test Script: API_2_ERH_FACYB_BS_1.scr

Test Applet: API_2_ERH_FACYB_BS_1.java

Load Script: API_2_ERH_FACYB_BS_1.ldr

Cleanup Script: API_2_ERH_FACYB_BS_1.clr

Parameter File: API_2_ERH_FACYB_BS_1.par

6.2.5.11.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

Initialize the handler

findAndCopyValue() with a null dstBuffer

NullPointerException is thrown

2

appendTLV with TAG: 0D and length 16

Select Text String TLV

dstOffset  dstBuffer.length

tag = 0Dh

dstBuffer.length = 20

dstOffset = 20

ArrayIndexOutOfBoundsException is thrown

3

dstOffset < 0

dstBuffer.length = 20

dstOffset = -1

ArrayIndexOutOfBoundsException is thrown

4

dstOffset + length >dstBuffer.length

dstBuffer.length = 20

dstOffset = 5

ArrayIndexOutOfBoundsException is thrown

5

length > dstBuffer.length

dstBuffer.length = 15

dstOffset = 0

ArrayIndexOutOfBoundsException is thrown

6

clear the handler, appendTLV with TAG 02 and Length 02

Select a TLV (tag 02h)

findAndCopyValue()

tag = 03h

ToolkitException.UNAVAILABLE_ELEMENT is thrown

Call the getValueLength() method

ToolkitException.UNAVAILABLE_ELEMENT is thrown.

7

appendTLV with TAG: 0D and value: 04 00 01 … 0F

Successful call

Tag = 0Dh

dstBuffer.length = 17

dstOffset = 0

Result of findAndCopyValue() is 17

8

Compare buffer

buffer = 04 00 01 … 0F

Result is 00h

9

initialize dstBuffer

dstBuffer = 55 55 … 55

Successful call

dstBuffer.length = 20

dstOffset = 2

Result of findAndCopyValue() is 19

10

Compare buffer

buffer =

55 55 04 00 01

02 03 04 05 06

07 08 09 0A 0B

0C 0D 0E 0F 55

Result is 00h

11

clear the handler, appendTLV with TAG: 0D and value: 04 00 01 … 0F

append a 2nd Text String TLV

Successful call

tag = 0Dh

dstBuffer.length = 17

dstOffset = 0

Result of findAndCopyValue() is 17

12

Compare buffer

buffer = 04 00 01 … 0F

Result is 00h

13

clear the handler, appendTLV with TAG: 0D and value: 04 00 01 … 0F

Successful call (with tag 8Dh)

tag = 8Dh

dstBuffer.length = 17

dstOffset = 0

Result of findAndCopyValue() is 17

14

Compare buffer

buffer = 04 00 01 … 0F

Result is 00h

15

Append tag 0Fh

buffer = 00 01 … 0F

Successful call (with tag 8Fh)

tag = 8Fh

dstBuffer.length = 16

dstOffset = 0

Result of findAndCopyValue() is 16

16

Compare buffer

buffer = 00 01 … 0F

Result is 00h

6.2.5.11.4 Test Coverage

CRR number

Test case number

N1

8, 10, 12

N2

6

N3

7, 9, 11

N4

13, 14, 15, 16

P1

1

P2

2, 3, 4, 5

C1

Does not apply for EnvelopeResponseHandler

6.2.5.12 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte[] dstBuffer, short dstOffset, short dstLength)

Test Area Reference: API_2_ERH_FACYBBS_BSS.

6.2.5.12.1 Conformance requirement

The method with following header shall be compliant to its definition in the API.

public short findAndCopyValue(byte tag,

byte occurrence,

short valueOffset,

byte[] dstBuffer,

short dstOffset,

short dstLength)

throws java.lang.NullPointerException,

java.lang.ArrayIndexOutOfBoundsException,

ToolkitException

6.2.5.12.1.1 Normal execution

  • CRRN1: looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its value into a destination buffer.
  • CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is no longer defined.
  • CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is returned.
  • CRRN4: The search method is comprehension required flag independent.

6.2.5.12.1.2 Parameter errors

  • CRRP1: if dstBuffer is null NullPointerException shall be thrown.
  • CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative ArrayIndexOutOfBoundsException shall be thrown.
  • CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUNDARIES.

6.2.5.12.1.3 Context errors

  • CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException HANDLER_NOT_AVAILABLE.

6.2.5.12.2 Test Suite files

Specific triggering: Unrecognized Envelope.

Test Script: API_2_ERH_FACYBBS_BSS_1.scr

Test Applet: API_2_ERH_FACYBBS_BSS_1.java

Load Script: API_2_ERH_FACYBBS_BSS_1.ldr

Cleanup Script: API_2_ERH_FACYBBS_BSS_1.clr

Parameter File: API_2_ERH_FACYBBS_BSS_1.par

6.2.5.12.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

Initialize the handler

findAndCopyValue() with a null dstBuffer

NullPointerException is thrown

2

appendTLV with TAG: 0D and length 16

dstOffset  dstBuffer.length

tag = 0Dh, occurrence = 1

valueOffset = 0

dstBuffer.length = 5

dstOffset = 5

dstLength = 1

ArrayIndexOutOfBoundsException is thrown

3

dstOffset < 0

dstBuffer.length = 5

dstOffset = -1

dstLength = 1

ArrayIndexOutOfBoundsException is thrown

4

dstLength >dstBuffer.length

dstBuffer.length = 5

dstOffset = 0

dstLength = 6

ArrayIndexOutOfBoundsException is thrown

5

dstOffset + dstLength >dstBuffer.length

dstBuffer.length = 5

dstOffset = 3

dstLength = 3

ArrayIndexOutOfBoundsException is thrown

6

dstLength < 0

dstBuffer.length = 5

dstOffset = 0

dstLength = -1

ArrayIndexOutOfBoundsException is thrown

7

appendTLV with TAG: 0D and length 6

valueOffset  Text String Length

tag = 0Dh, occurrence = 1

valueOffset = 6

dstBuffer.length = 15

dstOffset = 0

dstLength = 1

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

8

valueOffset < 0

valueOffset = -1

dstBuffer.length = 15

dstOffset = 0

dstLength = 1

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

9

dstLength > Text String length

valueOffset = 0

dstBuffer.length = 15

dstOffset = 0

dstLength = 7

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

10

valueOffset + dstLength > Text String length

valueOffset = 2

dstBuffer.length = 15

dstOffset = 0

dstLength = 5

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

11

clear the handler, appendTLV with TAG 02 and Length 02

Select a TLV (tag 02h)

findAndCopyValue()

tag = 0Dh

occurrence = 2

ToolkitException.UNAVAILABLE_ELEMENT is thrown

Call the getValueLength() method

ToolkitException.UNAVAILABLE_ELEMENT is thrown.

12

clear the handler and appendTLV with TAG: 0D and value: 04 00 01 … 0F

Successful call

tag = 0Dh, occurrence = 1

valueOffset = 0

dstBuffer.length = 17

dstOffset = 0

dstLength = 17

Result of findAndCopyValue() is 17

13

Compare buffer

buffer = 04 00 01 … 0F

Result is 00h

14

initialize dstBuffer

dstBuffer = 55 55 … 55

Successful call

tag = 0Dh, occurrence = 1

valueOffset = 2

dstBuffer.length = 20

dstOffset = 3

dstLength = 12

Result of findAndCopyValue() is 15

15

Compare buffer

buffer =

55 55 55 01 02

03 04 05 06 07

08 09 0A 0B 0C

55 55 55 55 55

Result is 00h

16

Append a Text String TLV

tag = 0D

buffer = 00 11 22 33 44 55 (no specific DCS byte)

Successful call

tag = 0Dh, occurrence = 1

valueOffset = 0

dstBuffer.length = 20

dstOffset = 0

dstLength = 17

Result of findAndCopyValue() is 17

17

Compare buffer

buffer = 04 00 01 … 0F

Result is 00h

18

Successful call

tag = 0Dh, occurrence = 2

valueOffset = 0

dstBuffer.length = 6

dstOffset = 0

dstLength = 6

Result of findAndCopyValue() is 6

19

Compare buffer

buffer = 00 11 22 33 44 55

Result is 00h

20

clear the handler and appendTLV with TAG: 0D and value: 04 00 01 … 0F

Successful call (with tag 8Dh)

tag = 8Dh

occurrence = 1

valueOffset = 0

dstBuffer.length = 17

dstOffset = 0

dstLength = 17

Result of findAndCopyValue () is 17

21

Compare buffer

buffer = 04 00 01 … 0F

Result is 00h

22

Append tag 0Fh

buffer = 00 01 … 0F

Successful call (with tag 8Fh)

tag = 8Fh

occurrence = 1

valueOffset = 0

dstBuffer.length = 16

dstOffset = 0

dstLength = 16

Result of findAndCopyValue () is 16

23

Compare buffer

buffer = 00 01 … 0F

Result is 00h

24

Successful call, findAndCopyValue with length =0

dstBuffer.length = 16

dstOffset = 16

dstLength = 0

Result of findAndCopyValue () is 16

6.2.5.12.4 Test Coverage

CRR number

Test case number

N1

13, 15, 17, 19

N2

11

N3

12, 14, 16, 18, 24

N4

20, 21, 22, 23

P1

1

P2

2, 3, 4, 5, 6

P3

7, 8, 9, 10

C1

Does not apply for EnvelopeResponseHandler

6.2.5.13 Method findAndCompareValue(byte tag, byte[] compareBuffer, short compareOffset)

Test Area Reference: API_2_ERH_FACRB_BS.

6.2.5.13.1 Conformance requirement

The method with following header shall be compliant to its definition in the API.

public byte findAndCompareValue(byte tag,

byte[] compareBuffer,

short compareOffset)

throws java.lang.NullPointerException,

java.lang.ArrayIndexOutOfBoundsException,

ToolkitException

6.2.5.13.1.1 Normal execution

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer:

  • CRRN1: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is no longer defined.
  • CRRN2: if the method is successful then the corresponding TLV becomes current.
  • CRRN3: if identical returns 0.
  • CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -1.
  • CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns 1.
  • CRRN6: The search method is comprehension required flag independent.

6.2.5.13.1.2 Parameter errors

  • CRRP1: if compareBuffer is null NullPointerException shall be thrown.
  • CRRP2: if compareOffset would cause access outside array bounds ArrayIndexOutOfBoundsException shall be thrown.

6.2.5.13.1.3 Context errors

  • CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException HANDLER_NOT_AVAILABLE.

6.2.5.13.2 Test Suite files

Specific triggering: Unrecognized Envelope.

Test Script: API_2_ERH_FACRB_BS_1.scr

Test Applet: API_2_ERH_FACRB_BS_1.java

Load Script: API_2_ERH_FACRB_BS_1.ldr

Cleanup Script: API_2_ERH_FACRB_BS_1.clr

Parameter File: API_2_ERH_FACRB_BS_1.par

6.2.5.13.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

appendTLV with TAG: 0D and length 16

findAndCompareValue() with a null dstBuffer and tag 0Dh

NullPointerException is thrown

2

compareOffset  compareBuffer.length

tag = 0Dh

compareBuffer.length = 20

compareOffset = 20

ArrayIndexOutOfBoundsException is thrown

3

compareOffset < 0

compareBuffer.length = 20

compareOffset = -1

ArrayIndexOutOfBoundsException is thrown

4

compareOffset + length > compareBuffer.length

compareBuffer.length = 20

compareOffset = 5

ArrayIndexOutOfBoundsException is thrown

5

length > compareBuffer.length

compareBuffer.length = 15

compareOffset = 0

ArrayIndexOutOfBoundsException is thrown

6

clear the handler, appendTLV with TAG 02 and Length 02

Select a TLV (tag 02h)

findAndCompareValue()

tag = 03h

ToolkitException.UNAVAILABLE_ELEMENT is thrown

7

Verify current TLV

getValueLength()

ToolkitException.UNAVAILABLE_ELEMENT is thrown.

8

clear the handler and appendTLV with TAG: 0D and value: 04 00 01 … 0F

Initialize compareBuffer

compareBuffer =

04 00 01 … 0F

Compare buffers

tag = 0Dh

compareOffset = 0

Result is 00h

9

Verify current TLV

getValueLength()

Result is 17

10

Initialize compareBuffer

compareBuffer =

04 00 01 … 10

Compare buffers with same parameters

Result is -1

11

Initialize compareBuffer

compareBuffer =

03 00 01 … 0F

Compare buffers with same parameters

Result is +1

12

Initialize compareBuffer

compareBuffer =

55 55 04 00 01

02 03 04 05 06

07 08 09 0A 0B

0C 0D 0E 0F 55

Compare buffers

compareOffset = 2

Result is 00h

13

append a Text String TLV

tag = 0Dh

buffer = 00 11 22 33 44 55

Initialize compareBuffer

compareBuffer =

55 55 04 00 01

02 03 04 05 06

07 08 09 0A 0B

0C 0D 0E 0F 55

Compare buffers

compareOffset = 2

Result is 00h

14

Initialize compareBuffer

compareBuffer =

55 55 04 01 01

02 03 04 05 06

07 08 09 0A 0B

0C 0D 0E 0F 55

Compare buffers

compareOffset = 2

Result is -1

15

Initialize compareBuffer

compareBuffer =

55 55 04 00 01

02 03 04 05 06

07 08 09 0A 0B

0C 0D 0D 10 55

Compare buffers

compareOffset = 2

Result is +1

16

clear the handler and appendTLV with TAG: 0D and value: 04 00 01 … 0F

Initialize compareBuffer

compareBuffer = 04 00 01 … 0F

Successful call (with tag 8Dh)

tag = 8Dh

compareBuffer.length = 17

compareOffset = 0

Result is 00h

17

Append tag 0Fh

buffer = 00 01 … 0F

Initialize compareBuffer

compareBuffer = 00 01 … 0F

Successful call (with tag 8Fh)

tag = 8Fh

compareBuffer.length = 16

compareOffset = 0

Result is 00h

6.2.5.13.4 Test Coverage

CRR number

Test case number

N1

6,7

N2

7,9

N3

8, 13, 12

N4

10, 14

N5

11, 15

N6

17, 16

P1

1

P2

2, 3, 4, 5

C1

Does not apply for Envelope response handler

6.2.5.14 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, byte[] compareBuffer, short compareOffset, short compareLength)

Test Area Reference: API_2_ERH_FACRBBS_BSS.

6.2.5.14.1 Conformance requirement

The method with following header shall be compliant to its definition in the API.

public byte findAndCompareValue(byte tag,

byte occurrence,

short valueOffset,

byte[] compareBuffer,

short compareOffset,

short compareLength)

throws java.lang.NullPointerException,

java.lang.ArrayIndexOutOfBoundsException,

ToolkitException

6.2.5.14.1.1 Normal execution

Looks for the indicated occurrence of a TLV element from the beginning of a TLV list and compare its value with a buffer:

  • CRRN1: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current TLV is no longer defined.
  • CRRN2: if the method is successful then the corresponding TLV becomes current.
  • CRRN3: if identical 0 is returned.
  • CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned.
  • CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned.
  • CRRN6: The search method is comprehension required flag independent.

6.2.5.14.1.2 Parameter errors

  • CRRP1: if compareBuffer is null NullPointerException shall be thrown.
  • CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if compareLength is negative ArrayIndexOutOfBoundsException shall be thrown.
  • CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUNDARIES.
  • CRRP4: if an input parameter is not valid (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException BAD_INPUT_PARAMETER.

6.2.5.14.1.3 Context errors

  • CRRC1: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be ToolkitException HANDLER_NOT_AVAILABLE.

6.2.5.14.2 Test Suite files

Specific triggering: Unrecognized Envelope.

Test Script: API_2_ERH_FACRBBS_BSS_1.scr

Test Applet: API_2_ERH_FACRBBS_BSS_1.java

Load Script: API_2_ERH_FACRBBS_BSS_1.ldr

Cleanup Script: API_2_ERH_FACRBBS_BSS_1.clr

Parameter File: API_2_ERH_FACRBBS_BSS_1.par

6.2.5.14.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

Initialize the handler

findAndCompareValue() with a null compareBuffer

NullPointerException is thrown

2

clear the handler and appendTLV with TAG: 0D and value: 04 00 01 … 0F

compareOffset  compareBuffer.length

tag = 0Dh, occurrence = 1

valueOffset = 0

compareBuffer.length = 5

compareOffset = 5

compareLength = 1

ArrayIndexOutOfBoundsException is thrown

3

compareOffset < 0

compareBuffer.length = 5

compareOffset = -1

compareLength = 1

ArrayIndexOutOfBoundsException is thrown

4

compareLength >compareBuffer.length

compareBuffer.length = 5

compareOffset = 0

compareLength = 6

ArrayIndexOutOfBoundsException is thrown

5

compareOffset + compareLength >compareBuffer.length

compareBuffer.length = 5

compareOffset = 3

compareLength = 3

ArrayIndexOutOfBoundsException is thrown

6

compareLength < 0

compareBuffer.length = 5

compareOffset = 0

compareLength = -1

ArrayIndexOutOfBoundsException is thrown

7

clear the handler and appendTLV with TAG and length of 6

valueOffset  Text String Length

tag = 0Dh, occurrence = 1

valueOffset = 6

compareBuffer.length = 15

compareOffset = 0

compareLength = 1

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

8

valueOffset < 0

valueOffset = -1

compareBuffer.length = 15

compareOffset = 0

compareLength = 1

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

9

compareLength > Text String length

valueOffset = 0

compareBuffer.length = 15

compareOffset = 0

compareLength = 7

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

10

valueOffset + compareLength > Text String length

valueOffset = 2

compareBuffer.length = 15

compareOffset = 0

compareLength = 5

ToolkitException.OUT_OF_TLV_BOUNDARIES is thrown

11

Invalid parameter

occurrence = 0

ToolkitException.BAD_INPUT_PARAMETER is thrown

12

appendTLV with TAG 02 and length 02

Select a TLV (tag 02h)

findAndCompareValue()

tag = 0Dh

occurrence = 2

ToolkitException.UNAVAILABLE_ELEMENT is thrown

13

Verify current TLV

getValueLength()

ToolkitException.UNAVAILABLE_ELEMENT is thrown.

14

clear the handler and appendTLV with TAG: 0D and value: 04 00 01 … 0F

Initialize compareBuffer

compareBuffer =

04 00 01 … 0F

findAndCompareValue()

tag = 0Dh, occurrence = 1

valueOffset = 0

compareOffset = 0

compareLength = 17

Result is 00h

15

Verify current TLV

getValueLength()

Result is 17

16

Initialize compareBuffer

compareBuffer =

04 00 01 … 10

Compare buffers with same parameters

Result is -1

17

Initialize compareBuffer

compareBuffer =

03 00 01 … 0F

Compare buffers with same parameters

Result is +1

18

Initialize compareBuffer

compareBuffer =

55 55 55 01 02

03 04 05 06 07

08 09 0A 0B 0C

55 55 55 55 55

Compare buffers

valueOffset = 2

compareOffset = 3

compareLength = 12

Result is 00h

19

Initialize compareBuffer

compareBuffer =

55 55 55 02 01

03 04 05 06 07

08 09 0A 0B 0C

55 55 55 55 55

Compare buffers with same parameters

Result is -1

20

Initialize compareBuffer

compareBuffer =

55 55 55 01 02

03 04 05 06 07

08 09 0A 0A 0D

55 55 55 55 55

Compare buffers with same parameters

Result is +1

21

append a Text String TLV

tag = 0Dh

buffer = 00 11 22 33 44 55

Initialize compareBuffer

compareBuffer =

04 00 01 … 0F

findAndCompareValue()

tag = 0Dh, occurrence = 1

valueOffset = 0

compareOffset = 0

compareLength = 17

Result is 00h

22

Initialize compareBuffer

compareBuffer =

00 11 22 33 44 55

findAndCompareValue()

tag = 0Dh, occurrence = 2

valueOffset = 0

compareOffset = 0

compareLength = 6

Result is 00h

23

Initialize compareBuffer

compareBuffer =

00 11 22 33 44 66

findAndCompareValue()

tag = 0Dh, occurrence = 2

valueOffset = 0

compareOffset = 0

compareLength = 6

Result is -1

24

clear the handler and appendTLV with TAG: 0D and value: 04 00 01 … 0F

Initialize compareBuffer

compareBuffer = 04 00 01 … 0F

Successful call (with tag 8Dh)

tag = 8Dh, occurrence = 1

valueOffset = 0

compareBuffer.length = 17

compareOffset = 0

compareLength = 17

Result is 00h

25

Append tag 0Fh

buffer = 00 01 … 0F

Initialize compareBuffer

compareBuffer = 00 01 … 0F

Successful call (with tag 8Fh)

tag = 8Fh, occurrence = 1

valueOffset = 0

compareBuffer.length = 16

compareOffset = 0

compareLength = 16

Result is 00h

26

Successful call, findAndCompareValue with length =0

CompareBuffer.length = 16

compareOffset = 16

compareLength = 0

Result of findAndCompareValue () is 00

6.2.5.14.4 Test Coverage

CRR number

Test case number

N1

12,13

N2

15,13

N3

14, 18, 22, 21, 26

N4

16, 19, 23

N5

17, 19

N6

25, 24

P1

1

P2

2, 3, 4, 5, 6

P3

7, 8, 9, 10

P4

11

C1

Does not apply for EnvelopeResponseHandler

6.2.5.15 Method appendArray

Test Area Reference: API_2_ERH_APDA_BSS.

6.2.5.15.1 Conformance requirement:

The method with following header shall be compliant to its definition in the API.

void appendArray(byte[] buffer, short offset, short length)

throws java.lang.NullPointerException,

java.lang.ArrayIndexOutOfBoundsException,

ToolkitException

6.2.5.15.1.1 Normal execution

  • CRRN1: appends a buffer into the EditHandler buffer.
  • CRRN2: a successful append does not modify the TLV selected.

6.2.5.15.1.2 Parameters error

  • CRRP1: if buffer is null, a java.lang.NullPointerException is thrown.
  • CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a java.lang.ArrayIndexOutOfBoundsException is thrown.

6.2.5.15.1.3 Context errors

  • CRRC1: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with reason code HANDLER_OVERFLOW.
  • CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code HANDLER_NOT_AVAILABLE.

6.2.5.15.2 Test suite files

Specific triggering: Unrecognized Envelope.

Test Script: API_2_ERH_APDA_BSS_1.scr

Test Applet: API_2_ERH_APDA_BSS_1.java

Load Script: API_2_ERH_APDA_BSS_1.ldr

Cleanup Script: API_2_ERH_APDA_BSS_1.clr

Parameter File: API_2_ERH_APDA_BSS_1.par

6.2.5.15.3 Test procedure

Id

Description

API Expectation

APDU Expectation

Initialize the envelope response handler with a TLV of length 1

1

Null buffer

NullPointerException is thrown

2

offset  buffer.length

buffer.length = 5

offset = 5

length = 1

ArrayIndexOutOfBoundsException is thrown

3

offset < 0

buffer.length = 5

offset = -1

length = 1

ArrayIndexOutOfBoundsException is thrown

4

length > buffer.length

buffer.length = 5

offset = 0

length = 6

ArrayIndexOutOfBoundsException is thrown

5

offset + length > buffer.length

buffer.length = 5

offset = 3

length = 3

ArrayIndexOutOfBoundsException is thrown

6

length < 0

buffer.length = 5

offset = 0

length = -1

ArrayIndexOutOfBoundsException is thrown

7

Handler overflow

buffer.length = 256

offset = 0

length = 256

ToolkitException.HANDLER_OVERFLOW is thrown

8

append the handler with TLVs:

81 03 11 22 33

82 02 99 77

findTLV 0x81

Successful call

buffer = FF FE … F8

offset = 0

length = 8

Verify Current TLV: Call getValueLength()

Result is 03h

9

Clear the handler

Successful call

buffer = FF FE … F8

offset = 0

length = 8

Call copy() method

Compare handler

compareBuffer = FF FE … F8

Result is 00h

10

Successful call

buffer = 00 01 … 07

offset = 2

length = 6

Call copy() method

Compare handler

compareBuffer = FF FE … F8 02 03 … 07

Result is 00h

11

Successful call

buffer = 11 22 … 88

offset = 2

length = 4

Call copy() method

Compare handler

compareBuffer = FF FE … F8 02 03 … 07 33 44 55 66

Result is 00h

6.2.5.15.4 Test Coverage

CRR number

Test case number

N1

9, 10, 11

N2

8

N3

P1

1

P2

2, 3, 4, 5, 6

C1

7

C2

Does not apply for EnvelopeResponseHandler

6.2.5.16 Method appendTLV(byte tag, byte value)

Test Area Reference: API_2_ERH_APTLBB.

6.2.5.16.1 Conformance requirement

The method with following header shall be compliant to its definition in the API.

void appendTLV (byte tag, byte value)

throws ToolkitException

6.2.5.16.1.1 Normal execution

  • CRRN1: Appends a TLV element to the current TLV list (1-byte element).
  • CRRN2: A successful append does not modify the TLV selected.

6.2.5.16.1.2 Parameters error

No requirements.

6.2.5.16.1.3 Context errors

  • CRRC1: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with reason code HANDLER_OVERFLOW.
  • CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code HANDLER_NOT_AVAILABLE.

6.2.5.16.2 Test suite files

Specific triggering: Unrecognized Envelope.

Test Script: API_2_ERH_APTLBB_1.scr

Test Applet: API_2_ERH_APTLBB_1.java

Load Script: API_2_ERH_APTLBB_1.ldr

Cleanup Script: API_2_ERH_APTLBB_1.clr

Parameter File: API_2_ERH_APTLBB_1.par

6.2.5.16.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

Call appendArray()

length = 253

Handler Overflow: Call twice the appendTLV()method

ToolkitException.HANDLER_OVERFLOW is thrown by one of the two.

2

append the handler with TLVs:

81 03 11 22 33

82 02 99 77

Select Command Details TLV

Call the appendTLV() method

Verify Current TLV: Call getValueLength()

Result is 03h

3

Clear the handler

Successful call

tag = 84h

value = 00h

Call copy() method

Compare handler

compareBuffer = 84 01 00

Result is 00h

4

Successful call

tag = 01h

value = FEh

Call copy() method

Compare handler

compareBuffer = 84 01 00 01 01 FE

Result is 00h

NOTE: Test case 1 call twice appendTLV because the current GSM 03.19 [7] is not clear enough on this point. So this test allows the two possible implementations.

6.2.5.16.4 Test Coverage

CRR number

Test case number

N1

3, 4

N2

2

C1

1

C2

Does not apply for EnvelopeResponseHandler

6.2.5.17 Method appendTLV(byte tag, byte value1, byte value2)

Test Area Reference: API_2_ERH_APTLBBB.

6.2.5.17.1 Conformance requirements:

The method with following header shall be compliant to its definition in the API.

void appendTLV (byte tag, byte value1,byte value2)

throws ToolkitException

6.2.5.17.1.1 Normal execution

  • CRRN1: Appends a TLV element to the current TLV list (2-byte element).
  • CRRN2: A successful append does not modify the TLV selected.

6.2.5.17.1.2 Parameters error

No requirements.

6.2.5.17.1.3 Context errors

  • CRRC1: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with reason code HANDLER_OVERFLOW.
  • CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code HANDLER_NOT_AVAILABLE.

6.2.5.17.2 Test suite files

Specific triggering: Unrecognized Envelope.

Test Script: API_2_ERH_APTLBBB_1.scr

Test Applet: API_2_ERH_APTL BBB_1.java

Load Script: API_2_ERH_APTL BBB_1.ldr

Cleanup Script: API_2_ERH_APTLBBB_1.clr

Parameter File: API_2_ERH_APTLBBB_1.par

6.2.5.17.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

Call the appendArray with length of 253

Handler Overflow: Call the appendTLV() method

ToolkitException.HANDLER_OVERFLOW is thrown

2

clear the handler, append the handler with TLVs:

81 03 11 22 33

82 02 99 77

Select Command Details TLV

Call the appendTLV() method

Verify Current TLV: Call getValueLength()

Result is 03h

3

Clear the handler

Successful call

tag = 84h

value1 = 00h

value2 = 01h

Call copy() method

Compare handler

compareBuffer = 84 02 00 01

Result is 00h

4

Successful call

tag = 01h

value1 = FEh

value2 = FDh

Call copy() method

Compare handler

compareBuffer = 84 02 00 01 01 02 FE FD

Result is 00h

6.2.5.17.4 Test Coverage

CRR number

Test case number

N1

3, 4

N2

2

C1

1

C2

Does not apply for EnvelopeResponseHandler

6.2.5.18 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short valuelength)

Test Area Reference: API_2_ERH_APTLB_BSS.

6.2.5.18.1 Conformance requirement

The method with following header shall be compliant to its definition in the API.

void appendTLV (byte tag,

byte[] value,

short valueoffset,

short valuelength)

throws java.lang.NullPointerException,

java.lang.ArrayIndexOutOfBoundsException,

ToolkitException

6.2.5.18.1.1 Normal execution

  • CRRN1: Appends a TLV element to the current TLV list (byte-array element).
  • CRRN2: A successful append does not modify the TLV selected.

6.2.5.18.1.2 Parameters error

  • CRRP1: if value is null, a java.lang.NullPointerException is thrown.
  • CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is negative, a java.lang.ArrayIndexOutOfBoundsException is thrown.

6.2.5.18.1.3 Context errors

  • CRRC1: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with reason code HANDLER_OVERFLOW.
  • CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code HANDLER_NOT_AVAILABLE.
  • CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code BAD_INPUT_PARAMETER.

6.2.5.18.2 Test suite files

Specific triggering: Unrecognized Envelope.

Test Script: API_2_ERH_APTLB_BSS_1.scr

Test Applet: API_2_ERH_APTLB_BSS_1.java

Load Script: API_2_ERH_APTLB_BSS_1.ldr

Cleanup Script: API_2_ERH_APTLB_BSS_1.clr

Parameter File: API_2_ERH_APTLB_BSS_1.par

6.2.5.18.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

Null value

NullPointerException is thrown

2

valueOffset  value.length

value.length = 5

valueOffset = 5

valueLength = 1

ArrayIndexOutOfBoundsException is thrown

3

valueOffset < 0

value.length = 5

valueOffset = -1

valueLength = 1

ArrayIndexOutOfBoundsException is thrown

4

valueLength > value.length

value.length = 5

valueOffset = 0

valueLength = 6

ArrayIndexOutOfBoundsException is thrown

5

ValueOffset + valueLength > value.length

value.length = 5

valueOffset = 3

valueLength = 3

ArrayIndexOutOfBoundsException is thrown

6

valueLength < 0

value.length = 5

valueOffset = 0

valueLength = -1

ArrayIndexOutOfBoundsException is thrown

7

Handler overflow

value.length = 254

valueOffset = 0

valueLength = 254

ToolkitException.HANDLER_OVERFLOW is thrown

8

Bad parameter

value.length = 256

valueOffset = 0

valueLength = 256

ToolkitException.BAD_INPUT_PARAMETER is thrown

9

clear the handler, append the handler with TLVs:

81 03 11 22 33

82 02 99 77

Select Command Details TLV

Successful call

tag = 04

value = FF FE … F8

valueOffset = 0

valueLength = 8

Verify Current TLV: Call getValueLength()

Result is 03h

10

Clear the handler

Successful call

tag = 04

value = FF FE … F8

valueOffset = 0

valueLength = 8

Call copy() method

Compare handler

CompareBuffer = 04 08 FF FE … F8

Result is 00

11

Successful call

tag = 85h

value = 00 01 … 07

valueOffset = 2

valueLength = 6

Call copy() method

Compare handler

compareBuffer = 04 08 FF FE … F8 85 06 02 03 … 07

Result is 00

12

Successful call

tag = 01

value = 11 22 … 88

valueOffset = 2

valueLength = 4

Call copy() method

Compare handler

compareBuffer = 04 08 FF FE … F8 85 06 02 03 … 07 01 04 33 44 55 66

Result is 00

13

Clear the handler

Successful call

tag = 04

value = 00 01 … 7F

valueOffset = 0

valueLength = 80h

Call copy() method

Compare handler

compareBuffer = 04 81 80 00 01…7F

Result is 00

6.2.5.18.4 Test Coverage

CRR number

Test case number

N1

10, 11, 12, 13

N2

9

P1

1

P2

2, 3, 4, 5, 6

C1

7

C2

Does not apply for EnvelopeResponseHandler

C3

8

6.2.5.19 Method appendTLV(byte tag, byte value1, byte[ ] value2, short value2offset, short value2length)

Test Area Reference: API_2_ERH_APTLBB_BSS.

6.2.5.19.1 Conformance requirement

The method with following header shall be compliant to its definition in the API.

void appendTLV (byte tag,

byte value1

byte[] value2,

short value2offset,

short value2length)

throws java.lang.NullPointerException,

java.lang.ArrayIndexOutOfBoundsException,

ToolkitException

6.2.5.19.1.1 Normal execution

  • CRRN1: Appends a TLV element to the current TLV list (1 byte and a byte-array element).
  • CRRN2: A successful append does not modify the TLV selected.

6.2.5.19.1.2 Parameters error

  • CRRP1: if value2 is null, a java.lang.NullPointerException is thrown.
  • CRRP2: if value2offset or value2length or both would cause access outside the array bounds, or if length is negative, a java.lang.ArrayIndexOutOfBoundsException is thrown.

6.2.5.19.1.3 Context errors

  • CRRC1: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with reason code HANDLER_OVERFLOW.
  • CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code HANDLER_NOT_AVAILABLE.
  • CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code BAD_INPUT_PARAMETER.

6.2.5.19.2 Test suite files

Specific triggering: Unrecognized Envelope.

Test Script: API_2_ERH_APTLBB_BSS_1.scr

Test Applet: API_2_ERH_APTLBB_BSS_1.java

Load Script: API_2_ERH_APTLBB_BSS_1.ldr

Cleanup Script: API_2_ERH_APTLBB_BSS_1.clr

Parameter File: API_2_ERH_APTLBB_BSS_1.par

6.2.5.19.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

Null value2

NullPointerException is thrown

2

value2Offset  value2.length

value2.length = 5

value2Offset = 5

value2Length = 1

ArrayIndexOutOfBoundsException is thrown

3

value2Offset < 0

value2.length = 5

value2Offset = -1

value2Length = 1

ArrayIndexOutOfBoundsException is thrown

4

value2Length > value2.length

value2.length = 5

value2Offset = 0

value2Length = 6

ArrayIndexOutOfBoundsException is thrown

5

value2Offset + value2Length > value2.length

value2.length = 5

value2Offset = 3

value2Length = 3

ArrayIndexOutOfBoundsException is thrown

6

value2Length < 0

value2.length = 5

value2Offset = 0

value2Length = -1

ArrayIndexOutOfBoundsException is thrown

7

Handler overflow

value2.length = 254

value2Offset = 0

value2Length = 254

ToolkitException.HANDLER_OVERFLOW is thrown

8

Bad parameter

value2.length = 256

value2Offset = 0

value2Length = 256

ToolkitException.BAD_INPUT_PARAMETER is thrown

9

clear the handler, append the handler with TLVs:

81 03 11 22 33

82 02 99 77

Select Command Details TLV

Successful call

tag = 04

value1 = 05

value2 = FF FE … F8

value2Offset = 0

value2Length = 8

Verify Current TLV: Call getValueLength()

Result is 03h

10

Clear the handler

Successful call

tag = 04

value1 = 05

value2 = FF FE … F8

value2Offset = 0

value2Length = 8

Call copy() method

Compare handler

CompareBuffer = 04 09 05 FF FE … F8

Result is 00

11

Successful call

tag = 85h

value1 = 55h

value2 = 00 01 … 07

value2Offset = 2

value2Length = 6

Call copy() method

Compare handler

compareBuffer =

04 09 05 FF FE … F8

85 07 55 02 03 … 07

Result is 00

12

Successful call

tag = 01

value1 = 44h

value2 = 11 22 … 88

value2Offset = 2

value2Length = 4

Call copy() method

Compare handler

CompareBuffer =

04 09 05 FF FE … F8

85 07 55 02 03 … 07

01 05 44 33 44 55 66

Result is 00

13

Clear the handler

Successful call

tag = 04

value1 = 00

value2 = 01 … 7F

value2Offset = 0

value2Length = 7Fh

Call copy() method

Compare handler

compareBuffer = 04 81 80 00 01…7F

Result is 00

6.2.5.19.4 Test Coverage

CRR number

Test case number

N1

10, 11, 12, 13

N2

9

P1

1

P2

2, 3, 4, 5, 6

C1

7

C2

Does not apply for EnvelopeResponseHandler

C3

8

6.2.5.20 Method clear

Test Area Reference: API_2_ERH_CLER.

6.2.5.20.1 Conformance requirement

The method with following header shall be compliant to its definition in the API.

void clear()

throws ToolkitException

6.2.5.20.1.1 Normal execution

  • CRRN1: Clears the TLV list of an EditHandler and resets the current TLV selected.

6.2.5.20.1.2 Parameters error

No requirements.

6.2.5.20.1.3 Context errors

  • CRRC1: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code HANDLER_NOT_AVAILABLE.

6.2.5.20.2 Test suite files

Specific triggering: Unrecognized Envelope.

Test Script: API_2_ERH_CLER_1.scr

Test Applet: API_2_ERH_CLER_1.java

Load Script: API_2_ERH_CLER_1.ldr

Cleanup Script: API_2_ERH_CLER_1.clr

Parameter File: API_2_ERH_CLER_1.par

6.2.5.20.3 Test procedure

Id

Description

API Expectation

APDU Expectation

1

append the handler with TLVs:

81 03 11 22 33

82 02 99 77

Select Command Details TLV

Call the getLength() method

Result of getLength() is not null

Clear the handler

Call the getLength() method

Result of getLength() is 0

2

Call the getValueLength() method

ToolkitException.UNAVAILABLE_ELEMENT is thrown

6.2.5.20.4 Test Coverage

CRR number

Test case number

N1

1, 2

C1

Does not apply for EnvelopeResponseHandler