Content for  ETSI TS 102 221   PDF version:  17.1.0

This function returns information concerning the current directory or current application. In addition, according to the application specification, it may be used to indicate to the application in the UICC that its session activation procedure has been successfully executed or that its termination procedure will be executed. Input:

• None.

Output:

• One of the following:
  • FCP of the current directory.
  • The DF name TLV Data Object of the currently selected application.
  • No data returned.

This function reads a string of bytes from the current transparent EF. This function shall only be performed if the READ access condition for this EF is satisfied. Input:

• Relative address and the length of the string.

Output:

• String of bytes.

Response data:

This function updates the current transparent EF with a string of bytes. This function shall only be performed if the UPDATE access condition for this EF is satisfied. An update can be considered as a replacement of the string already present in the EF by the string given in the update command. Input:

• Relative address and the length of the string.
• String of bytes.

Output:

• None.

Coding of parameter P1 and P2 are identical to the coding of P1 and P2 in the READ BINARY command.

This function reads one complete record in the current linear fixed or cyclic EF. The record to be read is described by the modes below. This function shall only be performed if the READ access condition for this EF is satisfied. The record pointer shall not be changed by an unsuccessful READ RECORD function. Four modes are defined: Input:

• Mode, record number (absolute mode only) and the length of the record.

Output:

• The record.

For the modes "next" and "previous" P1 has no significance within the scope of the present document and shall be set to '00' by the terminal. Response data:

This function updates one specific, complete record in the current linear fixed or cyclic EF. This function shall only be performed if the UPDATE access condition for this EF is satisfied. The UPDATE can be considered as a replacement of the relevant record data of the EF by the record data given in the command. The record pointer shall not be changed by an unsuccessful UPDATE RECORD function. The record to be updated is described by the modes below. Four modes are defined of which only PREVIOUS is allowed for cyclic files: Input:

• Mode, record number (absolute mode only) and the length of the record.
• The data used for updating the record.

Output:

• None.

Coding of parameter P2 is identical to the coding of P2 in READ RECORD command. For the modes "next" and "previous" P1 has no significance and shall be set to '00' by the terminal.

This function searches through a linear fixed or cyclic EF to find record(s) containing a specific pattern. This function shall only be performed if the READ access condition for this EF is satisfied. The search starts:

• either at the first byte of the record(s) (simple search); or
• from a given offset in the record(s); or
• from the first occurrence of a given byte in the record(s).

The response is either empty or contains the, up to the Le specified number of, record number(s) of the records that matches the search in the selected EF. If one or more matches are found the record pointer shall be set to the first record where the search pattern was found. Input:

• Search mode (simple/enhanced).
• Offset.
• Pattern.

Output:

• either none, if Le is empty or no matches is found; or
• at most the number of record(s) number(s) defined in Le.

If no match is found, either status word '9000' or the warning status '6282' shall be returned. The terminal might not send a GET RESPONSE command (see clause 7.3.1.1.4) after warning status '6282'.

For the modes "forward search from next record" and "backward search from previous record", P1 has no significance within the scope of the present document and shall be set to '00'. Response data:

This function adds the value given by the terminal to the value of the last increased/updated record of the current cyclic EF, and stores the result into the oldest record. The record pointer is set to this record and this record becomes record number 1. This function can only be used if this EF has an INCREASE access condition assigned and this condition is fulfilled. The INCREASE access condition is indicated in the access rules using AM_DO tag '84'. Tag '84' indicates that the INS code for the INCREASE command is indicated as the value in the TLV object (instruction code '32'). The INCREASE command can only be used on files that refer to an access rule where this INS code is indicated as part of the rule. The function does not perform the increase if the result would exceed the maximum value of the record (represented by all bytes set to 'FF'). Input:

• Value to be added.

Output:

• Value of the increased record.
• Value which has been added.

In this command, Lc is restricted to 0 < Lc < 128 and the maximum record length is limited to 127 bytes. Response data: