The MODA Tool

MODA is designed to simplify the tasks of creating or modifying HP3000 accounts, groups and users. MODA also has two commands that are used for cloning accounts and sync-ing account structures.

Operation

If you have ever had to modify the capabilities on an account via the ALTACCT command you will instantly appreciate MODA’s power. Normally, when you need to modify an attribute of an account, you need to type your changes plus all of the attributes that you don’t want to change. With MODA, all you have to key in are your changes.

A typical example of how MODA simplifies routine tasks is illustrated by the steps involved in adding SM to an account. Without MODA, you would have to re-key all of the capabilities that the account currently has and then add SM to the list. With MODA, you simply add SM to the list. This concept applies to any modifiable attribute of an account, group, or user. Further, the same holds true for creating accounts, groups, and users.

The main mechanism used to make modifying and creating accounts so easy is MODA’s line- editor, which is called MODIFY. Whenever you want to modify an object, MODA displays a fully- specified MPE ALT command on the screen which you edit to suit your needs. Using MODIFY’s editing commands (see "MPE File Codes") you simply change the line to look the way you want it to, and then press Enter to execute the command. A brief summary of MODIFY’s commands is provided later in this chapter.

In addition to these time-saving commands, MODA also has commands for cloning accounts and sync-ing accounts. MODA’s CLONEACCT command can be used for duplicating all aspects of an account’s structure into a new account structure. This functionality is ideal for facilitating version control. MODA’s COPYACCT command is used to bring two accounts in sync with regard to account structure. For example, if you wanted account A to have all of the groups and users that account B has, you would simply use MODA’s COPYACCT command to do this.

MODA uses the MPE COMMAND intrinsic for maximum compatibility with future releases of MPE/iX.

Capabilities

The Account, NewAccount, and CLONExxx commands require the user to have SM capability. All other commands require AM or SM capability.

Usage

MODA can be run from either the supplied UDC or from a fully-qualified RUN statement.

UDC

:MODA [<command> [,<command>] [...]]

RUN

:RUN MODA.PUB.LPSTOOLS;INFO="[<command> <command>...]"

MODA is typically run without parameters.

Command Summary

The following list provides a summary description of MODA commands, which can be used to quickly locate the command that suits the task at hand. Detailed information on each command is provided in the next section.

NOTE Most MODA commands can be abbreviated to one or two letters. Command names are shown with mixed upper case and lower case letters, where the minimum abbreviation is indicated by the upper case letters.

Table 12.1 MODA Commands

Command Code	Description
Account	Displays account attributes
CLONEaccount	Clones account structure to new account
COPYaccount	Copies attributes to existing account
Exit	Terminates MODA
Group	Displays group attributes
HELP	Invokes MODA help
NewAccount	Edits attributes for a new account
NewGroup	Edits attributes for a new group
NewUser	Edits attributes for a new user
User	Displays attributes for a user

Command Definitions

Following is a detailed description of each MODA command.

NOTE Brackets ([]) are used to indicate optional parameters. Angle brackets (<>) are used to denote a parameter to be filled in.

Account

This command has the following syntax:

Account <name> [ <subset> ]

The ACCOUNT command displays the attributes for the specified account. These attributes may be edited as required. If the account does not exist, an error is reported. Using the ACCOUNT command requires SM capability.

subset is one (or more) of the following, optionally separated by blanks:

ACCess CAPability CONnect CPU FILES HOME LOCattr MAXPRI PASSword

When a subset is supplied, only those fields will be displayed for editing. If no subset is found, then all of the attributes (fields) for the account, group and/or user will be displayed. The keywords for subset may be abbreviated to just the uppercase portion shown above.

For example, to change just the capabilities for account "FOO", you could enter:

:MODA A FOO CAP

CLONEaccount

This command has the following syntax:

CLONEaccount <oldacct> <newacct> [ ACAP = ALL ] [Quiet] [NOPASS]

[ GCAP = ALL ] [ UCAP = ALL ]

The CLONEACCOUNT command replicates (clones) the accounting structure of an existing account into a new account. The newacct will be created with the same attributes as the oldacct.

For every user and group within oldacct, a duplicate will be created within newacct. The groups and users created within newacct will have the same attributes as oldacct.

Note that UDC settings and Private Volume information is not replicated from oldacct to newacct.

The COPYACCOUNT and CLONEACCOUNT commands are very similar. The COPYACCOUNT command requires that newacct must already exist, while the CLONEACCOUNT command requires that newacct must NOT currently exist.

If the ACAP = ALL option is used, then the newacct will have all capabilities, rather than the set from oldacct.

If the GCAP = ALL option is used, then every group within newacct will have all available capabilities, rather than the set from the original groups from oldacct.

If the UCAP = ALL option is used, then every user within newacct will have all available capabilities, rather than the set from the original users from oldacct.

The NOPASS keyword will cause the newacct and all of its groups and users to be created without passwords.

The QUIET keyword will cause most of the information generated by the CLONEACCOUNT command to be suppressed.

COPYaccount

This command has the following syntax:

COPYaccount <oldacct> <newacct> [ ACAP = ALL ] [QUIET] [NOPASS]

[CREATE] [ GCAP = ALL ] [ UCAP = ALL ]

The COPYACCOUNT command copies the attributes from oldacct to newacct for the account, and for every user and group within oldacct. Only those groups and users within newacct that also appear within oldacct will be affected unless the CREATE keyword is used.

The COPYACCOUNT and CLONEACCOUNT commands are very similar. The COPYACCOUNT command requires that newacct must already exist, while the CLONEACCOUNT command requires that newacct must NOT currently exist.

CREATE	Instructs the COPYACCOUNT command to create within newacct any group or user found within oldacct that does not currently exist.
ACAP = ALL	If this option is used, then the newacct will have all capabilities, rather than the set from oldacct.
GCAP = ALL	If this option is used, then every group within newacct will have all available capabilities, rather than the set from the original groups from oldacct.
UCAP = ALL	If this option is used, then every user within newacct will have all available capabilities, rather than the set from the original users from oldacct
NOPASS	This keyword will cause the passwords for newacct and all of its groups and users to be remain unchanged.
QUIET	This keyword will cause most of the information generated by the COPYACCOUNT command to be suppressed.

Exit or //

The Exit command terminates MODA. MODA also accepts // as a synonym for EXIT.

Group

This command has the following syntax:

Group <name> [ <subset> ]

The GROUP command will display the attributes for the specified group for editing. If the group does not exist, an error is reported.

You can edit attributes of groups in accounts other than your logon account by specifying the group as group.account. For example, to edit just the password for the group PUB in the account HPOFFICE, you could enter:

G PUB.HPOFFICE, PASS

HELP

The HELP command invokes the MODA help facility.

NewAccount

This command has the following syntax:

NewAccount [ <templateaccount> ] [ , CAP = ALL ]

The NEWACCOUNT command (minimum abbreviation NA) is used to edit the attributes for a new account. If NEWACCOUNT is entered without a templateaccount, then a default set of attributes is chosen for editing. If a templateaccount is entered, then MODA will fetch the attributes for that account and display them for editing. The templateaccount provides a simple way to create a new account with the same attributes as an existing account.

CAP=ALL tells MODA that the attributes for editing should have all possible capabilities.

Example 1: Creating a new account without a template, with "ordinary" capabilities:

NEWACCOUNT FOO

This will present text to be edited that looks like:

:NEWACCT FOO,MGR;CAP=AM,AL,GL,DI,UV,LG,PS,CS,ND,SF,BA,IA,MR,DS,PH;

ACCESS=(A,W,X,R,L:AC);MAXPRI=CS;LOCATTR=0;FILES=;CPU=;

CONNECT=;PASS=

Example 2: Creating a new account without a template, with all capabilities:

NA FOO,CAP=ALL

This will present text to be edited that looks like:

:NEWACCT FOO,MGR;CAP=SM,AM,AL,GL,DI,OP,CV,UV,LG,PS,NA,NM,CS,ND,

SF,BA,IA,PM,MR,DS,PH;ACCESS=(A,W,L,X:AC);

MAXPRI=CS;LOCATTR=0;FILES=;CPU=;CONNECT=;PASS=

Example 3: Creating a new account, FOO, that looks like the LPSTOOLS account:

NEWACCOUNT LPSTOOLS

This will result in a note:

LPSTOOLS exists, used as a template

and will present text to be edited that looks like:

:NEWACCT ? ,MGR;CAP=SM,AM,AL,GL,DI,OP,CV,UV,LG,CS,ND,

SF,BA,IA,PM,MR,DS,PH;ACCESS=(A:AC;W:AC;L:ANY;X:ANY);

MAXPRI=CS;LOCATTR=0;FILES=;CPU=;CONNECT=;PASS=

The "?" should be edited to be "FOO".

NewGroup

This command has the following syntax:

NewGroup [ <templateaccount> ] [ , CAP = ALL ]

The NEWGROUP command (minimum abbreviation NG) is used to edit the attributes for a new group. If NEWGROUP is entered without a templategroup, then a default set of attributes is chosen for editing. If a templategroup is entered, then MODA will fetch the attributes for that group and display them for editing. The templategroup provides a simple way to create a new group with the same attributes as an existing group.

CAP=ALL tells MODA that the attributes for editing should have all possible capabilities.

MODA will report if the templategroup exists.

See "NewAccount" for examples similar to NEWGROUP.

NewUser

This command has the following syntax:

NewUser [ <templateuser> ] [ , CAP = ALL ]

The NEWUSER command (minimum abbreviation NU) is used to edit the attributes for a new user. If NEWUSER is entered without a templateuser, then a default set of attributes is chosen for editing. If a templateuser is entered, then MODA will fetch the attributes for that user and display them for editing. The templateuser provides a simple way to create a new user with the same attributes as an existing user.

CAP=ALL tells MODA that the attributes for editing should have all possible capabilities.

MODA will report if the templateuser exists.

See "NewAccount" for examples similar to NEWUSER.

User

This command has the following syntax:

User <name> [ <subset> ]

The USER command will display the attributes for the specified user for editing. If the user does not exist, an error is reported.

You can edit attributes of user in accounts other than your logon account by specifying the user as user.account. For example, to edit just the local attributes for the user MARY in the account ACCTNG, you could enter:

USER MARY.ACCTNG, LOC

Selected Summary for the MODIFY Editor Commands

These commands are provided here as a convenient reference to the more common commands used in editing the ALTACCT statement.

NOTE The following command codes are invoked by pressing the letter while holding down the "Ctrl" key.

Table 12.2 MODIFY Editor Commands

Command Code	Description
^A	Goto end of line (append)
^B	Activate Insert mode
^D	Delete the character at the cursor position
^E	Erase contents from the cursor position to end-of-line
^G	Oops, undo changes
^H	Backspace (non-destructive) cursor left
^O	Activate Overwrite mode
^Y	Abort changes
<Spacebar>	Space bar operations move the cursor to the right

NOTE Pressing ^A (Ctrl+A) or ^B (Ctrl+B) on the system console keyboard invokes special system-management related modes rather than the actions noted above. For instance, ^A invokes CONSOLE mode. if you accidentally go into console mode, press Return to quit. If you press ^B at the system console, type "CO" followed by Return.

See "The MODIFY Editor" for a complete description of the MODIFY editor.

TOOLBOX STANDARDS

The ToolBox collections from Lund Performance Solutions have a uniform user interface. As a result, in addition to the commands specific to each Toolbox tool, most tools allow the commands described in "TOOLBOX STANDARDS".

MODA Examples

Following is an example of the MODA tool CLONEACCOUNT command.

Figure 12.1 Clone Account

MODA Error Messages

Each BETIMES error message is described in the following table.

Table 12.3 MODA Error Messages

Message	Cause	Action
Expected valid account name	User entered an account-name that does not conform with the convention established by Hewlett-Packard for account names.	Review NEWACCT section in the MPE/iX Command Reference Manual for a complete description of the format for account names.
Expected valid group name	User entered a group-name that does not conform with the convention established by Hewlett-Packard for group names.	Review NEWGROUP section in the MPE/iX Command Reference Manual for a complete description of the format for group names.
Expected valid user name	User entered a user-name that does not conform with the convention established by Hewlett-Packard for user names.	Review NEWACCT section in the MPE/iX Command Reference Manual for a complete description of the format for user names.
You must have AM or SM capability to run this program.	User who tried to run MODA did not have adequate capabilities to run MODA.	Log into an account that has proper capabilities or run GRANT from the System Manager’s Toolbox to temporarily give yourself the necessary capabilities.