Compaq ACMS for OpenVMS
Managing Applications
Previous Contents Index

ACMS/INSTALL Command

Installs an application in ACMS$DIRECTORY or removes an application database file from ACMS$DIRECTORY.

Format

ACMS/INSTALL file-spec

Command Qualifier Default
/[NO]REMOVE /NOREMOVE

Privileges Required

Application Authorization Utility (AAU) authorization.

Parameters

file-spec

The file specification of an application database file to be moved to or removed from ACMS$DIRECTORY. The application database file must have a file type of .ADB.

If the file is to be moved into ACMS$DIRECTORY, the file specification can be any valid RMS file specification or logical name. If it is a logical name that is a search list, only the first translation in the search list is used. When you omit the device and directory, ACMS looks for the application database file in your default directory. The default file type is .ADB.

If the file is to be removed from ACMS$DIRECTORY, specify the /REMOVE qualifier and the file name of the application. Do not specify a node, device, directory, or file type, or you receive an error.

Qualifiers

/[NO]REMOVE

The /REMOVE qualifier indicates that you want to delete the specified application from ACMS$DIRECTORY. The default is /NOREMOVE.

Notes

You can install or delete only one application database file at a time. ACMS displays a message telling you when an application database file is successfully installed.

You do not need to install applications every time you start your ACMS system. This differs from the way you use OpenVMS INSTALL and some other ACMS operator commands.

The ACMS/INSTALL command does not support search lists.

Examples

#1 

$ ACMS/INSTALL APPL$:EMPLAPP.ADB
Application Database File APPL$:EMPLAPP.ADB Installed - 
in ACMS$DIRECTORY

This command searches for the file EMPLAPP.ADB on the disk and directory identified by the logical name APPL$, checks the application database file against the application authorization in the ACMSAAF.DAT file, and installs the application database file in ACMS$DIRECTORY. ACMS displays a message when it has successfully installed the application database file.

#2 

$ ACMS/INSTALL EMPLAPP /REMOVE
Application Database File EMPLAPP Removed from ACMS$DIRECTORY

Because it includes the /REMOVE qualifier, this command deletes the application database file EMPLAPP from ACMS$DIRECTORY. Only the application file name is specified. ACMS displays a message when it has successfully deleted the application database file.

#3 

$ ACMS/INSTALL EMPLAPP.ADB
Application Database File APPL$:EMPLAPP.ADB Installed - 
in ACMS$DIRECTORY

Because this command does not include a device or directory with the file specification, the ACMS/INSTALL command searches your default directory. ACMS displays a message when it has successfully located and installed the application database file.

ACMS/MODIFY APPLICATION Command

Modifies the attributes of an active application.

Format

ACMS/MODIFY APPLICATION [ application-name[,...]]

Command Qualifiers Defaults
/APPLICATION_ATTRIBUTES=(attribute[,...]) None
/[NO]CONFIRM /CONFIRM
/[NO]LOG /NOLOG
/SERVER_ATTRIBUTES=(attribute[,...]) None
/TASK_ATTRIBUTES=(attribute[,...]) None

Privileges Required

OpenVMS OPER privilege

Parameters

application-name

The name of the active application that you want to modify. If you do not supply an application name, all applications are modified with the attributes you specify. You can specify more than one application name by separating each name with a comma (,).

Qualifiers

/APPLICATION_ATTRIBUTES=(attribute[,...])

Modifies an attribute of the active application. The attribute argument specifies the attribute you want to modify. Specify more than one attribute by separating the attributes with a comma (,) and enclosing them in parentheses.

You can specify one or more of the following attributes:

/[NO]CONFIRM

This qualifier determines whether or not ACMS displays each application selected for modification and prompts you for confirmation before making the modifications. The default is /CONFIRM.

/[NO]LOG

This qualifier determines whether or not ACMS displays information level status messages generated by the modify request. The default is /NOLOG.

/SERVER_ATTRIBUTES=(attribute[,...])

Modifies an attribute of a server in the specified application. The attribute argument specifies the attribute you want to modify. Specify more than one attribute by separating the attributes with a comma (,) and enclosing them in parentheses.

The /SERVER_ATTRIBUTES qualifier is a repeating qualifier. This means that you can specify the /SERVER_ATTRIBUTES qualifier more than once on the same command.

You can specify one or more of the following attributes:

/TASK_ATTRIBUTES=(attribute[,...])

Modifies the attributes of the specified task. The attribute argument specifies the attribute you want to modify. Specify more than one attribute by separating the attributes with a comma (,) and enclosing them in parentheses.

The /TASK_ATTRIBUTES qualifier is a repeating qualifier. This means you can specify the /TASK_ATTRIBUTES qualifier more than once on the same command.

You can specify one or more of the following attributes:

Notes

When you specify the ACMS/MODIFY APPLICATION command, parameters are only modified within the current active application. If the application is stopped and restarted, the parameters are reset to the values specified in the application definition. If you want a modification to be permanent, you must modify the application definition.

Examples

#1 

$ ACMS/MODIFY APPLICATION TEST /APPLICATION_ATTRIBUTES=(NOAUDIT, -
_$ MAX_INSTANCE=3)
Apply Modifications to Application TEST (Y/[N]):

This command disables audit trail logging for the application and allows a maximum of three tasks to execute within the TEST application at any given time. ACMS displays the confirmation prompt before executing this command.

#2 

$ ACMS/MODIFY APPLICATION DATADAT -
_$ /SERVER_ATTRIBUTES=(NAME=(SERVER_1880,SERVER_1776), -
_$ MAX_PROCESS=5,MIN_PROCESS=1) -
_$ /SERVER_ATTRIBUTES=(NAME=SERVER_ODCE, -
_$ MAX_PROCESS=10,MIN_PROCESS=3) 
Apply Modifications to Application DATADAT (Y/[N]):

This command modifies the application DATADAT, setting the maximum processes allowed for servers SERVER_1880 and SERVER_1776 to 5 and the minimum processes required to 1. This command also modifies the attributes of server SERVER_ODCE, setting the maximum processes allowed to 10 and the minimum processes required to 3. Because /CONFIRM is the default, ACMS prompts you before executing this command.

#3 

$  ACMS/MODIFY APPLICATION POST_REQ -
_$ /SERVER_ATTRIBUTES=(NAME=SERVER_10,CREATION= -
_$ (DELAY=10,INTERVAL=30)) -
_$ /NOCONFIRM

This command modifies application POST_REQ, causing ACMS to wait 10 seconds for an instance of SERVER_10 to become free before creating a new server process. Once a new server is created, ACMS must wait 30 seconds before creating another new server.

#4 

$  ACMS/MODIFY APPLICATION NEWAPPL -
_$  /TASK_ATTRIBUTES=(NAME=(DTSK,FTSK),DISABLE) - 
_$  /TASK_ATTRIBUTES=(NAME=NEWTSK,ENABLE) /NOCONFIRM

This command modifies the application NEWAPPL, disabling the tasks DTSK and FTSK and enabling the task NEWTSK.

ACMS/REPLACE SERVER Command

Replaces a server image with a new version of that image. All subsequent tasks use the new image.

Format

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

Command Qualifiers Defaults
/APPLICATION=application-name See text
/[NO]CONFIRM /CONFIRM
/[NO]LOG /NOLOG

Privileges Required

OpenVMS OPER privilege

Parameters

server-name

The name of the server you want to replace. The server name is defined in the application definition. If you do not specify a server name, ACMS replaces all servers.

Qualifiers

/APPLICATION=application-name

Causes ACMS to replace server images only in the application you specify. Specify the application file name only; do not include node, device, or directory.

When you specify an application name with the /APPLICATION qualifier, ACMS searches for the server name in the application you specify. If you specify the /APPLICATION qualifier but do not specify a server name, ACMS searches for all servers in the application. If you do not specify the /APPLICATION qualifier, ACMS searches for the server name in all applications on the node.

/[NO]CONFIRM

The /CONFIRM qualifier causes ACMS to display each server selected for replacement and prompt you to indicate whether or not you want to replace the server. The /NOCONFIRM qualifier causes ACMS not to prompt you for confirmation. The default is /CONFIRM.

/[NO]LOG

Controls whether or not ACMS displays a message after replacing a server. The /NOLOG qualifier is the default.

Notes

When the application controller receives the ACMS/REPLACE SERVER command, it runs down all free server processes for the specified server and requests all active servers to run down when they are free. A server retaining context does not run down until the context has been released. New server processes are created to meet the minimum and maximum server process requirements of the application. If a server image is active or still executing, ACMS replaces it with the new version once it stops executing or is aborted.

If a server image does not stop because of an infinite loop, use the command ACMS/SHOW SERVER to determine the server process ID. To stop the server process, use one of the following:

You cannot replace a DCL server because the image executed is supplied by Compaq It is not customer modifiable.

See Chapter 9 for more information about this command.

If you use the ACMS/REPLACE SERVER command to replace a server when an application is not fully started, then EXC logs the following error message in SWL: 


%ACMSI-E-BADSTATE, Internal Error: invalid state 00000006

Examples

#1 

$ ACMS/REPLACE SERVER MYSERV/NOCONFIRM

This command replaces the server image for the server MYSERV with a new version of that image in all applications.

#2 

$ ACMS/REPLACE SERVER MYSERV/APPLICATION=TESTALL/NOCONFIRM

This command replaces the server image for the server MYSERV in the application TESTALL with a new version of that image.

ACMS/REPROCESS APPLICATION_SPEC Command

Causes ACMS to retranslate the application specification for an application and redirect all subsequent task selections to the application pointed to by the application specification.

Format

ACMS/REPROCESS APPLICATION_SPEC application-spec

Command Qualifiers Defaults
/[NO]CONFIRM /CONFIRM
/[NO]LOG /NOLOG

Privileges Required

OpenVMS OPER privilege

Parameters

application-spec

The application specification for an application. It can be a logical name or a search list of application database files. If the application specification is a search list, the first available application in the search list is used.

The search list can contain an application that resides on a remote node. If the file resides on a remote node, you must specify the remote node name in the search list. The following is an example of a search list defined as the logical name PAYROLL: 


$ DEFINE/SYSTEM PAYROLL BIGAPPL::PAYROLL, FASTAPPL::PAYROLL, -
_$ BACKUP::PAYROLL

You cannot specify access control strings in an application specification. See Chapter 6 for more information on application specifications.

Qualifiers

/[NO]CONFIRM

The /CONFIRM qualifier causes ACMS to prompt you for confirmation before reprocessing the application specification. The /NOCONFIRM qualifier causes ACMS not to prompt you for confirmation before performing the reprocess. The default is /CONFIRM.

/[NO]LOG

Controls whether or not ACMS displays a message after translating the application specification. The /NOLOG qualifier is the default.

Notes

The ACMS/REPROCESS APPLICATION_SPEC command can be used to failover to applications. If a search list is used for an application specification, automatic failover occurs in the event of a system failure. Use the ACMS/REPROCESS APPLICATION_SPEC command to failover to the original application when it becomes available.

The ACMS/REPROCESS APPLICATION_SPEC command is not supported if, on a single submitter node, you have two application specification logical names that point to two differently ordered search lists containing the same application names.

Example


$ ACMS/REPROCESS APPLICATION_SPEC PAYROLL

This example causes ACMS to retranslate the search list for the logical name PAYROLL. ACMS uses the first available application in the search list.

ACMS/RESET AUDIT Command

Resets the ACMS Audit Trail Logger, causing the ACMS audit trail log file to be closed and a new log file to be opened.

Format

ACMS/RESET AUDIT

Privileges Required

OpenVMS OPER privilege

Notes

If the Audit Trail Logger process has stopped, the ACMS/RESET AUDIT command restarts the process.

Starting ACMS creates a new version of the audit trail log file.

The logical name ACMS$AUDIT_LOG points to the ACMS audit trail log file. ACMS$AUDIT_LOG is defined during system startup with auditing enabled and when audit trail logging is enabled with the ACMS/SET SYSTEM /AUDIT command.

If the logical name ACMS$AUDIT_LOG is already defined when you execute the ACMS/RESET AUDIT command, ACMS creates a new version of the file using its equivalence name string. If the logical ACMS$AUDIT_LOG is not defined, ACMS creates the file SYS$ERRORLOG:ACMSAUDIT.LOG. For more information about the Audit Trail Logger and the audit trail log file, see Chapter 12.

Example


$ ACMS/RESET AUDIT

This command creates a new version of the Audit Trail Logger.

ACMS/RESET TERMINALS Command

Causes ACMS to read the DDU database file and authorize any new controlled terminals as well as release any terminals that are no longer authorized.

Format

ACMS/RESET TERMINALS

Privileges Required

OpenVMS OPER privilege

Notes

The TSC must be started before you can use the ACMS/RESET TERMINALS command. The ACMS/RESET TERMINALS command only affects terminals controlled by the TSC. No current terminal user is affected.

If you assign the AUTOLOGIN or CONTROLLED sign-in characteristics to a terminal, ACMS reads the new characteristic only when you:

If a terminal that was previously assigned the NOT CONTROLLED characteristic is assigned the CONTROLLED characteristic, ACMS checks to see if that terminal is currently using the ACMS menu interface. If it is, ACMS designates the terminal as controlled so it is not released when the user signs out. If the terminal is not using the ACMS menu interface, the TSC allocates that terminal.

Conversely, if a terminal that was previously assigned the CONTROLLED characteristic is now assigned the NOT CONTROLLED characteristic, ACMS checks to see if that terminal is currently using the ACMS menu interface. If it is, ACMS designates the terminal as not controlled and releases the terminal when the user signs out. If the terminal is not using the ACMS menu interface, the TSC deallocates that terminal. Once deallocated, the terminal can be used to sign in normally.

For more information about sign-in characteristics for terminals, see Chapter 2.

Example


$ ACMS/RESET TERMINALS

This command makes available to ACMS any terminals recently assigned the CONTROLLED characteristic. Terminals defined with the CONTROLLED characteristic sign directly in to ACMS when users type an OpenVMS login sequence.

Previous Next Contents Index