[Artwork] / [QisMLib] / [Programmer's Corner]

QisMScript console application

A console program to execute various commands supported by the scripting sub-system of QisMLib called QisMScript. This provides an alternate way of exploring and executing the various functions provided by QisMLib and it's extensions

Command line reference

qismscript64
  +script:"USER" | {script_file_path}
  [-help:commands]
  [-set:{key_name}={value}]*
  [-log:{log_file_path}] | [-log+:{existing_log_path}]
  [-silent]

• Uses the QisMScript API of QisMLib to execute available commands
• Uses qismscript.cfg as the configuration file for QisMLib. All necessary extensions must be listed in this file
• Refer to qismscript_commands for a listing of all available commands

Required

+script:USER

• Run qismscript console in interactive mode

• The user will be prompted to enter a command which will be then executed. The interactive session will continue until either:

  • The user enters the command exit
  • The specified command results in a fatal error

+script:{script_file_path}

• Execute commands specified in a text file, one line per command

• Lines starting with a # are treated as comments and ignored

• The execution continued until either:

  • The exit command is encountered
  • A fatal error occurs
  • There are no more commands to execute in the script

Optional

[-help:commands]

• Print a list of available commands and exit

[-set:{key_name}={value}]*

• Pass one or more variables to the script at the command line

• These variables can be referenced in the script as ((key_name))

  • e.g. -set:INPUT=C:\tmp\test.gds will cause all occurrences of ((INPUT)) to be replaced by C:\tmp\test.gds

• This works even in interactive mode

• References to variables that have not been set at command-line or within a preceding command will be passed as-is without substitution

[-log:{log_path}] | [-log+:{log_path}]

• Enable creation of a log file at the specified path
• For -log+ the file if it exists, will be opened in append mode. Otherwise, a new log file will be created at the specified path

[-silent]

• Run the application without printing to stdout/stderr
• NOT to be use in interactive mode