6.3.10 Other parts transferred to framework from API

3GPP51.013Release 17Test specification for Subscriber Identity Module (SIM) Application Programming Interface (API) for Java CardTS

6.3.10.1 A handler is a temporary JCRE Entry Point object

Test Area Reference: FWK_API_HEPO

6.3.10.1.1 Conformance Requirement:

6.3.10.1.1.1 Normal execution

  • CRRN1: The EnvelopeHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime Environment (JCRE) Specification [12]).
  • CRRN2: The EnvelopeResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime Environment (JCRE) Specification [12]).
  • CRRN3: The ProactiveHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime Environment (JCRE) Specification [12]).
  • CRRN4: The ProactiveResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime Environment (JCRE) Specification [12]).

6.3.10.1.1.2 Parameters errors

No requirements.

6.3.10.1.1.3 Context errors

No requirements.

6.3.10.1.2 Test suite files

Test Script: FWK_API_HEPO_1.scr

Test Applet: FWK_API_HEPO_1.java

Load Script: FWK_API_HEPO_1.ldr

Cleanup Script: FWK_API_HEPO_1.clr

Parameter File: FWK_API_HEPO_1.par

6.3.10.1.3 Test Procedure

Id

Description

API/Framework Expectation

APDU Expectation

1

EnvelopeHandler.getTheHandler and store it in a static field of the toolkit applet

SecurityException is thrown

2

EnvelopeHandler.getTheHandler and store it in a field of the toolkit applet

SecurityException is thrown

3

EnvelopeResponseHandler.getTheHandler and store it in a static field of the toolkit applet

SecurityException is thrown

4

EnvelopeResponseHandler.getTheHandler and store it in a field of the toolkit applet

SecurityException is thrown

5

ProactiveHandler.getTheHandler and store it in a static field of the toolkit applet

SecurityException is thrown

6

ProactiveHandler.getTheHandler and store it in a field of the toolkit applet

SecurityException is thrown

7

Build and send a DISPLAY TEXT command to be able to get the reference of the ProactiveReponseHandler

Proactive command fetched and terminal response is issued

ProactiveResponseHandler.getTheHandler and store it in a static field of the toolkit applet

SecurityException is thrown

8

ProactiveResponseHandler.getTheHandler and store it in a field of the toolkit applet

SecurityException is thrown

6.3.10.1.4 Test Coverage

CRR number

Test case number

N1

1, 2

N2

3, 4

N3

5, 6

N4

7, 8

6.3.10.2 Transaction

Test Area Reference: FWK_API_TRAN

6.3.10.2.1 Conformance Requirement:

6.3.10.2.1.1 Normal execution

  • CRRN1: A pending toolkit applet transaction at the ProactiveHandler.send() method invocation is aborted.

6.3.10.2.1.2 Parameters errors

No requirements.

6.3.10.2.1.3 Context errors

No requirements.

6.3.10.2.2 Test suite files

Test Script: FWK_API_TRAN_1.scr

Test Applet: FWK_API_TRAN_1.java

Load Script: FWK_API_TRAN_1.ldr

Cleanup Script: FWK_API_TRAN_1.clr

Parameter File: FWK_API_TRAN_1.par

6.3.10.2.3 Test Procedure

Id

Description

API/Framework Expectation

APDU Expectation

1

Verify that transaction is aborted when a proactive command is sent

Initialise a byte field with 0x05

Build a display text proactive command.

beginTransaction()

Update the byte with 0x02

send the proactive command

Proactive command fetched and terminal response is issued

Verify that the byte value is 0x05

JCSystem.getTransactionDepth()

Shall return 0

6.3.10.2.4 Test Coverage

CRR number

Test case number

N1

1

6.3.10.3 Timer Id between Applets

Test Area Reference: FWK_API_TMID

6.3.10.3.1 Conformance Requirement:

6.3.10.3.1.1 Normal execution

No requirements.

6.3.10.3.1.2 Parameters errors

No requirements.

6.3.10.3.1.3 Context errors

  • CRRC1: The method ToolkitRegistry.releaseTimer() shall throw a ToolkitException with INVALID_TIMER_ID reason if the timer is valid but isn’t allocated to this applet.

6.3.10.3.2 Test suite files

Test Script: FWK_API_TMID_1.scr

Test Applet: FWK_API_TMID_1.java

Load Script: FWK_API_TMID_1.ldr

Cleanup Script: FWK_API_TMID_1.clr

Parameter File: FWK_API_TMID_1.par

6.3.10.3.3 Test Procedure

Id

Description

API/Framework Expectation

APDU Expectation

1

During installation :

First instance allocate a timer and store the returned value in a static field.

Second instance allocate a timer.

Trig second instance and try to releaseTimer() with the static field value.

releaseTimer() shall throw a ToolkitException with INVALID_TIMER_ID reason

6.3.10.3.4 Test Coverage

CRR number

Test case number

N1

1