Cooperativas, asociaciones y comisiones

This section describes administrative WIB commands. All administrative WIB commands require access control by restriction to their usage only on an administrative TAR type.

The priority of the administrative TAR type is the same as for the operational TAR types. Thus, if a client-bound message is received on an administrative TAR type when WIB is in executing mode, the behavior is as defined in section 7.2. The administrative WIB commands Install Plug-In, Remove Plug-In and Set Script Trigger Mode shall use the Output variable for returning information on the outcome of the command rather than generating an error. The intention is to enable an administrative application to diagnose the outcome. 5.2.1 Install Plug-In

- Im ple m en tation Sp ecification e nt nu mber: M P M0 2:0 111 R e vision :P A 29

This WIB command is used to activate and possibly also download a new plug-in to the SIM card after the card has been issued. The installed plug-in may be subsequently accessed by WIB using the Plug-in WIB command, under the name indicated by Plug-in name.

The implementation of the Install Plug-In WIB command is mandatory. However, the functionality of downloadable plug-ins is optional.

This specification does not mandate anything about the nature of the plug-in installation procedure except for the following:

1. The installed plug-in shall not be accessible to WIB before the execution of this WIB command, even if the command is not used for the actual download of plug-in installation data.

2. Successful execution of the Install Plug-In WIB command shall cause the output of any subsequent call to Assign Version

Information to Variable WIB command to contain the information of the installed plug-in.

Note that Plug-ins may be accessible to WIB when issuing the card.

In case the plug-in installation is intended as an upgrade of an already existing plug-in, the plug-in must first be removed using the Remove Plug-in WIB command, before it is (re) installed.

If the operation is successful, WIB shall assign '00'h to the Output variable. If the operation fails, WIB shall assign the value '02'h to the Output variable if the plug- in name does not exist and '03'h if the Manufacturer Specific Plug-in Version does not match any available plug-in. For any other failure, WIB shall assign '01'h to the output variable.

An attempt to install an already existing plug-in is not an error and shall be regarded as a successful operation.

5.2.2 Remove Plug-In The WIB command tag is '7D'h.

This WIB command is used to de-activate an existing plug-in so that it is rendered inaccessible to the WIB. The plug-in to be de-activated is indicated by Plug-in name.

If the indicated plug-in is unknown to the WIB, nothing shall be performed by this WIB command, and script execution shall carry on as normal.

1.3 - Im ple m en tation Sp ecification e nt nu mber: M P M0 2:0 111 R e vision :P A 29

In case a plug-in is successfully de-activated using the WIB command, the name of the de-activated plug-in shall no longer be contained in the output of any

subsequent call to Assign Version Information to Variable WIB. Depending on the implementation, this command may cause WIB to free the space occupied by the plug-in. Physical removal may also depend on some other mechanism.

If the operation is successful, WIB shall assign '00'h to the Output variable. If the operation fails, WIB shall assign the value '01'h to the Output variable.

An attempt to remove a non-existent plug-in is not an error and shall be regarded as a successful operation.

5.2.3 Set Script Trigger Mode The WIB command tag is '7B'h/'FB'h

The WIB command shall update the WIB menu and event configuration. If the WIB command indicates that the configuration update shall be persistent, the configuration files EFMenu and EFEventConfig shall be updated.

Event handling is persistently disabled by setting the Event type field of the first entry in EFEventConfig to 'FF'h. When the event handling is persistently enabled, the

Event type of the first entry in EFEventConfig shall be set to 'FE'h. This means that

enabling and disabling of event handling through this command relies on using the first event as a flag event.

Enabling of menu triggering or event triggering when already enabled, shall result in a new menu or event subscription being set up according to the respective configuration file.

WIB shall interact with any other configured information on the card to build a SET-UP MENU proactive SIM command. If disabling the menu, the SET-UP MENU proactive SIM command shall exclude all information from the WIB menu configuration file.

If the WIB command includes a Menu Text to Display, this text shall be used as a single menu entry instead of any configured WIB menu entries for the menu in the ME. No entry in the menu itself shall be linked to the WIB. This text is only valid until the SIM is reset and WIB does thus not need to store it.

The execution of this WIB command shall take the same menu and event handling issues into consideration as described in section 7.1 and 7.10.

- Im ple m en tation Sp ecification e nt nu mber: M P M0 2:0 111 R e vision :P A 29

If the operation is successful, WIB shall assign '00'h to the Output variable. If the operation fails, WIB shall assign the value '01'h to the Output variable.

5.2.4 Get Script Trigger Mode The WIB command tag is '7A'h.

This WIB command shall always return the current persistently configured script trigger mode. This means that it shall not consider temporary configuration resulting from a previous Set Script Trigger Mode WIB command. 5.2.5 Get Menu

The WIB command tag is '79'h.

This WIB command shall read the contents of the EFMenu and EFMenuTitle setup

files and prepare output according to [CSP].

The content and ordering of the list of menu items in the output shall reflect the item status and menu ordinal as defined in EFMenu.

The output shall be prepared even if the menu is disabled. 5.2.6 Get Script Info

The WIB command tag is '78'h.

This WIB command shall read the contents of the EFScriptAddress and EFEventConfig

1.3 - Im ple m en tation Sp ecification e nt nu mber: M P M0 2:0 111 R e vision :P A 29

6 Proactive SIM Command Parameters

When generating proactive SIM commands as a result of a WIB command execution, there may be parameters that have to be set for the proactive SIM