Commands [ Silhouette Reference Manual ] MPE/iX 5.0 Documentation
Silhouette Reference Manual
Chapter 6 Commands
This chapter introduces the commands available to help you manage
Silhouette capabilities. The information provided for each command
includes its syntax, parameters, a discussion on its use, and an example.
To access and manage the Silhouette environment program, use the MPE :RUN
command to activate the Silhouette Manager Program (MP). After you enter
RUN SILMP.PUB.SYS, the Silhouette system banner appears, followed by the
program chevron prompt (>):
:RUN SILMP.PUB.SYS
HP30302 (A.01.00) Silhouette Manager Program
(C) COPYRIGHT Carolian Systems International Inc. 1984
>
If you are using an MPE XL operating system, specifying SILMP at the
colon prompt (:) takes you into the Silhouette program and displays the
Manager Program (MP) chevron prompt (>). The ability to run a program,
such SILMP.PUB.SYS, without explicitly using the MPE XL :RUN command is
called an implied :RUN. Use the :RUN command (RUN SILMP.PUB.SYS) or
simply enter SILMP to access the Silhouette program.
The Manager Program (MP) is your means of communicating with Silhouette.
Enter commands at the chevron prompt (>), to perform various Silhouette
functions.
The following listing describes the types of Silhouette commands
available to you:
Type Command Function
Managing >SYSTEM - Specifies current configuration file.
Configuration
Files
>VERIFY - Validates information in configuration file.
Starting and >BACKUP - Releases files so a backup can be performed on
Stopping the secondary system.
Silhouette
>KILL - Stops program without completing transactions.
>RECOVER - Applies transactions from a logfile to the
database.
>RELEASE - Closes a communications line.
>RESUME - Restarts the program after a backup is performed.
>START - Starts the program and creates components
>STOP - Stops program after completing transactions.
>SWITCH - Makes the secondary system the primary system.
>USE - Opens a communications line.
(cont.)
Requesting Status >CONFIG - Provides information about current configuration.
>STATUS - Provides information on the status of Silhouette.
Miscellaneous >EXIT - Terminates the MP, but not Silhouette.
>HELP - Displays a description of each command.
>VERSION - Displays information about the software version.
All Silhouette commands except the >SWITCH command are valid on the
primary system. Only the >SYSTEM, >STATUS, >SWITCH, VERIFY, and VERSION
commands are valid on the secondary system.
Each configured Silhouette system allows only one user to run the Manager
Program (MP) for each configuration file. The Silhouette system can
handle more than one logfile but only one logfile can be specified per
configuration file.
Several Silhouette commands require that you specify the appropriate
configuration file. If only one configuration file exists on the system,
it need not be specified. If two or more configuration files exist on a
Silhouette system (for example, FILEA and FILEB), to start the
duplicating process you must enter >START FILEA or >START FILEB rather
than just >START.
In order to facilitate user-defined commands (UDCs), a command will be
accepted using the INFO= parameter of the MPE :RUN command. In this
case, the single command is executed and the process terminated.
Figure 6-1 is an example of a UDC that starts the Silhouette system, and
then stops the system.
____________________________________________
| |
| START |
| OPTION LIST |
| RUN SILMP.PUB.SYS;INFO="START CONFIG"|
| ***** |
| STOP |
| OPTION LIST |
| RUN SILMP.PUB.SYS;INFO="STOP CONFIG" |
| ***** |
____________________________________________
Figure 6-1. Silhouette UDC
MPE/iX 5.0 Documentation