ISHELL(3F) Last changed: 1-6-98
NAME
ISHELL - Executes a UNICOS shell command
SYNOPSIS
ISTAT = ISHELL(command)IMPLEMENTATION
UNICOS, UNICOS/mk, and IRIX systems
DESCRIPTION
On IRIX systems, this routine is in libffio.so which is linked by
default when compiling programs with the MIPSpro 7 Fortran 90 compiler
or when compiling programs with the -craylibs option to the MIPSpro
7.2 F77 compiler.
ISHELL executes a UNICOS shell command. ISHELL has the following
argument:
command Command to be given to the shell; can be of type character
or some numeric type. If it is a noncharacter type, the
command should consist of packed characters terminated by a
null byte.
On IRIX systems, this argument must be of type character.
ISHELL passes command to the shell sh(1) as input, as if command were
entered at a terminal.
RETURN VALUES
ISHELL returns the termination status filled in by the waitpid(2)
system call, which is used to wait for the child shell process.
Unless the command was interrupted by a signal, its exit status is
contained in bits 8 through 15 (bit 0 being the least significant bit)
of the value returned by ISHELL (see the waitpid(2) man page for more
information). However, if any errors occur in running the shell or
collecting its exit status, ISHELL returns a negative number; this
number is the negative value of errno corresponding to the error.
EXAMPLES
WRITE(TPMNT,500) DTV, XDT, VOL, XVOL, DSN, PDN, MBSV
CALL ISHELL(TPMNT)
500 FORMAT('tpmnt -l sl -F U -T -g ',a6,' -x ',a6,
+ '-v ',a6,'=',a6,' -P ',a8,' -f ',a, ' -b ',a)
SEE ALSOpshell(1) in the UNICOS User Commands Reference Manual, publication SR
-2011
system(3C) in the UNICOS System Libraries Reference Manual,
publication SR-2080
Application Programmer's Library Reference Manual, publication SR-
2165, for the printed version of this man page.
