G.2 File Contents and Organization

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

Parameters in this file are organized in the following clauses:

[CONVERT]	Conversion parameters used during conversion (i.e. CAP file generation)
[INSTALL(load)]	Parameters used by the Install for Load command
[LOAD]	Parameters used by the Load command
[INSTALL(install)]	Parameters used by the Install for Install command

All clauses may appear only once in the file, except for the "INSTALL(install)" clause. If that clause appears more than once, it will apply to different applet instances, in sequence.

G.2.1 Default values, order and processing

The ordering of the parameters and the clauses is relevant, since parameter names may be repeated and apply to different applets.

When one single parameter is repeated within one clause, it refers to different applets. The value of the n^th appearance of the parameter applies to applet n.

When one clause is repeated (INSTALL(install)), then the n^th appearance of the clause applies to applet n. Parameter/value pairs which are found in one appearance of the clause are valid for the subsequent applets as long as they are not overridden. For example, first INSTALL(install) may contain all values for parameters, whereas the subsequent INSTALL(install) clauses may only contain parameters whose values change.

If one required parameter is missing from one clause, the last defined value of this parameter in a previous clause of the same file will be used.

G.2.2 CONVERT Clause

These parameters allow configuration of the conversion process of the Java class file(s) into one CAP file.

Parameter	Description
PackageAID	AID of the package
PackageName	Fully qualified name of the package
PackageVersion	Version of the package
AppletClassAID	AID of the applet
AppletClassName	Name of the applet

G.2.3 INSTALL(load) Clause

Here are the parameters to be included in the Install(Load) command (as specified in TS 23.048 [8] ).

Parameter	Description
PackageAID	AID of the package
PackageNonVolatileMemSize	Non Volatile memory space (in bytes) required for package loading
InstallationNonVolatileMemSize	Non volatile memory required for installation, in bytes
InstallationVolatileMemSize	Volatile memory required for installation, in bytes

G.2.4 LOAD Clause

Here are the parameters to be included in the Load command (as specified in TS 23.048 [8] ).

Parameter	Description
MaxLoadCommandDataLength	Maximum length of the data provided in the load command (P3 parameter of the LOAD APDU embedded in the command packet)

G.2.5 INSTALL(install) Clause

Here are the parameters to be included in the Install(Install) command (as specified in 3GPP TS 23.048 [8]).

Parameter	Description
PackageAID	AID of the package
AppletClassAID	AID of the applet
InstanceAID	AID of the instance of the applet
InstallationNonVolatileMemSize	Non volatile memory required for installation, in bytes
InstallationVolatileMemSize	Volatile memory required for installation, in bytes
AccessDomain	Specify the SIM files that may be accessed by the applet and the operations allowed on these files. This parameter includes the Access Domain Parameter (ADP) and Access Domain Data (ADD)
PriorityLevel	Priority level of the Toolkit applet instance
MaxNumberOfTimers	Maximum number of timers allowed for this applet instance
MaxMenuEntryTextLength	Maximum text length for a menu entry
MaxNumberOfMenuEntries	Maximum number of menu entries allowed for this applet instance
MenuEntriesPositionIdentifier	For each menu entry: Position and identifier of that menu entry
MaxNumberOfChannels	Maximum Number of channels for this applet instance
MSLFieldLength	Length of Minimum Security Level field
MSLParameter	MSL Parameter
MSLData	MSL Data
AppletSpecificParameters	Parameters specific to the applet

The applet shall be installed with install(install and make selectable) command.