7. checkres

Check the reservation.

7.1 Send

        <mauicomm version="0.5" comm="checkres" ts="[TIMESTAMP]">
        <checkres user="[USER]" resid="[RESID]"/>
        </mauicomm>

• The TIMESTAMP is the UNIX epoch time in seconds.
• The USER is the user executing the command.
• The RESID is the reservation in question.

7.2 Receive

You will receive something similar to the following XML document:

        <mauiupdate version="0.5" update="resupdate" ts="1012853878">
        <resupdate>

        <resid id="group:systems:1013725454:2"/>
        <resstart val="1013680800"/>
        <resduration val="86400"/>
        <resstate val="Active"/>
        <restype val="Hard"/>
        <authtype val="group"/>
        <auth val="systems"/>

        <reslimits>
        <reslimit key="SlotLimit" val="16"/>
        <reslimit key="UserLimit" val="2"/>
        <reslimit key="NodeLimit" val="8"/>
        </reslimits>

        <nodes nodescount='16' slotscount='32'>
        <node id='Node:hn008'>
                <slot id='Node:hn008:s0'/> <slot id='Node:hn008:s1'/> </node>
        <node id='Node:hn009'>
                <slot id='Node:hn009:s0'/> <slot id='Node:hn009:s1'/> </node>
        <node id='Node:hn010'>
                <slot id='Node:hn010:s0'/> <slot id='Node:hn010:s1'/> </node>
        <node id='Node:hn011'>
                <slot id='Node:hn011:s0'/> <slot id='Node:hn011:s1'/> </node>
        <node id='Node:hn012'>
                <slot id='Node:hn012:s0'/> <slot id='Node:hn012:s1'/> </node>
        <node id='Node:hn013'>
                <slot id='Node:hn013:s0'/> <slot id='Node:hn013:s1'/> </node>
        <node id='Node:hn014'>
                <slot id='Node:hn014:s0'/> <slot id='Node:hn014:s1'/> </node>
        <node id='Node:hn015'>
                <slot id='Node:hn015:s0'/> <slot id='Node:hn015:s1'/> </node>
        <node id='Node:hn016'>
                <slot id='Node:hn016:s0'/> <slot id='Node:hn016:s1'/> </node>
        <node id='Node:hn017'>
                <slot id='Node:hn017:s0'/> <slot id='Node:hn017:s1'/> </node>
        <node id='Node:hn018'>
                <slot id='Node:hn018:s0'/> <slot id='Node:hn018:s1'/> </node>
        <node id='Node:hn025'>
                <slot id='Node:hn025:s0'/> <slot id='Node:hn025:s1'/> </node>
        <node id='Node:hn030'>
                <slot id='Node:hn030:s0'/> <slot id='Node:hn030:s1'/> </node>
        <node id='Node:hn031'>
                <slot id='Node:hn031:s0'/> <slot id='Node:hn031:s1'/> </node>
        <node id='Node:hn032'>
                <slot id='Node:hn032:s0'/> <slot id='Node:hn032:s1'/> </node>
        <node id='Node:hn033'>
                <slot id='Node:hn033:s0'/> <slot id='Node:hn033:s1'/> </node>
        </nodes>

        </resupdate>
        </mauiupdate>

NOTES:

• resstate is one of the strings ("Active", "Inactive").
• restype is one of the strings ("Hard", "Soft", "Solid"). A hard reservation is one created by the administrator through the setres command. A soft reservation is one made by the scheduler for a job (it can be changed by the system). A solid reservation is merely an active soft reservation.
• The authtype is one of the strings ("user", "group", "acct") and specifies what type of authorization is used to determine who can run jobs in the reservation.
• The auth is the appropriate user, or group, or account string.
• The nodes/slots section is a listing of slotIDs in the reservation at one-node-per-line (potentially multiple slotIDs per line).