Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info
titleAvailability

This routine is available since starting with katl-commons 1.0.

Syntax

...

system(command)

Description

...

Excerpt

Executes the command command of the operating system. Returns the exit code of the program and the output and error streams as strings. Through this you may integrate outside scripts (sh, ksh, perl, ...) with JIRAJira. Streams are limited to 4Kb (only the first 4Kb are taken into account).

Parameters

...

Parameter name

Type

Required

Description

command

string

yes

Valid Operating System command

Returns

...

string []

The routine returns an array with 3 elements

  1. The operating system exit code of the process being spawned (as string)
  2. The output stream (limited to 4Kb) as a string
  3. The error stream (limited to 4Kb) as a string

in this order.

Example

...

Let's create a file using system routine and windows command prompt:

...

Code Block
titleInvoking a windows .bat file
string testfolder="c:/tests/"; //assuming this path exists. 
//we assume in this path a file called `myexec.bat` has been previously created and contains one line `echo Hello;`

//now the following call will return `0.0|[THE_PATH_OF_EXECUTION]>echo Hello; Hello;|`
return system("C:/WINDOWS/system32/cmd.exe /c " + testfolder + "myexec.bat");

...


Note

For windows operating system, you should put the full (absolute) path of the command.

See

...

also

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
cqllabel = "system_routines"
labelssystem_routines