13.04.2013 Views

Digipass Plug-In for SBR Administrator Reference - Vasco

Digipass Plug-In for SBR Administrator Reference - Vasco

Digipass Plug-In for SBR Administrator Reference - Vasco

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

<strong>Digipass</strong> <strong>Plug</strong>-<strong>In</strong> <strong>for</strong> <strong>SBR</strong> <strong>Administrator</strong> <strong>Reference</strong> <strong>Digipass</strong> TCL Command-Line Administration<br />

14.2.3 Help<br />

To access help from the command prompt, use these commands:<br />

Table 64: DPADMINCMD Help Commands<br />

Command Notes<br />

help Provides basic in<strong>for</strong>mation about DPADMINCMD, including a list of all<br />

commands available.<br />

help Provides in<strong>for</strong>mation about the specific command, including required<br />

parameters, optional parameters and available subcommands.<br />

help Provides in<strong>for</strong>mation about the specific subcommand, including required and<br />

optional parameters.<br />

14.2.4 Command Parameters<br />

Some notes on command parameters in TCL:<br />

Parameters are given in list <strong>for</strong>m: {field1 value1 field2 value2 ...}<br />

Parameter values that include whitespace require double quotes or { }, <strong>for</strong> example<br />

{field1 “value 1” field2 {value 2} ...}<br />

Commands may be substituted <strong>for</strong> parameters using square brackets, where the<br />

command will return the type of parameter(s) required. eg.<br />

<strong>for</strong>each i [user query {domain master} {domain userid has_dp}] { puts<br />

$i }<br />

<strong>In</strong> this example, a query returns a list of Users with <strong>Digipass</strong> assigned, which is used in<br />

the <strong>for</strong>each command.<br />

14.2.5 Result Output<br />

Results are typically returned in list <strong>for</strong>m, with pairs of field names and values, eg:<br />

{domain master userid user0001 has_dp Assigned}<br />

Some commands do not return field in<strong>for</strong>mation, only a simple message, eg:<br />

Created Component.<br />

Queries return a list of list results, with only the requested fields displayed. These may be<br />

<strong>for</strong>matted <strong>for</strong> better readability by wrapping the query in another command, eg:<br />

<strong>for</strong>each i [user query {domain master} {domain userid has_dp}] { puts $i }<br />

The result from the example above will display each user record in the master domain on a<br />

separate line, and only display the requested fields (domain, userid and has_dp), eg:<br />

domain master userid admin has_dp Assigned<br />

domain master userid user0001 has_dp Unassigned<br />

© 2006 VASCO Data Security <strong>In</strong>c. 153

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!