CREATE.ACCOUNT

acc.name

is the name to be given to the new account. This name must start with a letter and may not contain spaces. The name will be translated to uppercase and must not exceed 32 characters in length. The command will prompt for this if it is not given on the command line.

pathname

is the pathname of the operating system directory to hold the account. The pathname should be enclosed in quotes if it contains spaces. The directory will be created if it does not already exist but the parent directory must already exist. The command will prompt for this if it is not given on the command line.

description

is a text description of the account that will be displayed when listing the QM.ACCOUNTS file. It must be enclosed in quotes if it contains spaces.

NO.QUERY

suppresses the confirmation prompts when the pathname directory already contains a VOC file or when creating a new directory.

NO.CASE

creates the account with a case insensitive VOC file. This option is ignored if the VOC file is already present in the account directory.

The CREATE.ACCOUNT command creates a new account and populates the VOC file from the NEWVOC template and optional NEWVOC.MODS file stored in the QMSYS account. The new account is added to the register of accounts in the ACCOUNTS file in the QMSYS account.

Creation of accounts by specific users may be barred by the system administrator. See Application Level Security for more details.

If no pathname is specified on the command line, CREATE.ACCOUNT prompts for the pathname. The command will look in the VOC of the QMSYS account for an X-type record named $ACCOUNT.ROOT.DIR and, if this is found, will use field 2 of this record to specify a directory name under which the account should be created by default. This default pathname can be selected by entering a null response to the pathname prompt.

The MODE mmm option sets file permission modes (not Windows). The mmm component is an octal permissions mask that will be applied to the directory that represents the account and all other items created in the account by this command. The optional sss component is the mode settings to be applied to the the subfiles in the newly created VOC file. If sss is omitted, the ddd value is used.

The USER and GROUP options set the owner and group for the account (not Windows). The uid and gid qualifiers may be specified either as numbers or as names. No error is reported if the user executing the command does not have sufficient access rights to apply these values. When either of these options is omitted, the user and group are inherited from the user executing the command.

Accounts may be installed anywhere within the operating system file hierarchy. It is often useful to distribute accounts across disk drives for improved load balancing. Alternatively, related information can be clustered together in a single partition to simplify replication. It is recommended that new accounts are not created under the directories of existing accounts as this can lead to accidental deletion. For example, it is generally not a good idea to create application accounts as subdirectories of the QMSYS account.

Attempting to create an account in the root directory will ask for confirmation unless the NO.QUERY keyword has been used.

When QM is installed on a USB memory device, if pathname specifies a directory on the USB device, this will be transformed internally to a format that allows for the drive letter to be different when the stick is loaded in future.