# Compaq ACMS for OpenVMS
Quick Reference Guide

Previous | Contents | Index

## 2.5.3 DEFAULT Command (DDU>)

Changes information in the DDU DEFAULT definition.
DEFAULT

Command Qualifiers | Defaults
--- | ---
/[NO]AUTOLOGIN=username | From current DEFAULT definition
/[NO]CONTROLLED | From current DEFAULT definition
/PRINTFILE [ = print-file-spec | spooled-device-name ] | From current DEFAULT definition

## 2.5.4 EXIT Command (DDU>)

Ends the DDU session and returns to the DCL prompt.
EXIT

## 2.5.5 HELP Command (DDU>)

Displays information about DDU commands and qualifiers.
HELP [ topic [...] ]

Command Qualifiers | Defaults
--- | ---
/[NO]PROMPT | /PROMPT

## 2.5.6 LIST Command (DDU>)

Writes DDU definitions to ACMSDDU.LIS in your default directory, or to an output file you specify.
LIST device-name

Command Qualifiers | Defaults
--- | ---
/BRIEF | Full DDU definitions
/OUTPUT[=file-spec] | /OUTPUT=ACMSDDU.LIS

## 2.5.7 MODIFY Command (DDU>)

Changes the login characteristics in a DDU definition.
MODIFY device-name

Command Qualifiers | Defaults
--- | ---
/[NO]AUTOLOGIN=username | From current definition
/[NO]CONTROLLED | From current definition
/PRINTFILE [ = print-file-spec | spooled-device-name ] | From current definition

## 2.5.8 REMOVE Command (DDU>)

Removes a DDU definition from the device authorization file.
REMOVE device-name

## 2.5.9 RENAME Command (DDU>)

Changes the device name in a DDU definition.
RENAME old-device-name new-device-name

Command Qualifiers | Defaults
--- | ---
/[NO]AUTOLOGIN=username | From old definition
/[NO]CONTROLLED | From old definition
/PRINTFILE [ = print-file-spec | spooled-device-name ] | From old definition

## 2.5.10 SHOW Command (DDU>)

Displays DDU definitions.
SHOW device-name

Command Qualifiers | Defaults
--- | ---
/BRIEF | Full definition

# 2.6 Operator Commands

This section contains syntax for the ACMS operator commands. ACMS operator commands allow you to control the ACMS system and its components. See Compaq ACMS for OpenVMS Managing Applications for more information about ACMS operator commands and qualifiers.

## 2.6.1 ACMS/CANCEL TASK Command

Stops one or more task instances. With qualifiers, stops only the task instance you identify.
ACMS/CANCEL TASK [ task-name ]

Command Qualifiers | Defaults
--- | ---
/APPLICATION=application-name | All applications
/[NO]CONFIRM | /CONFIRM
/DEVICE=device-name | All devices
/IDENTIFIER=task-id | All tasks
/[NO]LOG | /NOLOG
/SUBMITTER=submitter-id | All submitters
/USER=user-name | All user names

## 2.6.2 ACMS/CANCEL USER Command

Cancels a user by stopping all of the user's outstanding tasks and by signing the user out of ACMS.
ACMS/CANCEL USER [ user-name ]

Command Qualifiers | Defaults
--- | ---
/[NO]CONFIRM | /CONFIRM
/DEVICE=device-name | All devices
/[NO]LOG | /NOLOG
/SUBMITTER=submitter-id | All submitters

## 2.6.3 ACMS/DEBUG Command

Starts the ACMS Task Debugger. This command allows you to test tasks and server procedures without building an entire ACMS application.
ACMS/DEBUG [task-group name]

Command Qualifiers | Defaults
--- | ---
/AGENT_HANDLE | None
/PID | None
/SERVER | None
/TWS_POOLSIZE[=n] | 350 pages (on VAX)
| 1600 pagelets (on Alpha)
/TWSC_POOLSIZE[=n] | 50 pages (on VAX)
| 50 pagelets (on Alpha)
/WORKSPACE | None

## 2.6.4 ACMS/ENTER Command

Allows a terminal that has logged in to OpenVMS to use the ACMS menu system.
ACMS/ENTER

Command Qualifiers | Defaults
--- | ---
/[NO]RETURN | /RETURN

## 2.6.5 ACMS/INSTALL Command

Installs an application in ACMS$DIRECTORY or removes an application database file from ACMS$DIRECTORY.
ACMS/INSTALL file-spec

Command Qualifiers | Defaults
--- | ---
/[NO]REMOVE | /NOREMOVE

## 2.6.6 ACMS/MODIFY APPLICATION Command

Modifies the attributes of an active application.
ACMS/MODIFY APPLICATION [ application-name[,...]]

Command Qualifiers | Defaults
--- | ---
/APPLICATION_ATTRIBUTES=(attribute[,...]) | None
/[NO]CONFIRM | /CONFIRM
/[NO]LOG | /NOLOG
/SERVER_ATTRIBUTES=(attribute[,...]) | None
/TASK_ATTRIBUTES=(attribute[,...]) | None

## 2.6.7 ACMS/REPLACE SERVER Command

Replaces a server image with a new version of that image. All subsequent tasks use the new image.
ACMS/REPLACE SERVER [ server-name[,...]]

Command Qualifiers | Defaults
--- | ---
/APPLICATION=application-name | All applications
/[NO]CONFIRM | /CONFIRM
/[NO]LOG | /NOLOG

## 2.6.8 ACMS/REPROCESS APPLICATION_SPEC Command

Causes ACMS to retranslate the application specification for an application and redirect all subsequent task selections to the application pointed to by the application specification.
ACMS/REPROCESS APPLICATION_SPEC application-spec

Command Qualifiers | Defaults
--- | ---
/[NO]CONFIRM | /CONFIRM
/[NO]LOG | /NOLOG

## 2.6.9 ACMS/RESET AUDIT Command

Resets the ACMS Audit Trail Log, and causes the current ACMS Audit Trail Log file to close and a new log file to open.
ACMS/RESET AUDIT

## 2.6.10 ACMS/RESET TERMINALS Command

Causes ACMS to read the Device Definition Utility (DDU) database file, authorize any new controlled terminals, and release any terminals no longer authorized.
ACMS/RESET TERMINALS

## 2.6.11 ACMS/SET QUEUE Command

Sets the processing characteristics of a started task queue. The processing characteristics are used by the queued task initiator (QTI) to process tasks in a queue.
ACMS/SET QUEUE queue-name[,...]

Command Qualifiers | Defaults
--- | ---
/TASK_THREADS=n | /TASK_THREADS=1

## 2.6.12 ACMS/SET SYSTEM Command

Depending on the qualifiers used, enables or disables Audit Trail logging, or enables or disables ACMS operator terminals.
ACMS/SET SYSTEM

Command Qualifiers | Defaults
--- | ---
/[NO]AUDIT | Current setting
/[NO]OPERATOR | Current setting
/PROCESS | Current setting
/TERMINAL=device-name | Current setting

## 2.6.13 ACMS/SHOW APPLICATION Command

Displays information about one or more active ACMS applications in static mode. See the ACMS/SHOW APPLICATION/CONTINUOUS command to display application information in continuous mode.
ACMS/SHOW APPLICATION [ application-name[,...]]

Command Qualifiers | Defaults
--- | ---
/CONNECTIONS | No connection information displayed
/DETACHED_TASKS | No detached task information displayed
/POOL | No pool information displayed
/SERVER_ATTRIBUTES | No server attributes displayed
/TASK_ATTRIBUTES | No task attributes displayed

## 2.6.14 ACMS/SHOW APPLICATION/CONTINUOUS Command

Displays information about an active ACMS application in continuous refresh mode.
ACMS/SHOW APPLICATION/CONTINUOUS application-name

Command Qualifiers | Defaults
--- | ---
/[NO]BEGINNING_TIME=time | /NOBEGINNING_TIME
/[NO]ENDING_TIME=time | /NOENDING_TIME
/[NO]INTERVAL[=seconds] | /NOINTERVAL
/[NO]OUTPUT[=file-spec] | /NOOUTPUT

## 2.6.15 ACMS/SHOW QTI Command

Displays the run-time characteristics of the queued task initiator (QTI).
ACMS/SHOW QTI

## 2.6.16 ACMS/SHOW QUEUE Command

Displays information about one or more task queues.
ACMS/SHOW QUEUE [ queue-name[,...]]

## 2.6.17 ACMS/SHOW SERVER Command

Displays information about one or more servers running under a specified application.
ACMS/SHOW SERVER [ server-name [,...] ]

Command Qualifiers | Defaults
--- | ---
/APPLICATION=application-name | All applications

## 2.6.18 ACMS/SHOW SYSTEM Command

Displays information about the ACMS run-time system, all local and remote users, and all local applications.
ACMS/SHOW SYSTEM

Command Qualifiers | Defaults
--- | ---
/POOL | No pool information displayed
/ALL | All processes using message-switch displayed

## 2.6.19 ACMS/SHOW TASK Command

Displays information about one or more active ACMS tasks executing on the local node.
ACMS/SHOW TASK [ task-name[,...]]

Command Qualifiers | Defaults
--- | ---
/APPLICATION=application-name | All applications
/DEVICE=device-name | All devices
/IDENTIFIER=task-id | All tasks
/SUBMITTER=submitter-id | All submitters
/USER=user-name | All users

## 2.6.20 ACMS/SHOW USER Command

Displays information about ACMS users. With qualifiers, displays information about only those users you identify.
ACMS/SHOW USER [user-name[,...]]

Command Qualifiers | Defaults
--- | ---
/ALL | /ALL
/APPLICATION | All applications
/DEVICE=device-name | All devices
/[NO]FULL | /NOFULL
/LOCAL | All submitters
/REMOTE | All submitters
/SUBMITTER=submitter-id | All submitters

## 2.6.21 ACMS/START APPLICATION Command

Starts one or more ACMS applications.
ACMS/START APPLICATION application-name[,...]

## 2.6.22 ACMS/START QTI Command

Starts the queued task initiator (QTI).
ACMS/START QTI

## 2.6.23 ACMS/START QUEUE Command

Starts the task queue you specify. Once you start a task queue, the QTI begins processing any queued task elements in the queue.
ACMS/START QUEUE queue-name[,...]

Command Qualifiers | Defaults
--- | ---
/ERROR_QUEUE=error-queue-name | No error queue
/TASK_THREADS=n | /TASK_THREADS=1

## 2.6.24 ACMS/START SYSTEM Command

Starts the ACMS system.
ACMS/START SYSTEM

Command Qualifiers | Defaults
--- | ---
/[NO]AUDIT | /AUDIT
/[NO]QTI | /NOQTI
/[NO]TERMINALS | /TERMINALS

## 2.6.25 ACMS/START TASK Command

Starts a detached task in the specified application.
ACMS/START TASK task-name application-name

Command Qualifiers | Defaults
--- | ---
/[NO]LOG | /NOLOG
/[NO]RETRY_LIMIT[=n] | /RETRY_LIMIT=0
/SELECTION_STRING=selection_string | Null string
/USERNAME=username | User name of application
/WAIT_TIMER=n | /WAIT_TIMER=5 seconds

## 2.6.26 ACMS/START TERMINALS Command

Starts the terminal subsystem controller (TSC) when ACMS is running. The ACMS/START TERMINALS command enables terminal users to access ACMS menus.
ACMS/START TERMINALS

## 2.6.27 ACMS/STOP APPLICATION Command

Stops one or more ACMS applications.
ACMS/STOP APPLICATION application-name[,...]

Command Qualifiers | Defaults
--- | ---
/[NO]CANCEL | /NOCANCEL

## 2.6.28 ACMS/STOP QTI Command

Stops the queued task initiator (QTI) and all active task queues.
ACMS/STOP QTI

Command Qualifiers | Defaults
--- | ---
/[NO]CANCEL | /NOCANCEL

## 2.6.29 ACMS/STOP QUEUE Command

Stops the specified task queue.
ACMS/STOP QUEUE queue-name[,...]

Command Qualifiers | Defaults
--- | ---
/[NO]CANCEL | /NOCANCEL

## 2.6.30 ACMS/STOP SYSTEM Command

Stops the ACMS system, the terminal subsystem controller (TSC), the queued task initiator (QTI), and all applications.
ACMS/STOP SYSTEM

Command Qualifiers | Defaults
--- | ---
/[NO]CANCEL | /NOCANCEL

## 2.6.31 ACMS/STOP TERMINALS Command

Stops the terminal subsystem controller (TSC), thereby canceling the tasks of all ACMS menu users and logging out all current terminal users.
ACMS/STOP TERMINALS

# 2.7 SWLUP Commands

This section contains syntax for the ACMS Software Event Log Utility (SWLUP) commands. SWLUP commands allow you to generate reports containing information logged by the Software Event Logger (SWL). See Compaq ACMS for OpenVMS Managing Applications for more information about SWLUP commands and qualifiers.

## 2.7.1 @ (At sign) Command (SWLUP>)

Runs an indirect command file that contains SWLUP commands.
@ file-spec

## 2.7.2 EDIT Command (SWLUP>)

Lets you edit the last SWLUP command you typed, or lets you create an edit buffer for entering SWLUP commands.
EDIT

## 2.7.3 EXIT Command (SWLUP>)

Causes SWLUP to exit or ends the execution of a command file.
EXIT

## 2.7.4 HELP Command (SWLUP>)

Displays information about SWLUP commands and qualifiers.
HELP [ topic [...] ]

Command Qualifiers | Defaults
--- | ---
/[NO]PROMPT | /PROMPT

## 2.7.5 LIST Command (SWLUP>)

Lists events recorded in the Software Event Logger file.
LIST [ EVENTS ]

Command Qualifiers | Defaults
--- | ---
/BEFORE[=time] | Full report
/EVENT_CODE=event-code[,...] | All event codes
/FACILITY=facility-name[,...] | All facilities
/IMAGE=image-name[,...] | All images
/INPUT=file-spec | /INPUT=SYS$ERRORLOG:SWL.LOG
/OUTPUT=file-spec | /OUTPUT=SYS$OUTPUT
/PRINT | Does not print
/PROCESS_NAME=process-name[,...] | All processes
/SEVERITY=severity-code[,...] | All severity codes
/SINCE[=time] | Full report
/USER=user-name[,...] | All user names

## 2.7.6 RENEW Command (SWLUP>)

Starts a new system wide Software Event Logger file.
RENEW

## 2.7.7 SAVE Command (SWLUP>)

Writes to a file that the last command typed.
SAVE file-spec

## 2.7.8 SET [NO]LOG Command (SWLUP>)

Enables or disables creation of a log file that records your SWLUP session.
SET LOG [ file-spec ]
SET NOLOG

## 2.7.9 SET [NO]VERIFY Command (SWLUP>)

Enables or disables the printing of commands stored in an indirect command file. SWLUP sends output to the default output device SYS$OUTPUT.
SET [NO]VERIFY

## 2.7.10 SHOW CURRENT Command (SWLUP>)

Displays the name of the current log file opened by the SWL detached process.
SHOW CURRENT

## 2.7.11 SHOW LOG Command (SWLUP>)

Displays whether or not you are currently logging SWLUP commands and the name of the log file, if applicable.
SHOW LOG

## 2.7.12 SHOW VERSION Command (SWLUP>)

Displays the current version of SWLUP on the default output device SYS$OUTPUT.
SHOW VERSION

## 2.7.13 STOP Command (SWLUP>)

Stops the SWL detached process so that it can exit properly.
STOP

# 2.8 UDU Commands

This section contains syntax for the ACMS User Definition Utility (UDU) commands. You can use UDU commands to authorize ACMS users. See Compaq ACMS for OpenVMS Managing Applications for more information about the UDU commands and qualifiers.

## 2.8.1 ADD Command (UDU>)

Authorizes and assigns sign-in characteristics to ACMS users by adding UDU definitions to the user authorization file (ACMSUDF.DAT). You can use qualifiers to assign sign-in characteristics or let new definitions receive information from the UDU DEFAULT definition.
ADD user-name

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

## 2.8.2 ADD/PROXY Command (UDU>)

Adds a user proxy to the ACMS proxy file (ACMSPROXY.DAT). Before you can use the ADD /PROXY command, you must have already created a proxy file using the CREATE /PROXY command.
ADD /PROXY remote-node::remote-user local-user

Previous | Next | Contents | Index