gpib_ppuconf(3)                     CLIX                     gpib_ppuconf(3)



  NAME

    gpib_ppuconf - Unconfigures a General Purpose Interface Bus (GPIB)
    device's parallel poll response

  LIBRARY

    Intergraph XIO Library (libix.a)

  SYNOPSIS

    #include <sys/xio/xerr.h>

    int gpib_ppuconf(
      int channel ,
      char *ldev ,
      int lcnt );

  PARAMETERS

    channel   Represents a channel.

    ldev      Points to an array of devices.

    lcnt      Specifies the number of devices.

  DESCRIPTION

    The gpib_ppuconf() function disables a General Purpose Interfaces Bus
    (GPIB) device's ability to respond to a parallel poll request on channel.
    The ldev parameter points to an array of primary addresses of the GPIB
    devices to be unconfigured.  The lcnt parameter is the number of devices.
    If all devices on a GPIB channel are to be unconfigured, lcnt is 0.

    After putting the system controller in its active state, gpib_ppuconf()
    unconfigures specific GPIB devices with the following messages.

    UNL   Unlisten

    LAG   Listen Address Group

    PPC   Parallel Poll Configure

    PPD   Parallel Poll Disable

    UNL   Unlisten

    If a global Parallel Poll Unconfigure (PPU) is indicated, the system
    controller is switched to an active state, and the PPU message is issued
    on the GPIB channel.




  2/94 - Intergraph Corporation                                              1

  gpib_ppuconf(3)                     CLIX                     gpib_ppuconf(3)



  EXAMPLES

    To disable parallel polling for GPIB devices 1 and 28:

    lcnt = 2;
    ldev[0] = 1;
    ldev[1] = 28;
    if (status = gpib_ppuconf(channel, ldev, lcnt)) {
         fprintf(stderr, "gpib_ppuconf: failed, %d\n", status);
         return(-1);
    }
    fprintf(stdout, "gpib_ppuconf: succeeded\n");


  RETURN VALUES

    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_ppuconf() 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_DEVICE_INVALID]
           One or more of the specified primary addresses are incorrect.

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

    [BAD_DATA_BUFFER_SIZE]
           The number of devices specified with lcnt is incorrect.

  RELATED INFORMATION

    Functions:  gpib_open(3), gpib_ppconf(3), gpib_ppreq(3), gpib_cmd(3)

    Files:  xgpib(7)




  2                                              Intergraph Corporation - 2/94