Programmer Guide/Command Reference/NEW

NEW <var>itemtype</var> <var>itemname</var> [ /I ] [ /U|/u ] [ /G ] [ /Z ] [ <var>createargs</var> [ <var>createopts</var> ] ]

The <code>NEW</code> command creates a new shell item of the type <var>itemtype</var> and named <var>itemname</var>.

<var>itemtype</var>

The type of the new shell item. This must be unique (in the item namespace of a shell).

<var>itemname</var>

The name of the new shell item. If this argument is set to the character *, the name is choosen automatically.

<var>createargs</var>

Arguments specifying parameters for the initialization of the new item. The format and meaning of these arguments are depending on the type of the new shell item.

<code>/I</code>

Enable silent error reporting. If specified, <code>NEW</code> will generate a warning rather than an error if arguments are missing or it is unable create the new item.

<code>/G</code>

Garbage collection. If specified, a temporary (or local) item created, which is automatically deleted when exiting the macro.

<code>/U</code>

If specified, the global item protection is enabled. This means all items created before this item (called the protection-master) are proteced from being deleted, until the global item protection is disabled, which is done by deleting the protection-master). Protected items can only be deleted using a special option of the delete command. Note: This option is case-sensitive.

<code>/u</code>

If specified, the created item protected from being deleted. , until the global item protection is disabled, which is done by deleting the protection-master). Note: This option is case-sensitive.

<code>/z</code>