Compaq ACMS for OpenVMS
Managing Applications
Previous Contents Index

ACMS/SHOW QTI Command

Displays the run-time characteristics of the QTI.

Format

ACMS/SHOW QTI

Required Privileges

None

Notes

None

Example


$ ACMS/SHOW QTI
ACMS V4.0    QTI - Queued Task Initiator  Time:  14-MAY-1994  16:16:05.52
State:  STARTED                    User Name:        SYSTEM
PID:    11000211                   Process Name:     ACMS01QTI001000
Queues: 2                          Submitter Count:  5

This example displays the run-time characteristics of the QTI. See Chapter 8 for a description of the fields in this display.

ACMS/SHOW QUEUE Command

Displays queue information.

Format

ACMS/SHOW QUEUE [ queue-name[,...]]

Privileges Required

None

Parameters

queue-name

The name of the queue that you want to display information about. Specify more than one queue name by separating the queue names with a comma (,). If you do not supply a queue name, ACMS displays information about all queues that are started on your node.

Notes

The queues displayed by the ACMS/SHOW QUEUE command are those currently being processed by the Queued Task Initiator (QTI).

Example


$ ACMS/SHOW QUEUE MECCAQUEUE
ACMS V4.0    QUEUED TASK QUEUES              Time: 14-MAY-1994 16:16:05.52
Task Queue: MECCAQUEUE                                  State:  STARTED
    Threads:      4            Successful tasks invocations: 783
    Active Tasks: 2            Failed tasks invocations:     4
    Error Queue:  MECCAERROR_QUEUE
    Tasks queued to error queue: 0

This example displays queue information about the queue MECCAQUEUE. See Chapter 8 for a description of the fields shown in this display.

ACMS/SHOW SERVER Command

Displays information about one or more servers running under a specified application.

Format

ACMS/SHOW SERVER [ server-name [,...]]

Command Qualifier Default
/APPLICATION=application-name See text

Required Privileges

None

Parameters

server-name

The name of the server you want to display. Specify more than one server name by separating the server names with a comma (,). If you do not supply a server name, ACMS displays information on all servers.

Qualifiers

/APPLICATION=application-name

Specifies an application that contains the server or servers you want to display. Specify only the file name of the application database file; do not specify a device, directory, or file type. If you do not specify the /APPLICATION qualifier, all servers in all active applications are displayed.

Notes

None

Examples

#1 

$ ACMS/SHOW SERVER ACMS_TEST_SERVER/APPLICATION=ACMS_TEST_APPL
ACMS V4.0     CURRENT SERVERS       Time:  8-MAY-1994 13:42:28.91
Application Name: ACMS_TEST_APPL                  State:  STARTED
    Server Name: ACMS_TEST_SERVER
        Process Name: ACMS007SP001001              State:  ACTIVE  
        User Name:      TEST_USER                  PID:    212004A6
        Image:          TESTS::ACMS_TEST_SERVER.EXE;23
        Active Task:    DEMO_TASK
        Task ID:        NODE1::00010029-0000000F
        Process Name: ACMS007SP001002              State:  FREE
        User Name:      TEST_USER                  PID:    212004A9
        Image:          ACMS_TEST_SERVER.EXE;23
        Active Task:    NONE
        Task ID:        NONE

This example displays information about the server ACMS_TEST_SERVER running under the application ACMS_TEST_APPL.

#2 

$ ACMS/SHOW SERVER ACMS_DCL_SERVER/APPLICATION_NAME=ACMS_TEST_APPL
ACMS V4.0     CURRENT SERVERS       Time:  8-MAY-1994 13:42:28.91
Application Name: ACMS_TEST_APPL                 State:  STARTED
    Server Name: ACMS_DCL_SERVER
        Process Name: ACMS008SP001000            State:  ACTIVE
        User Name:      DEMO_USER   (DYNAMIC)    PID:    2120073C
        Image:          DCL SERVER PROCESS
        Active Task:    DCL_TASK
        Task ID:        NODE1::0001002F-00000017

This example displays information about the server ACMS_DCL_SERVER running under the application ACMS_TEST_APPL.

ACMS/SHOW SYSTEM Command

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

Format

ACMS/SHOW SYSTEM

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

Privileges Required

None

Qualifiers

/POOL

Displays information on pool size and available pool space for the system message switch pools for ACMS processes. No information on current users or applications is displayed when you specify the /POOL qualifier. If you do not specify the /POOL qualifier, no pool information is displayed.

/ALL

Use the /ALL qualifier with the /POOL qualifier to display information on pool size and available pool space for the system message switch pools for user-written agent processes, agents using the ACMSDEBUG Utility, and processes executing operator commands, in addition to information for ACMS processes.

Notes

You can use the pool information displayed when you use the /POOL qualifier to set the ACMSGEN parameters MSS_POOLSIZE and MSS_PROCESS_POOL. See Chapter 11 for more information on adjusting the pool size for your system.

Examples

#1 

$ ACMS/SHOW SYSTEM
ACMS V4.0  Current System State: STARTED  Time: 23-APR-1994 10:53:37.70 
    
Terminal Subsystem State:    STARTED 
Queued Task Initiator State: STOPPED 
System Auditing State:       ENABLED 
    
Active ACMS Users 
    
User Name      Submitter ID        Agent PID      Device 
SMITH          MYNODE::00030035    22400104       TWA3: 
SMITH          MYNODE::00030040    22400104       TWA4: 
ACMS_TEST      YRNODE::00B60013    (YRNODE::)     LTA5014: 
ACMS_TEST      YRNODE::023B0004    (YRNODE::)     LTA5006: 
    
Active Execution Controllers 
    
Application Name           Process Name       User Name     Exc PID 
PACCARE_APPL               ACMS01EXC002000    ACMS_TEST     224000CE 
EMPLOYEE_INFO_APPLICATION  ACMS01EXC003000    SMITH         224000D7 
EMPLOYEE_INFO_APPL_RTS     ACMS01EXC004000    EMPLOYEE_EXC  224000D9

This command displays information about ACMS. The display describes the current system state as STARTED and lists all ACMS users, active applications, and their Application Execution Controllers (EXC). See Chapter 8 for an itemized description of each field in this display.

#2 

$ ACMS/SHOW SYSTEM/POOL
ACMS V4.0  Current System State: STARTED  Time: 23-APR-1994 10:53:37.70 
 
Terminal Subsystem State:     STARTED 
Queued Task Initiator State:  STOPPED 
System Auditing State:        ENABLED 
 
ACMS System Message Switch Pools 
 
    Process         Pool     Free  (pct)  Largest  Allocation    Garbage 
      name          size     bytes         block    failures  collections 
< Shared Pool >    262144   228056 (86%)   65536        0            0 
ACMS01ACC001000    131072   121168 (92%)   65536        0            0 
ACMS01ATL001000    131072   127024 (96%)   65536        0            0 
ACMS01TSC001000    131072   126544 (96%)   65536        0            0 
ACMS01CP001000     131072   123824 (94%)   65536        0            0 
ACMS01EXC008000    131072   123312 (94%)   65536        0            0 
ACMS008SP001000    131072   125552 (95%)   65536        0            0 
ACMS008SP002013    131072   126704 (96%)   65536        0            0

This example displays pool size information about the current ACMS system. The display shows the current active system processes, the amount of pool space they use, the number of free bytes of pool space available, the largest block of pool space currently used, the number of allocation failures (if any), and the number of attempts to use fragmented pool space. See Chapter 8 for an itemized description of each field in this display.

ACMS/SHOW TASK Command

Displays information about one or more active ACMS tasks executing on the local node.

Format

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

Required Privileges

None

Parameters

task-name

The name of the task assigned in the application definition. If you do not specify a task name, ACMS displays information about all active tasks. Specify more than one task name by separating the task names with a comma (,).

Qualifiers

/APPLICATION=application-name

Names the application in which the task or tasks you want to display are defined. The application name is the file name of the application database file. Do not include device, directory, or file type (.ADB). If you omit this qualifier, ACMS searches all applications on the node for the tasks you specify. If you include an application name with the /APPLICATION qualifier, ACMS searches for the task name in that application only.

/DEVICE=device-name

Displays only those tasks that have the specified device name. Device name is the name of the terminal at which the task is running. You must end the device name with a colon (:). When you do not specify the /DEVICE qualifier, ACMS does not select tasks by device name to display.

/IDENTIFIER=task-id

Displays only those tasks that have the specified ID. ACMS assigns a unique task ID to each task a user selects. You need not specify leading and trailing zeros when specifying a task ID. You can display information on tasks called by other tasks. Refer to Chapter 12 for information about specifying a task ID.

/SUBMITTER=submitter-id

Displays only those tasks that have the specified user ID. ACMS assigns a unique user ID to each user who signs in. You need not specify leading and trailing zeros when specifying a submitter ID. 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 display.

/USER=user-name

Displays only those tasks that were submitted by the user with the specified user name.

Notes

If you do not specify a qualifier, the ACMS/SHOW TASK command displays information about all active tasks as well as all tasks called by other tasks.

The ACMS/SHOW TASK command does not display the transaction ID (TID) for a task that is executing a transaction step if that transaction step is a single processing step. The ACMS/SHOW TASK command displays the TID only for all composed tasks and for tasks where the transaction step is a block step.

Example


$ ACMS/SHOW TASK
ACMS V4.0   CURRENT TASKS           Time: 28-MAY-1994 13:35:23.19
Task Name:  MON_TASK
  Task ID:          WOW::0001000D-00000001
  Application:      LAS_APPL                       User Name:     CAMEO        
  Submitter ID:     WOW::0001000D                  Device:        TTB1:
Task Name:  OPR_TASK
  Task ID:          WOW::00020013-00000003
  Application:      LAS_APPL                       User Name:    NOMIS       
  Submitter ID:     WOW::00020013                  Device:       TTH0:
  Called Task:      OPR_TASK_A
      Task ID:      WOW::00020013-00000003-00000001          
  Called Task:      OPR_TASK_B
      Task ID:      WOW::00020013-00000003-00000002

This command displays information about all tasks active on the local node. See Chapter 9 for a description of each field shown in this display.

ACMS/SHOW USER Command

Displays information about ACMS users. With qualifiers, displays information about only those users you identify.

Format

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

Privileges Required

None

Parameters

user-name

Specifies the name of the user that you want to display information about. If you do not specify a user name, the ACMS/SHOW USER command displays information about all ACMS users. Specify more than one user name by separating each user name with a comma (,).

Qualifiers

/ALL

Displays information for both local and remote users. Local users are those who sign in to ACMS on the local node. Remote users are those who select tasks from a remote node. In addition, the /ALL qualifier displays the total number of users accessing the ACMS system. ACMS/SHOW USER/ALL is the default.

You cannot specify the /ALL qualifier with the /LOCAL or /REMOTE qualifier.

/APPLICATION

Displays each local application that a user is connected to.

/DEVICE=device-name

Displays information about ACMS users at the specified terminal. The device name is a terminal ID. You must end the device-name with a colon (:). If you do not specify the /DEVICE qualifier, ACMS does not select users by device name to display information about.

/[NO]FULL

Displays task information for each user. The default is /NOFULL.

/LOCAL

Displays information for local users only. Local users are those who sign in to ACMS on the local node. You cannot specify the /LOCAL qualifier with the /REMOTE or /ALL qualifier.

/REMOTE

Displays information only about remote users currently accessing applications on the local node. Remote users are those who selected tasks from a remote node. You cannot specify the /REMOTE qualifier with the /LOCAL or /ALL qualifier.

/SUBMITTER=submitter-id

Displays information only about users that have the specified submitter ID. ACMS assigns a unique submitter ID to each user who signs in. 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 display information about.

Notes

If you do not specify a user name or use any of the qualifiers, the ACMS/SHOW USER command displays information about all users.

If a user is signed in at more than one terminal, you can use the /DEVICE qualifier to get information about the user's activity at one of the terminals. This qualifier is valid only for local users.

If you have the OPER privilege, you can cancel one or more local users by using the ACMS/CANCEL USER command.

The ACMS/SHOW USER/FULL command does not display information about called tasks. Use the ACMS/SHOW TASK command to display information about called tasks.

Use the /LOCAL qualifier to display information about local users.

Use the /REMOTE qualifier to display information about remote users.

Use the /ALL qualifier (the default) to display information about both local and remote users.

Use the /APPLICATION qualifier to see a list of local applications that the user is connected to.

Examples

#1 

$ ACMS/SHOW USER/ALL
ACMS V4.0    CURRENT USERS        Time: 16-MAR-1994 16:32:14.93 
 
User name:      SMITH             Submitter ID: VAXA::0001001E 
  Agent PID:    22E000C0          Device:       TWA2: 
 
User name:      JONES             Submitter ID: VAXA::0002001E 
  Agent PID:    22E000C0          Device:       RTA2: 
 
User name:      TOWERS            Submitter ID: VAXA::0004001E 
  Agent PID:    22E000C0          Device:       LTA2: 
 
User name:      NEWMAN            Submitter ID: VAXB::0006001E 
Agent PID:      (VAXB::)          Device:       TWA2: 
 
User name:      JACKSON           Submitter ID: VAXB::0007001E 
  Agent PID:    (VAXB::)          Device:       LTA12: 
 
User name:      SMITH_S           Submitter ID: VAXC::0008001E 
  Agent PID:    (VAXB::)          Device:       LTA22: 
 
Total known active users:       6

This command displays information about all local and remote users signed in to ACMS on the node. For nodes with concurrent-use licenses, the total number of active users represents the number of license units in use. ACMS/SHOW USER/ALL is the default.

#2 

$ ACMS/SHOW USER/LOCAL
ACMS V4.0    CURRENT USERS        Time: 16-MAR-1994 16:32:14.93 
 
User Name:   SMITH                Submitter ID: VAXA::0001001E 
  Agent PID: 22E000C0             Device:       TWA2: 
 
User name:   JONES                Submitter ID:VAXA::0002001E 
  Agent PID: 22E000C0             Device:       RTA2: 
 
User name:   TOWERS               Submitter ID: VAXA::0004001E 
  Agent PID: 22E000C0             Device:       LTA2:

This command displays information about all local users signed in to ACMS.

#3 

$ ACMS/SHOW USER/APPLICATION
ACMS V4.0       CURRENT USERS     Time: 23-APR-1994 10:45:19.14 
 
User Name:   SMITH                Submitter ID: MYNODE::00030035 
  Agent PID: 22400104             Device:       TWA3: 
    
    Application: PACCARE_APPL 
    Application: EMPLOYEE_INFO_APPLICATION 
    
User Name:   SMITH                Submitter ID: MYNODE::00030040 
  Agent PID: 22400104             Device:       TWA4: 
    
    This user is not connected to any applications 
    
User Name:   ACMS_TEST            Submitter ID: YRNODE::00B60013 
  Agent PID: (YRNODE::)           Device:       LTA5014: 
               
    Application: EMPLOYEE_INFO_APPLICATION 
    Application: PACCARE_APPL 
    
User Name:   ACMS_TEST            Submitter ID: YRNODE::023B0004 
  Agent PID: (YRNODE::)           Device:       LTA5006: 
    
    Application: EMPLOYEE_INFO_APPLICATION 
    Application: PACCARE_APPL 
    
Total known active users:   4

This command displays information about all local and remote users signed in to ACMS on the node and lists the local applications that each user is connected to. For nodes with concurrent-use licenses, the total number of known active users represents the number of license units in use.

#4 

$ ACMS/SHOW USER/APPLICATION/LOCAL
ACMS V4.0    CURRENT USERS        Time: 16-MAR-1994 16:32:14.93 
 
User Name:     SMITH              Submitter ID: VAXA::0001001E 
  Agent PID:   22E000C0           Device:       TWA2: 
 
    Application: EMPLOYEE_INFO_APPLICATION 
    Application: PAYROLL_APPLICATION 
    Application: ACCOUNTING_APPLICATION 
 
User Name:      JONES             Submitter ID: VAXA::0002001E 
  Agent PID:    22E000C0          Device:       RTA2: 
 
    Application: PAYROLL_APPLICATION 
 
User name:      JONES_J           Submitter ID: VAXA::0003001E 
  Agent PID:    22E000C0          Device:       RTA3: 
     
     This user is not connected to any application 
 
User name:      TOWERS            Submitter ID: VAXA::0004001E 
  Agent PID:    22E000C0          Device:       LTA2: 
 
    Application: INVENTORY_APPLICATION 
    Application: ORDER_ENTRY_APPLICATION 
    Application: CREDIT_INQUIRY_APPLICATION

This command displays information about all local users and lists the local applications that each user is connected to.

#5 

$ ACMS/SHOW USER/DEVICE=RTA2:
ACMS V4.0    CURRENT USERS        Time: 16-MAR-1994 16:32:14.93 
 
User Name:      JONES             Submitter ID: VAXA::0002001E 
  Agent PID:    22E000C0          Device:       RTA2:

This command displays information about the user signed in to ACMS at terminal RTA2:.

#6 

$ ACMS/SHOW USER/FULL 
ACMS V4.0    CURRENT USERS        Time: 16-MAR-1994 16:32:14.93 
 
User Name:     SMITH              Submitter ID: VAXA::0001001E 
  Agent PID:   22E000C0           Device:       TWA2: 
 
Task Name:  EMPLOYEE_INFO_UPDATE_TASK 
  Task ID:     VAXA::0001001E-00000001   
  Appl Name:   EMPLOYEE_INFO_APPLICATION 
  Appl Node:   VAXA:: 
 
User Name:     JONES              Submitter ID: VAXA::0002001E 
  Agent PID:   22E000C0           Device:       RTA2: 
 
   User JONES has no active tasks. 
 
User name:     TOWERS             Submitter ID: VAXA::0004001E 
  Agent PID:   22E000C0           Device:       LTA2: 
 
Task Name:  ORDER_ADD 
  Task ID:     VAXA::0004001E-00000001 
  Appl Name:   ORDER_ENTRY_APPLICATION 
  Appl Node:   VAXA::

This command displays information about all local users and lists the tasks submitted by those users.

#7 

$ ACMS/SHOW USER/REMOTE
ACMS V4.0    CURRENT USERS        Time: 16-MAR-1994 16:32:14.93 
 
User name:      NEWMAN            Submitter ID: VAXB::0006001E 
  Agent PID:    (VAXB::)          Device:       TWA2: 
 
User name:      JACKSON           Submitter ID: VAXB::0007001E 
  Agent PID:    (VAXB::)          Device:       LTA12: 
 
User name:      SMITH_S           Submitter ID: VAXC::0008001E 
  Agent PID:    (VAXC::)          Device:       LTA22:

This command displays information about all remote users.

#8 

$ ACMS/SHOW USER/REMOTE/APPLICATION
ACMS V4.0    CURRENT USERS        Time: 16-MAR-1994 16:32:14.93 
 
User name:      NEWMAN            Submitter ID: VAXB::0006001E 
  Agent PID:    (VAXB::)          Device:       TWA2: 
 
    Application: PAYROLL_APPLICATION 
    Application: ACCOUNTING_APPLICATION 
 
User name:      JACKSON           Submitter ID: VAXB::0007001E 
  Agent PID:    (VAXB::)          Device:       LTA12: 
 
    Application: EMPLOYEE_INFO_APPLICATION 
    Application: PAYROLL_APPLICATION 
    Application: ACCOUNTING_APPLICATION 
    Application: INVENTORY_APPLICATION 
    Application: ORDER_ENTRY_APPLICATION 
    Application: CREDIT_INQUIRY_APPLICATION 
 
User name:      SMITH_S           Submitter ID: VAXC::0008001E 
  Agent PID:    (VAXC::)          Device:       LTA22: 
          
    Application: PAYROLL_APPLICATION 
    Application: CREDIT_INQUIRY_APPLICATION

This command displays information about all remote users signed in to ACMS and lists the local applications that each user is connected to.

Previous Next Contents Index