# Compaq ACMS for OpenVMS
Managing Applications

Previous | Contents | Index

# SHOW QUEUE Command (ACMSQUEMGR>)

> Displays the characteristics of the task queue you specify.

## Format

> SHOW QUEUE queue-name

> Command Qualifier | Default
> --- | ---
> /OUTPUT[=file-spec] | SYS$OUTPUT

## Privileges Required

> None

## Parameters

> ### queue-name

> The name of the queue you want to display information about. A queue name can be any valid RMS file name containing 1 through 39 alphanumeric characters. To display all queues, use the wildcard character (*) in place of a queue name.

## Qualifiers

> ### /OUTPUT[=file-spec]

> Specifies the file specification where you want to send the SHOW command output. Specify a full file specification, including device, directory, file name, and file type. If you specify an incomplete file specification, ACMSQUEMGR uses the file ACMSQUEMGR.LIS. If you do not use the /OUTPUT qualifier, ACMSQUEMGR sends the output to the default device, SYS$OUTPUT.

## Notes

> None

##

### Examples

#1
    ACMSQUEMGR> SHOW QUEUE FASTQUEUE
    Queue Name: FASTQUEUE
    Enqueues State: RESUMED  Dequeues State: SUSPENDED Max Wsp Size: 200
    File Specification: DISK1:[FOSTER]SHOW_OUTPUT.LIS;1

> This command displays queue information for queue FASTQUEUE in your current default directory.

#2
    ACMSQUEMGR> SHOW QUEUE SLOWQUEUE /OUTPUT=SLOW_SHOW.LIS

> This command writes information about queue SLOWQUEUE to the file SLOW_SHOW.LIS.

# Chapter 21
Operator Commands

This chapter contains reference information and examples for the ACMS operator commands. See Chapter 8 and Chapter 9 for a discussion on the ACMS operator commands and their functions.

# ACMS/CANCEL TASK Command

> Stops one or more task instances. With qualifiers, stops only the task instance you identify.

## Format

> 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

## Privileges Required

> OpenVMS OPER privilege

## Parameters

> ### task-name

> The name of the task you want to cancel. It is the name given to the task in the application definition. The task name you specify can exist in more than one application.

## Qualifiers

> ### /APPLICATION=application-name

> Cancels tasks in the specified application only. The application name is the file name of an application database for a started application. Do not include device, directory, or file type with the application name. When you specify the /APPLICATION qualifier, ACMS searches for the task name only in the application you specify. If you do not specify the /APPLICATION qualifier, ACMS searches for the task name in all active applications on the system.

> If you specify an application name with the /APPLICATION qualifier, but do not specify a task name, ACMS cancels all currently active tasks for the specified application. Naming an application with the /APPLICATION qualifier and naming a task causes ACMS to search for the task in that application only.

> ### /[NO]CONFIRM

> The /CONFIRM qualifier causes ACMS to display the name of each task to be canceled and prompts you to indicate whether you still want to cancel the task. The /NOCONFIRM qualifier tells ACMS not to prompt you to confirm that you want to cancel a task. The default is /CONFIRM.

> ### /DEVICE=device-name

> Cancels tasks with the specified device name only. Device-name is the name of the terminal at which the task is running. You must end the device name with a colon (:). If you do not specify the /DEVICE qualifier, ACMS cancels the identified task on all available devices.

> ### /IDENTIFIER=task-id

> Cancels tasks with the specified task ID only. ACMS assigns a unique task ID to each task and to each task called by another task. If you do not specify the /IDENTIFIER qualifier, ACMS does not select tasks by ID to cancel. Refer to Chapter 12 for information about specifying a task ID.

> ### /[NO]LOG

> The /LOG qualifier causes ACMS to display a message indicating that a task has been canceled. The default is /NOLOG.

> ### /SUBMITTER=submitter-id

> Cancels tasks with the specified submitter ID only. ACMS assigns a unique submitter ID to each user who signs in to ACMS. Refer to Chapter 12 for information about specifying a submitter ID.

> If you do not specify the /SUBMITTER qualifier, ACMS does not select tasks by submitter ID to cancel.

> ### /USER=user-name

> Cancels tasks having the specified user name only. There can be more than one user with the user name you specify. If you do not specify the /USER qualifier, ACMS does not select tasks by user name.

## Notes

> Without any qualifiers, the ACMS/CANCEL TASK command cancels all active tasks and prompts you to confirm each cancellation. If you use the /NOCONFIRM qualifier, ACMS cancels all task instances without prompting you.

> In some situations, you can cancel more than one task instance with a single qualifier. For example, you can use the /APPLICATION, /IDENTIFIER, /SUBMITTER, or /USER qualifier to cancel all active instances of a task that have a particular application name, task ID, submitter ID, or user name.

> Specifying more than one qualifier limits the scope of the command. For example, specifying the /APPLICATION=AVERTZ and /DEVICE=NL qualifiers on the same command line causes ACMS to cancel only tasks in the application AVERTZ that have the null device type (NL).

## Examples

#1
    $ ACMS/CANCEL TASK/NOCONFIRM
    Task Name: MON_TASK
      Task ID:          ODE::0001000D-0000001
      Application:      LAS_APPL             User Name:        TUTTLE
      Submitter ID:     ODE::0001000D        Device:           RTA8:
      Called Task:      MON_TASK_A
          Task ID:      ODE::0001000D-0000001-00000002

> This command cancels each active task on the current node.

#2
    $ ACMS/CANCEL TASK/DEVICE=TTH0:
    Task Name: DELETE_ALL
      Task ID:       ALLDAY::0001000D-00000001
      Application:   ACCOUNT                User Name:     COUNT
      Submitter ID:  ALLDAY::0001000D       Device:        TTH0:
    Task ID:       ALLDAY::0001000D-00000001 (Y/[N]):Y

> This command displays information about the task active at device TTH0 and prompts you to confirm whether or not to cancel the task. Here, the user canceled the task by typing the letter Y (for YES) in response to the (Y/[N]). If you do not want ACMS to prompt for confirmation, specify the /NOCONFIRM qualifier on the command line.

#3
    $ ACMS/CANCEL TASK/NOCONFIRM/USER=ADAMS

> This command cancels all tasks on a node submitted by a user with the user name ADAMS. Because the /NOCONFIRM qualifier was specified, ACMS does not prompt for confirmation before canceling the task.

#4
    $ ACMS/CANCEL TASK/NOCONFIRM/SUBMITTER=10016

> This command cancels all tasks submitted by a user whose ID is 10016.

#5
    $ ACMS/CANCEL TASK/APPLICATION=MARKET

> This command displays all active tasks that are a part of the application MARKET and prompts you to indicate whether or not you want to cancel each task.

#6
    $ ACMS/CANCEL TASK/IDENTIFIER=WOW::00050012-00000003

> This command cancels the task with the task ID WOW::00050012-00000003. ACMS also cancels all tasks called by the identified task.

#7
    $ ACMS/CANCEL TASK/IDENTIFIER=WOW::00050012-00000003-00000001

> This command cancels the task with the task ID WOW::00050012-00000003-00000001. Three fields in the task ID indicate that this task is a called task.

# ACMS/CANCEL USER Command

> Cancels a user by stopping all of the user's outstanding tasks and by signing the user out of ACMS.

## Format

> ACMS/CANCEL USER [ user-name ]

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

## Privileges Required

> OpenVMS OPER privilege

## Parameters

> ### user-name

> The user name of one or more users that you want to cancel. If you include a user name, ACMS cancels the users who are signed in to ACMS under the user name you provide. If you do not include a user name or any qualifiers, ACMS cancels all active users.

## Qualifiers

> ### /[NO]CONFIRM

> The /CONFIRM qualifier causes ACMS to display information about each user selected to be canceled and prompts you to indicate whether or not you still want to cancel the user. The /NOCONFIRM qualifier tells ACMS not to prompt you for confirmation. The default is /CONFIRM.

> ### /DEVICE=device-name

> Cancels one or more users identified by device name. Device-name is the name of the terminal at which the user is logged in. You must end the device name with a colon (:). If you do not specify the /DEVICE qualifier, ACMS does not cancel users by device name.

> ### /[NO]LOG

> Controls whether or not ACMS displays a message after canceling a user. The /NOLOG qualifier is the default.

> ### /SUBMITTER=submitter-id

> Cancels the user identified by the specified submitter ID. ACMS assigns a unique submitter ID to each user who signs in to ACMS. Refer to Chapter 12 for information about specifying a submitter ID.

> If you do not specify the /SUBMITTER qualifier, ACMS does not select users by submitter ID to cancel.

## Notes

> The ACMS/CANCEL USER command also cancels tasks called by other tasks.

> The ACMS/CANCEL USER command does not affect remote users. You can use only the ACMS/CANCEL USER command to cancel users on your current node. Use the ACMS/CANCEL TASK command to cancel tasks owned by remote users.

> To determine a user name, submitter ID, or device name, specify the ACMS/SHOW USER command.

## Examples

#1
    $ ACMS/CANCEL USER
    User Name:       ZEKE         Submitter ID:  BILBO::0001000D
      Agent PID:     22000122     Device:        TTB1:
    Submitter ID:    BILBO::0001000D (Y/[N]):N
    User Name:       SIMONSAYS    Submitter ID:  BILBO::000200013
      Agent PID:     22000122     Device:        TTH0:_
      Submitter ID:  BILBO::000200013 (Y/[N]):N

> This command displays information about all active users on the current node. Because the user responded by typing the letter N (for NO) at the confirmation prompt, the users ZEKE and SIMONSAYS are not canceled.

#2
    $ ACMS/CANCEL USER ADAMS
    User Name:      ADAMS         Submitter ID:       ALLDAY::0001000D
      Agent PID:    00000055      Device ID:          TTH0:
    Submitter ID:   ALLDAY::0001000D (Y/[N]):

> This command displays information about a user ADAMS and prompts for confirmation before canceling. Type Y in response to the confirmation prompt to cancel the user. After you type Y, ACMS can display information about another user ADAMS, if there is one.

#3
    $ ACMS/CANCEL USER/DEVICE=TTH0:
    User Name:        ADAMS         Submitter ID:       ALLDAY::0001000D
      Agent PID:      00000055      Device ID:          TTH0:
    Submitter ID:   ALLDAY::0001000D (Y/[N]):

> Because the /CONFIRM qualifier is the default, this command displays information about the user who is working at the TTH0 device and prompts you to confirm the cancellation. Type Y in response to the confirmation prompt to cancel user ADAMS.

#4
    $ ACMS/CANCEL USER/SUBMITTER=1000D /LOG
    User Name:      ADAMS         Submitter ID: CARAT::0001000D
      Agent PID:    22000122      Device ID:    TTC7:
    Submitter ID:   CARAT::0001000D (Y/[N]):Y
    %ACMSOPR-I-USERCANED, User ADAMS canceled

> This command displays information about the task instance active for a user whose submitter ID is 0001000D, and cancels the user after you type Y at the confirmation prompt. The /LOG qualifier prints a message showing you that the cancellation attempt was successful. By default, you do not receive a cancellation message. Refer to Chapter 12 for a complete description of submitter IDs.

# ACMS/DEBUG Command

> Starts the ACMS Task Debugger. This command allows you to test tasks and server procedures without building an entire ACMS application.

## Format

> ACMS/DEBUG [task-group name]

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

## Qualifiers

> ### /AGENT_HANDLE

> Allows you to submit calls to ACMS tasks from an agent program. The handle name for the agent program must be unique to the system on which you are debugging the task. To ensure that the agent handle is unique to the system, include the PID of the task debugger or the user name of the person doing the debugging in the /AGENT_HANDLE name.

> ### /PID

> Identifies the process ID (PID) for the server process to be debugged.

> ### /SERVER

> Allows you to debug procedure servers as they execute in the ACMS run-time environment. Using this command, you can observe the server process execution through the OpenVMS Debugger, and locate run-time programming or logic errors and other bugs.

> ### /TWS_POOLSIZE

> Allows you to specify the sizes of the temporary pools that task workspaces use when a task is started. When you start a task, the group and user workspaces the task uses, as well as system and task workspaces, are copied into temporary workspaces for use by the task. At any given time, the sum of all group, user, system, and task workspaces for all active tasks cannot exceed this number. Valid sizes are from 129 to 65,535 pages (VAX) or 129 to 65,535 pagelets (Alpha). The default value is 350 pages (VAX) or 1600 pagelets (Alpha).

> ### /TWSC_POOLSIZE

> Controls the overall size of the pool used to store information needed to allocate the task instance workspaces stored in the TWS_POOLSIZE pool. Valid sizes are from 9 to 63 pages (VAX) or 9 to 63 pagelets (Alpha). The default value is 50 pages (VAX) or 50 pagelets (Alpha).

> ### /WORKSPACE

> Allows the examination of workspaces during exchange steps, the action part of processing steps, or at the beginning or end of a task. If it is not specified, workspaces can be examined only when a task is running a server.

## Privileges Required

> None

## Notes

> If you specify a value between 0 and 129 for /TWS_POOLSIZE, or a value for TWSC_POOLSIZE that is between 0 and 9, ACMS overrides the value and sets them to the minimum required values (129 or 9, respectively). Then before starting the task debugger, ACMS notifies the user that the change has been made. If you specify a value less than 0 for either pool size, ACMS returns an error message.

> If you invoke ACMS/DEBUG/SERVER using the process name for a server process that has a UIC group number different from the invoking user's process UIC group number, you receive the following error:

>     %ACMSOPR-E-DBGSERERR, Error during DEBUG/SERVER
>     -ACMSOPS-W-NOSUCHSER, Specified server does not exist
>     %ACMSOPR-E-ERROR, Some operations may not have been performed

> To correct this problem, use the process PID to access the server process.

## Examples

#1
    $ ACMS/DEBUG VR_TASK_GROUP/WORKSPACE

> This command instructs the ACMS Task Debugger to debug tasks in the task group database file VR_TASK_GROUP. The command also allows you to examine and deposit data in workspaces.

#2
    $ ACMS/DEBUG/SERVER ACMS000SP001000

> This command starts the debugger for the server process name ACMS000SP001000.

#3
    $ ACMS/DEBUG/TWSC_POOLSIZE=30/TWS_POOLSIZE=500 VR_TASK_GROUP

> This command instructs the ACMS Task Debugger to debug tasks in the task group database file VR_TASK_GROUP. In addition, the command overrides the default values of TWSC_POOLSIZE and TWS_POOLSIZE for this session.

# ACMS/ENTER Command

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

## Format

> ACMS/ENTER

> Command Qualifier | Default
> --- | ---
> /[NO]RETURN | /RETURN

## Privileges Required

> None

## Qualifiers

> ### /[NO]RETURN

> If you specify the /RETURN qualifier, your DCL process waits until you exit from ACMS. When you exit from ACMS, you are returned to your DCL process.

> If you specify the /NORETURN qualifier, your DCL process is deleted once you enter the ACMS menu system. Once you exit from ACMS, you are logged out. The default is /RETURN.

## Notes

> Both the ACMS system and the Terminal Subsystem Controller (TSC) must be started before a user can enter the ACMS menu system.

> Your terminal must be authorized in the ACMS device definition file for you to enter the ACMS menu system. See Chapter 2 for information on authorizing devices with the Device Definition Utility (DDU).

> You cannot issue an ACMS/ENTER command from a DCL server unless the task was selected from a user-written agent. Doing so can cause parts of the Terminal Subsystem Controller (TSC) to fail and can sign other users out of ACMS. Components within the ACMS terminal subsystem maintain databases based on terminal names. When you issue a second ACMS/ENTER command, various errors can occur in the ACMS Command Process (CP) and TSC, including process termination.

## Examples

#1
    $ ACMS/ENTER

> This command places you in the ACMS menu system. When you exit from ACMS, you are returned to DCL command level.

#2
    $ ACMS/ENTER/NORETURN

> This command places you in the ACMS menu system. When you exit from ACMS, you are logged out.

Previous | Next | Contents | Index