Talk:Open Access Metadata Open Standard (OAMOS)

From RPG Open Access Metadata Standard
Jump to: navigation, search

Contents

Changes between version 1.0 and version 2.0

New name for tag:

version 1.0          version 2.0
------------     ------------
<fmt>            <Format>
<objAtrs>        <ObjectAttributes>
<inds>           <Indicators>
<ind>            <Indicator>
<flds>           <Fields>
<fld>            <Field>
<fldKwds>        <Keywords>
<fldKwd>         <Keyword>
<fmtKwds>        <Keywords>
<fmtKwd>         <Keyword>
<multiFmt>       <MultiFormats>

New name for attribute:

version 1.0          version 2.0
------------     ------------
width=           len=
kwd=             name=

Here the overall structure for format reference at file level - new in version 2.0:

<File name="DSPF1" lib="LIB1" type="DSPF">
  <Formats>                                        Formats start (1 occurrence)
     <Format ref=".../lib/file/FMT1.xml">
     <Format ref=".../lib/file/FMT2.xml">
     <Format ref=".../lib/file/FMT3.xml"> 
  </Formats>                                       Formats end
</File>

Here the overall structure for DDS keyword reference at file level - new in version 2.0:

(version 1.0 preconized to explode file-level keywords into each xml-formats - both structure are accepted)
<File name="DSPF1" lib="LIB1" type="DSPF">
  <Keywords>
     <Keyword name="INDARA"/>
     <Keyword name="CF03" value="03"/>
  </Keywords>
  <Indicators>
     <Indicator name="*IN03" use="I"/>
  </Indicators> 
  <Formats>                                         
     ... 
  </Formats>                                        
</File>

New tag for "Modern UI component & UI properties description"

See corresponding chapter on main page.



version 1.0

DDS-XML (Core XML)

Here the overall structure
<fmt ...>                                               Format start (1 occurrence)
	<objAtrs .../>                                  Object attributes block - coming from compilation options (1 occurrence)
        <inds>                                          Format's indicators block (1 occurrence)
		<ind .../>                              (n occurrences)
	</inds>
	<fmtKwds>                                       Format's DDS Keywords block (1 occurrence)
		<fmtKwd .../>                           (n occurrences)
	</fmtKwds>
	<flds>                                          Format's fields block (1 occurrence)
		<fld ...>                               (n occurrences)
			<fldKwds>                       Field's DDS Keywords block (1 occurrence)
				<fldKwd .../>           (n occurrences)
			</fldKwds>
		</fld>
	</flds>
</fmt>                                                  Format end

DDS-XML for Display file (dspf)

Current status: version 1.0

Premise
All file-level keywords are repeated at the format-level.
All reference info (REF, REFFLD) are exploded before hand in order to expose a complete and direct definition.
<fmt 
 	name="..."                                      format name 
	lib="..."                                       library name
	dspf="..."                                      display-file name
	type="NORMAL|SFLCTL|SFL|SFLMSG"
	[window="Y"] 
	mode="80|132" 
	[recasc="otherFmt"]                             cf. SFLCTL/SFL correlation
	X="1"                                           top-left
	Y="1"                                           top-left
	width="80|132|nnn"                              nnn for window
	height="24|27|nn"                               nn for window
	strRow="1"                                      top-line format
	endRow="11"                                     bottom-line format
>
	<objAtrs                                        object attributes block - coming from compilation options
		[CCSID="37"]                            (Use same format as crtCmd parameter: parmName="parmValue")
	/>
        <inds>
		<ind 
			name="*IN01|*IN02|...|*IN99" 
			use="I|O|B" 
		/>
		<ind .../>
	</inds>
	<fmtKwds>
		<fmtKwd 
			[cond="51"]                                         (DDS *ind set in positions 7 through 16)  
			kwd="DDS Keyword" 
			[value="DDS Keyword parameter(s)"] 
		/>
		<fmtKwd .../>
	</fmtKwds>
	<flds>
		<fld 
			[cond="51"]                                         (DDS *ind set in positions 7 through 16) 
			[name="field name"] 
			type="A|D|F|I|M|N|S|W|X|Y|E|J|O|G|const"            (for const: specify its value with DFT DDS keyword (1))
			use="I|O|B|H|P|M" 
			[X="60"]                                            top-left
			[Y="1"]                                             top-left
			width="..."                                         length
			[maskWidth="layout width"]                          length with sign, dec-sep, EDTCDE, EDTWRD 
		>
			<fldKwds>
				<fldKwd  
					[cond="51"]                                (DDS *ind set in positions 7 through 16)   
					kwd="DDS Keyword" 
					[value="DDS Keyword parameter(s)"] 
				/>
				<fldKwd .../>  
			</fldKwds>
		</fld>
		<fld .../>
	</flds>
</fmt>
(1) type="const":
    A                                  2  2'My text'
    ...is implicitly equivalent to:
    A                                  2  2DFT('My text')
    ...therefore, in XML, we will get:
		<fld 
			[name="const001"] 
			type="const"
			use="O" 
			X="2"
			Y="2"
			width="7"
		>
			<fldKwds>
				<fldKwd  
					kwd="DFT" 
					value="My text" 
				/>
			</fldKwds>
		</fld>

DDS-XML for Printer file (prtf)

Current status: version 1.0

Premise
All file-level keywords are repeated at the format-level.
All reference info (REF, REFFLD) are exploded before hand in order to expose a complete and direct definition.
<fmt
	name="..."                                      format name
	lib="..."                                       library name
	prtf="..."                                      printer-file name
>
	<objAtrs                                        object attributes block - coming from compilation options
		[PAGESIZE="50 100 *ROWCOL"]             (Use same format as crtCmd parameter: parmName="parmValue")
		[OVRFLW="50"]                           (idem for any relevant parm-info)
	/>
	<inds>
		<ind 
			name="*IN01|*IN02|...|*IN99" 
		/>
		<ind .../>
	</inds>
	<fmtKwds>
		<fmtKwd 
			[cond="51"]                                         (DDS *ind set in positions 7 through 16) 
			kwd="DDS Keyword" 
			[value="DDS Keyword parameter(s)"] 
		/>
		<fmtKwd .../>
	</fmtKwds>
	<flds>
		<fld 
			[cond="51"]                                         (DDS *ind set in positions 7 through 16)
			[name="field name"] 
			type="S|A|F|L|T|Z|O|G|const"                        (for const: specify its value with DFT DDS keyword)
			use="O|P" 
			[X="60"] 
			[Y="1"] 
			width="..."                                         length 
			[maskWidth="layout width"]                          length with sign, dec-sep, EDTCDE, EDTWRD 
		>
			<fldKwds>
				<fldKwd  
					[cond="51"]                                 (DDS *ind set in positions 7 through 16)
					kwd="DDS Keyword" 
					[value="DDS Keyword parameter(s)"] 
				/>
				<fldKwd .../>  
			</fldKwds>
		</fld>
		<fld .../>
	</flds>
</fmt>

DDS-XML for Physical file (pf)

Current status: version 1.0

Premise
All file-level keywords are repeated at the format-level.
All reference info (REF, REFFLD) are exploded before hand in order to expose a complete and direct definition.
<fmt
	name="..."                                      format name
	lib="..."                                       library name
	pf="..."                                        physical-file name
>
	<objAtrs                                        object attributes block - coming from compilation options
		[CCSID="37"]                            (Use same format as crtCmd parameter: parmName="parmValue")
	/>
	<fmtKwds>
		<fmtKwd 
		 	kwd="DDS Keyword" 
			[value="DDS Keyword parameter(s)"] 
		/>
		<fmtKwd .../>
	</fmtKwds>
	<flds>
		<fld 
			[typeName="K"]                                       Key 
			name="field name" 
			type="P|S|B|F|A|H|L|T|Z|5|J|O|G" 
			[use="B|I|N"]                                        default B
			width="..."                                          length 
 			[maskWidth="layout width"]                           length with sign, dec-sep, EDTCDE, EDTWRD 
		>
			<fldKwds>
				<fldKwd  
					kwd="DDS Keyword" 
					[value="DDS Keyword parameter(s)"] 
				/>
				<fldKwd .../>  
			</fldKwds>
		</fld>
		<fld .../>
	</flds>
</fmt>

DDS-XML for Logical file (lf)

Current status: version 1.0

Premise
All file-level keywords are repeated at the format-level.
All reference info (REF, REFFLD) are exploded before hand in order to expose a complete and direct definition.
<fmt
	name="..."                                      format name
	lib="..."                                       library name
	lf="..."                                        logical-file name
>
	<objAtrs                                        object attributes block - coming from compilation options
		[CCSID="37"]                            (Use same format as crtCmd (CRTLF or CRTPF) parameter: parmName="parmValue")
	/>
	<fmtKwds>
		<fmtKwd 
			kwd="DDS Keyword" 
			[value="DDS Keyword parameter(s)"] 
		/>
		<fmtKwd .../>
	</fmtKwds>
	<joins>
		<join 
			kwd="JDUPSEQ|JFLD|JOIN" 
			[value="DDS Keyword parameter(s)"] 
		/>
		<join .../>
	</joins>
	<flds>
		<fld 
			[typeName="K|S|O"]                                   Key, Select, Omit 
			name="field name" 
			type="P|S|B|F|A|H|L|T|Z|5|J|O|G" 
			[use="B|I|N"]                                        default B 
			width="..."                                          length 
			[maskWidth="layout width"]                           length with sign, dec-sep, EDTCDE, EDTWRD 
		>
			<fldKwds>
				<fldKwd  
					kwd="DDS Keyword" 
					[value="DDS Keyword parameter(s)"] 
				/>
				<fldKwd .../>  
			</fldKwds>
		</fld>
		<fld .../>
	</flds>
</fmt>
DDS-XML for Multiple Format Logical file (lf)

Current status: version 1.0

Premise
All file-level keywords are repeated at the format-level.
All reference info (REF, REFFLD) are exploded before hand in order to expose a complete and direct definition.
<multiFmt
	lib="..."                                       library name
	lf="..."                                        logical-file name
>
	<fmt
		name="..."                              format name 
	>
		<fmtKwds .../>                          fmtKwds block (includes <fmtKwd>)
		<flds .../>                             flds block (includes <fld><fldKwds><fldKwd>)
	</fmt>
	<fmt .../>
</multiFmt>