9.2 Command Line Programming
9.2.1 Programming WIBU-Boxes
/PABoxPort
This option sets the port with the specified port value as the selected WIBU-KEY interface for the subsequently used programming or listing commands. The port value must be entered directly behind the option without blank. Whether the specified interface may be used by WIBU-KEY is established as soon as access for programming or listing is required. The selected interface remains valid until another is specified.
WKCRYPT /PA1 WKCRYPT /PAL2 WKCRYPT /PA#2 WKCRYPT /PAC1 WKCRYPT /PA#9
The first three examples address LPT1 to LPT3, the following two address COM1 and COM2. The complete description of the port value specification for the WIBU-KEY interfaces may be found in the appendix B11.
/PC [M][UserCodeNumber]
This option deletes (program clear) all undesired entries in the selected
WIBU-BOXes at the specified port with the specified Firm Code and User Code. Is no User Code specified, all entries with the current Firm Code get
erased. If the option is specified as /PCM, a Master Entry will be cleared.
3
Example: Deleting WIBU-BOX Entries WKCRYPT /F10 /PAL2 /PQ3 /PC13erases all Base Entries 10:13 from the last three WIBU-BOXes at LPT2. WKCRYPT /F10 /PAL2 /PQ3 /PC
erases all entries with Firm Code 10 from the same WIBU-BOXes.
/PE [BoxEntryNumber]
This option specifies a fixed WIBU-BOX entry in the range of 1 to 10 which is used for the next WIBU-BOX programming operations. The specification of a fixed entry permits the storing of an identical Firm Code/User Code entry
several times in one WIBU-BOX. If the /PE option is not specified or without
parameter, the first free entry within a WIBU-BOX is used to program a new entry. For the replacing, extending or modifying of a Base Entry or an Added Entry, the first matching entry is used.
/PN
The /PN option (program new) programs a new entry into the selected WIBU-
BOXes at the selected interface. The Firm Code and User Code must previously be specified by the options /F and /U.
Chapter 9 Programming WIBU-BOX Hardware
3
Example: Programming WIBU-BOX Entries WKCRYPT /F10 /U13 /PNprograms the new entry 10:13 in the last WIBU-BOX at LPT1.
WKCRYPT /F10 /U13++ /PQ3 /PN /U22 /PN
programs the last three WIBU-BOXes at LPT1 with the entries 10:13, 10:14 and 10:15. Each WIBU-BOX is programmed with the entry 10:22.
/PQNumber
This option sets the number (program quantify) of selected WIBU-BOXes
which may be used at the selected interface for programming and listing commands. A number between 1 and 20 is allowed. The default value is 1. Whether the specified number of WIBU-BOXes can be selected, is only established when the WIBU-BOXes are called for programming or listing. In case that a number of WIBU-BOXes is selected, they are counted from the free end of the plugged series. Their listing and programming though begins with the WIBU-BOX nearest to the interface.
3
Example: Listing WIBU-BOX Entries WKCRYPT /PAL2 /PQ5 /Llists the last five WIBU-BOXes at LPT2.
WKCRYPT /F10 /U20++ /PAC1 /PQ3 /L /PN /L
programs new entries with Firm Code and User Code 10:20, 10:21 and 10:22 in the last three WIBU-BOXes at COM1. The contents of the WIBU-BOXes are listed before and after the programming.
/PR [M]UserCodeNumber
This option (program replace) replaces all entries in the selected WIBU-BOXes
at the selected interface with the specified Firm Code/User Code. The current Firm Code/User Code must previously be specified by the options
/F and /U. Should an entry with the current Firm Code and User Code
already exist in one of the WIBU-BOXes, this option will be ignored. This
which means that the old entry won’t be cleared. Should the entry with the
specified User Code not exist, a new entry will be generated.
WKCRYPT /F10 /U13 /PR22
substitutes the entry 10:22 in the last WIBU-BOX at LPT1 by 10:13.
WKCRYPT /F10 /U13 /PAL2 /PQ3 /PR22
concerns the last three WIBU-BOXes at LPT2.
/PS [:NetworkServerName]
This option specifies a WkLAN server that is used for the next programming or list commands. To be able to change the contents of a WIBU-BOX
connected to a server, the right options for WkLAN must be set on the Server page of the WIBU-KEY Control Panel Applet (chapter 11.1.3,
page 255). For the command line option /PS the server name must be
specified directly after the colon. It must be a valid IP address or a station name that is known by a DNS or WINS server. If all required
communication demands are installed, the programming of a WIBU-BOX over the Internet is possible.
The /PS option without argument specifies the use of the local subsystem.
3
Example: Specifying a WkLAN Server WKCRYPT /PS:MyServer /LWKCRYPT /PS:”My Server” /L WKCRYPT /PS:”200.200.200.5” /L WKCRYPT /PS /L
/PXCCountValue
This option adds a Limit Counter to the current selected Base Entry. Such an
entry is selected via the /PE option or via the specified Firm Code/User
Code or Firm Code/ Master Code specification.
3
Example: Limit Counter SettingWKCRYPT /F10 /U13 /PXC1234 WKCRYPT /PE3 /PXC10
Chapter 9 Programming WIBU-BOX Hardware
/PXD[C][S][D] [HighValue-]LowValue
This option bundles an Added Data Entry to the selected Base Entry. Such a
Base Entry is selected via the /PE option or via the specified Firm Code/
User Code or Firm Code/Master Code. If the HighValue is not specified, it is
set to 0.
With the C, S and D sub-options it can optionally be specified on which
options the programming sequence depends:
Q S ( symbol) is specified if the programming sequence depends on the
serial number of the WIBU-BOX. This means that such a programming sequence can change only one specific WIBU-BOX.
Q C ( symbol) is specified if the programming sequence depends on the
programming counter in the WIBU-BOX. This means that the programming can be done only for this counter value. After each programming of the WIBU-BOX the programming counter is increased.
Q D ( symbol) is specified if the programming sequence depends on the
data to be stored. Different data produce different programming sequences. This is an additional security mechanism that prohibits that during the Remote Programming the transfer value can be changed.
Within the /PXD option any combination of these flags can be used. The
suboption D can only be used from WIBU-BOX version 4 on.
3
Example: Added Data Entry Setting WKCRYPT /F10 /U13 /PXD10adds the Added Data Entry 0-10 to the Base Entry 10:13. WKCRYPT /PE3 /PXD4-3
adds the Added Data Entry 4-3 to the third Base Entry. WKCRYPT /F10 /U13 /PXDC10
programming sequence depends on the programming counter. WKCRYPT /PE3 /PXDSCD4-3
This option adds an Expiration Date to the current selected Base Entry. Such
a Base Entry is selected via the /PE option or via the specified Firm
Code/User Code or Firm Code/Master Code. For the date specifications
DayDelta and DateValue see appendix B10.
The C, S and D sub options have the same meaning as described for the
option /PXD. They are used when changing an Expiration Date Entry with
the /PMT option.
/
Note: The suboption D can only be used from WIBU-BOX version 4 on.Using a version 4 or newer WIBU-BOX, it is strongly recommended to use this option for security reasons.
3
Example: Expiration Date Setting WKCRYPT /F10 /U13 /PXT10 programs an Expiration Date to 10 days. WKCRYPT /PE3 /PXTS30programs an Expiration Date to 30 days. This entry can only be changed with a programming sequence depending on the serial number of the WIBU-BOX.
WKCRYPT /F10 /U13 /PXT97Dec31 sets the Expiration Date to the end of 1997. WKCRYPT /PE3 /PXTD99Mar31
uses the end of the first quarter of 1999 as Expiration Date. The programming sequence to change this last entry depends on the value of the new Expiration Date to be programmed.
Chapter 9 Programming WIBU-BOX Hardware