Listing 7 set_num_resources()

{
    # Sets the number of resources for the semaphore. Returns 0 if the
    # number of resources was set; otherwise, returns non-zero.

    local FUNC_NAME=set_num_resources
    ${TRACE:-trace $FUNC_NAME $@}

    local semaphore=$1
    integer num_resources=$2
    local resources_file=$HOME_DIR/$semaphore/$RESOURCES_FILENAME

    if is_non_negative_integer $num_resources
    then
        echo $num_resources > $resources_file
        return $?
    else
        return 1
    fi
}