<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:Georgia;
panose-1:2 4 5 2 5 4 5 2 3 3;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:#0563C1;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:#954F72;
text-decoration:underline;}
p.MsoListParagraph, li.MsoListParagraph, div.MsoListParagraph
{mso-style-priority:34;
margin-top:0in;
margin-right:0in;
margin-bottom:0in;
margin-left:.5in;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
p.msonormal0, li.msonormal0, div.msonormal0
{mso-style-name:msonormal;
mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:0in;
font-size:12.0pt;
font-family:"Times New Roman",serif;}
span.EmailStyle19
{mso-style-type:personal;
font-family:"Calibri",sans-serif;
color:windowtext;}
span.EmailStyle20
{mso-style-type:personal-reply;
font-family:"Georgia",serif;
color:#1F497D;}
.MsoChpDefault
{mso-style-type:export-only;
font-size:10.0pt;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
/* List Definitions */
@list l0
{mso-list-id:376398522;
mso-list-type:hybrid;
mso-list-template-ids:898791858 1904893804 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l0:level1
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:none;
mso-level-number-position:left;
margin-left:.75in;
text-indent:-.25in;}
@list l0:level2
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:none;
mso-level-number-position:left;
margin-left:1.25in;
text-indent:-.25in;}
@list l0:level3
{mso-level-number-format:roman-lower;
mso-level-tab-stop:none;
mso-level-number-position:right;
margin-left:1.75in;
text-indent:-9.0pt;}
@list l0:level4
{mso-level-tab-stop:none;
mso-level-number-position:left;
margin-left:2.25in;
text-indent:-.25in;}
@list l0:level5
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:none;
mso-level-number-position:left;
margin-left:2.75in;
text-indent:-.25in;}
@list l0:level6
{mso-level-number-format:roman-lower;
mso-level-tab-stop:none;
mso-level-number-position:right;
margin-left:3.25in;
text-indent:-9.0pt;}
@list l0:level7
{mso-level-tab-stop:none;
mso-level-number-position:left;
margin-left:3.75in;
text-indent:-.25in;}
@list l0:level8
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:none;
mso-level-number-position:left;
margin-left:4.25in;
text-indent:-.25in;}
@list l0:level9
{mso-level-number-format:roman-lower;
mso-level-tab-stop:none;
mso-level-number-position:right;
margin-left:4.75in;
text-indent:-9.0pt;}
@list l1
{mso-list-id:1494680052;
mso-list-type:hybrid;
mso-list-template-ids:425242560 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l1:level1
{mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l1:level2
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l1:level3
{mso-level-number-format:roman-lower;
mso-level-tab-stop:none;
mso-level-number-position:right;
text-indent:-9.0pt;}
@list l1:level4
{mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l1:level5
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l1:level6
{mso-level-number-format:roman-lower;
mso-level-tab-stop:none;
mso-level-number-position:right;
text-indent:-9.0pt;}
@list l1:level7
{mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l1:level8
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l1:level9
{mso-level-number-format:roman-lower;
mso-level-tab-stop:none;
mso-level-number-position:right;
text-indent:-9.0pt;}
@list l2
{mso-list-id:1861697043;
mso-list-type:hybrid;
mso-list-template-ids:1028688988 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l2:level1
{mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l2:level2
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l2:level3
{mso-level-number-format:roman-lower;
mso-level-tab-stop:none;
mso-level-number-position:right;
text-indent:-9.0pt;}
@list l2:level4
{mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l2:level5
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l2:level6
{mso-level-number-format:roman-lower;
mso-level-tab-stop:none;
mso-level-number-position:right;
text-indent:-9.0pt;}
@list l2:level7
{mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l2:level8
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l2:level9
{mso-level-number-format:roman-lower;
mso-level-tab-stop:none;
mso-level-number-position:right;
text-indent:-9.0pt;}
@list l3
{mso-list-id:1976637234;
mso-list-type:hybrid;
mso-list-template-ids:1314449358 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l3:level1
{mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l3:level2
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l3:level3
{mso-level-number-format:roman-lower;
mso-level-tab-stop:none;
mso-level-number-position:right;
text-indent:-9.0pt;}
@list l3:level4
{mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l3:level5
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l3:level6
{mso-level-number-format:roman-lower;
mso-level-tab-stop:none;
mso-level-number-position:right;
text-indent:-9.0pt;}
@list l3:level7
{mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l3:level8
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:none;
mso-level-number-position:left;
text-indent:-.25in;}
@list l3:level9
{mso-level-number-format:roman-lower;
mso-level-tab-stop:none;
mso-level-number-position:right;
text-indent:-9.0pt;}
ol
{margin-bottom:0in;}
ul
{margin-bottom:0in;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="#0563C1" vlink="#954F72">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D">John,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D">I must admit to not having done a detailed analysis (inspecting the updated book), but the approach and items listed below look good to me. Some minor notes on the
items 1 and 2:<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoListParagraph" style="text-indent:-.25in;mso-list:l2 level1 lfo6"><![if !supportLists]><span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D"><span style="mso-list:Ignore">1.<span style="font:7.0pt "Times New Roman"">
</span></span></span><![endif]><span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D">From: “…</span>accompanied in in the same XFDU Package..”
<span style="font-size:12.0pt;font-family:"Georgia",serif">To: </span> “<span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D">“…</span>accompanied in the same XFDU Package…”<span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D"><o:p></o:p></span></p>
<p class="MsoListParagraph" style="text-indent:-.25in;mso-list:l2 level1 lfo6"><![if !supportLists]><span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D"><span style="mso-list:Ignore">2.<span style="font:7.0pt "Times New Roman"">
</span></span></span><![endif]><span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D">From “…</span>only when it associated…”
<span style="font-size:12.0pt;font-family:"Georgia",serif">To: </span> “only when it is associated…”<span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D"><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D">Best regards,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D">-Erik
<o:p></o:p></span></p>
<p class="MsoListParagraph"><span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:12.0pt;font-family:"Georgia",serif;color:#1F497D"><o:p> </o:p></span></p>
<div>
<div style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b>From:</b> SMWG <smwg-bounces@mailman.ccsds.org> <b>On Behalf Of
</b>John Pietras<br>
<b>Sent:</b> Friday, December 14, 2018 12:18<br>
<b>To:</b> CCSDS SMWG ML (smwg@mailman.ccsds.org) <smwg@mailman.ccsds.org><br>
<b>Subject:</b> Re: [Smwg] action item 2018-1211-01, Clarify constraints on presence of payload and metadata files in an XFDU packages<o:p></o:p></p>
</div>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">CSSMWG colleagues ---<o:p></o:p></p>
<p class="MsoNormal">At the 11 December 2018 telecon we discussed the ambiguity in the specification of the relationship between the elements of the XFDU Manifest and the numbers and types of files within the XFDU Package; i.e., there is currently no prohibition
on the XFDU Package containing “other” files that are not accounted for in the DataObject and MetadataObject elements of the Manifest.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Serge has suggested deleting 4.2.7.1 (“The metadataSection element shall contain one metadataObject element for each Metadata Object (i.e., metadata file) associated with the payload data file(s) being transferred in the XFDU Package”)
and 4.2.8.1 (“The dataObjectSection element shall contain one dataObject element for each payload data file in the XFDU Package”), and replacing them with a requirement such as “Each file present in the XFDU package archive other than the manifest shall be
described by either a dataObject element or by a metadataObject element.” Serge justified this wording by saying that (a) there is nothing stated that normatively limits the contents of the XFDU Package to just a single manifest file, one of more payload
files, and zero or more metadata files, and furthermore (b) “payload data file” and “metadata file” are not even formally defined. The suggested approach sidesteps the need to distinguish between payload files and metadata files for the purposes of ensuring
correspondence between files in the Package and metadataObject/ dataObject elements in the Manifest.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">I sympathize and concur with the desire to not create distinctions where it is otherwise not necessary to do so. However, in this case I think that the distinction between the two kinds of files is very important in understanding what’s
in the XFDU Package and how those contents relate to the elements of the Manifest. Furthermore, “payload data” is defined in 1.5.2 (g) and we have sections named “Payload Data File Names” (3.2.1.3), “Metadata File Names” (3.2.1.4), “Payload Data File Enclosed
within the XFDU Package” (4.3), and “Metadata File Enclosed within the XFDU Package” (4.4). To try to remove these terms in some globally-uniform way would involve more effort than I think we have resources/time to do.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">So instead I chose to clarify and formalize the concepts of payload data file and metadata file, and specify that an XFDU Package shall contain only: a single XFDU Manifest file; one or more payload data files; and zero or more metadata
files. I have made the following changes to the TGFT White Book:<o:p></o:p></p>
<p class="MsoListParagraph" style="margin-bottom:12.0pt;text-indent:-.25in;mso-list:l1 level1 lfo2">
<![if !supportLists]><span style="mso-list:Ignore">1.<span style="font:7.0pt "Times New Roman"">
</span></span><![endif]>Changed the “payload data” item in 1.5.2 to “payload data file”, and changed the definition to “a file that contains the essential data of the data transfer. One or more payload data files are contained in an XFDU Package, which is the
“service data unit” of TGFT. A payload data file may be accompanied in in the same XFDU Package by one or more metadata files that provide information necessary to the interpretation or processing of the payload data.”
<o:p></o:p></p>
<p class="MsoListParagraph" style="margin-bottom:12.0pt;text-indent:-.25in;mso-list:l1 level1 lfo2">
<![if !supportLists]><span style="mso-list:Ignore">2.<span style="font:7.0pt "Times New Roman"">
</span></span><![endif]>Added a “metadata file” item in 1.5.2, with the definition “a file that contains data that is used to interpret or process data contained in a payload data file. A metadata file may be contained within and XFDU Package only when it associated
with one or more payload data files within that XFDU Package.”<o:p></o:p></p>
<p class="MsoListParagraph" style="margin-bottom:12.0pt;text-indent:-.25in;mso-list:l1 level1 lfo2">
<![if !supportLists]><span style="mso-list:Ignore">3.<span style="font:7.0pt "Times New Roman"">
</span></span><![endif]>Added some wording to section 2.3 to better describe the contents of and constraints on files in XFDU Packages.<o:p></o:p></p>
<p class="MsoListParagraph" style="margin-bottom:12.0pt;text-indent:-.25in;mso-list:l1 level1 lfo2">
<![if !supportLists]><span style="mso-list:Ignore">4.<span style="font:7.0pt "Times New Roman"">
</span></span><![endif]>Refined the General section (4.1) under Composition Rules for XFDU Packages for TGFT to include payload data files and metadata files. This specifically states that each dataObject element corresponds to a payload file, and each metadataObject
corresponds to a metadata file. <o:p></o:p></p>
<p class="MsoListParagraph" style="margin-bottom:12.0pt;text-indent:-.25in;mso-list:l1 level1 lfo2">
<![if !supportLists]><span style="mso-list:Ignore">5.<span style="font:7.0pt "Times New Roman"">
</span></span><![endif]>Changed 4.2.6.3.1 to “The optional <b>anyMdID</b> attribute of the
<b>contentUnit</b> element shall be present if the XFDU Manifest contains a <b>metadataSection</b> element (4.2.7) that contains any
<b>metadataObject</b> elements that correspond to metadata files that are needed to interpret or process the payload data file that is represented by the
<b>contentUnit</b>. If present, this attribute shall contain the IDREF values of the
<b>ID</b> attributes of the <b>metadataObject</b> elements (see 4.3.7.2.1 (a)) that correspond to those related metadata files.”
<br>
<br>
This change corrects an error that had slipped by me until Serge’s email referenced it. As originally phrased, the a<b>nyMdID</b> attribute would be present in all
<b>contentUnit</b> elements is there were any <b>metadataObject</b> elements, whether or not the metadata file(s) had anything to do with the specific payload data file. The text now indicates
<br>
that the <b>anyMdID</b> attribute is to be populated only when there are metadata files that are relevant to the specific payload data file.<o:p></o:p></p>
<p class="MsoListParagraph" style="margin-bottom:12.0pt;text-indent:-.25in;mso-list:l1 level1 lfo2">
<![if !supportLists]><span style="mso-list:Ignore">6.<span style="font:7.0pt "Times New Roman"">
</span></span><![endif]>Changed 4.2.7.1 to “The <b>metadataSection</b> element shall contain one
<b>metadataObjec</b>t element for each metadata file associated with the payload data file(s) being transferred in the XFDU Package.”<o:p></o:p></p>
<p class="MsoListParagraph" style="text-indent:-.25in;mso-list:l1 level1 lfo2"><![if !supportLists]><span style="mso-list:Ignore">7.<span style="font:7.0pt "Times New Roman"">
</span></span><![endif]>In section 4.5, [Composition Rules for] TGFT XFDU Package:<o:p></o:p></p>
<p class="MsoListParagraph" style="margin-left:.75in;text-indent:-.25in;mso-list:l0 level1 lfo4">
<![if !supportLists]><span style="mso-list:Ignore">a.<span style="font:7.0pt "Times New Roman"">
</span></span><![endif]>Changed 4.5.2 to “The TGFT XFDU package shall contain one
<s><span style="color:red">enclosed payload data</span></s><span style="color:red">
</span>file for every <b>dataObject</b> element in the dataObjectSection of the XFDU manifest.”<o:p></o:p></p>
<p class="MsoListParagraph" style="margin-left:.75in;text-indent:-.25in;mso-list:l0 level1 lfo4">
<![if !supportLists]><span style="mso-list:Ignore">b.<span style="font:7.0pt "Times New Roman"">
</span></span><![endif]>Changed 4.5.3 to “The TGFT XFDU package shall contain one
<s><span style="color:red">enclosed metadata</span></s><span style="color:red"> </span>
file for every <b>metadataObject</b> element in the metadataSection of the XFDU manifest for which the metadataReference element has an href value that begins “file:”.<o:p></o:p></p>
<p class="MsoListParagraph" style="margin-left:.75in;text-indent:-.25in;mso-list:l0 level1 lfo4">
<![if !supportLists]><span style="mso-list:Ignore">c.<span style="font:7.0pt "Times New Roman"">
</span></span><![endif]>Inserted a new requirement (4.5.4) “Other than the XFDU Manifest file, the TGFT XFDU package shall not contain any files that do not have either (a) a corresponding
<b>dataObject</b> element in the XFDU manifest or (b) a corresponding <b>metadataObject</b> element in the XFDU manifest for which the
<b>metadataReference</b> element has an <b>href </b>value that begins “file:”.<o:p></o:p></p>
<p class="MsoListParagraph" style="mso-margin-top-alt:0in;margin-right:0in;margin-bottom:12.0pt;margin-left:.75in;text-indent:-.25in;mso-list:l0 level1 lfo4">
<![if !supportLists]><span style="mso-list:Ignore">d.<span style="font:7.0pt "Times New Roman"">
</span></span><![endif]>Inserted a new requirement (4.5.5) “Other than the XFDU Manifest, each file in the TGFT XFDU package shall correspond to one and only one of either (a) a
<b>dataObject</b> element in the XFDU manifest or (b) a <b>metadataObject</b> element in the XFDU manifest for which the
<b>metadataReference</b> element has an <b>href </b>value that begins “file:”.<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in">Items (a), (b), and (c) above are specifically aimed at limiting the files in the XFDU Package to only those files that are identified in the XFDU Manifest. I added item (d) because I’m not completely sure that
otherwise it is prohibited that a <b>dataObject</b> element and a <b>metadataObject</b> element point to the same file.
<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in"> <o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in">These changes have been made to the draft version that has been uploaded to the CWE at
<a href="https://cwe.ccsds.org/css/docs/CSS-SM/CWE%20Private/Book%20Production/Blue/Terrestrial%20Generic%20File%20Transfer/White%20Book/Drafts/927x01w0_09%20-%20Terrestrial%20Generic%20File%20Transfer%20-%20Working-JVP%2020181214.doc?Web=1">
https://cwe.ccsds.org/css/docs/CSS-SM/CWE%20Private/Book%20Production/Blue/Terrestrial%20Generic%20File%20Transfer/White%20Book/Drafts/927x01w0_09%20-%20Terrestrial%20Generic%20File%20Transfer%20-%20Working-JVP%2020181214.doc?Web=1</a><o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in"><o:p> </o:p></p>
<p class="MsoNormal" style="margin-left:.5in">Please review it to see if it solves the issue.<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in"><o:p> </o:p></p>
<p class="MsoNormal" style="margin-left:.5in">Best regards,<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:.5in">John<o:p></o:p></p>
</div>
</body>
</html>