sim.access
Interface SIMView


public interface SIMView
extends javacard.framework.Shareable

The SIMView interface is the interface between the GSM System Services and any applet (SIM Toolkit or other). It offers some methods to communicate with the GSM System Services without compromising the GSM file system integrity (e.g. ME file context, conflicting access to files ...). All the methods are based on the commands of the GSM11.11 specification. This interface shall be implemented by a JCRE owned object. This interface is not intended for the activation of a SIM Toolkit applet.

Version:
8.0.0
See Also:
Shareable, SIMViewException

Field Summary
static short FID_DF_ACES
          File identifier : DF ACeS = 0x5F33 (under DF GSM)
static short FID_DF_CTS
          File identifier : DF CTS = 0x5F60 (under DF GSM)
static short FID_DF_DCS_1800
          File identifier : DF DCS-1800 = 0x7F21
static short FID_DF_FP_CTS
          File identifier : DF FP-CTS = 0x7F23
static short FID_DF_GLOBALSTAR
          File identifier : DF Globalstar = 0x5F31 (under DF GSM)
static short FID_DF_Graphics
          Deprecated. Replaced by FID_DF_GRAPHICS in version 7.4.0
static short FID_DF_GRAPHICS
          File identifier : DF Graphics = 0x5F50 (under DF TELECOM)
static short FID_DF_GSM
          File identifier : DF GSM = 0x7F20
static short FID_DF_ICO
          File identifier : DF ICO = 0x5F32 (under DF GSM)
static short FID_DF_IRIDIUM
          File identifier : DF IRIDIUM = 0x5F30 (under DF GSM)
static short FID_DF_IS_41
          File identifier : DF IS-41 = 0x7F22
static short FID_DF_MEXE
          File identifier : DF MExE = 0x5F3C (under DF GSM)
static short FID_DF_PCS_1900
          File identifier : DF PCS-1900 = 0x5F40 (under DF GSM)
static short FID_DF_PDC
          File identifier : DF PDC = 0x7F80
static short FID_DF_SOLSA
          File identifier : DF SoLSA = 0x5F70 (under DF GSM)
static short FID_DF_TELECOM
          File identifier : DF TELECOM = 0x7F10
static short FID_DF_TETRA
          File identifier : DF TETRA = 0x7F90
static short FID_DF_TIA_EIA_136
          File identifier : DF TIA-EIA-136 = 0x7F24
static short FID_DF_TIA_EIA_553
          File identifier : DF TIA-EIA-553= 0x5F40 (under DF GSM)
static short FID_DF_TIA_EIA_95
          File identifier : DF TIA-EIA-95 = 0x7F25
static short FID_EF_AAEM
          File identifier : EF AAeM = 0x6FB6 (under DF GSM)
static short FID_EF_ACC
          File identifier : EF ACC = 0x6F78 (under DF GSM)
static short FID_EF_ACCOLC
          File identifier : EF ACCOLC = 0x4F89 (under DF TIA-EIA-553)
static short FID_EF_ACM
          File identifier : EF ACM = 0x6F39 (under DF GSM)
static short FID_EF_ACMMAX
          File identifier : EF ACMmax = 0x6F37 (under DF GSM)
static short FID_EF_AD
          File identifier : EF AD = 0x6FAD (under DF GSM)
static short FID_EF_ADN
          File identifier : EF ADN = 0x6F3A (under DF TELECOM)
static short FID_EF_AMPS_2_GSM
          File identifier : EF AMPS_2_GSM = 0x4F91 (under DF TIA-EIA-553)
static short FID_EF_AMPS_UI
          File identifier : EF AMPS_UI = 0x4F93 (under DF TIA-EIA-553)
static short FID_EF_ARPK
          File identifier : EF ARPK= 0x4F42 (under DF MExE)
static short FID_EF_BCCH
          File identifier : EF BCCH = 0x6F74 (under DF GSM)
static short FID_EF_BDN
          File identifier : EF BDN = 0x6F4D (under DF TELECOM)
static short FID_EF_CBMI
          File identifier : EF CBMI = 0x6F45 (under DF GSM)
static short FID_EF_CBMID
          File identifier : EF CBMID = 0x6F48 (under DF GSM)
static short FID_EF_CBMIR
          File identifier : EF CBMIR = 0x6F50 (under DF GSM)
static short FID_EF_CCCH
          File identifier : EF CCCH = 0x4F8E (under DF TIA-EIA-553)
static short FID_EF_CCP
          File identifier : EF CCP = 0x6F3D (under DF TELECOM)
static short FID_EF_CMI
          File identifier : EF CMI = 0x6F58 (under DF TELECOM)
static short FID_EF_CNL
          File identifier : EF CNL = 0x6F32 (under DF GSM)
static short FID_EF_COUNT
          File identifier : EF COUNT = 0x4F83 (under DF TIA-EIA-553)
static short FID_EF_CPBCCH
          File identifier : EF CPBCCH= 0x6F63(under DF GSM)
static short FID_EF_CSID
          File identifier : EF CSID= 0x4F8C (under DF TIA-EIA-553)
static short FID_EF_DCK
          File identifier : EF DCK = 0x6F2C (under DF GSM)
static short FID_EF_ECC
          File identifier : EF ECC = 0x6FB7 (under DF GSM)
static short FID_EF_ECCP
          File identifier : EF ECCP = 0x6F4F (under DF TELECOM)
static short FID_EF_ELP
          File identifier : EF ELP = 0x2F05 (under MF)
static short FID_EF_EMLPP
          File identifier : EF eMLPP = 0x6FB5 (under DF GSM)
static short FID_EF_EXT1
          File identifier : EF EXT1 = 0x6F4A (under DF TELECOM)
static short FID_EF_EXT2
          File identifier : EF EXT2 = 0x6F4B (under DF TELECOM)
static short FID_EF_EXT3
          File identifier : EF EXT3 = 0x6F4C (under DF TELECOM)
static short FID_EF_EXT4
          File identifier : EF EXT4 = 0x6F4E (under DF TELECOM)
static short FID_EF_FC1
          File identifier : EF FC1= 0x4F8A (under DF TIA-EIA-553)
static short FID_EF_FDN
          File identifier : EF FDN = 0x6F3B (under DF TELECOM)
static short FID_EF_FPLMN
          File identifier : EF FPLMN = 0x6F7B (under DF GSM)
static short FID_EF_GID1
          File identifier : EF GID1 = 0x6F3E (under DF GSM)
static short FID_EF_GID2
          File identifier : EF GID2 = 0x6F3F (under DF GSM)
static short FID_EF_GPI
          File identifier : EF GPI = 0x4F81 (under DF TIA-EIA-553)
static short FID_EF_GSM_RECON
          File identifier : EF GSM_RECON = 0x4F90 (under DF TIA-EIA-553)
static short FID_EF_HPLMN
          File identifier : EF HPLMN = 0x6F31 (under DF GSM)
static short FID_EF_HPLMNWACT
          File identifier : EF HPLMNwAcT= 0x6F62 (under DF GSM)
static short FID_EF_ICCID
          File identifier : EF ICCID = 0x2FE2 (under MF)
static short FID_EF_IMG
          File identifier : EF IMG = 0x4F20 (under DF Graphics)
static short FID_EF_IMSI
          File identifier : EF IMSI = 0x6F07 (under DF GSM)
static short FID_EF_INVSCAN
          File identifier : EF InvScan= 0x6F64(under DF GSM)
static short FID_EF_IPC
          File identifier : EF IPC = 0x4F82 (under DF TIA-EIA-553)
static short FID_EF_KC
          File identifier : EF Kc = 0x6F20 (under DF GSM)
static short FID_EF_KCGPRS
          File identifier : EF KcGPRS = 0x6F52 (under DF GSM)
static short FID_EF_LDCC
          File identifier : EF LDCC = 0x4F8F (under DF TIA-EIA-553)
static short FID_EF_LND
          File identifier : EF LND = 0x6F44 (under DF TELECOM)
static short FID_EF_LOCI
          File identifier : EF LOCI = 0x6F7E (under DF GSM)
static short FID_EF_LOCIGPRS
          File identifier : EF LOCIGPRS = 0x6F53 (under DF GSM)
static short FID_EF_LP
          File identifier : EF LP = 0x6F05 (under DF GSM)
static short FID_EF_MEXE_ST
          File identifier : EF MExE_ST= 0x4F40 (under DF MExE)
static short FID_EF_MIN
          File identifier : EF MIN = 0x4F88 (under DF TIA-EIA-553)
static short FID_EF_MSISDN
          File identifier : EF MSISDN = 0x6F40 (under DF TELECOM)
static short FID_EF_NETSEL
          File identifier : EF NETSEL = 0x4F86 (under DF TIA-EIA-553)
static short FID_EF_NIA
          File identifier : EF NIA = 0x6F51 (under DF GSM)
static short FID_EF_NSID
          File identifier : EF NSID = 0x4F84 (under DF TIA-EIA-553)
static short FID_EF_OPLMNWACT
          File identifier : EF OPLMNwAcT= 0x6F61 (under DF GSM)
static short FID_EF_ORPK
          File identifier : EF ORPK= 0x4F41 (under DF MExE)
static short FID_EF_PHASE
          File identifier : EF Phase = 0x6FAE (under DF GSM)
static short FID_EF_PLMNSEL
          File identifier : EF PLMNsel = 0x6F30 (under DF GSM)
static short FID_EF_PLMNWACT
          File identifier : EF PLMNwAcT= 0x6F60 (under DF GSM)
static short FID_EF_PSID
          File identifier : EF PSID = 0x4F85 (under DF TIA-EIA-553)
static short FID_EF_PUCT
          File identifier : EF PUCT = 0x6F41 (under DF GSM)
static short FID_EF_REG_THRESH
          File identifier : EF REG_THRESH = 0x4F8D (under DF TIA-EIA-553)
static short FID_EF_S_ESN
          File identifier : EF S_ESN = 0x4F8B (under DF TIA-EIA-553)
static short FID_EF_SAI
          File identifier : EF SAI = 0x4F30 (under DF SoLSA)
static short FID_EF_SDN
          File identifier : EF SDN = 0x6F49 (under DF TELECOM)
static short FID_EF_SID
          File identifier : EF SID = 0x4F80 (under DF TIA-EIA-553)
static short FID_EF_SLL
          File identifier : EF SLL = 0x4F31 (under DF SoLSA)
static short FID_EF_SMS
          File identifier : EF SMS = 0x6F3C (under DF TELECOM)
static short FID_EF_SMSP
          File identifier : EF SMSP = 0x6F42 (under DF TELECOM)
static short FID_EF_SMSR
          File identifier : EF SMSR = 0x6F47 (under DF TELECOM)
static short FID_EF_SMSS
          File identifier : EF SMSS = 0x6F43 (under DF TELECOM)
static short FID_EF_SPL
          File identifier : EF SPL = 0x4F87 (under DF TIA-EIA-553)
static short FID_EF_SPN
          File identifier : EF SPN = 0x6F46 (under DF GSM)
static short FID_EF_SST
          File identifier : EF SST = 0x6F38 (under DF GSM)
static short FID_EF_SUME
          File identifier : EF SUME = 0x6F54 (under DF GSM)
static short FID_EF_TPRPK
          File identifier : EF TPRPK = 0x4F43 (under DF MExE)
static short FID_EF_VBS
          File identifier : EF VBS = 0x6FB3 (under DF GSM)
static short FID_EF_VBSS
          File identifier : EF VBSS = 0x6FB4 (under DF GSM)
static short FID_EF_VGCS
          File identifier : EF VGCS = 0x6FB1 (under DF GSM)
static short FID_EF_VGCSS
          File identifier : EF VGCSS = 0x6FB2 (under DF GSM)
static short FID_MF
          File identifier : MF = 0x3F00
static byte REC_ACC_MODE_ABSOLUTE_CURRENT
          Record access mode : absolute/current record = 0x04
static byte REC_ACC_MODE_NEXT
          Record access mode : next record = 0x02
static byte REC_ACC_MODE_PREVIOUS
          Record access mode : previous record = 0x03
static byte SEEK_FROM_BEGINNING_FORWARD
          Seek mode : from the beginning forward = 0x00
static byte SEEK_FROM_END_BACKWARD
          Seek mode : from the end backward = 0x01
static byte SEEK_FROM_NEXT_FORWARD
          Seek mode : from the next location forward = 0x02
static byte SEEK_FROM_PREVIOUS_BACKWARD
          Seek mode : from the previous location backward = 0x03
 
Method Summary
 short increase(byte[] incr, short incrOffset, byte[] resp, short respOffset)
          INCREASE command as defined in GSM 11.11 standard.
This method increases the current cyclic EF record of the calling applet.
 void invalidate()
          INVALIDATE command as defined in GSM 11.11 standard.
This method invalidates the currently selected EF of the calling applet.
 short readBinary(short fileOffset, byte[] resp, short respOffset, short respLength)
          READ BINARY command as defined in GSM 11.11 standard.
This method reads the data bytes of the current transparent EF of the calling applet.
 short readRecord(short recNumber, byte mode, short recOffset, byte[] resp, short respOffset, short respLength)
          READ RECORD command as defined in GSM 11.11 standard.
This method reads the data bytes of the current linear fixed/cyclic EF of the calling applet.
 void rehabilitate()
          REHABILITATE command as defined in GSM 11.11 standard.
This method rehabilitates the currently selected EF of the calling applet.
 short seek(byte mode, byte[] patt, short pattOffset, short pattLength)
          SEEK command as defined in GSM 11.11 standard.
This method seeks a pattern in the current linear fixed EF of the calling applet.
 void select(short fid)
          SELECT command as defined in GSM 11.11 standard.
This SELECT method allows to update the current file without handling the Select Response.
 short select(short fid, byte[] fci, short fciOffset, short fciLength)
          SELECT command as defined in GSM 11.11 standard.
By default, the MF is selected at the beginning of each applet activation (current file = MF).
 short status(byte[] fci, short fciOffset, short fciLength)
          STATUS command as defined in GSM 11.11 standard.
This method returns the FCI (File Control Information) of the current DF (or MF) of the calling applet.
 void updateBinary(short fileOffset, byte[] data, short dataOffset, short dataLength)
          UPDATE BINARY command as defined in GSM 11.11 standard.
This method updates the data bytes of the current transparent EF of the calling applet.
 void updateRecord(short recNumber, byte mode, short recOffset, byte[] data, short dataOffset, short dataLength)
          UPDATE RECORD command as defined in GSM 11.11 standard.
This method updates the data bytes of the current linear fixed/cyclic EF of the calling applet.
 

Field Detail

FID_MF

public static final short FID_MF
File identifier : MF = 0x3F00

FID_DF_TELECOM

public static final short FID_DF_TELECOM
File identifier : DF TELECOM = 0x7F10

FID_DF_GSM

public static final short FID_DF_GSM
File identifier : DF GSM = 0x7F20

FID_DF_DCS_1800

public static final short FID_DF_DCS_1800
File identifier : DF DCS-1800 = 0x7F21

FID_DF_IS_41

public static final short FID_DF_IS_41
File identifier : DF IS-41 = 0x7F22

FID_DF_FP_CTS

public static final short FID_DF_FP_CTS
File identifier : DF FP-CTS = 0x7F23

FID_DF_PDC

public static final short FID_DF_PDC
File identifier : DF PDC = 0x7F80

FID_DF_TETRA

public static final short FID_DF_TETRA
File identifier : DF TETRA = 0x7F90

FID_DF_TIA_EIA_136

public static final short FID_DF_TIA_EIA_136
File identifier : DF TIA-EIA-136 = 0x7F24

FID_DF_TIA_EIA_95

public static final short FID_DF_TIA_EIA_95
File identifier : DF TIA-EIA-95 = 0x7F25

FID_DF_Graphics

public static final short FID_DF_Graphics
Deprecated. Replaced by FID_DF_GRAPHICS in version 7.4.0


FID_DF_GRAPHICS

public static final short FID_DF_GRAPHICS
File identifier : DF Graphics = 0x5F50 (under DF TELECOM)

FID_DF_IRIDIUM

public static final short FID_DF_IRIDIUM
File identifier : DF IRIDIUM = 0x5F30 (under DF GSM)

FID_DF_GLOBALSTAR

public static final short FID_DF_GLOBALSTAR
File identifier : DF Globalstar = 0x5F31 (under DF GSM)

FID_DF_ICO

public static final short FID_DF_ICO
File identifier : DF ICO = 0x5F32 (under DF GSM)

FID_DF_ACES

public static final short FID_DF_ACES
File identifier : DF ACeS = 0x5F33 (under DF GSM)

FID_DF_PCS_1900

public static final short FID_DF_PCS_1900
File identifier : DF PCS-1900 = 0x5F40 (under DF GSM)

FID_DF_CTS

public static final short FID_DF_CTS
File identifier : DF CTS = 0x5F60 (under DF GSM)

FID_DF_SOLSA

public static final short FID_DF_SOLSA
File identifier : DF SoLSA = 0x5F70 (under DF GSM)

FID_DF_TIA_EIA_553

public static final short FID_DF_TIA_EIA_553
File identifier : DF TIA-EIA-553= 0x5F40 (under DF GSM)

FID_DF_MEXE

public static final short FID_DF_MEXE
File identifier : DF MExE = 0x5F3C (under DF GSM)

FID_EF_ICCID

public static final short FID_EF_ICCID
File identifier : EF ICCID = 0x2FE2 (under MF)

FID_EF_ELP

public static final short FID_EF_ELP
File identifier : EF ELP = 0x2F05 (under MF)

FID_EF_ADN

public static final short FID_EF_ADN
File identifier : EF ADN = 0x6F3A (under DF TELECOM)

FID_EF_FDN

public static final short FID_EF_FDN
File identifier : EF FDN = 0x6F3B (under DF TELECOM)

FID_EF_SMS

public static final short FID_EF_SMS
File identifier : EF SMS = 0x6F3C (under DF TELECOM)

FID_EF_CCP

public static final short FID_EF_CCP
File identifier : EF CCP = 0x6F3D (under DF TELECOM)

FID_EF_MSISDN

public static final short FID_EF_MSISDN
File identifier : EF MSISDN = 0x6F40 (under DF TELECOM)

FID_EF_SMSP

public static final short FID_EF_SMSP
File identifier : EF SMSP = 0x6F42 (under DF TELECOM)

FID_EF_SMSS

public static final short FID_EF_SMSS
File identifier : EF SMSS = 0x6F43 (under DF TELECOM)

FID_EF_LND

public static final short FID_EF_LND
File identifier : EF LND = 0x6F44 (under DF TELECOM)

FID_EF_SDN

public static final short FID_EF_SDN
File identifier : EF SDN = 0x6F49 (under DF TELECOM)

FID_EF_EXT1

public static final short FID_EF_EXT1
File identifier : EF EXT1 = 0x6F4A (under DF TELECOM)

FID_EF_EXT2

public static final short FID_EF_EXT2
File identifier : EF EXT2 = 0x6F4B (under DF TELECOM)

FID_EF_EXT3

public static final short FID_EF_EXT3
File identifier : EF EXT3 = 0x6F4C (under DF TELECOM)

FID_EF_BDN

public static final short FID_EF_BDN
File identifier : EF BDN = 0x6F4D (under DF TELECOM)

FID_EF_EXT4

public static final short FID_EF_EXT4
File identifier : EF EXT4 = 0x6F4E (under DF TELECOM)

FID_EF_SMSR

public static final short FID_EF_SMSR
File identifier : EF SMSR = 0x6F47 (under DF TELECOM)

FID_EF_ECCP

public static final short FID_EF_ECCP
File identifier : EF ECCP = 0x6F4F (under DF TELECOM)

FID_EF_CMI

public static final short FID_EF_CMI
File identifier : EF CMI = 0x6F58 (under DF TELECOM)

FID_EF_IMG

public static final short FID_EF_IMG
File identifier : EF IMG = 0x4F20 (under DF Graphics)

FID_EF_LP

public static final short FID_EF_LP
File identifier : EF LP = 0x6F05 (under DF GSM)

FID_EF_IMSI

public static final short FID_EF_IMSI
File identifier : EF IMSI = 0x6F07 (under DF GSM)

FID_EF_KC

public static final short FID_EF_KC
File identifier : EF Kc = 0x6F20 (under DF GSM)

FID_EF_PLMNSEL

public static final short FID_EF_PLMNSEL
File identifier : EF PLMNsel = 0x6F30 (under DF GSM)

FID_EF_HPLMN

public static final short FID_EF_HPLMN
File identifier : EF HPLMN = 0x6F31 (under DF GSM)

FID_EF_ACMMAX

public static final short FID_EF_ACMMAX
File identifier : EF ACMmax = 0x6F37 (under DF GSM)

FID_EF_SST

public static final short FID_EF_SST
File identifier : EF SST = 0x6F38 (under DF GSM)

FID_EF_ACM

public static final short FID_EF_ACM
File identifier : EF ACM = 0x6F39 (under DF GSM)

FID_EF_GID1

public static final short FID_EF_GID1
File identifier : EF GID1 = 0x6F3E (under DF GSM)

FID_EF_GID2

public static final short FID_EF_GID2
File identifier : EF GID2 = 0x6F3F (under DF GSM)

FID_EF_SPN

public static final short FID_EF_SPN
File identifier : EF SPN = 0x6F46 (under DF GSM)

FID_EF_PUCT

public static final short FID_EF_PUCT
File identifier : EF PUCT = 0x6F41 (under DF GSM)

FID_EF_CBMI

public static final short FID_EF_CBMI
File identifier : EF CBMI = 0x6F45 (under DF GSM)

FID_EF_BCCH

public static final short FID_EF_BCCH
File identifier : EF BCCH = 0x6F74 (under DF GSM)

FID_EF_ACC

public static final short FID_EF_ACC
File identifier : EF ACC = 0x6F78 (under DF GSM)

FID_EF_FPLMN

public static final short FID_EF_FPLMN
File identifier : EF FPLMN = 0x6F7B (under DF GSM)

FID_EF_LOCI

public static final short FID_EF_LOCI
File identifier : EF LOCI = 0x6F7E (under DF GSM)

FID_EF_AD

public static final short FID_EF_AD
File identifier : EF AD = 0x6FAD (under DF GSM)

FID_EF_PHASE

public static final short FID_EF_PHASE
File identifier : EF Phase = 0x6FAE (under DF GSM)

FID_EF_VGCS

public static final short FID_EF_VGCS
File identifier : EF VGCS = 0x6FB1 (under DF GSM)

FID_EF_VGCSS

public static final short FID_EF_VGCSS
File identifier : EF VGCSS = 0x6FB2 (under DF GSM)

FID_EF_VBS

public static final short FID_EF_VBS
File identifier : EF VBS = 0x6FB3 (under DF GSM)

FID_EF_VBSS

public static final short FID_EF_VBSS
File identifier : EF VBSS = 0x6FB4 (under DF GSM)

FID_EF_EMLPP

public static final short FID_EF_EMLPP
File identifier : EF eMLPP = 0x6FB5 (under DF GSM)

FID_EF_AAEM

public static final short FID_EF_AAEM
File identifier : EF AAeM = 0x6FB6 (under DF GSM)

FID_EF_CBMID

public static final short FID_EF_CBMID
File identifier : EF CBMID = 0x6F48 (under DF GSM)

FID_EF_ECC

public static final short FID_EF_ECC
File identifier : EF ECC = 0x6FB7 (under DF GSM)

FID_EF_CBMIR

public static final short FID_EF_CBMIR
File identifier : EF CBMIR = 0x6F50 (under DF GSM)

FID_EF_DCK

public static final short FID_EF_DCK
File identifier : EF DCK = 0x6F2C (under DF GSM)

FID_EF_CNL

public static final short FID_EF_CNL
File identifier : EF CNL = 0x6F32 (under DF GSM)

FID_EF_NIA

public static final short FID_EF_NIA
File identifier : EF NIA = 0x6F51 (under DF GSM)

FID_EF_KCGPRS

public static final short FID_EF_KCGPRS
File identifier : EF KcGPRS = 0x6F52 (under DF GSM)

FID_EF_LOCIGPRS

public static final short FID_EF_LOCIGPRS
File identifier : EF LOCIGPRS = 0x6F53 (under DF GSM)

FID_EF_SUME

public static final short FID_EF_SUME
File identifier : EF SUME = 0x6F54 (under DF GSM)

FID_EF_PLMNWACT

public static final short FID_EF_PLMNWACT
File identifier : EF PLMNwAcT= 0x6F60 (under DF GSM)

FID_EF_OPLMNWACT

public static final short FID_EF_OPLMNWACT
File identifier : EF OPLMNwAcT= 0x6F61 (under DF GSM)

FID_EF_HPLMNWACT

public static final short FID_EF_HPLMNWACT
File identifier : EF HPLMNwAcT= 0x6F62 (under DF GSM)

FID_EF_CPBCCH

public static final short FID_EF_CPBCCH
File identifier : EF CPBCCH= 0x6F63(under DF GSM)

FID_EF_INVSCAN

public static final short FID_EF_INVSCAN
File identifier : EF InvScan= 0x6F64(under DF GSM)

FID_EF_SAI

public static final short FID_EF_SAI
File identifier : EF SAI = 0x4F30 (under DF SoLSA)

FID_EF_SLL

public static final short FID_EF_SLL
File identifier : EF SLL = 0x4F31 (under DF SoLSA)

FID_EF_SID

public static final short FID_EF_SID
File identifier : EF SID = 0x4F80 (under DF TIA-EIA-553)

FID_EF_GPI

public static final short FID_EF_GPI
File identifier : EF GPI = 0x4F81 (under DF TIA-EIA-553)

FID_EF_IPC

public static final short FID_EF_IPC
File identifier : EF IPC = 0x4F82 (under DF TIA-EIA-553)

FID_EF_COUNT

public static final short FID_EF_COUNT
File identifier : EF COUNT = 0x4F83 (under DF TIA-EIA-553)

FID_EF_NSID

public static final short FID_EF_NSID
File identifier : EF NSID = 0x4F84 (under DF TIA-EIA-553)

FID_EF_PSID

public static final short FID_EF_PSID
File identifier : EF PSID = 0x4F85 (under DF TIA-EIA-553)

FID_EF_NETSEL

public static final short FID_EF_NETSEL
File identifier : EF NETSEL = 0x4F86 (under DF TIA-EIA-553)

FID_EF_SPL

public static final short FID_EF_SPL
File identifier : EF SPL = 0x4F87 (under DF TIA-EIA-553)

FID_EF_MIN

public static final short FID_EF_MIN
File identifier : EF MIN = 0x4F88 (under DF TIA-EIA-553)

FID_EF_ACCOLC

public static final short FID_EF_ACCOLC
File identifier : EF ACCOLC = 0x4F89 (under DF TIA-EIA-553)

FID_EF_FC1

public static final short FID_EF_FC1
File identifier : EF FC1= 0x4F8A (under DF TIA-EIA-553)

FID_EF_S_ESN

public static final short FID_EF_S_ESN
File identifier : EF S_ESN = 0x4F8B (under DF TIA-EIA-553)

FID_EF_CSID

public static final short FID_EF_CSID
File identifier : EF CSID= 0x4F8C (under DF TIA-EIA-553)

FID_EF_REG_THRESH

public static final short FID_EF_REG_THRESH
File identifier : EF REG_THRESH = 0x4F8D (under DF TIA-EIA-553)

FID_EF_CCCH

public static final short FID_EF_CCCH
File identifier : EF CCCH = 0x4F8E (under DF TIA-EIA-553)

FID_EF_LDCC

public static final short FID_EF_LDCC
File identifier : EF LDCC = 0x4F8F (under DF TIA-EIA-553)

FID_EF_GSM_RECON

public static final short FID_EF_GSM_RECON
File identifier : EF GSM_RECON = 0x4F90 (under DF TIA-EIA-553)

FID_EF_AMPS_2_GSM

public static final short FID_EF_AMPS_2_GSM
File identifier : EF AMPS_2_GSM = 0x4F91 (under DF TIA-EIA-553)

FID_EF_AMPS_UI

public static final short FID_EF_AMPS_UI
File identifier : EF AMPS_UI = 0x4F93 (under DF TIA-EIA-553)

FID_EF_MEXE_ST

public static final short FID_EF_MEXE_ST
File identifier : EF MExE_ST= 0x4F40 (under DF MExE)

FID_EF_ORPK

public static final short FID_EF_ORPK
File identifier : EF ORPK= 0x4F41 (under DF MExE)

FID_EF_ARPK

public static final short FID_EF_ARPK
File identifier : EF ARPK= 0x4F42 (under DF MExE)

FID_EF_TPRPK

public static final short FID_EF_TPRPK
File identifier : EF TPRPK = 0x4F43 (under DF MExE)

REC_ACC_MODE_NEXT

public static final byte REC_ACC_MODE_NEXT
Record access mode : next record = 0x02

REC_ACC_MODE_PREVIOUS

public static final byte REC_ACC_MODE_PREVIOUS
Record access mode : previous record = 0x03

REC_ACC_MODE_ABSOLUTE_CURRENT

public static final byte REC_ACC_MODE_ABSOLUTE_CURRENT
Record access mode : absolute/current record = 0x04

SEEK_FROM_BEGINNING_FORWARD

public static final byte SEEK_FROM_BEGINNING_FORWARD
Seek mode : from the beginning forward = 0x00

SEEK_FROM_END_BACKWARD

public static final byte SEEK_FROM_END_BACKWARD
Seek mode : from the end backward = 0x01

SEEK_FROM_NEXT_FORWARD

public static final byte SEEK_FROM_NEXT_FORWARD
Seek mode : from the next location forward = 0x02

SEEK_FROM_PREVIOUS_BACKWARD

public static final byte SEEK_FROM_PREVIOUS_BACKWARD
Seek mode : from the previous location backward = 0x03
Method Detail

select

public short select(short fid,
                    byte[] fci,
                    short fciOffset,
                    short fciLength)
             throws java.lang.NullPointerException,
                    SIMViewException
SELECT command as defined in GSM 11.11 standard.
By default, the MF is selected at the beginning of each applet activation (current file = MF). This method selects a file of the GSM file system. The file search starts at the current DF of the applet according to the file search method described in GSM 11.11 specification. The current DF or current EF and the current record pointer of the calling applet will be changed after successful execution.
Parameters:
fid - is the File Identifier of the file to be selected.
fci - is the reference to the target byte array for FCI (File Control Information) of current file, coding is according to GSM 11.11. If fci is null the NullPointerException is thrown.
fciOffset - is the offset in the fci buffer for the response data.
fciLength - is the length of the required data in the fci byte array. If the fciLength is greater than the length of the response, the whole response is copied into the fci buffer and the length of the response is returned by the method. If the fcilength is smaller than the length of the response, the first part of the response is copied into the fci buffer and the fciLength is returned by the method.
Returns:
length of the data which have been written in the fci buffer (cannot be greater than fciLength parameter)
Throws:
java.lang.NullPointerException - if fci is null
java.lang.ArrayIndexOutOfBoundsException - if operation would cause access of data outside array bounds.
SIMViewException - in case of error
  • FILE_NOT_FOUND
  • MEMORY_PROBLEM
  • INTERNAL_ERROR

select

public void select(short fid)
            throws SIMViewException
SELECT command as defined in GSM 11.11 standard.
This SELECT method allows to update the current file without handling the Select Response. By default, the MF is selected at the beginning of each applet activation (current file = MF). This method selects a file of the common GSM file system. The file search starts at the current DF of the applet according to the file search method described in GSM 11.11 specification. The current DF or current EF and the current record pointer of the calling applet will be changed after successful execution.
Parameters:
fid - is the File Identifier of the file to be selected.
Throws:
SIMViewException - in case of error
  • FILE_NOT_FOUND
  • MEMORY_PROBLEM
  • INTERNAL_ERROR

status

public short status(byte[] fci,
                    short fciOffset,
                    short fciLength)
             throws java.lang.NullPointerException,
                    SIMViewException
STATUS command as defined in GSM 11.11 standard.
This method returns the FCI (File Control Information) of the current DF (or MF) of the calling applet.
Parameters:
fci - is the reference to the target byte array for FCI (File Control Information) of current DF (or MF), coding is according to GSM 11.11. If fci is null the NullPointerException is thrown.
fciOffset - is the offset in the fci buffer for the response data.
fciLength - is the length of the required data in the fci byte array. If the fciLength is greater than the length of the response, the whole response is copied into the fci buffer and the length of the response is returned by the method. If the fcilength is smaller than the length of the response, the first part of the response is copied into the fci buffer and the fciLength is returned by the method.
Returns:
length of the data which have been written in the fci buffer (cannot be greater than fciLength parameter)
Throws:
java.lang.NullPointerException - if fci is null
java.lang.ArrayIndexOutOfBoundsException - if operation would cause access of data outside array bounds.
SIMViewException - in case of error
  • MEMORY_PROBLEM
  • INTERNAL_ERROR

readBinary

public short readBinary(short fileOffset,
                        byte[] resp,
                        short respOffset,
                        short respLength)
                 throws java.lang.NullPointerException,
                        java.lang.ArrayIndexOutOfBoundsException,
                        SIMViewException
READ BINARY command as defined in GSM 11.11 standard.
This method reads the data bytes of the current transparent EF of the calling applet.
Parameters:
fileOffset - is the offset in the source transparent file.
resp - is the reference to the response byte array for read data. If resp is null the NullPointerException is thrown. If respOffset or respLength or respOffset+respLength is in contradiction with the resp byte array the ArrayIndexOutOfBoundsException is thrown.
respOffset - is the offset in the response byte array.
respLength - is the number of bytes to read.
Returns:
respOffset+respLength
Throws:
java.lang.NullPointerException - if resp is null
java.lang.ArrayIndexOutOfBoundsException - if reading would cause access of data outside array bounds
SIMViewException - in case of error
  • NO_EF_SELECTED
  • FILE_INCONSISTENT
  • AC_NOT_FULFILLED
  • INVALIDATION_STATUS_CONTRADICTION
  • OUT_OF_FILE_BOUNDARIES
  • MEMORY_PROBLEM
  • INTERNAL_ERROR

updateBinary

public void updateBinary(short fileOffset,
                         byte[] data,
                         short dataOffset,
                         short dataLength)
                  throws java.lang.NullPointerException,
                         java.lang.ArrayIndexOutOfBoundsException,
                         SIMViewException
UPDATE BINARY command as defined in GSM 11.11 standard.
This method updates the data bytes of the current transparent EF of the calling applet.
Parameters:
fileOffset - is the offset in the destination transparent file.
data - is the reference to the source byte array for data to update. If data is null the NullPointerException is thrown. If dataOffset or dataLength or dataOffset+dataLength is in contradiction with the data byte array the ArrayIndexOutOfBoundsException is thrown.
dataOffset - is the offset in the source byte array.
dataLength - is the number of bytes to update.
Throws:
java.lang.NullPointerException - if data is null
java.lang.ArrayIndexOutOfBoundsException - if updating would cause access of data outside array bounds
SIMViewException - in case of error
  • NO_EF_SELECTED
  • FILE_INCONSISTENT
  • AC_NOT_FULFILLED
  • INVALIDATION_STATUS_CONTRADICTION
  • OUT_OF_FILE_BOUNDARIES
  • MEMORY_PROBLEM
  • INTERNAL_ERROR

readRecord

public short readRecord(short recNumber,
                        byte mode,
                        short recOffset,
                        byte[] resp,
                        short respOffset,
                        short respLength)
                 throws java.lang.NullPointerException,
                        java.lang.ArrayIndexOutOfBoundsException,
                        SIMViewException
READ RECORD command as defined in GSM 11.11 standard.
This method reads the data bytes of the current linear fixed/cyclic EF of the calling applet. The current record pointer can be changed due to the choosen mode.
Parameters:
recNumber - is the record number.
mode - is the mode for reading record, according to GSM 11.11. If mode is REC_ACC_MODE_NEXT and the record pointer is at the last record the RECORD_NUMBER_NOT_AVAILABLE SIMViewException shall be thrown. If mode is REC_ACC_MODE_PREVIOUS and the record pointer is at the first record, the RECORD_NUMBER_NOT_AVAILABLE SIMViewException shall be thrown.
recOffset - is the offset in the record for the data to read.
resp - is the reference to the response byte array for read data. If resp is null the NullPointerException is thrown. If respOffset or respLength or respOffset+respLength is in contradiction with the resp byte array the ArrayIndexOutOfBoundsException is thrown.
respOffset - is the offset in the response byte array.
respLength - is the number of bytes to read.
Returns:
respOffset+respLength
Throws:
java.lang.NullPointerException - if resp is null
java.lang.ArrayIndexOutOfBoundsException - if reading would cause access of data outside array bounds
SIMViewException - in case of error
  • NO_EF_SELECTED
  • FILE_INCONSISTENT
  • AC_NOT_FULFILLED
  • INVALIDATION_STATUS_CONTRADICTION
  • OUT_OF_RECORD_BOUNDARIES
  • RECORD_NUMBER_NOT_AVAILABLE
  • INVALID_MODE
  • MEMORY_PROBLEM
  • INTERNAL_ERROR

updateRecord

public void updateRecord(short recNumber,
                         byte mode,
                         short recOffset,
                         byte[] data,
                         short dataOffset,
                         short dataLength)
                  throws java.lang.NullPointerException,
                         java.lang.ArrayIndexOutOfBoundsException,
                         SIMViewException
UPDATE RECORD command as defined in GSM 11.11 standard.
This method updates the data bytes of the current linear fixed/cyclic EF of the calling applet. The current record pointer can be changed due to the choosen mode.
Parameters:
recNumber - is the record number.
mode - is the mode for updating record, according to GSM 11.11. If mode is REC_ACC_MODE_NEXT and the record pointer is at the last record the RECORD_NUMBER_NOT_AVAILABLE SIMViewException shall be thrown. If mode is REC_ACC_MODE_PREVIOUS and the record pointer is at the first record, the RECORD_NUMBER_NOT_AVAILABLE SIMViewException shall be thrown.
recOffset - is the offset in the record for the data to update.
data - is the reference to the source byte array for data to update. If data is null the NullPointerException is thrown. If dataOffset or dataLength or dataOffset+dataLength is in contradiction with the data byte array the ArrayIndexOutOfBoundsException is thrown.
dataOffset - is the offset in the source byte array.
dataLength - is the number of bytes to update.
Throws:
java.lang.NullPointerException - if data is null
java.lang.ArrayIndexOutOfBoundsException - if updating would cause access of data outside array bounds
SIMViewException - in case of error
  • NO_EF_SELECTED
  • FILE_INCONSISTENT
  • AC_NOT_FULFILLED
  • INVALIDATION_STATUS_CONTRADICTION
  • OUT_OF_RECORD_BOUNDARIES
  • RECORD_NUMBER_NOT_AVAILABLE
  • INVALID_MODE
  • MEMORY_PROBLEM
  • INTERNAL_ERROR

seek

public short seek(byte mode,
                  byte[] patt,
                  short pattOffset,
                  short pattLength)
           throws java.lang.NullPointerException,
                  java.lang.ArrayIndexOutOfBoundsException,
                  SIMViewException
SEEK command as defined in GSM 11.11 standard.
This method seeks a pattern in the current linear fixed EF of the calling applet.
Parameters:
mode - is the seek mode, according to GSM 11.11 (no type information). If mode is SEEK_FROM_NEXT_FORWARD and the record pointer is at the last record the PATTERN_NOT_FOUND SIMViewException shall be thrown. If mode is SEEK_FROM_PREVIOUS_BACKWARD and the record pointer is at the first record, the PATTERN_NOT_FOUND SIMViewException shall be thrown.
patt - is the reference to the byte array containing the seek pattern. If patt is null the NullPointerException is thrown. If pattOffset or pattLength or pattOffset+pattLength is in contradiction with the patt byte array the ArrayIndexOutOfBoundsException is thrown.
pattOffset - is the offset of the seek pattern in the byte array.
pattLength - is the length of the seek pattern. If pattLength is greater than the current record size than the OUT_OF_RECORD_BOUNDARIES SIMViewException shall be thrown. If pattLength is zero than PATTERN_NOT_FOUND SIMViewException shall be thrown.
Returns:
record number if pattern found
Throws:
java.lang.NullPointerException - if patt is null
java.lang.ArrayIndexOutOfBoundsException - if seeking would cause access of data outside array bounds
SIMViewException - in case of error
  • NO_EF_SELECTED
  • PATTERN_NOT_FOUND
  • FILE_INCONSISTENT
  • AC_NOT_FULFILLED
  • INVALIDATION_STATUS_CONTRADICTION
  • INVALID_MODE
  • OUT_OF_RECORD_BOUNDARIES
  • MEMORY_PROBLEM
  • INTERNAL_ERROR

increase

public short increase(byte[] incr,
                      short incrOffset,
                      byte[] resp,
                      short respOffset)
               throws java.lang.NullPointerException,
                      java.lang.ArrayIndexOutOfBoundsException,
                      SIMViewException
INCREASE command as defined in GSM 11.11 standard.
This method increases the current cyclic EF record of the calling applet. The response buffer will only contain the value of the increased record.
Parameters:
incr - is the reference to the source byte array, containing the value to add, on 3 bytes.
incrOffset - is the offset in the source byte array.
resp - is the reference to the response byte array for new record value. If incr or resp is null the NullPointerException is thrown. If resp buffer is smaller than the record size, the ArrayIndexOutOfBoundsException is thrown. If resp buffer is bigger than the record size, the resp buffer is filled with the record value and left justified
respOffset - is the offset in the response byte array.
Returns:
length of the valid data in the resp buffer (cannot be greater than the record size)
Throws:
java.lang.NullPointerException - if incr or resp is null
java.lang.ArrayIndexOutOfBoundsException - if increasing would cause access of data outside array bounds
SIMViewException - in case of error
  • NO_EF_SELECTED
  • FILE_INCONSISTENT
  • AC_NOT_FULFILLED
  • INVALIDATION_STATUS_CONTRADICTION
  • MAX_VALUE_REACHED
  • MEMORY_PROBLEM
  • INTERNAL_ERROR

invalidate

public void invalidate()
                throws SIMViewException
INVALIDATE command as defined in GSM 11.11 standard.
This method invalidates the currently selected EF of the calling applet.
Throws:
SIMViewException - in case of error
  • NO_EF_SELECTED
  • AC_NOT_FULFILLED
  • INVALIDATION_STATUS_CONTRADICTION
  • MEMORY_PROBLEM
  • INTERNAL_ERROR

rehabilitate

public void rehabilitate()
                  throws SIMViewException
REHABILITATE command as defined in GSM 11.11 standard.
This method rehabilitates the currently selected EF of the calling applet.
Throws:
SIMViewException - in case of error
  • NO_EF_SELECTED
  • AC_NOT_FULFILLED
  • INVALIDATION_STATUS_CONTRADICTION
  • MEMORY_PROBLEM
  • INTERNAL_ERROR