Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • pbs.event().management - A pbs.management object representing the PBS server management operation that was executed. The management object and thus operation cannot be modified with this hook event.


  • pbs.event().management.rq_attrs attribs - A list of pbs.server_attribute objects representing the attributes associated with server management operation. The server attributes attribute objects are read-only.

Event Classes:

  • pbs.event().management: _management
    • cmd: integer value of the server management operation, constants defined in pbs.MGR_CMD_*, translation to text is found in pbs.REVERSE_MGR_CMDS
    • objname: name of the object, such as the hook name.
    • objtype: integer value of the server management operation type, constants defined in pbs.MGR_OBJ_*, translation to text is found in pbs.REVERSE_MGR_OBJS
    • rqrequest_time: time of the request in seconds since epoch
    • rq_reply__brp_txttext: text returned to the user via the server management operationrq
    • _reply__brp_code: code returned to the user via the server management operation
    • rq_reply__brp_choice: request choice, constants defined in pbs.BRP_CHOICE_*, translation to text is found in pbs.REVERSE_BRP_CHOICES
    • rq_reply__brp_auxcode: Auxiliary error code
    • rq_attrsattribs: List of server_attribute class objects
  • pbs.event().management.rq_attrs: List[_server_attribute]
    • al_name: name of the attributeal
    • _rescresource: resource of the attribute
    • al_value: value of the attribute
    • al_op: integer value of the attribute operation, constants defined in pbs.BATCH_OP_*, translation to text is found in pbs.REVERSE_BATCH_OPS
    • al_flags: integer value of the attribute flags, constants defined in pbs.ATR_VFLAG_*, translation to text is found in pbs.REVERSE_ATR_VFLAGS
    • al_sisters: list of co-resources for the attribute

...

  • A management hook script is executed by the server after a server management operation is completed.

  • The event will contain data if the server management operation succeeded or failed.

  • TODO/FIXME: Keeping with the hook design, if one management hook is rejected, the other management hooks with a higher order value will not run???.
  • If the management hook script encounters an unexpected error causing an unhandled exception, or times out due to the hook's alarm setting, the hook will act similar to a pbs.event().reject().

...