ishell(3F)

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
     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 ALSO
     pshell(1) in the UNICOS User Commands Reference Manual

     system(3C) in the UNICOS System Libraries Reference Manual

     Application Programmer's Library Reference Manual for the printed
     version of this man page.