create-account Command

The create-account BASIC program creates a new master dictionary, copies all the necessary items into it, and updates the mds file with the name and address.

The newac file in the dm account contains the items that are placed into a new account master dictionary. Additional, application-specific items may be added to newac. For security purposes, items can be removed from newac as well. For example, dangerous commands such as delete-file and clear-file could be either removed or renamed to prevent accidental use.

For a complete description of the attributes requested in create-account, see Master Dictionary. If the account name is omitted from the command line, the process prompts for it.

Syntax

create-account {VME:} {account.name} {(options}

Parameter(s)

{VME:}	(Optional) For Windows: By default, the account is created in the FSI. To create the account in the VME, use this optional prefix.
account.name	Name of account. NOTE—The following reserved characters are not supported for use in account names: *~@'():?/<>\"\|^[]
options	h	For Hot-Backup purposes, suppresses updates to the new account from newac items.
	l	For Hot-Backup purposes, specifies that files in the account are logged.
	s	Creates a case sensitive account.
	t	For Hot-Backup purposes, specifies that files in the account are not logged (applicable if logging all files).
	x	Specifies that files in the account are not saved during a regular backup and are not logged via Hot Backup.
	y	Specifies that files in the account are saved (but not their contents) during a regular backup. Also, files are not logged via Hot Backup.

Example(s)

create-account fred

mds,, ’fred’ NEW ITEM size = 31

mds,, fred

type D

modulo 37

ret-lock

upd-lock

password

syspriv

justification L

width 12

reallocation

mds,,	Item-ID of the account to create.
type	Describes the type of item. D indicates this is a file-defining item. (local) DS-pointer account indicates case-sensitivity (local). R indicates this is an OSFI file-defining item (remote)
modulo	Modulo used in creating the file for this account.
retrieval codes and update lock codes	Unique locks for limiting access to files within the account.
password	Optional logon password for this account. The password displays as a formula conversion in hexadecimal.
syspriv	User privilege level. This can be sys0, sys1, or sys2.
justification and width	Describes the output specifications for the master dictionary.
reallocation	Describes the reallocation modulo for the master dictionary, if any. This value must be enclosed in parentheses.