.. _assignmid:

=================
Assign Resources
=================

    1. SDP Leaf Node provides API for **Assign Resources** workflow.
    2. The SDP Leaf Node **accepts the command** if :-

        A. Operational **state** of the SDP Leaf node is **ON/OFF/INIT/STANDBY/ALARM**

    3. The SDP Leaf Node **rejects the command** if :-

        A. Operational **state** of SDP Leaf node is **FAULT/UNKNOWN** .

    4. The following **state requirements** are applied for the **command execution** :-

        A. SDP Subarray is in 'observation state' **EMPTY** or **IDLE** .
        B. SDP Subarray node is :term:`available` .

    5. The **command execution** involves below **key operations** :-

        A. The Input JSON is **validated** and if **malformed** , and Command is **'Failed'** with exception message
        B. Interface schema version if missing from the input JSON is added
        C. The command is then invoked on the SDP Subarray.

            - If SDP Subarray **raises exception** , command failure is reported as **'RESULT_CODE - FAILED'** on Long Running Command Result attribute of the SDP leaf node.
            - If SDP Subarray **accept command** , the TMC SDP leaf node will wait for command completion.

    6. The SDP leaf node **monitors the progress** of command via the SDP sub-array node **ObsState transitions** and the **long running command results**.

        A. Command is **successful** when the SDP Subarray Node transitions to **IDLE** ObsState. This is reported as **'RESULT_CODE - OK'** on Long Running Command Result attribute of the Subarray node.
        B. Command **failure** is reported in any of the below cases as **'RESULT_CODE - FAILED'** on Long Running Command Result attribute of the TMC SDP Subarray leaf node.

            - The SDP Subarray reports **error event** when command is invoked .
            - The command **times out** if SDP SubarrayNode **does not transition** to **IDLE** within the **timeout period** specified by `CommandTimeOutDefault` property specified in helm chart of the SDP Leaf Node .

    7. Input JSON to SDP Subarray is as per schema detailed at -  https://developer.skao.int/projects/ska-telmodel/en/latest/schemas/sdp/ska-sdp-assignres.html