Compaq ACMS for OpenVMS
Managing Applications


Previous Contents Index


ACMS/STOP SYSTEM Command

Stops the ACMS system, the TSC, the QTI, and all applications.

Format

ACMS/STOP SYSTEM

Command Qualifier Default
/[NO]CANCEL /NOCANCEL


Privileges Required

OpenVMS OPER privilege

Qualifiers

/[NO]CANCEL

If you specify the /CANCEL qualifier, all active tasks are canceled immediately. If you specify /NOCANCEL, ACMS waits until all active tasks are either completed or halted before stopping the ACMS system. The default is /NOCANCEL.

Notes

Once you specify the ACMS/STOP SYSTEM command, no new tasks can be started.

Include the ACMS/STOP SYSTEM/CANCEL command in your OpenVMS site-specific shutdown file, SYS$MANAGER:SYSHUTDWN.COM.

If the ACMS system stalls, you might not be able to use the ACMS/STOP SYSTEM command to stop it. Use the STOP command from DCL to stop the ACMS Central Controller (ACC) process. Stop the remaining ACMS process using the ACMS/STOP SYSTEM command.

The ACMS/STOP SYSTEM command executes only when there are no tasks active. If there are active tasks, ACMS waits for the tasks to complete before executing the ACMS/STOP SYSTEM command, and also disables any new tasks from starting. Use the DCL REPLY command to ask users to halt or complete their tasks, and then sign out before issuing the ACMS/STOP SYSTEM command. You can then use the /CANCEL qualifier to stop any tasks that remain active.

See the OpenVMS DCL Dictionary for information about the DCL REPLY command.

To restart ACMS, use the ACMS/START SYSTEM command. To restart applications, use the ACMS/START APPLICATION command after the ACMS/START SYSTEM command. To restart a queue, specify the ACMS/START SYSTEM command with the /QTI qualifier or ACMS/START QUEUE command.


Example


$ ACMS/STOP SYSTEM/CANCEL
      

This command cancels any active tasks and stops all applications, the TSC, the QTI, and the ACMS software.


ACMS/STOP TERMINALS Command

Stops the TSC, thereby canceling the tasks of all ACMS menu users and signing out all current menu users.

Format

ACMS/STOP TERMINALS


Privileges Required

OpenVMS OPER privilege

Notes

Use the ACMS/STOP TERMINALS command to prevent users from signing in or to stop all ACMS task activity.

Because the ACMS/STOP TERMINALS command cancels active tasks and signs users out of ACMS, use the DCL REPLY command to ask users to finish tasks before entering this command. See the OpenVMS DCL Dictionary for information about the DCL REPLY command.

To restart the TSC, specify the ACMS/START TERMINALS command.


Example


$ ACMS/STOP TERMINALS 
      

This command cancels active tasks and stops the TSC. Users cannot sign in to ACMS.


Chapter 22
ACMSGEN Commands

This chapter contains reference information and examples for the ACMSGEN Utility commands. See Chapter 11 for general information on the ACMSGEN Utility. It is recommended that you change ACMSGEN-generated parameters with the ACMSPARAM.COM command procedure. See Chapter 10 for information about the ACMSPARAM.COM command procedure.


EXIT Command (ACMSGEN>)

Ends the ACMSGEN session and returns you to the DCL prompt.

Format

EXIT


Privileges Required

None

Notes

You can also end an ACMSGEN session by pressing [Ctrl/Z]. [Ctrl/Z] signals the end of the file for data entered from the terminal. [Ctrl/Z] is displayed as EXIT.

ACMSGEN does not automatically write your changes to the ACMSGEN work area when you exit.


Example


ACMSGEN> EXIT
$
      

This command ends the ACMSGEN session and returns you to the DCL prompt.


HELP Command (ACMSGEN>)

Displays information about ACMSGEN commands and qualifiers.

Format

HELP [ topic [...]]


Privileges Required

None

Parameters

topic

The command or topic you want to know about. If you do not supply a topic, HELP provides a list of topics to choose from.

Notes

None

Example


ACMSGEN> HELP USE_CURRENT
USE_CURRENT
  Initializes the work area with current values from the ACMSPAR.ACM
  file.
       Format:
           USE CURRENT
Topic?
 
      

This command displays help information about the USE CURRENT command.


SET Command (ACMSGEN>)

Changes parameter values in the ACMSGEN work area. The parameter changes are not made to any real parameter set until you use the WRITE command.

Format

SET parameter-name value


Privileges Required

None

Parameters

parameter-name

The name of the ACMS parameter whose value you are changing. Display the names of parameters by using the SHOW command.

value

The new value for the parameter. Enter integer values in decimal numbers. String values can be enclosed in quotation marks.

Notes

None

Examples

#1

ACMSGEN> SET CP_SLOTS 5
ACMSGEN> SET MAX_LOGINS 25
ACMSGEN> WRITE CURRENT
      

These commands increase the number of users who can sign in by increasing the values of the CP_SLOTS and MAX_LOGINS parameters. The first SET command places 5 in the work area as the value for CP_SLOTS. The second SET command places 25 in the work area as the value for MAX_LOGINS. The WRITE CURRENT command writes values from the work area to the SYS$SYSTEM:ACMSPAR.ACM file.

#2

ACMSGEN> USE WORK
ACMSGEN> SET CP_USERNAME ACMS$CP
ACMSGEN> WRITE CURRENT
      

These commands change the current user name of the Command Process (CP) to ACMS$CP and update the current values for other parameters with values from the work file, WORK.ACM. The USE command initializes the work area with values from the work file. The SET command changes the value of CP_USERNAME to ACMS$CP. The WRITE ACTIVE command copies the values for current parameters from the work area to the global section for current values.


SHOW Command (ACMSGEN>)

Displays the value in the work area, the default value, the minimum value, the maximum value, the unit of measure, and the dynamic/fixed status for ACMS system parameters.

Format

SHOW

Command Qualifiers Defaults
/ACC None
/ALL None
/CP None
/EXC None
/MSS None
/QTI None
/TSC None


Privileges Required

None

Parameters

parameter-name

The name of a parameter that you want to display information about. You must supply a parameter name or you receive an error.

Qualifiers

/ACC

Displays information only for the parameters that affect the ACMS Central Controller (ACC).

/ALL

Displays information for all parameters values.

/CP

Displays information only for the parameters that affect the ACMS Command Process.

/EXC

Displays information only for the parameters that affect the ACMS Application Execution Controller.

/MSS

Displays information only for the parameters that affect the ACMS message switch subsystem.

/QTI

Displays information only for the parameter values that affect the ACMS Queued Task Initiator (QTI).

/TSC

Displays information only for the parameters that affect the Terminal Subsystem Controller (TSC).

Notes

If you specify a qualifier, it overrides the parameter name.

The dynamic/fixed status indicates whether or not you can change the active value for a parameter. You can change the active or current values of dynamic parameters. You can change only the current values of fixed parameters.


Examples

#1

ACMSGEN> SHOW MAX_TTS_CP
MAX_TTS_CP      20       20       0       -1       te
 
      

For the MAX_TTS_CP parameter, this command displays:

#2

ACMSGEN> SHOW/TSC
Parameters in use:  CURRENT
Parameter Name  Current    Default Minimum  Maximum  Unit     Dynamic
--------------  -------    ------- -------  -------  ----     -------
MAX_LOGINS      60         60      0        -1       submitters    D 
MAX_TTS_CP      20         20      0        -1       terminals     D
PERM_CPS        1          1       0        -1       command prcs  D
CP_SLOTS        3          3       0        -1       command prcs  D
MIN_CPIS        2          2       0        -1       CP threads    D
TSC_USERNAME    ACMSSYSTEM SYSTEM                    VMS username
TSC_PRIORITY    6          4       0        31       VMS priority
 
      

This command displays information for parameters that affect the TSC, including the values now in the work area.

#3

ACMSGEN> USE ACTIVE
ACMSGEN> SHOW/ALL
      

The USE ACTIVE command places active values for all parameters into the work area. The SHOW command displays information for all parameters, including the active values in the work area.

#4

ACMSGEN> USE WORK
ACMSGEN> SHOW/TSC
      

The USE command initializes the work area with values from the file SYS$SYSTEM:WORK.ACM. The SHOW command displays information about parameters affecting the TSC, including their work file values from the work area.


USE Command (ACMSGEN>)

Initializes the ACMSGEN work area with values from a work file.

Format

USE file-spec


Privileges Required

None

Parameters

file-spec

The file specification of the parameter file you created with the WRITE command. SYS$SYSTEM is the default device and directory for the file. The default file type is .ACM.

Notes

If the work area does not contain work file values, initialize the work area with the USE command before performing any operation (such as display or update) with values from a work file.

Examples

#1

ACMSGEN> USE WORK
ACMSGEN> WRITE ACTIVE
      

These commands update the active values for dynamic parameters with values from a work file, WORK.ACM. The USE command initializes the work area with values from the work file. The WRITE ACTIVE command copies values for dynamic parameters from the work area to the global section for active values.

#2

ACMSGEN> USE WORK
ACMSGEN> WRITE CURRENT
      

These commands update current values with values from the work file WORK.ACM. The WORK.ACM file contains values from an earlier ACMSGEN session. The USE command initializes the work area with values from the WORK.ACM file. The WRITE CURRENT command copies values from the ACMSGEN work area to the SYS$SYSTEM:ACMSPAR.ACM file.


USE ACTIVE Command (ACMSGEN>)

Initializes the ACMSGEN work area with active values for all parameters from an ACMS system global section.

Format

USE ACTIVE


Privileges Required

None

Notes

Active values are used by an active ACMS system. ACMS keeps active values in a system global section. The global section can receive active values in two ways:

If the work area does not contain active values, initialize the work area with the USE ACTIVE command before performing any operation, such as display or update, with active values.

If the ACMS system is inactive when you use the USE ACTIVE command, you receive an error message. Values in the work area do not change.


Examples

#1

ACMSGEN> USE ACTIVE
ACMSGEN> WRITE WORK
      

These commands place a copy of the active values for all parameters in the work file, SYS$SYSTEM:WORK.ACM. The USE ACTIVE command initializes the work area with active values for all parameters. The WRITE command copies all values in the work area to the work file.

#2

ACMSGEN> USE ACTIVE
ACMSGEN> SET MIN_CPIS 2
ACMSGEN> WRITE ACTIVE
      

These commands change the active value for MIN_CPIS to 2. The USE ACTIVE command initializes the work area with active values for all parameters. The SET command places 2 in the work area as the value for MIN_CPIS. The WRITE ACTIVE command copies the values for dynamic parameters from the work area to the global section for active values.

#3

ACMSGEN> USE ACTIVE 
ACMSGEN> WRITE CURRENT
      

These commands use active values to update current values for dynamic parameters. The USE ACTIVE command initializes the work area with active values for all parameters. The WRITE CURRENT command copies the values from the work area to the SYS$SYSTEM:ACMSPAR.ACM file as new current values.


USE CURRENT Command (ACMSGEN>)

Initializes the ACMSGEN work area with current values for all parameters from the SYS$SYSTEM:ACMSPAR.ACM parameter file.

Format

USE CURRENT


Privileges Required

None

Notes

Current values are the values used to initialize ACMS. By default, ACMSGEN initializes the ACMSGEN work area with current values. Often you can display or update current values without initializing the work area explicitly.

Examples

#1

ACMSGEN> USE CURRENT
ACMSGEN> SET PERM_CPS 2
ACMSGEN> WRITE CURRENT
      

These commands change the current value for PERM_CPS to 2. The USE CURRENT command initializes the work area with current values. The SET command places 2 in the work area as the value for PERM_CPS. The WRITE CURRENT command updates the values in the SYS$SYSTEM:ACMSPAR.ACM file with values from the work area.

#2

ACMSGEN> USE CURRENT
ACMSGEN> WRITE WORK
      

The USE CURRENT command initializes the work area with current values. The WRITE command copies values from the work area to the work file, SYS$SYSTEM:WORK.ACM.

#3

ACMSGEN> USE CURRENT
ACMSGEN> WRITE ACTIVE
      

These commands use current values to update the active values of dynamic parameters. Recent changes to current values can take effect immediately for some parameters. The USE CURRENT command initializes the work area with current values for all parameters. The WRITE ACTIVE command copies values for dynamic parameters from the work area to the global section for active values.


USE DEFAULT Command (ACMSGEN>)

Initializes the ACMSGEN work area with ACMS default values for all ACMS parameters.

Format

USE DEFAULT


Privileges Required

None

Notes

If the work area does not contain default values, initialize the work area with the USE DEFAULT command before performing any operation, except display, with ACMS default values. You cannot change values in the default list.

For a list of the default values for ACMSGEN parameters, see Table 11-3.


Examples

#1

ACMSGEN> USE DEFAULT
ACMSGEN> WRITE ACTIVE
      

These commands reset the active values for dynamic parameters to ACMS default values. The USE DEFAULT command initializes the work area with ACMS default values. The WRITE ACTIVE command writes values for dynamic parameters from the work area to the global section for active values.

#2

ACMSGEN> USE DEFAULT
ACMSGEN> WRITE CURRENT
      

These commands reset current values to ACMS default values. The USE DEFAULT command initializes the work area with ACMS default values. The WRITE CURRENT command writes values from the work area to the SYS$SYSTEM:ACMSPAR.ACM file as current values for all ACMS parameters.


Previous Next Contents Index