service methods: improve diagnostic error messages, fixes #21