<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 08:00:18 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>MongoDB Jira</title>
    <link>https://jira.mongodb.org</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>9.7.1</version>
        <build-number>970001</build-number>
        <build-date>13-04-2023</build-date>
    </build-info>


<item>
            <title>[DOCS-10329] Inaccurate documentation for getMore maxTimeMS option</title>
                <link>https://jira.mongodb.org/browse/DOCS-10329</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;p&gt;Documentation for the &lt;a href=&quot;https://docs.mongodb.com/manual/reference/command/getMore/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;getMore&lt;/a&gt; command&apos;s &lt;tt&gt;maxTimeMS&lt;/tt&gt; option states:&lt;/p&gt;

&lt;blockquote&gt;&lt;p&gt;Optional. Specifies a time limit in milliseconds for processing operations on a cursor. If you do not specify a value for maxTimeMS, operations will not time out. A value of 0 explicitly specifies the default unbounded behavior.&lt;/p&gt;&lt;/blockquote&gt;

&lt;p&gt;This option corresponds to the &lt;tt&gt;maxAwaitTimeMS&lt;/tt&gt; option in drivers (see: &lt;a href=&quot;https://jira.mongodb.org/browse/DRIVERS-272&quot; title=&quot;Add option maxAwaitTimeMS on getMore commands&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DRIVERS-272&quot;&gt;&lt;del&gt;DRIVERS-272&lt;/del&gt;&lt;/a&gt; and &lt;a href=&quot;https://jira.mongodb.org/browse/SERVER-15815?focusedCommentId=1161264&amp;amp;page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-1161264&quot; class=&quot;external-link&quot; rel=&quot;nofollow&quot;&gt;this comment&lt;/a&gt; from &lt;a href=&quot;https://jira.mongodb.org/browse/SERVER-15815&quot; title=&quot;maxTimeMS on initial tailable cursor query and getMore.&quot; class=&quot;issue-link&quot; data-issue-key=&quot;SERVER-15815&quot;&gt;&lt;del&gt;SERVER-15815&lt;/del&gt;&lt;/a&gt;).&lt;/p&gt;

&lt;p&gt;I believe the second sentence is incorrect. If the driver has not specified the &lt;tt&gt;awaitData&lt;/tt&gt; option for a &lt;tt&gt;tailable&lt;/tt&gt; cursor, then a getMore should return immediately. If &lt;tt&gt;awaitData&lt;/tt&gt; has been specified, then the server waits for a predefined amount (3.4 waits for one second according to my testing). Saying &quot;operations will not time out&quot; implies that the getMore may not return at all until there is new data to return, as does &quot;default unbounded behavior&quot; in the last sentence.&lt;/p&gt;

&lt;p&gt;AFAIK, specifying zero for &lt;tt&gt;maxTimeMS&lt;/tt&gt; is equivalent to not providing the option at all, which would have the server&apos;s default timeout kick in. In the C driver, there is logic to avoid setting &lt;tt&gt;maxTimeMS&lt;/tt&gt; on getMore if the user supplied a value of zero. I expect other drivers do the same.&lt;/p&gt;</description>
                <environment></environment>
        <key id="388529">DOCS-10329</key>
            <summary>Inaccurate documentation for getMore maxTimeMS option</summary>
                <type id="3" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14718&amp;avatarType=issuetype">Task</type>
                                            <priority id="3" iconUrl="https://jira.mongodb.org/images/icons/priorities/major.svg">Major - P3</priority>
                        <status id="6" iconUrl="https://jira.mongodb.org/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="success"/>
                                    <resolution id="9">Done</resolution>
                                        <assignee username="cory.bullinger@mongodb.com">Cory Bullinger</assignee>
                                    <reporter username="jmikola@mongodb.com">Jeremy Mikola</reporter>
                        <labels>
                            <label>reopened</label>
                            <label>server-docs-bug-bash</label>
                            <label>triage</label>
                    </labels>
                <created>Tue, 30 May 2017 20:43:39 +0000</created>
                <updated>Mon, 30 Oct 2023 21:11:26 +0000</updated>
                            <resolved>Tue, 18 Jul 2023 22:35:08 +0000</resolved>
                                                    <fixVersion>Server_Docs_20231030</fixVersion>
                                    <component>manual</component>
                    <component>Server</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>5</watches>
                                                                                                                <comments>
                            <comment id="4945106" author="JIRAUSER1264463" created="Tue, 1 Nov 2022 17:34:58 +0000"  >&lt;p&gt;Thanks &lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=jmikola%40mongodb.com&quot; class=&quot;user-hover&quot; rel=&quot;jmikola@mongodb.com&quot;&gt;jmikola@mongodb.com&lt;/a&gt;. Appreciate the update.&lt;/p&gt;</comment>
                            <comment id="4943075" author="jmikola@gmail.com" created="Tue, 1 Nov 2022 03:02:31 +0000"  >&lt;p&gt;The original text I cited in the OP is still in the current documentation. This still seems relevant.&lt;/p&gt;</comment>
                            <comment id="4940724" author="edu.bot" created="Mon, 31 Oct 2022 16:09:57 +0000"  >&lt;p&gt;Hello! This ticket has been closed due to inactivity. If you believe this ticket is still important, please reopen it and leave a comment to explain why. Thank you!&lt;/p&gt;</comment>
                            <comment id="1583779" author="david.storch" created="Wed, 31 May 2017 14:32:14 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=jmikola&quot; class=&quot;user-hover&quot; rel=&quot;jmikola&quot;&gt;jmikola&lt;/a&gt;, your comment looks accurate. One other thing I&apos;d like to point out is that &lt;tt&gt;maxTimeMS&lt;/tt&gt; is not allowed on a &lt;tt&gt;getMore&lt;/tt&gt; unless the &lt;tt&gt;getMore&lt;/tt&gt; is issued against an &lt;tt&gt;awaitData&lt;/tt&gt; cursor.&lt;/p&gt;</comment>
                            <comment id="1583192" author="jmikola@gmail.com" created="Tue, 30 May 2017 20:44:05 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=david.storch&quot; class=&quot;user-hover&quot; rel=&quot;david.storch&quot;&gt;david.storch&lt;/a&gt;: Can you fact-check my comments in the OP?&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                                                <inwardlinks description="is related to">
                                        <issuelink>
            <issuekey id="349044">DOCS-9823</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="240203">DOCS-6620</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                <customfield id="customfield_10050" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname># Replies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>5.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Wed, 31 May 2017 14:32:14 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        1 year, 14 weeks, 1 day ago
    
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_18254" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Dependencies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue><![CDATA[]]></customfieldvalue>


                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_15850" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                            <customfield id="customfield_14876" key="com.atlassian.jira.plugin.system.customfieldtypes:userpicker">
                        <customfieldname>Docs Reviewer</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>ashley.brown@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_10057" key="com.atlassian.jira.toolkit:lastusercommented">
                        <customfieldname>Last comment by Customer</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>true</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10056" key="com.atlassian.jira.toolkit:lastupdaterorcommenter">
                        <customfieldname>Last commenter</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>emet.ozar@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            1 year, 14 weeks, 1 day ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>cory.bullinger@mongodb.com</customfieldvalue>
            <customfieldvalue>david.storch@mongodb.com</customfieldvalue>
            <customfieldvalue>edu.bot</customfieldvalue>
            <customfieldvalue>jmikola@mongodb.com</customfieldvalue>
            <customfieldvalue>sarah.olson@mongodb.com</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|ht89sv:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|ht0clb:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>9223372036854775807</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10053" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>Time In Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_14350" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>serverRank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|ht7vvb:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                </customfields>
    </item>
</channel>
</rss>