This command replaces the previously assigned access control entries with UIC [PAYUP,*], ACCESS=CONTROL.

Ends an AAU session and returns you to the DCL prompt.

Format

EXIT

Privileges Required

None

Note

You can also end an AAU session by pressing [Ctrl/Z]. [Ctrl/Z] signals the end of the file for data entered from the terminal. [Ctrl/Z] is displayed as EXIT.

Example

AAU> EXIT
$ 
      

The EXIT command stops AAU and returns you to the DCL prompt.

Displays information about AAU commands and qualifiers.

Format

HELP [ topic [...]]

Command Qualifier	Default
/[NO]PROMPT	/PROMPT

Privileges Required

None

Parameters

topic

The AAU command or qualifier you want information about. If you do not specify a topic, AAU help provides you with a list of topics to choose from.

Qualifiers

/[NO]PROMPT

Controls whether or not you receive prompts for topics and subtopics. The /PROMPT qualifier displays help prompts and is the default. With the /NOPROMPT qualifier, the HELP command does not display prompts.

Notes

None

Example

AAU> HELP ADD
ADD
   Adds an authorization record to the application authorization
   database file ACMSAAF.DAT. This authorizes one for more users
   to install an application database file in ACMS$DIRECTORY.
   Format:
       ADD application-name [/qualifiers]
   For example:
       AAU> ADD PERSONNEL /APPL_USERNAME=FIDDLE
   You can use qualifiers to assign authorization characteristics or
   let new authorizations automatically receive information from the
   DEFAULT authorization.
   To create an authorization for a single application, use the name of
   that application as the application name. To create an authorization
   for all applications, use the keyword $ALL as the application name.
  Additional information available:
  Parameter  Qualifiers
ADD Subtopic? 
      

This command displays help information about the ADD command.

Writes the contents of an authorization to ACMSAAU.LIS in your default directory or to an output file you specify.

Format

LIST application-name

Command Qualifiers	Defaults
/BRIEF	Full authorizations
/OUTPUT=[file-spec]	/OUTPUT=ACMSAAU.LIS

Privileges Required

None

Parameters

application-name

The name of the application you want to list. The name can be $ALL, DEFAULT, the wildcard character (*), or a valid RMS file name of up to 39 characters. Use the wildcard character (*) as a prefix , as a suffix, or as a combination of prefix and suffix.

Qualifiers

/BRIEF

Lists only the application authorization names. The default is to list the complete authorizations.

/OUTPUT=[file-spec]

Copies one or more application authorizations to a file you name. If you do not include a file specification, AAU uses the ACMSAAU.LIS file by default and puts the list file in your current default directory.

Notes

To write all definitions to an output file, use the wildcard character (*) as the user name. To print a listing file, use the DCL PRINT command after you have finished your AAU session. To display the contents of an output file on the terminal, use the DCL TYPE command.

Examples

AAU> LIST PERSONNEL *
      

This command writes to an output file all information contained in the PERSONNEL authorization.

AAU> LIST * /BRIEF
      

This command writes to an output file a list of all authorized application names only.

AAU> LIST *
      

This command writes all authorizations in the ACMSAAF.DAT authorization database file to the ACMSAAU.LIS file in your default directory.

AAU> LIST B*
      

This command writes the authorizations for all application names beginning with the letter B to an output file.

Changes information in an application authorization.

Format

MODIFY application-name

Command Qualifiers	Default
/ACL=(access-control-list[,...])	From existing authorization
/APPL_USERNAME=user-name	From existing authorization
/[NO]DYNAMIC_USERNAMES	From existing authorization
/SRV_USERNAMES[=(server-user-name[,...])]	From existing authorization
/[NO]WILD_SUFFIX	From existing authorization

Privileges Required

None

Parameters

application-name

The application name for the authorization you are changing. The name can be a valid RMS file name of up to 39 characters, $ALL, or DEFAULT. Use the wildcard character (*) as a prefix, as a suffix , or as both.

Qualifiers

/ACL=(access-control-list[,...])

The /ACL qualifier authorizes a user to install an application database file in ACMS$DIRECTORY. The Access Control List identifies who can and who cannot install an application. See the description of the /ACL qualifier under the ADD command for more information about the /ACL qualifier and rules for specifying Access Control Lists.

/APPL_USERNAME=user-name

Identifies the user name of an application. The ACMS/INSTALL command does not install the application database file in ACMS$DIRECTORY unless the application user name in the application database file matches the one you specify with the /APPL_USERNAME qualifier. If you specify the wildcard character (*) instead of a user name, the wildcard user name automatically matches any user name specified in the application that a user tries to install.

By default, AAU uses the setting assigned in the DEFAULT authorization. AAU assigns the default setting /APPL_USERNAME=* when the ACMSAAF.DAT file is first created.

/[NO]DYNAMIC_USERNAMES

Allows a user to install an application database file if the setting you assign with the /[NO]DYNAMIC_USERNAMES qualifier matches that in the application. For example, if you do not want an application installed that allows servers to use dynamic user names or "USERNAME OF SUBMITTER", use the /NODYNAMIC_USERNAMES qualifier. If you want an application installed that allows servers to use dynamic user names, use the /DYNAMIC_USERNAMES qualifier.

By default, AAU uses the setting assigned in the DEFAULT authorization. AAU assigns /NODYNAMIC_USERNAMES as the default setting when the ACMSAAF.DAT file is first created.

/SRV_USERNAMES[=(server-user-name[,...])]

Specifies one or more server user names that are associated with the application you are authorizing. The ACMS/INSTALL command installs an application if the server user names that you specify with the /SRV_USERNAMES qualifier match those in the application database file. If you specify the wildcard character (*) for a server user name, the wildcard user name automatically matches all server user names specified in the application.

If you do not want to authorize any server user names, include the /SRV_USERNAMES qualifier without any specifiers. For example:

AAU> MODIFY INVESTMENT /SRV_USERNAMES

By default, AAU uses the setting assigned in the DEFAULT authorization. AAU assigns the default setting /SRV_USERNAMES=* when the ACMSAAF.DAT file is first created.

/[NO]WILD_SUFFIX

Allows a user to install or prevents a user from installing any application whose name begins with the letters of the application name you are authorizing. For example, the following command allows the user with UIC [PERSONNEL,RICHARD] to install any application name that starts with the letters INVAPPL:

AAU> MODIFY INVAPPL /ACL=(IDENTIFIER=[PERSONNEL,RICHARD], - _AAU> ACCESS=CONTROL)/WILD_SUFFIX

Once this command is in effect, user [PERSONNEL,RICHARD] can install applications with names such as INVAPPL, INVAPPL1, and INVAPPL2.

By default, AAU uses the setting assigned in the DEFAULT authorization. AAU assigns the default setting /NOWILD_SUFFIX when the ACMSAAF.DAT file is first created.

Notes

The AAU MODIFY command does not invoke an editor.

Both the DEFAULT and the MODIFY commands let you modify the DEFAULT authorization. The DEFAULT command, however, lets you change the DEFAULT authorization only. The MODIFY command serves a more general use and lets you modify any authorization in the ACMSAAF.DAT database file.

Examples

AAU> MODIFY PERSONNEL /APPL_USERNAME=ACCOUNT*
      

This command assigns the application user name ACCOUNT to the PERSONNEL authorization. The new application user name replaces the old one.

AAU> MODIFY EMPLOYEE /SRV_USERNAMES=(TRAINING_SRV)
      

This command replaces the old server user name with TRAINING_SRV.

AAU> MODIFY EMPLOYEE /WILD_SUFFIX
      

This command adds the wildcard characteristic to the EMPLOYEE authorization. Users authorized to install EMPLOYEE can also install any application that begins with the letters EMPLOYEE, such as EMPLOYEE1 or EMPLOYEE2.

Deletes an authorization from the ACMSAAF.DAT application authorization database file.

Format

REMOVE application-name

Privileges Required

None

Parameters

application-name

The name of the application authorization you are deleting. It can be a valid RMS file name of up to 39 characters or $ALL. It cannot be DEFAULT because AAU does not allow you to delete the DEFAULT authorization.

Notes

None

Examples

AAU> REMOVE PERSONNEL
      

This command deletes the authorization that has the application name PERSONNEL.

AAU> REMOVE $ALL
      

This command deletes the $ALL authorization. As a result, you may need to create individual authorizations for applications that you want authorized users to install.

Gives an application authorization a new name.

Format

RENAME old-application-name new-application-name

Command Qualifiers	Default
/ACL=(access-control-list[,...])	From old authorization
/APPL_USERNAME=user-name	From old authorization
/[NO]DYNAMIC_USERNAMES	From old authorization
/SRV_USERNAMES[=(server-user-name[,...])]	From old authorization
/[NO]WILD_SUFFIX	From old authorization

Privileges Required

None

Parameters

old-application-name

The application name for the old authorization you are renaming. It can be a valid RMS file name of up to 39 characters or $ALL. It cannot be DEFAULT; AAU does not let you rename the DEFAULT authorization.

new-application-name

The application name you give to the new authorization. The new application name can be a valid RMS file name of up to 39 characters or $ALL.

Qualifiers

/ACL=(access-control-list[,...])

The /ACL qualifier authorizes a user to install an application database file in ACMS$DIRECTORY. The Access Control List identifies who can and who cannot install an application. See the description of the /ACL qualifier under the ADD command for more information about the /ACL qualifier and rules for specifying Access Control Lists.

/APPL_USERNAME=user-name

Identifies the user name of an application. The ACMS/INSTALL command does not install the application database file in ACMS$DIRECTORY unless the application user name in the application database file matches the one you specify with the /APPL_USERNAME qualifier. If you specify the wildcard character (*) instead of a user name, the wildcard user name automatically matches any user name specified in the application that a user tries to install.

By default, AAU uses the setting assigned in the DEFAULT authorization. AAU assigns the default setting /APPL_USERNAME=* when the ACMSAAF.DAT file is first created.

/[NO]DYNAMIC_USERNAMES

Allows a user to install an application database file if the setting you assign with the /[NO]DYNAMIC_USERNAMES qualifier matches that in the application. For example, if you do not want an application installed that allows servers to use dynamic user names or "USERNAME OF SUBMITTER", use the /NODYNAMIC_USERNAMES qualifier. If you want an application installed that allows servers to use dynamic user names, use the /DYNAMIC_USERNAMES qualifier.

By default, AAU uses the setting assigned in the DEFAULT authorization. AAU assigns /NODYNAMIC_USERNAMES as the default setting when the ACMSAAF.DAT file is first created.

/SRV_USERNAMES[=(server-user-name[,...])]

Specifies one or more server user names that are associated with the application you are authorizing. The ACMS/INSTALL command installs an application if the server user names that you specify with the /SRV_USERNAMES qualifier match those in the application database file. If you specify the wildcard character (*) for a server user name, the wildcard user name automatically matches all server user names specified in the application.

If you do not want to authorize any server user names, include the /SRV_USERNAMES qualifier without any specifiers. For example:

$ AAU> RENAME INVESTMENT /SRV_USERNAMES

By default, AAU uses the setting assigned in the DEFAULT authorization. AAU assigns the default setting /SRV_USERNAMES=* when the ACMSAAF.DAT file is first created.

/[NO]WILD_SUFFIX

Allows a user to install or prevents a user from installing any application whose name begins with the letters of the application name you are authorizing. For example, the following command allows the user with UIC [PERSONNEL,RICHARD] to rename any application name that starts with the letters INVAPPL:

AAU> RENAME INVAPPL /ACL=(IDENTIFIER=[PERSONNEL,RICHARD], - _AAU> ACCESS=CONTROL)/WILD_SUFFIX

Once this command is in effect, user [PERSONNEL,RICHARD] can rename applications with names such as INVAPPL, INVAPPL1, and INVAPPL2.

By default, AAU uses the setting assigned in the DEFAULT authorization. AAU assigns the default setting /NOWILD_SUFFIX when the ACMSAAF.DAT file is first created.

Note

The new application name must be unique in the ACMSAAF.DAT file.

Examples

AAU> RENAME PERSONNEL EMPLOYEE /ACL=(ID=[PERSONNEL,RICHARD], -
_AAU> ACCESS=CONTROL)/APPL_USERNAME=MERCHANT /SRV_USERNAMES -
_AAU> =MERCHANT_SRV
      

This command changes the application name from PERSONNEL to EMPLOYEE. The /ACL qualifier replaces the old access control entry with UIC [PERSONNEL,RICHARD]. The /APPL_USERNAME qualifier changes the application user name to MERCHANT. Finally, the SRV_USERNAMES qualifier replaces any previously assigned server user names with the user name MERCHANT_SRV. The hyphen (-) at the end of a command allows you to continue the command on a new line, and the AAU> prompt shows you when to enter the rest of your command.

AAU> RENAME MEDICAL SURGICAL /WILD_SUFFIX
      

This command changes the application name in the authorization from MEDICAL to SURGICAL. It also gives the wildcard characteristic to the new authorization. Application names with this characteristic allow users to specify with the ACMS/INSTALL operator command any application name that begins with the letters of the word SURGICAL. For example, the ACMS/INSTALL operator command lets a user install application names, such as SURGICAL1, SURGICALTEAM, or SURGICAL2.

Displays information about application authorizations on your terminal screen.

Format

SHOW application-name

Command Qualifier	Default
/BRIEF	Displays full authorizations

Privileges Required

None

Parameters

application-name

The name of an application authorization that you want to display on your terminal screen. The name can be a valid RMS file name of up to 39 characters, $ALL, DEFAULT, or the wildcard character (*). You can also use the wildcard character as a prefix, as a suffix, or as both.

Qualifiers

/BRIEF

Displays only the application names of all authorizations in the ACMSAAF.DAT file. By default, the SHOW command displays the contents of all authorizations in ACMSAAF.DAT.

Note

To display the contents of all authorizations in the ACMSAAF.DAT file, use the wildcard character (*) as the application name.

Examples

AAU> SHOW *
      

With the wildcard character (*) as the application name, you can display the contents of all authorizations in the ACMSAAF.DAT file.

AAU> SHOW PERSONNEL*
      

You list the contents of the authorization that has the application name PERSONNEL.

AAU> SHOW * /BRIEF
      

The /BRIEF qualifier on the SHOW command lets you see all the application names in the ACMSAAF.DAT file, without having to list all information associated with each application name.

AAU> SHOW B*
      

The SHOW command displays authorizations for all application names beginning with the letter B.