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