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.

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 >

To read the clock, enter R at the CLKUTIL prompt. The system responds by displaying the day, the date and the current time.
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.)
When the system prompts you for the time, enter Greenwich Mean Time using a 24-hour format.
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.
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:

Halt system activity and shut the system down. At the MPE prompt, enter:
```
   CTRL A
   =SHUTDOWN
```
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
```
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.)
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, 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:

Halt system activity and shut the system down by entering:
```
   CTRL A SHUTDOWN
```
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
```
Press any key to override autoboot.
When you see the message Interact with IPL (Y or N)?, enter Y.
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:

enter:
```
   discutil>SAVE
```
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.
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.
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).
At the ENTER THE MODIFICATION DATE (MM/DD/YYYY): prompt, you may specify a retrieval date.
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.
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.

Using the Standalone ISL Utilities

Technical documentation

» Table of Contents

» Glossary