Using the Standalone ISL Utilities [ Performing System Management Tasks ] MPE/iX 5.0 Documentation
Performing System Management Tasks
Using the Standalone ISL Utilities
A standalone utility, as the name implies, works on its own without
information or help from any other utility. The three utilities listed
below are the standalone ISL utilities. Each of them is explained in the
following sections.
--------------------------------------------------------------------------------------------
| | |
| Parameter | Definition |
| | |
--------------------------------------------------------------------------------------------
| | |
| CLKUTIL | Reads or sets the date and time of the hardware clock. The time |
| | should remain set at Greenwich Mean Time (GMT). |
| | |
--------------------------------------------------------------------------------------------
| | |
| IOMAP | Identifies the actual hardware configuration of the system and its |
| | paths and devices. |
| | |
--------------------------------------------------------------------------------------------
| | |
| DISCUTIL | Performs various disk operations and displays information about |
| | the volumes. |
| | |
--------------------------------------------------------------------------------------------
You may also see additional utilities at the ISL prompt.
To set or change the system clock
The ISL utility CLKUTIL reads and sets the hardware clock, which is
maintained either by a Battery Backup Unit (BBU) or an Uniterruptible
Power Supply (UPS), depending on the system. This clock maintains
Greenwich Mean Time (GMT) independently of the software clock that is
displayed when you enter the ISL START utility or any of the other ISL
utilities that support the software clock. Therefore, CLKUTIL reads the
date and time previously set with CLKUTIL, but it does not itself reflect
the changes that you might make while in any other ISL utility.
1. To enter the clock utility, enter the CLKUTIL command at the ISL
prompt:
ISL> CLKUTIL
The system responds with a banner:
________________________________________________________________
| |
| |
| SYSTEM FOR ISL STAND ALONE UTILITIES. [IHO, SPU LAB] |
| Version 1.0 |
| |
| ****** clock utility ************ ver 1.0 ***** 11/6/86 |
| enter command : (r) read clock, (s) set clock > |
| |
________________________________________________________________
2. To read the clock, enter R at the CLKUTIL prompt. The system
responds by displaying the day, the date and the current time.
3. To set the clock, enter S at the CLKUTIL prompt, and at the
prompt, enter the date in the correct format.
* mm is a two-digit number, 01 through 12, representing the
month
* dd is a two-digit number, 01 through 31, representing the
day of the month
* yyyy is a four-digit number representing the year. (You
may also simply enter the last two digits for the year.)
4. When the system prompts you for the time, enter Greenwich Mean
Time using a 24-hour format.
5. The system asks you to verify the adjusted date and time by
issuing a message similar to the following:
THU, JAN 18, 1990, 11:17:00 PM
ok (y/n)?
Enter Y to set the clock. Enter N to return to the enter date
prompt.
6. Press Return at the enter command prompt to return to the ISL
prompt.
NOTE There are two new CI commands, SETCLOCK and SHOWCLOCK, that help
you display information about and manage the system clock. They
allow you to change the system time and time zone without rebooting
the system and using the ISL utility CLKUTIL.
* SHOWCLOCK displays the system time in the hh:mm:ss format,
the current time correction and the time zone.
* SETCLOCK changes the system time by introducing a time
correction into the system that is gradually consumed. By
doing so, it allows for negative time corrections (i.e.
"setting the clock back"), that do not adversely affect
system accounting, database logging and recovery systems and
other user applications that rely on the forward progression
of time.
For more information about the SETCLOCK and SHOWCLOCK commands,
refer to MPE/iX Commands Reference Manual Volumes 1 and 2
(32650-90003 and 32650-90364).
To list system hardware
You can use the IOMAP utility, which you start from ISL, to get complete
information about the system hardware. Once initiated, IOMAP displays a
user interface that is divided into input and output sections so that you
can configure IOMAP and selectively control how it operates.
To start IOMAP, do the following at the system console:
1. Halt system activity and shut the system down. At the MPE prompt,
enter:
CTRL A
=SHUTDOWN
2. Once the system issues the final shutdown message, transfer
control by entering:
CTRL B
CM>TC
If this reply does not work, initiate a hard reset by entering:
CM>RS
3. At the ISL prompt (ISL>), enter the IOMAP command. (If autoboot
is enabled, press any key to interrupt it and display the ISL
prompt, and then enter the command.)
4. To exit the IOMAP utility, enter Y at the prompt:
Do you want to exit this program and return to ISL?
Below is an example of an IOMAP listing for a Series 935:
_______________________________________________________________________________
| |
| |
| IOMAP revision 2807 February 19, 1988 |
| |
| IOMAP Running: ce81 |
| This program has the capability to identify the configuration of |
| the system and its I/O paths and devices. Many of the components of |
| the I/O system can be tested with self-test and loopback diagnostics. |
| |
| Without changing any parameters, this program will |
| map all existing I/0 components in the system, |
| but does not perform any other diagnostics. |
| |
| You may enter break mode by pressing control-C or control-Y. |
| |
| You may press control-X to erase what you just typed in. |
| |
| Do you wish to modify any program parameters? [y,n] (n): N |
| |
| Identify: Loop 1: All I/O components are being identified... |
| Processor Identification: |
| Hardware Model: AH (A1002A), Revision: 0 |
| Hardware ID: xxxxxxxxH, Software ID: xxxxxxxxH |
| Processor Board Revisions: |
| CPU - CPU Chip: 3 |
| SIU - System Interface Unit: 1 |
| CCU - Cache Control Unit: 2 |
| TCU - TLB Control Unit: 2 |
| MIU - Math Interface Unit: 2 |
| PDH - Processor Dependent Hardware: 2 |
| PDC - Processor Dependent Code: 9 |
| Cache and TLB Sizes: |
| Instruction Cache: 128 K bytes, Instruction TLB: 2 K entries |
| Data Cache: 128 K bytes, Data TLB: 2 K entries |
| Co-processors: |
| Floating Point Co-processor is installed |
| Main Memory: 48 M bytes |
| |
_______________________________________________________________________________
_________________________________________________________________________________________
| |
| |
| I/0 Configuration: |
| Type SW Revisions Tests |
| Path Component Name ID Mod Hdwr Firm Avail |
| ------------ -------------------------------------- ---- ---- ---- ---- ----- |
| 0 Native Processor 0H 0H 0 0 |
| 4 CIO Channel Adapter 8H 10H 0 0 |
| 4.1 HP-IB card 2H - 6 2733 ST LB |
| 4.1.0 7937H disc drive 214H - - - |
| 4.1.1 7937H disc drive 214H - - - |
| 4.1.2 7937H disc drive 214H - - - |
| 4.1.3 7937H disc drive 214H - - - |
| 4.1.4 7937H disc drive 214H - - - |
| 4.2 Console Device Adapter |
| 4.3 LAN card 6H - 1 2531 ST |
| 4.4 LAN card 6H - 2 2620 ST |
| 24 Memory Controller 1H 8H 4 0 LB |
| 28 Memory Controller 1H 8H 4 0 LB |
| 32 Memory Controller 1H 8H 4 0 LB |
| 36 CIO Channel Adapter 8H 10H 0 0 |
| 36.5 HP-IB card 2H 6 2733 ST LB |
| 36.5.0 7978A/B mag tape unit 178H - - - |
| Identify Loop 1 (1H) complete. |
| |
| Do you want to exit this program and return to ISL? [y,n] (n): Y |
| IOMAP Exiting. |
| |
_________________________________________________________________________________________
To recover corrupted disk files
DISCUTIL is a standalone utility that lets you perform various disk
operations without the operating system. For example, you can move files
to tape from disks on a system that has directory damage and is,
therefore, logically inoperable.
You start DISCUTIL at the initial system load prompt (ISL) on the system
console. When DISCUTIL is loaded and running, the operating system is
not available.
Below is a list of the commands available to you in DISCUTIL and a brief
explanation of each one.
--------------------------------------------------------------------------------------------
| | |
| Command | Definition |
| | |
--------------------------------------------------------------------------------------------
| | |
| CONFIGURE | Configures additional devices. |
| | |
--------------------------------------------------------------------------------------------
| | |
| DISMOUNT | Dismounts a disk volume making it inaccessible to DISCUTIL. |
| | |
--------------------------------------------------------------------------------------------
| | |
| DO | Re-executes a command from the command history stack after |
| | allowing you to make changes to it. |
| | |
--------------------------------------------------------------------------------------------
| | |
| DSTAT | Displays information about each mounted volume. |
| | |
--------------------------------------------------------------------------------------------
| | |
| EXIT | Terminates DISCUTIL. |
| | |
--------------------------------------------------------------------------------------------
| | |
| HELP | Lists available commands. |
| | |
--------------------------------------------------------------------------------------------
| | |
| LISTREDO | Displays the command line history stack/queue, ordered from the |
| | least to the most recent command with absolute command reference |
| | numbers preceding each command. |
| | |
--------------------------------------------------------------------------------------------
| | |
| MOUNT | Mounts a disk volume making it accessible to DISCUTIL. |
| | |
--------------------------------------------------------------------------------------------
| | |
| PDEV | Lists the disk currently configured and mounted. |
| | |
--------------------------------------------------------------------------------------------
| | |
| REDO | Modifies and re-executes a command in the command history stack. |
| | |
--------------------------------------------------------------------------------------------
| | |
| SAVE | Saves user-specified files from disks to tape. |
| | |
--------------------------------------------------------------------------------------------
| | |
| SHOWDEV | Displays information about each configured device. |
| | |
--------------------------------------------------------------------------------------------
| | |
| TAPE | Displays and selects the current tape LDEV. |
| | |
--------------------------------------------------------------------------------------------
| | |
| UNCONFIG | Unconfigures currently configured devices. |
| | |
--------------------------------------------------------------------------------------------
To enter DISCUTIL, do the following:
1. Halt system activity and shut the system down by entering:
CTRL A SHUTDOWN
2. After the system issues the final shutdown message, enter TC to
soft reset the system. For example:
Shutdown of operating system complete. (Shut 6)
user>
TC
3. Press any key to override autoboot.
4. When you see the message Interact with IPL (Y or N)?, enter Y.
5. At the ISL prompt, enter the DISCUTIL command.
ISL>DISCUTIL
The DISCUTIL banner appears followed by the prompt:
discutil>
The following examples show you how to issue some of the DISCUTIL
commands. Although they may appear similar to the MPE commands or the
commands used in other utilities, these are solely a function of
DISCUTIL. For further information, read Volume Management Reference
Manual (32650-90045).
* To get information about all DISCUTIL commands, enter HELP. To get
information about one of the commands, enter HELP followed by the
command name. For example, to get help with the MOUNT command,
enter:
HELP MOUNT
* To display the command line history stack, enter LISTREDO. To
modify and re-execute one of the commands, use the REDO command.
To simply re-execute the command, use DO.
For example, to modify and re-execute the fifth command you
entered, enter:
discutil>REDO 5
To modify and re-execute the last command entered, enter:
discutil>REDO
To reissue the fifth command without editing it, enter:
discutil>DO 5
* To configure a device, use the CONFIGURE command followed by the
LDEV number, device class and path. For example, to configure a
disk drive as LDEV 21, enter:
discutil>CONFIGURE 21 DISC 6/4.0.0
* To unconfigure a currently configured device, use the UNCONFIG
command followed by the LDEV number of the device. For example,
to take LDEV 14 out of the configuration, enter:
discutil>UNCONFIG 14
* To list the disks currently configured and mounted, their volume
set names, volume numbers and paths, enter the PDEV command. (You
can also get configuration information with the SHOWDEV command.)
* To dismount a disk volume, enter the DISMOUNT command and the LDEV
number of the volume. For example, to dismount LDEV 4, enter:
discutil>DISMOUNT 4
* To mount a disk volume and make it accessible, enter MOUNT and the
volume's LDEV number. For example, to mount volume 4 enter:
discutil>MOUNT 4
* To display the current tape drive, enter the TAPE command. To
assign a logical device as the current tape drive, enter the
command followed by the LDEV number. For example, to configure
LDEV 7 as the current tape drive, enter:
discutil>TAPE 7
* To invoke SAVE, enter SAVE at the discutil prompt and respond with
the appropriate information. (For a detailed explanation of SAVE,
read the next section.)
To recover files with SAVE
To recover files with the SAVE command, perform the following steps:
1. Enter:
discutil>SAVE
2. At the ENTER FILE SET TO BE SAVED: prompt, enter information in
the following format:
[filename[.groupname[.acctname]]]
Indicate the file(s) that you want copied to tape. The file(s)
must reside on a disk defined during startup of DISCUTIL or with
the CONFIGURE command.
You can replace the filename, groupname, and acctname parameters
by @ to indicate all members of the set.
The prompt repeats after the file set is saved. To terminate
SAVE, press RETURN.
3. To save files from a specific device enter the LDEV number and
press RETURN at the ENTER THE LDEV: prompt. SAVE searches only
the specified disk's label table for the file(s) that you want.
To search all disks, press RETURN without entering anything.
The logical device number entered must be known to DISCUTIL. Use
the PDEV command to determine which LDEVs are valid.
4. At the ENTER THE VOLUME SET NAME: prompt, you may enter vsname
(volume set name).
This prompt appears only if you did not specify an LDEV at the
previous prompt. If desired, enter a volume set name to have SAVE
search for the target file(s) on a specific volume set. The
volume set name must be known to DISCUTIL, so use the PDEV command
to determine which names are valid. For the default, press RETURN
to indicate that you want SAVE to search all disks for the
file(s).
5. At the ENTER THE MODIFICATION DATE (MM/DD/YYYY): prompt, you may
specify a retrieval date.
6. Enter a valid tape drive LDEV at the ENTER THE TAPE LDEV: prompt.
DISCUTIL saves the disk files to the tape mounted on the LDEV
specified at this prompt. It repeats the prompt until you enter a
valid LDEV.
DISCUTIL searches the label tables of all LDEVs specified for the
indicated file(s). Each time it finds a file, and each time it
successfully writes a file to tape, it prints a message. DISCUTIL
also reports errors and prompts you to mount new tapes as
necessary. Once it has written all the specified files to tape,
DISCUTIL prompts you to enter another file set for saving.
7. To end the SAVE command, press RETURN without entering a file
name.
Below is a short example of the interaction between user and DISCUTIL
during SAVE:
___________________________________________________________________
| |
| |
| discutil>SAVE |
| |
| ENTER FILE SET TO BE SAVED: MYFILE.JOHN.SMITH |
| |
| ENTER THE LDEV: 3 |
| |
| ENTER THE MODIFICATION DATE(MM/DD/YYYY):06/25/1990 |
| |
| ENTER THE TAPE LDEV: 7 |
| |
| MYFILE .JOHN .SMITH - LDEV 3 - ADDR $0002CA0 - FOUND |
| MYFILE .JOHN .SMITH - LDEV 3 - ADDR $0002CA0 - SAVED |
| |
| ENTER FILE SET TO BE SAVED: |
| |
___________________________________________________________________
To enable the access port (AP)
The access port allows you to use CTRL B commands. To activate it, you
turn the keyswitch on the control panel to the console enabled position.
If you are using a remote console, you can enter CTRL B ER to activate
the access port.
The mode determines the duration of remote access:
Single mode Disables remote access when the remote console
disconnects.
Multiple mode Remote access remains enabled until you enter the DR
command.
The figure below shows the key switch on Series 925 through 949 systems
with the exception of the Series 932 system.
Figure 1-1. Enabling the Access Port
For further information regarding the access port, refer to the System
Startup, Configuration, and Shutdown Reference Manual (32650-90042).
To use the access port
The commands you use to control activity of the access port are listed
below:
--------------------------------------------------------------------------------------------
| | |
| Command | Definition |
| | |
--------------------------------------------------------------------------------------------
| | |
| CA | Configures the system's remote support modem port. |
| | |
--------------------------------------------------------------------------------------------
| | |
| CO | Returns the console from control mode to console mode. |
| | |
--------------------------------------------------------------------------------------------
| | |
| DI | Disconnects the line to a remote console. |
| | |
--------------------------------------------------------------------------------------------
| | |
| DR | Disables access to the system by a remote console. |
| | |
--------------------------------------------------------------------------------------------
| | |
| DS | Disables the display of the system status line during console |
| | mode. |
| | |
--------------------------------------------------------------------------------------------
| | |
| ER | Enables access by a remote console. |
| | |
--------------------------------------------------------------------------------------------
| | |
| ES | Enables the display of the system status line during console mode. |
| | |
--------------------------------------------------------------------------------------------
| | |
| HE | Displays the help screen. |
| | |
--------------------------------------------------------------------------------------------
| | |
| RS | Stops all processing, initiates SPU self-test, and loads software |
| | from the load device if enabled for autoboot. |
| | |
--------------------------------------------------------------------------------------------
| | |
| SE | Transfers the remote terminal from console or control mode to |
| | session mode. |
| | |
--------------------------------------------------------------------------------------------
| | |
| TA | Initiates the access port self-test. |
| | |
--------------------------------------------------------------------------------------------
| | |
| TC | Transfers processor execution to an operating system specific |
| | routine. Initiates a system soft reset. |
| | |
--------------------------------------------------------------------------------------------
| | |
| TE | Sends messages (up to 80 characters) between local and remote |
| | consoles. |
| | |
--------------------------------------------------------------------------------------------
MPE/iX 5.0 Documentation