CREATE-ACCOUNT Proc

The CREATE-ACCOUNT Proc is used to create new user accounts.

Format

CREATE-ACCOUNT [account-name]

Description

When you create an account, the system makes a copy of the NEWAC file, which is stored in the SYSPROG account, and places it in the Master Dictionary of the new account. It puts a D-pointer to the new account in the SYSTEM Dictionary, and a Q-pointer to the new account in the Master Dictionary of the SYSPROG account.

As part of this process you can specify retrieval and update permissions, the system privilege level, and the amount of disk space the account will occupy. You can also set the account password when you create the account.

  1. Enter an account name. An account name can be any combination of letters, numbers, or symbols. It cannot contain spaces. If you do not enter the account name in the command line, the CREATE-ACCOUNT Proc prompts you for it:

    2. ACCOUNT NAME?

  2. You are prompted for the retrieval code:

    3. L/RET-CODE(S)?

    The retrieval code is optional. This is a MultiValued lock code, used to prevent unauthorized users from reading files in the account. When a user logs on, this code is compared to the retrieval code specified in the user’s-ID; if the codes don’t match, the user won’t be able to read files in that account.

    You can enter any combination of letters and numbers as the lock code; press ENTER if you don’t want to enter a lock code.

  3. This prompt for the update code displays:

    4. L/UPD-CODE(S)?

    The update code is also optional. This is a MultiValued lock code that works similar to the retrieval code. It is used to prevent unauthorized users from making changes to files in the account. Enter any combination of letters and numbers as the lock code; press ENTER if you don’t want to enter a lock code.

    More detailed information about retrieval and update codes can be found in the mvBase Operation and Administration Guide.

  4. The next prompt is for the system privilege level:

    5. PRIVILEGES?

    There are four security-level codes, which allow the administrator to limit access to various levels of the system from the account for which they are set:

    SYS0 (lowest)

    Users cannot create or delete files, clear data from files, or update the Master Dictionary. This is the default; press ENTER to enter the default privilege level.

    SYS1

    Users can update the Master Dictionary and use magnetic tape or floppy disk commands.

    SYS2

    Users can use the DEBUG command, both the System and the BASIC Debuggers, the DUMP processor, and the FILE-SAVE and FILE-RESTORE processors.

    SYS3 (highest)

    Users have unrestricted access to all levels of the system, including all files, regardless of any retrieval or update codes.

  5. You are prompted to enter the modulo:

    6. MODULO?

    The modulo specifies the amount of disk space required for the account. The default modulo is 7. Press ENTER at the prompt to use the default.

  6. The CREATE-ACCOUNT Proc runs the PASSWORD command. You can either set a password for the new account, or press ENTER if you don’t want to set a password. You can use the PASSWORD command at any time later when you want to set or change the password for the account.

  7. If the account will have multiple users, you may want to create a separate user-ID for each user. You can assign each user a specific password and privileges. To create user-IDs, use the Editor to create a Q-pointer in the SYSTEM Dictionary that points to the account’s Master Dictionary.

Creating a New Account

To create a new ORDERS account:

  1. From the SYSPROG account, type this command at the TCL prompt:

    2. >CREATE-ACCOUNT

  2. The system prompts you to enter this data:

    3. ACCOUNT NAME?ORDERS

    L/RET-CODE(S)?OR]AR]INV]HIST

    L/UPD-CODE(S)?OR]AR

    PRIVILEGES?SYS1

    MODULO?<ENTER>

    (In this example the default modulo of 7 is entered by pressing ENTER at the prompt.)

    PASSWORD?

  3. Enter a password for the account, or press ENTER if you don’t want to set a password. If you press ENTER, the system asks you to confirm that you don’t want to set a password.

    4. ARE YOU SURE YOU DO NOT WANT A PASSWORD (Y/N)?

  4. Type Y or N at the prompt. The Proc then creates the new account, and these messages display:

    5. [417] FILE 'ORDERS' CREATED; BASE = 7221,

    MODULO = 7.

    UPDATING ACCOUNT M/DICT

    310 ITEMS COPIED

    CREATE-ACCOUNT FINISHED

    The new account has been created.

    The example below shows the sequence of messages displayed when you create the account:

    >CREATE-ACCOUNT

    ACCOUNT NAME?ORDERS

    L/RET-CODE(S)?OR]AR]INV]HIST

    L/UPD-CODE(S)?OR]AR

    PRIVILEGES?SYS1

    MODULO?<ENTER>

    PASSWORD?<ENTER>

     

    [417] FILE 'ORDERS' CREATED; BASE = 7221, MODULO = 7.

    UPDATING ACCOUNT M/DICT

    283 ITEMS COPIED

    CREATE-ACCOUNT FINISHED