gpib_ppreq(3)                       CLIX                       gpib_ppreq(3)



  NAME

    gpib_ppreq - Performs a parallel poll of a General Purpose Interface Bus
    (GPIB) channel

  LIBRARY

    Intergraph XIO Library (libix.a)

  SYNOPSIS

    #include <sys/xio/xerr.h>

    int gpib_ppreq(
      int channel ,
      int timeout ,
      char *poll );

  PARAMETERS

    channel   Represents a GPIB channel.

    timeout   Specifies the number of 1/60 second intervals to wait before
              aborting the request.

    poll      Points to the parallel poll response.

  DESCRIPTION

    The gpib_ppreq() function conducts a parallel poll of the General Purpose
    Interface Bus (GPIB) channel.  The address pointed to by poll contains the
    parallel poll response upon completion.

    If an abort timeout is desired, timeout contains the number of 1/60 second
    intervals that the driver waits before aborting the request.  A value of 0
    disables the timeout mechanism.

  EXAMPLES

    To conduct a parallel poll of GPIB devices on a channel:

    timeout = 0;
    if (status = gpib_ppreq(channel, timeout, &poll)) {
         fprintf(stderr, "gpib_ppreq: failed, %d\n", status);
         return(-1);
    }
    fprintf(stdout, "gpib_ppreq: succeeded\n");


  RETURN VALUES




  2/94 - Intergraph Corporation                                              1

  gpib_ppreq(3)                       CLIX                       gpib_ppreq(3)



    Upon successful completion, a value of 0 is returned.  Otherwise, one of
    the failure codes listed in the ERRORS section is returned.

  ERRORS

    The gpib_ppreq() function fails if one of the following is true:

    [XIO_FAILURE]
           The system does not contain the driver needed to support this
           request.

    [GPIB_OUT_OF_RANGE]
           The specified channel is beyond the maximum allowed.

    [GPIB_NOT_OPEN]
           The specified channel is not open.

    [GPIB_NOT_OWNER]
           The specified channel is currently open by another process.

    [GPIB_TIMEOUT]
           The current request aborted before the parallel poll response was
           received from the GPIB channel.

    [BAD_DATA_BUFFER_ADDRESS]
           The poll parameter points to an invalid memory address.

    [GPIB_HARDWARE_CHECK]
           A hardware error was detected during the parallel poll of the
           specified GPIB channel.  For example, none of the devices had been
           previously configured for parallel polling.

  RELATED INFORMATION

    Functions:  gpib_open(3), gpib_ppconf(3), gpib_ppuconf(3),
    gpib_service(3), gpib_spreq(3), gpib_cmd(3)

    Files:  xgpib(7)
















  2                                              Intergraph Corporation - 2/94