# Compaq ACMS for OpenVMS
Managing Applications

Previous | Contents | Index

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

# EXIT Command (AAU>)

> 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.

# HELP Command (AAU>)

> 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.

# LIST Command (AAU>)

> 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

#1
    AAU> LIST PERSONNEL *

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

#2
    AAU> LIST * /BRIEF

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

#3
    AAU> LIST *

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

#4
    AAU> LIST B*

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

# MODIFY Command (AAU>)

> 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

#1
    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.

#2
    AAU> MODIFY EMPLOYEE /SRV_USERNAMES=(TRAINING_SRV)

> This command replaces the old server user name with TRAINING_SRV.

#3
    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.

# REMOVE Command (AAU>)

> 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

#1
    AAU> REMOVE PERSONNEL

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

#2
    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.

# RENAME Command (AAU>)

> 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

#1
    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.

#2
    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.

# SHOW Command (AAU>)

> 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

#1
    AAU> SHOW *

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

#2
    AAU> SHOW PERSONNEL*

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

#3
    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.

#4
    AAU> SHOW B*

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

Previous | Next | Contents | Index