Compaq ACMS for OpenVMS
Managing Applications


Previous Contents Index


ACMS/SET QUEUE Command

Sets the processing characteristics of a started task queue. The processing characteristics are used by the Queued Task Initiator (QTI).

Format

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

Command Qualifier Default
/TASK_THREADS=n /TASK_THREADS=1


Privileges Required

OpenVMS OPER privilege

Parameters

queue-name

The name of the queue for which you want to set processing characteristics.

Qualifiers

/TASK_THREADS=n

Specifies the number of concurrent outstanding tasks that the QTI processes for the specified queue. Here, n indicates a value from 1 through 255. Normally, a relatively low number (1 through 5) is sufficient to achieve maximum throughput of the queue.

The /TASK_THREADS qualifier is a positional qualifier. If you position the /TASK_THREADS qualifier between the ACMS/SET QUEUE command and the queue names, all queue names are affected. To have the /TASK_THREADS qualifier apply to an individual queue name in a list of queue names, place the qualifier directly after the queue name. See the examples section for examples of using this qualifier. The default is /TASK_THREADS=1.


Notes

None

Examples

#1

$ ACMS/SET QUEUE NEWQ
      

This command sets to one the maximum number of concurrent outstanding tasks for queue NEWQ.

#2

$ ACMS/SET/TASK_THREADS=5 QUEUE QUE1,QUE2 
      

This command limits the number of concurrent outstanding tasks to five for queues QUE1 and QUE2.

#3

$ ACMS/SET QUEUE/TASK_THREADS=5 QUE1,QUE3,QUE4, QUE2 /TASK_THREADS=3
 
      

This command limits the number of concurrent outstanding tasks to five for queues QUE1, QUE3, and QUE4 and to three for queue QUE2.


ACMS/SET SYSTEM Command

Depending on the qualifiers used, enables or disables audit trail logging, or enables or disables ACMS operator terminals.

Format

ACMS/SET SYSTEM

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


Privileges Required

OpenVMS OPER privilege

Qualifiers

/[NO]AUDIT

The /AUDIT qualifier starts the Audit Trail Logger and enables systemwide auditing. The /NOAUDIT qualifier stops systemwide auditing. If you do not specify this qualifier, systemwide auditing is not affected.

/[NO]OPERATOR

Enables or disables the terminals identified by the /PROCESS qualifier or /TERMINAL qualifier as ACMS operator terminals. When you specify the /OPERATOR or /NOOPERATOR qualifier, you must also specify either the /PROCESS or the /TERMINAL qualifier. If you do not specify this qualifier, ACMS terminals are not affected.

/PROCESS

If you specify the /OPERATOR qualifier, the /PROCESS qualifier enables your terminal as an ACMS operator terminal for as long as your current process is active. If you specify the /NOOPERATOR qualifier, the /PROCESS qualifier disables your terminal as an ACMS operator terminal.

You must specify either the /OPERATOR or /NOOPERATOR qualifier when you use the /PROCESS qualifier. If you do not specify this qualifier, ACMS terminals are not affected.

/TERMINAL=(device-name[,...])

If you specify the /OPERATOR qualifier, the /TERMINAL qualifier identifies one or more terminals as an ACMS operator terminal (for as long as ACMS is active). If you specify the /NOOPERATOR qualifier, the /TERMINAL qualifier disables one or more terminals as an ACMS terminal. If you specify more than one device name, separate the device names with commas and enclose them in parentheses. A colon (:) in the device name is not required.

You must specify either the /OPERATOR or /NOOPERATOR qualifier with the /TERMINAL qualifier. If you do not specify this qualifier, ACMS terminals are not affected.


Notes

If an application fails, or if the Audit Trail Logger or TSC stops abnormally, ACMS sends a message to ACMS operator terminals to inform you.

You cannot use the /[NO]PROCESS qualifier for a batch job.


Examples

#1

$ ACMS/SET SYSTEM/PROCESS/OPERATOR
      

This command enables your terminal as an ACMS operator terminal for the duration of your process or until ACMS stops.

#2

$ ACMS/SET SYSTEM/TERMINAL=(TTE2,TTE3)/OPERATOR
      

This command enables terminals TTE2 and TTE3 as ACMS operator terminals for as long as ACMS is active.

#3

$ ACMS/SET SYSTEM/TERMINAL=TTE2/NOOPERATOR
      

This command disables terminal TTE2 as an ACMS operator terminal.

#4

$ ACMS/SET SYSTEM/AUDIT
      

This command enables the Audit Trail Logger. Use this command to reenable the Audit Trail Logger after you have disabled it.


ACMS/SHOW APPLICATION Command

Displays information about one or more active ACMS applications in static mode. See the ACMS/SHOW APPLICATION/CONTINUOUS command if you want to display an application in continuous mode.

Format

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[=(server-name[,...])] No server attributes displayed
/TASK_ATTRIBUTES[=(task-name[,...])] No task attributes displayed


Privileges Required

None

Parameters

application-name

The file name of the application you want to display information about. Specify only the file name of the application; do not include device, directory, or file type. If you do not include an application name, ACMS displays information about all active applications. Specify more than one application name by separating the application names with a comma (,).

Qualifiers

/CONNECTIONS

Displays the local and remote users who are connected to the application.

/DETACHED_TASKS

Displays information about all detached tasks that are started and have not completed.

/POOL

Displays information on pool size and available pool space for an application. If you do not specify the /POOL qualifier, no pool information is displayed. If you specify the /POOL qualifier but do not supply an application name, pool information is displayed for all active applications.

/SERVER_ATTRIBUTES[=(server-name[,...])]

Displays the current settings of modifiable server attributes for the specified application. If you specify a server name, ACMS displays the current values of server attributes for the specified server only. Specify more than one server name by separating the server names with a comma (,) and enclosing them in parentheses. If you do not specify a server name, ACMS displays the server attributes for all servers in the specified application.

You can display the settings of the following server attributes:

Modify server attributes with the ACMS/MODIFY APPLICATION/SERVER_ATTRIBUTES command.

/TASK_ATTRIBUTES[=(task-name[,...])]

Displays the current settings of modifiable task attributes for the specified application. If you specify a task name, ACMS displays the task attributes for the specified task only. Specify more than one task name by separating the task names with a comma (,) and enclosing them in parentheses. If you do not specify a task name, ACMS displays task attributes for all tasks in the specified application.

You can display the settings of the following task attributes:

Modify task attributes with the ACMS/MODIFY APPLICATION/TASK_ATTRIBUTES command.


Notes

If you specify an application that is not active, ACMS returns an error.

The ACMS/SHOW APPLICATION command with no qualifiers displays information that is useful in determining the optimal values for maximum server processes and minimal server processes.

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


Examples

#1

$ ACMS/SHOW APPLICATION
ACMS V4.0     CURRENT APPLICATIONS        Time:  5-MAY-1994 13:34:56.41
Application Name: TIME_TEST                          State:  STARTED
    Object Name:       ACMS01EXC001000
    User Name:         NOMIS                PID:               22000123
    Max Task Count:    120                  Max SP Count:      150  
    Cur Task Count:    2                    Cur SP Count:      1    
    Auditing:          OFF                  SP Mon. Interval:  5   
Server Name                  max SPs  min SPs  active   free    waiting
                                                SPs      SPs     tasks
LAS_SRVR                      1        0        1        0       1
Application Name: SANDAPPL                             State:  STARTED
    Object Name:       ACMS01EXC003000
    User Name:         EDLOD                PID:               2200047C
    Max Task Count:    65535                Max SP Count:      150  
    Cur Task Count:    0                    Cur SP Count:      0    
    Auditing:          OFF                  SP Mon Interval:   20   
Server Name                  max SPs  min SPs  active   free    waiting
                                                SPs      SPs     tasks
SANDSRV                       5        0        0        0       0
 
      

This example displays server and task information for all applications started on the local node.

#2

$ ACMS/SHOW APPLICATION QUALITY/SERVER_ATTRIBUTES=(NAME=LAS_SRVR) -
_$ /TASK_ATTRIBUTES
ACMS V4.0       CURRENT APPLICATIONS        Time:  5-MAY-1994 13:34:56.41
Application Name: QUALITY                               State:  STARTED
    Object Name:        ACMS01EXC001000                  
    User Name:          NOMIS              PID:                22000123
    Max Task Count:     123                Max SP Count:       150
    Cur Task Count:     1                  Cur SP Count:       1
    Auditing:           OFF                SP Mon. Interval:   10
---------------------- SERVER ATTRIBUTES ----------------------------
Server Name: LAS_SRVR
    Max. SPs:           1                  Min SPs:            0
    Creation Delay:     5                  Creation Interval:  2
    Deletion Delay:     15                 Deletion Interval:  5
    Auditing:           ON                 Process Dumps:      OFF
------------------------ TASK ATTRIBUTES ----------------------------
Task Name: LAS_TASK1                           
    Status:              ENABLED            Auditing:           ON    
    Transaction Timeout: NO TIME LIMIT
Task Name: LAS_TASK2
    Status:              DISABLED           Auditing:           OFF   
    Transaction Timeout: 30 
 
      

This example displays the modifiable server attributes for server LAS_SRVR in the application QUALITY. See Chapter 9 for a description of the fields in this display.

#3

$ ACMS/SHOW APPLICATION/POOL TEST
ACMS V4.0       CURRENT APPLICATIONS      Time: 20-MAY-1994 11:21:04.50
Application Name: TEST                                   State:  STARTED
    Object Name:        ACMS01EXC008000
    User Name:          WAYNE              PID:                25C01337
    Max Task Count:     65535              Max SP Count:       5    
    Cur Task Count:     0                  Cur SP Count:       2    
    Auditing:           ON                 SP Mon. Interval:   5    
Application Workspace and Control Pools
      Pool          Pool      Free  (pct.) Largest  Allocation  Garbage
      type          size      bytes         block   failures  collections
Group/User workspace pools     
  Control pool      65536     64848 (98%)    32768       0            0
  Workspace pool   131072    130560 (99%)    65536       0            0
TEST_GRP01                     
  Control pool      25600     25088 (98%)    16384       0            0
  Workspace pool   179200    178688 (99%)    65536       0            0
TEST_GRP02                     
  Control pool      25600     25088 (98%)    16384       0            0
  Workspace pool   179200    178688 (99%)    65536       0            0
DBMS_GRP                       
  Control pool      25600     25088 (98%)    16384       0            0
  Workspace pool   179200    178688 (99%)    65536       0            0
TEST_GRP10                     
  Control pool      25600     25088 (98%)    16384       0            0
  Workspace pool   179200    178688 (99%)    65536       0            0
TEST_GRP_LANG                  
  Control pool      25600     25088 (98%)    16384       0            0
  Workspace pool   179200    178688 (99%)    65536       0            0
 
      

This example displays poolsize information for the application TEST. See Chapter 9 for a description of the fields in this display.

#4

$  ACMS/SHOW APPLICATION/CONNECTIONS
ACMS V4.0    CURRENT APPLICATIONS       Time: 23-APR-1994 10:50:42.95    
    
Application Name: PACCARE_APPL                         State: STARTED 
    
   User Name      Submitter ID        Agent PID      Device 
   SMITH          MYNODE::00030035    22400104       TWA3: 
   ACMS_TEST      YRNODE::023B0004    (YRNODE::)     LTA5006: 
   ACMS_TEST      YRNODE::00B60013    (YRNODE::)     LTA5014: 
    
    
Application Name: EMPLOYEE_INFO_APPLICATION            State: STARTED 
    
   User Name      Submitter ID        Agent PID      Device 
   ACMS_TEST      YRNODE::00B60013    (YRNODE::)     LTA5014: 
   ACMS_TEST      YRNODE::023B0004    (YRNODE::)     LTA5006: 
   SMITH          MYNODE::00030035    22400104       TWA3: 
    
    
Application Name: EMPLOYEE_INFO_APPL_RTS               State: STARTED 
    
   There are no users connected to this application 
 
      

This command displays information about all users connected to applications PACCARE_APPL and EMPLOYEE_INFO_APPLICATION. There are no users connected to the application EMPLOYEE_INFO_APPL_RTS.

#5

$ ACMS/SHOW APPLICATION/DETACHED_TASKS DIST_APPL
                                     
ACMS V4.0       CURRENT APPLICATIONS   Time: 23-APR-1994 09:58:20.65 
 
Application Name: DIST_APPL                   State:  STARTED 
 
  Task Name:  DEQUEUE_TASK 
    Task State:       Active 
    Submitter ID:     YRNODE::00020016        Username:    JONES 
    Retry Limit:      10                      Retry Count: 2 
    Retry Wait Timer: 60 
 
  Task Name:  UPDATE_CENTRAL_TASK 
    Task State:       Waiting to Retry 
    Submitter ID:     YRNODE::00020017        Username:    SMITH 
    Retry Limit:      10                      Retry Count: 0 
    Retry Wait Timer: 60 
      

This example shows that the detached tasks DEQUEUE_TASK and UPDATE_CENTRAL_TASK in the application DIST_APPL are started. The task DEQUEUE_TASK is currently active and has retried two times. The task UPDATE_CENTRAL_TASK is waiting to retry. Both tasks wait 60 seconds before retrying, and both tasks have a retry limit of 10.


ACMS/SHOW APPLICATION/CONTINUOUS Command

Displays information about an active ACMS application in continuous refresh mode.

Format

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


Required Privileges

None

Parameters

application-name

The file name of an application that you want to display information about. Specify only the file name of an application database file; do not include a device, directory, or file type. You can specify only one application name with each command.

Qualifiers

/[NO]BEGINNING_TIME=time

Controls when the command starts displaying information on your terminal screen or when it begins to copy screen information to an output file (if you use /OUTPUT). The /BEGINNING_TIME qualifier is most useful in a command file. You can specify absolute time or a combination of absolute and delta times. See the OpenVMS DCL Dictionary for information about specifying time. The /NOBEGINNING_TIME qualifier is the default.

/[NO]ENDING_TIME=time

Controls when the command stops displaying information on your terminal screen or when it stops copying screen information to an output file (if you use /OUTPUT). The /ENDING_TIME qualifier is most useful when used in a command file. You can specify absolute time or a combination of absolute and delta times. See the OpenVMS DCL Dictionary for information about specifying absolute and delta time. The /NOENDING_TIME qualifier is the default.

/[NO]INTERVAL=seconds

Controls how often a terminal screen is refreshed or how often new information is copied to an output file (if you use /OUTPUT). The default is /INTERVAL=30.

/[NO]OUTPUT [=file-spec]

Controls whether or not display output is sent to a file. If you enter /OUTPUT with a partial file specification, ACMSSHOW is the default file name, .LIS is the default file type, and your current default directory is the directory. The /NOOUTPUT qualifier is the default; output is sent to your terminal.

Notes

The ACMS/SHOW APPLICATION /CONTINUOUS command provides information you can use to evaluate values in the application definition clause MAXIMUM SERVER PROCESSES, and in the MAXIMUM SERVER PROCESSES and MINIMUM SERVER PROCESSES subclauses.

Control the video display by using the control and arrow keys. Press [Ctrl/C], [Ctrl/Y], or [Ctrl/Z] to terminate the display. Press [Ctrl/W] to refresh the screen. Use the up arrow and down arrow keys to scroll the screen forward and backward.

There are cases when the values for average number of active servers, average number of free servers and average number of waiting tasks for a given server are displayed as 0. This can occur even when the displayed maximum values of these quantities are quite large.

The averages that are displayed with the ACMS/SHOW APPLICATION /CONTINUOUS command are calculated as follows. Every time that the screen display needs to be refreshed, EXC is polled for data about the servers and a refresh counter is incremented by 1. The average is determined by dividing the running total of the particular data point (i.e. Waiting Tasks) by the number of times that the display has been refreshed. In the case of a data point that has had a noticable maximum peak over a short amount of time, the average can be very close to zero as the number of refreshes gets very large. The decimal value of the average is rounded down in all cases. So an average of 0.499(9) or less, is rounded down to zero.


Example


$ ACMS/SHOW APPLICATION/CONTINUOUS SANDAPPL
                  ACMS CONTINUOUS APPLICATION MONITOR                       
                        28-MAY-1994 13:48:36.10                             
Name:    SANDAPPL                                State:  STARTED
Process: ACMS01EXC003000
User: EDLOD                                      PID:  2200047C             
Max Tasks: 65535                                 Max SPs:   5               
Cur Tasks: 0                                     Cur SPs:   0               
                                                                            
SERVER NAME                Min SP/Max SP  Current  Average  Minimum  Maximum
                                                                            
SANDSRV                         0/5                                         
    Active Servers                              0        0        0        0
    Free Servers                                0        1        1        1
    Waiting Tasks                               0        0        0        0
      

This command shows the SANDAPPL application in continuous refresh mode. Because you did not name an interval, ACMS changes the screen every 30 seconds. See Chapter 9 for a description of each field in this display.


Previous Next Contents Index