As a hook writer, I need to be able to efficiently query the server object to get information on jobs which match a specific given characteristic (i.e. state, user, attribute, queue, reservation, etc.)
Looping through ALL jobs in the complex in the python script is prohibitively slow.
be able to request only a set of jobs to iterate on based on a filter (i.e. state, user, attribute, queue, reservation, etc.)