5 GSM Framework

03.193GPPRelease 1999Subscriber Identity Module Application Programming Interface (SIM API) for Java CardTS

5.1 Overview

The GSM Framework consists of the GSM applet and the JCRE File System Object.

The GSM Framework is based on two packages:

– The GSM low level package [FFS];

– The sim.access package, which allows applets to access the GSM files.

5.2 GSM file data access

The following methods shall be offered by the API to card applets, to allow access to the GSM data:

select Select a file without changing the current file of any other applet or of the subscriber session. At the invocation of the processToolkit method of a toolkit applet, the current file is the MF. The toolkit applet file context remains unchanged during the whole execution of the processToolkit method, the current record may be altered if the current file is a cyclic file and the content of the current file may be altered. This method returns the selected file information;

status Read the file status information of the current DF;

readBinary Read data bytes of the transparent EF currently selected by the applet;

readRecord Read data bytes of the linear fixed or cyclic EF currently selected by the applet without changing the current record pointer of any other applet / subscriber. This method allows reading part of a record;

updateBinary Modify data bytes of the transparent EF currently selected by the applet. The toolkit applet shall send the corresponding refresh ;

updateRecord Modify data bytes of the linear fixed or cyclic EF currently selected by the applet. The current record pointer of other applets / subscriber shall not be changed in case of linear fixed EF but the record pointer of a cyclic EF shall be changed for all other applets / subscriber to the record number 1. This method allows updating part of a record. The toolkit applet shall send the corresponding refresh ;

seek Search a record of the linear fixed file currently selected by the applet starting with a given pattern. The current record pointer of any other applet or of the subscriber session shall not be changed;

increase Increase the value of the last updated record of the cyclic EF currently selected. It becomes than record number 1 for every other applet and subscriber session. This method returns the increased value. The toolkit applet shall send the corresponding refresh;

rehabilitate Rehabilitate the EF currently selected by the applet with effect for all other applets / subscriber. The toolkit applet shall send the corresponding refresh;

invalidate Invalidate the EF currently selected by the applet with effect for all other applets / subscriber. The toolkit applet shall send the corresponding refresh.

These methods are described in the sim.access.SIMView interface in Annex A.

5.3 Access control

The Access Control privileges of the applet are granted during installation according to the level of trust. When an applet requests access to GSM or operator specific files, the SIM Toolkit Framework checks if this access is allowed by examination of the file control information stored on the card. If access is granted the SIM Toolkit Framework will process the access request, if access is not granted, an exception will be thrown.

[Contents and coding of the file(s) containing access control information will be defined in TSĀ 11.11]

5.4 GSM low Level API

[FFS. This API allows the implementation of the GSM applet]