| Previous | Contents | Index |
Stops the ACMS system, the TSC, the QTI, and all applications.
ACMS/STOP SYSTEM
Command Qualifier Default /[NO]CANCEL /NOCANCEL
OpenVMS OPER privilege
/[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.
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.
$ ACMS/STOP SYSTEM/CANCEL
|
This command cancels any active tasks and stops all applications, the TSC, the QTI, and the ACMS software.
Stops the TSC, thereby canceling the tasks of all ACMS menu users and signing out all current menu users.
ACMS/STOP TERMINALS
OpenVMS OPER privilege
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.
$ ACMS/STOP TERMINALS
|
This command cancels active tasks and stops the TSC. Users cannot sign in to ACMS.
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.
Ends the ACMSGEN session and returns you to the DCL prompt.
EXIT
None
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.
ACMSGEN> EXIT
$
|
This command ends the ACMSGEN session and returns you to the DCL prompt.
Displays information about ACMSGEN commands and qualifiers.
HELP [ topic [...]]
None
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.
None
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.
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.
SET parameter-name value
None
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.
None
| #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.
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.
SHOW
- parameter-name
- /qualifier [...]
Command Qualifiers Defaults /ACC None /ALL None /CP None /EXC None /MSS None /QTI None /TSC None
None
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.
/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).
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.
| #1 |
|---|
ACMSGEN> SHOW MAX_TTS_CP
MAX_TTS_CP 20 20 0 -1 te
|
For the MAX_TTS_CP parameter, this command displays:
- Value in the work area
- Default value
- Minimum value
- Maximum value (--1 indicates infinity)
- Unit of measure
- Dynamic/fixed status
| #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.
Initializes the ACMSGEN work area with values from a work file.
USE file-spec
None
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.
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.
| #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.
Initializes the ACMSGEN work area with active values for all parameters from an ACMS system global section.
USE ACTIVE
None
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:
- When you use a WRITE ACTIVE command, ACMS writes values from the work area to the global section.
- When you use an ACMS START /SYSTEM command from the DCL prompt, ACMS copies values from the SYS$SYSTEM:ACMSPAR.ACM file to the global section.
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.
| #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.
Initializes the ACMSGEN work area with current values for all parameters from the SYS$SYSTEM:ACMSPAR.ACM parameter file.
USE CURRENT
None
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.
| #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.
Initializes the ACMSGEN work area with ACMS default values for all ACMS parameters.
USE DEFAULT
None
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.
| #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 |