Download Blue Gene/L: Application Development

򐂰 status_t jm_signal_job(db_job_id_t jid, rm_signal_t signal);
This function signals a job.
The return codes are:
–
–
–
–
STATUS_OK
CONNECTION_ERROR
JOB_NOT_FOUND
INCOMPATIBLE_STATE
The job’s state prevents it from being signaled.
– INTERNAL_ERROR
򐂰 status_t rm_get_nodecards(rm_bp_id_t bpid,rm_nodecard_list_t **nc_list);
This function returns a list of all the node cards in the specified Base Partition.
The return codes are:
– STATUS_OK
– CONNECTION_ERROR
– INCONSISTENT_DATA
The Base Partition was not found.
– INTERNAL_ERROR
򐂰 status_t rm_get_data(rm_element_t *rme, enum RMSpecification spec, void *
result);
status_t rm_set_data(rm_element_t *rme, enum RMSpecification spec, void * result);
These two auxiliary functions access the requested field in an rm_element_t structure
(BGL, base partition, wire, switch, connections, port, node card).
The return codes are:
– STATUS_OK
– INVALID_INPUT
•
•
The specification “spec” is unknown.
The specification “spec” is illegal (per the “rme” element).
– INTERNAL_ERROR
򐂰 status_t rm_set_serial(rm_serial_t serial);
This function sets the machine serial number to be used in the following API calls.
The return codes are:
– STATUS_OK
– INVALID_INPUT
•
•
The machine serial number “serial” is null.
The machine serial number is too long.
򐂰 status_t rm_set_serial(rm_serial_t *serial);
This function retrieves the machine serial used with the APIs.
The return codes are:
– STATUS_OK
– INTERNAL_ERROR
118
IBM System Blue Gene Solution: Application Development