ucpinq(2)                           CLIX                           ucpinq(2)



  NAME

    ucpinq - Returns the User Controlled Priority (UCP)

  LIBRARY

    Intergraph XIO Library (libix.a)

  SYNOPSIS

    int ucpinq(
      int pid );

  PARAMETERS

    pid   Represents a process identifier.

  DESCRIPTION

    The ucpinq() function returns the User Controlled Priority (UCP) of the
    process with process identifier pid.  If pid is 0, the priority of the
    calling process is returned.  If the process is not running at a UCP
    priority, 128 is returned.

  RETURN VALUES

    If the process exists and is a UCP process, the UCP priority of the
    process is returned.  If the process exists but is not a UCP process, 128
    is returned.  Otherwise, a value of -1 is returned and errno is set to
    indicate the error.

  ERRORS

    The ucpinq() function fails if the following is true:

    [ESRCH]   No process exists with process ID pid.

  RELATED INFORMATION

    Functions: ucpsig(2), ucprelse(2), ucppri(2), ucpclr(2), ucpset(2)














  2/94 - Intergraph Corporation                                              1