s1kd-newdml(1)                    s1kd-tools                    s1kd-newdml(1)

NAME
      s1kd-newdml - Create a new S1000D data management list

SYNOPSIS
             s1kd-newdml [options] [<object>...]

DESCRIPTION
      The s1kd-newdml tool creates a new S1000D data management list with the
      code and other metadata specified.

OPTIONS
      -#, --code <code>
             The data management list code of the new DML.

      -$, --issue <issue>
             Specify which issue of S1000D to use.  Currently  supported  is‐
             sues are:

             · 5.0 (default)

             · 4.2

             · 4.1

             · 4.0

             · 3.0

             · 2.3

             · 2.2

             · 2.1

             · 2.0

      -@, --out <path>
             Save the new DML to <path>.  If <path> is an existing directory,
             the DML will be created in it instead of the current  directory.
             Otherwise,  the DML will be saved as the filename <path> instead
             of being automatically named.

      -%, --templates <dir>
             Use the XML template in the specified directory instead  of  the
             built-in  template.   The  template must be named dml.xml inside
             <dir> and must conform to the default S1000D issue (5.0).

      -~, --dump-templates <dir>
             Dump the built-in XML template to the specified directory.

      -b, --brex <BREX>
             BREX data module code.

      -c, --security <sec>
             The security classification of the new DML.

      -d, --defaults <file>
             Specify the .defaults file name.

      -f, --overwrite
             Overwrite existing file.

      -h, -?, --help
             Show usage message.

      -I, --date <date>
             The issue date of the new DML in the form of YYYY-MM-DD.

      -i, --info-code <info code>
             When creating a DMRL from SNS rules (-S), use the specified info
             code for each entry.  Specify this option multiple times to cre‐
             ate multiple data modules for each part of the SNS.  <info code>
             can specify:

             · the base info code (e.g., 520)

             · the info code variant (e.g., 520B)

             · the item location code (e.g., 520B-C)

      -l, --list
             Treat input (stdin or arguments) as lists of CSDB objects to add
             to the new list.

      -m, --remarks <remarks>
             Set the remarks for the new data management list.

      -N, --omit-issue
             Omit the issue/inwork numbers from filename.

      -n, --issno <issue>
             The issue number of the new DML.

      -p, --prompt
             Prompts the user for any values left unspecified.

      -q, --quiet
             Do not report an error when the file already exists.

      -R, --rpccode <NCAGE>
             Specifies a default responsible partner company enterprise  code
             for  entries  which do not carry this in their ID STATUS section
             (ICN, COM, DML).

      -r, --rpcname <name>
             Specifies a default responsible partner company enterprise  name
             for  entries  which  do not carry this in their IDSTATUS section
             (ICN, COM, DML).

      -S, --sns <SNS>
             Create a DMRL using the specified SNS rules.

      -v, --verbose
             Print the file name of the newly created DML.

      -w, --inwork <inwork>
             The inwork number of the new DML.

      -z, --issue-type <type>
             The issue type of the new DML.

      --version
             Show version information.

      <object>...
             Any number of CSDB object file names to automatically add to the
             list.

      In addition, the following options allow configuration of the XML pars‐
      er:

      --dtdload
             Load the external DTD.

      --huge Remove any internal arbitrary parser limits.

      --net  Allow network access to load external DTD and entities.

      --noent
             Resolve entities.

      --parser-errors
             Emit errors from parser.

      --parser-warnings
             Emit warnings from parser.

      --xinclude
             Do XInclude processing.

      --xml-catalog <file>
             Use an XML catalog when resolving entities.   Multiple  catalogs
             may be loaded by specifying this option multiple times.

  .defaults file
      Refer  to  s1kd-newdm(1) for information on the .defaults file which is
      used by all the s1kd-new* commands.

EXAMPLE
             $ s1kd-newdml -# EX-12345-C-2018-00001

AUTHORS
      khzae.net.

                                 2021-04-16                    s1kd-newdml(1)