Qshell Interpreter (qsh) - FTP Directory Listing - IBM

Chapter 5. Qshell APIs
The following APIs (application program interfaces) are available for Qshell:
v QzshSystem() - Run a QSH Command
v QzshCheckShellCommand() - Find QSH Command
[ Legal | AS/400 Glossary ]
QzshSystem() - Run a QSH Command
Parameters
Authorities
Return Value
Syntax
#include
int QzshSystem( const char *command );
Threadsafe: Yes
The QzshSystem() function runs the specified shell command by spawning a child
process and invoking qsh in the child process. qsh interprets and runs command
and then exits.
The QzshSystem() function returns when the child process has ended. While the
QzshSystem() function is waiting for the child process to end, it ignores the
SIGQUIT and SIGINT signals, and blocks the SIGCHLD signal. The QzshSystem()
function does not affect the status information of any other child processes started
by the calling process.
*command
(Input) Pointer to null-terminated string that contains the shell command to run.
Object Referred To Authority Required errno
Each directory in the path
name preceding the
executable file
*X EACCES
Executable file *X EACCES
If executable file is a shell
script
*RX EACCES
value QzshSystem() was successful. The return value is the status returned from
the waitpid() function. An application can use the macros provided in the
sys/wait.h header file to interpret the status information from the child
process. The return value can be a negative number.
-1 Qp0zSystem() was not successful. The errno value is set to indicate the
error.
© Copyright IBM Corp. 1998, 1999 113