The psh BASIC program executes a UNIX command and captures the results in a D3 item. This command is an alternative to the ! command, which allows capturing the result of the UNIX command into a D3 item.
For Windows: Not Supported
psh unix.command{~}>{>} {file} item{(t}
| unix.command | Any UNIX command. If it contains the > character, it is passed down to sh with its conventional usage. In this case, the > before the D3 item specification must be escaped by a ~ character. Only stdout is captured. To capture stderr, redirect it to stdout. |
| file | Optional D3 file name where the item is stored. If not specified, lst is used as a default. |
| item | Item name where the result is stored. If >> are used, with no space in between, the result of the UNIX command is appended to the end of the item, if it already exists. |
| t | Displays the result on screen, as well as storing it in the specified item. |
Prints a calendar for the year 2003 and stores it in the item 2003 in the file tmp.
psh cal 2003 > tmp 2003
Transfers the file /usr/D3/myfile into the D3 item myfile in the file lst (default). If the file does not exist on UNIX, the error message displays on the terminal.
psh cat /usr/D3/myfile > myfile
Transfers the file /usr/D3/myfile into the D3 item myfile in the file lst (default). stderr is redirected to stdout ('2>&1'). Therefore, if the file does not exist, the error message is in the D3 item.
psh cat /usr/D3/myfile 2>&1 ~> myfile
Stores the error messages produced by the two compilations of myprog1.c and myprog2.c in the item myerrs. The second error messages are appended to the end of the first.
psh cc myprog1.c 2>&1 ~> myerrs psh cc myprog2.c 2>&1 ~>> myerrs
Changes the directory, lists it, and stores the result in the item mylist.
psh cd /tmp; exec ls -l > mylist
Use exec to avoid creating an intermediate shell.
cd is not a UNIX command, but a sh keyword, and thus cannot use the exec command.