Examples

Note The following examples assume that the proxy file is empty.

UDU> CREATE /PROXY
UDU> ADD /PROXY COMET::PERSONNEL PERS_USER
UDU> SHOW /PROXY *
Remote User: COMET::PERSONNEL                Local User: PERS_USER
      

In this example, the ADD command adds a single proxy that allows the user on node COMET with user name PERSONNEL to select a task on the application node using the user name of PERS_USER.

UDU> ADD /PROXY COMET::* RENTAL_AGENT
UDU> SHOW /PROXY *
Remote User: COMET::*                       Local User: RENTAL_AGENT 
Remote User: COMET::PERSONNEL               Local User: PERS_USER
      

In this example, the ADD command specifies that any remote user except PERSONNEL on node COMET can select a task on the application node using the user name RENTAL_AGENT. When user PERSONNEL on node COMET selects a task on the application node, the local user name is PERS_USER, because there is a specific proxy for COMET::PERSONNEL. The asterisk is interpreted as a literal in the ADD /PROXY command.

UDU> ADD /PROXY *::BICKFORD *
UDU> SHOW /PROXY *
Remote User: *::BICKFORD                    Local User:* 
Remote User: COMET::*                       Local User: RENTAL_AGENT 
Remote User: COMET::PERSONNEL               Local User: PERS_USER
      

In this example, the ADD command specifies that remote task submitters with the user name BICKFORD on any remote node can select a task on the application node using the same user name.

Authorizes and assigns sign-in characteristics to ACMS users by creating new UDU definitions from existing UDU definitions. With qualifiers, you can assign different sign-in characteristics to the new definitions.

Format

COPY source-user-name new-user-name

Command Qualifiers	Default
/[NO]AGENT	From source definition
/[NO]DISPLAY_MENU	From source definition
/[NO]FINAL=(keyword[,...])	From source definition
/[NO]INITIAL=(keyword[,...])	From source definition
/LANGUAGE[=language-name]	From source definition
/MDB=menu-database-file	From source definition
/MENU[=menu-path-name]	From source definition
/PRINTFILE = print-file-spec spooled-device-name	From source definition
/[NO]SKIPMENULANGUAGE	From source definition

Privileges Required

None

Parameters

source-user-name

The OpenVMS user name in the source definition. The source user name can be $ALL.

new-user-name

The OpenVMS user name for the new definition. The new user name can be $ALL.

Qualifiers

/[NO]AGENT

The /AGENT qualifier enables an agent to submit a task that has a user name different from the user name of the agent process. You must use the /AGENT qualifier to authorize the CP and the QTI as agents. If your system has other agent programs that submit tasks of this type, you must also authorize them with the /AGENT qualifier. You must use the /AGENT qualifier for any user name that a detached task runs under. Use the /NOAGENT qualifier when an agent program no longer submits tasks for processing that run under user names other than the submitting agent program. The default is whatever is defined in the source definition.

/[NO]DISPLAY_MENU

The /DISPLAY_MENU qualifier enables the menu display identified in the user's definition and the Selection: prompt once the user signs in. A menu is identified by a menu path name and a menu database file. If a user's definition has the NODISPLAY_MENU characteristic, ACMS displays only the Selection: prompt after the user signs in, without a full default menu. The /NODISPLAY_MENU qualifier disables the menu display. The default is whatever is defined in the source definition.

/[NO]FINAL=(keyword[,...])

Specifies a task that is run when the user exits from ACMS. If you do not specify the /[NO]FINAL qualifier, the default is taken from the source definition.

Specify one or more of the following keywords. If you specify more than one keyword, you must enclose the keywords in parentheses.

• APPLICATION=application-name
  Specifies the application in which the final task is run. When you specify the APPLICATION keyword, you must also specify a task name with the TASK keyword.
• [NO]IGNORE_ERROR
  Specifies that errors in the final task are ignored. If an error occurs in the final task, ACMS does not display an error message or record information about the error in the audit trail log file.
• [NO]SELECTION_STRING="string"
  Specifies a parameter required by the final task. For example, if the final task is an editor, "string" is the file specification of the file to be edited. Enclose the string in quotation marks.
• TASK=task-name
  Specifies the name of the final task.

/[NO]INITIAL=(keyword[,...])

Specifies the task that is run when the user enters the ACMS environment. The default is taken from the source definition.

Specify one or more of the following keywords. If you specify more than one keyword, you must enclose the keywords in parentheses.

• APPLICATION=application-name
  Specifies the application in which the initial task is run. When you specify the APPLICATION keyword, you must also specify a task name with the TASK keyword.
• [NO]IGNORE_ERROR
  Specifies that errors in the initial task are ignored. By default, if an error occurs in an initial task, an error message is displayed on the user's terminal, the reason for the error is recorded in the audit trail log, and the user is signed out of ACMS.
• [NO]SELECTION_STRING="string"
  Specifies a parameter required by the initial task. For example, if the initial task is an editor, "string" is the file specification of the file to be edited. Enclose the string in quotation marks.
• TASK=task-name
  Specifies the name of the initial task.

/LANGUAGE[=language-name]

Assigns a language to a user in a UDU definition. ACMS matches the language assigned to a user with the language assigned to a DECforms form layout and displays panels in the selected language. The default is taken from the source definition.

/MDB=menu-database-file

Assigns a menu database file to a UDU definition. A menu database file is a file of run-time menu definitions created by the Application Definition Utility (ADU) BUILD command. The ACMS run-time system assumes ACMS$DIRECTORY as the default directory and .MDB as the default file type for menu database files in UDU definitions. The default is whatever is defined in the source definition.

/MENU[=menu-path-name]

Assigns a menu to a UDU definition. The menu path name is the location of a run-time menu definition in a menu database file. Users cannot see menus whose path names are higher in the menu tree than their default menu path names. Path names for all menus except the highest menu consist of strings of menu keywords. If you do not know the path name to include with the /MENU qualifier, you can derive the menu path name from menu keywords, as explained in Compaq ACMS for OpenVMS ADU Reference Manual.

You can define menu entries that contain slashes in the menu definition; however, you cannot specify menu paths containing these slashes in the UDU.

For example, the following format is not allowed:

UDU> MODIFY SMITH /MENU="TOP/V32.SUBMENU"

If you do not specify a path name and there is no path name defined in the source definition, the user receives a blank path name. When a blank path name is defined, the user receives the top menu in the menu database file when signing in.

/PRINTFILE=print-file-spec
/PRINTFILE=spooled-device-name

Use this qualifier to specify a file name or spooled device name for a user. When a form is enabled, ACMS uses the Printfile specification for a device assigned in DDU, if it is available. If it is not, ACMS uses the Printfile specification for the user.

To use the Printfile feature, you must also include a PRINT response step in the DECforms source IDFL file that contains the specifications of the panel that you want to print.

/[NO]SKIPMENULANGUAGE

Use this qualifier with the /LANGUAGE qualifier to specify that a language is to be assigned to a user for all DECforms forms except menu forms. For example, with the /SKIPMENULANGUAGE qualifier you can specify that DECforms display all panels in French except menu panels.

Notes

None

Examples

UDU> COPY COURTS WILSON
      

This command creates a user definition for WILSON, copying all the information from the definition for COURTS.

UDU> COPY TRACY MORRIS /MENU=EMPLOYEE
      

This command creates a user definition for MORRIS, copying information from the definition for TRACY. The /MENU qualifier assigns MORRIS a different default menu path name, EMPLOYEE.

UDU> COPY STEVENS SMITH /MENU
      

This command creates a user definition for SMITH, copying information from the definition for STEVENS. The /MENU qualifier overrides the path name from the STEVENS definition, so the definition for SMITH receives a blank path name. After signing in, SMITH receives the top menu in the menu database file.

Creates an empty ACMS proxy file (ACMSPROXY.DAT).

Format

CREATE /PROXY

Note

Creates an empty ACMS proxy file, ACMSPROXY.DAT. If you define the ACMSPROXY logical name and then enter the UDU CREATE /PROXY command, the empty proxy file is created at the location defined by the ACMSPROXY logical name. If you do not define the ACMSPROXY logical name, UDU creates ACMSPROXY.DAT in your current directory. If the proxy file already exists, UDU returns an error message.

Example

UDU> CREATE /PROXY 
      

This command creates an ACMS proxy file.

Changes information in the UDU DEFAULT definition. If you omit one or more qualifiers from an ADD command, the resulting new definition receives information from the existing DEFAULT definition.

Format

DEFAULT

Command Qualifiers	Default
/[NO]AGENT	From existing DEFAULT definition
/[NO]DISPLAY_MENU	From existing DEFAULT definition
/[NO]FINAL=(keyword[,...])	From existing DEFAULT definition
/[NO]INITIAL=(keyword[,...])	From existing DEFAULT definition
/LANGUAGE[=language-name]	From existing DEFAULT definition
/MDB=menu-database-file	From existing DEFAULT definition
/MENU[=menu-path-name]	From existing DEFAULT definition
/PRINTFILE = print-file-spec spooled-device-name	From existing DEFAULT definition
/[NO]SKIPMENULANGUAGE	From existing DEFAULT definition

Privileges Required

None

Qualifiers

/[NO]AGENT

The /AGENT qualifier enables an agent to submit a task that has a user name different from the user name of the agent process. You must use the /AGENT qualifier to authorize the CP and the QTI as agents. If your system has other agent programs that submit tasks of this type, you must also authorize them with the /AGENT qualifier. You must use the /AGENT qualifier for any user name that a detached task runs under. Use the /NOAGENT qualifier when an agent program no longer submits tasks for processing that run under user names other than the submitting agent program.

/[NO]DISPLAY_MENU

The /DISPLAY_MENU qualifier enables the menu display identified in the user's definition and the Selection: prompt once the user signs in. A menu is identified by a menu path name and a menu database file. If a user's definition has the NODISPLAY_MENU characteristic, ACMS displays only the Selection: prompt after the user signs in, without a full default menu. The /NODISPLAY_MENU qualifier disables the menu display.

/[NO]FINAL=(keyword[,...])

Specifies a task that is run when the user exits from ACMS. If you do not specify the /[NO]FINAL qualifier, the default is taken from the current DEFAULT definition.

Specify one or more of the following keywords. If you specify more than one keyword, you must enclose the keywords in parentheses.

• APPLICATION=application-name
  Specifies the application in which the final task is run. When you specify the APPLICATION keyword, you must also specify a task name with the TASK keyword.
• [NO]IGNORE_ERROR
  Specifies that errors in the final task are ignored. If an error occurs in the final task, ACMS does not display an error message or record information about the error in the audit trail log file.
• [NO]SELECTION_STRING="string"
  Specifies a parameter required by the final task. For example, if the final task is an editor, "string" is the file specification of the file to be edited. Enclose the string in quotation marks.
• TASK=task-name
  Specifies the name of the final task.

/[NO]INITIAL=(keyword[,...])

Specifies the task that is run when the user enters the ACMS environment. The default is taken from the current DEFAULT definition.

Specify one or more of the following keywords. If you specify more than one keyword, you must enclose the keywords in parentheses.

• APPLICATION=application-name
  Specifies the application in which the initial task is run. When you specify the APPLICATION keyword, you must also specify a task name with the TASK keyword.
• [NO]IGNORE_ERROR
  Specifies that errors in the initial task are ignored. By default, if an error occurs in an initial task, an error message is displayed on the user's terminal, the reason for the error is recorded in the audit trail log, and the user is signed out of ACMS.
• [NO]SELECTION_STRING="string"
  Specifies a parameter required by the initial task. For example, if the initial task is an editor, "string" is the file specification of the file to be edited. Enclose the string in quotation marks.
• TASK=task-name
  Specifies the name of the initial task.

/LANGUAGE[=language-name]

Assigns a language to a user in a UDU definition. ACMS matches the language assigned to a user with the language assigned to a DECforms form layout and displays panels in the selected language. The default is taken from the existing DEFAULT definition.

/MDB=menu-database-file

Assigns a menu database file to a UDU definition. A menu database file is a file of run-time menu definitions created by the Application Definition Utility (ADU) BUILD command. The ACMS run-time system assumes ACMS$DIRECTORY as the default directory and .MDB as the default file type for menu database files in UDU definitions.

/MENU[=menu-path-name]

Assigns a menu to a UDU definition. The menu path name is the location of a run-time menu definition in a menu database file. Users cannot see menus whose path names are higher in the menu tree than their default menu path names. Path names for all menus except the highest menu consist of strings of menu keywords. If you do not know the path name to include with the /MENU qualifier, you can derive the menu path name from menu keywords, as explained in the Compaq ACMS for OpenVMS ADU Reference Manual.

You can define menu entries that contain slashes in the menu definition; however, you cannot specify menu paths containing these slashes in the UDU.

For example, the following format is not allowed:

UDU> MODIFY SMITH /MENU="TOP/V32.SUBMENU"

If you do not specify a path name and there is no default path name defined in the existing DEFAULT definition, the user receives a blank path name. If a blank path name is defined, the user receives the top menu in the menu database file.

/PRINTFILE=print-file-spec
/PRINTFILE=spooled-device-name

Use this qualifier to specify a file name or spooled device name for a user. When a form is enabled, ACMS uses the Printfile specification for a device assigned in DDU, if it is available. If it is not, ACMS uses the Printfile specification for the user.

To use the Printfile feature, you must also include a PRINT response step in the DECforms source IDFL file that contains the specifications of the panel that you want to print.

/[NO]SKIPMENULANGUAGE

Use this qualifier with the /LANGUAGE qualifier to specify that a language is to be assigned to a user for all DECforms forms except menu forms. For example, with the /SKIPMENULANGUAGE qualifier you can specify that DECforms display all panels in French except menu panels.

Notes

ACMS creates a DEFAULT definition the first time you run UDU, or when you create a new user authorization file. ACMS assigns to the DEFAULT definition an initial display of the top-level menu and selection prompt, the menu database file specification ACMS$DIRECTORY:ACMS.MDB, and a blank menu path name.

The ADD command is the only command affected by the DEFAULT definition. When you use the ADD command to create a new UDU definition, the new definition takes the default information assigned in the DEFAULT definition. You can use qualifiers with the ADD command to override information from the DEFAULT definition.

Examples

UDU> DEFAULT /MENU=EMPLOYEE
      

This command assigns the default menu EMPLOYEE to the DEFAULT definition.

UDU> DEFAULT /MENU
      

This command assigns a blank menu path name to the DEFAULT definition. The user receives the top menu in the menu database file.

Ends the UDU session and returns you to DCL level.

Format

EXIT

Privileges Required

None

Note

You can also type [Ctrl/Z] to end a UDU session. [Ctrl/Z] signals the end of the file for data entered from the terminal. [Ctrl/Z] is displayed as EXIT.

Example

UDU> EXIT
$
      

This command ends a UDU session and returns you to the DCL prompt.

Displays information about UDU commands and qualifiers.

Format

HELP [ topic [...] ]

Command Qualifier	Default
/[NO]PROMPT	/PROMPT

Privileges Required

None

Parameters

topic

The UDU topic you want information about. If you do not supply a topic, HELP provides you with a list of topics to choose from.

Qualifiers

/[NO]PROMPT

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

Notes

None

Example

UDU> HELP LIST
LIST
   Writes User Definition Utility definitions to an output file.
   Format:
       LIST user-name
   For example:
       UDU> LIST *
  Additional information available:
  Parameter  Qualifiers
  /OUTPUT    /BRIEF
LIST Subtopic? 
Topic? 
 
      

This command displays information about the UDU LIST command.

Writes UDU definitions to ACMSUDU.LIS in your default directory, or to an output file you specify.

Format

LIST user-name

Command Qualifiers	Defaults
/BRIEF	Full definition
/OUTPUT[=file-spec]	/OUTPUT=ACMSUDU.LIS

Privileges Required

None

Parameters

user-name

The OpenVMS user name of the definition you are listing. You can use the wildcard character (*), $ALL, or DEFAULT as the user name. You can use the wildcard character to represent a partial user name.

Qualifiers

/BRIEF

Lists only the OpenVMS user names in definitions. The default is to list complete definitions.

/OUTPUT[=file-spec]

Copies one or more user definitions to a file you name. If you do not include a file specification, UDU uses the ACMSUDU.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 the listing file, use the DCL PRINT command after you have finished your UDU session. To display the contents of an output file, use the DCL TYPE command.

Examples

UDU> LIST CONNOR
      

This command writes the definition for CONNOR to the ACMSUDU.LIS output file.

UDU> LIST * /BRIEF
      

This command writes the user names in all UDU definitions to the output file ACMSUDU.LIS.

UDU> LIST *
      

The LIST command with the wildcard character (*) writes all definitions in the user authorization file (ACMSUDF.DAT) to the output file ACMSUDU.LIS.

UDU> LIST B*
      

This command uses the wildcard character (*) to write the definitions for user names beginning with the letter B to an output file.