HP 3000 Manuals HP 3000 Manuals
Using the SYSGEN I/O Configurator
To view and modify the I/O configuration from within SYSGEN, you use the
I/O configurator module. To do so, start SYSGEN and enter IO at the
SYSGEN prompt. SYSGEN displays the commands available to you. To issue
a command, you can enter either the full command name or the abbreviation
shown in parentheses.
____________________________________________________________________________
| |
| |
| :SYSGEN |
| sysgen>IO |
| |
| ** I/O configurator commands ** |
| |
| aclass (ac) adev (ad) apath (ap) avol (av) |
| dclass (dc) ddev (dd) dpath (dp) dvol (dv) |
| lclass (lc) ldev (ld) lpath (lp) lvol (lv) |
| maddress(ma) mclass (mc) mdev (md) mpath (mp) |
| mvol (mv) |
| |
| clear (cl)(c) exit (ex)(e) help (he)(h) hold (ho) |
| oclose (oc) redo |
| |
| io> |
| |
| |
____________________________________________________________________________
Example 5-1. Starting the I/O Configurator
Getting help with I/O Configurator commands
The help facility enables you to identify quickly the function and syntax
of those I/O configurator commands and options required to perform the
multiple operations that define or change device-dependent information.
To see a list of the commands available for use in the I/O configurator
and their abbreviations, enter HELP at the I/O configurator prompt. To
display the syntax for each available command at the current level, enter
HELP ALL, as shown in the example below:
__________________________________________________________________________
| |
| |
| io>HELP ALL |
| |
| command (abb) parameter=value |
| ------------- --------------- |
| |
| aclass (ac) class = name |
| ldev = #/#,#,... |
| [mode = IN|OUT|CIO|NCIO|RANDOM| |
| DEFAULT] |
| |
| adev (ad) ldev = #/#,#,... |
| [path = devicepath] |
| id = productid |
| [rsize = recordsize] |
| [outdev = outputdevice] |
| [mode = JOB|DATA|INTERACTIVE|DUPLICATIVE| |
| INPUT|OUTPUT|AUTOREPLY|NLIO|NONE] |
| [class = classname,...|NONE] |
| [cmode = IN|OUT|CIO|NCIO|RANDOM| |
| DEFAULT] |
| [pmgr = physicalmanagername] |
| [lmgr = logicalmanagername] |
| [pmgrpri = physicalmanagerpriority] |
| [mpetype = compmodetype] |
| [mpesubtype= compmodesubtype] |
| [devname = devicename] |
| . |
| . |
| |
| mpath (mp) path = devicepath |
| [id = productid] |
| [pmgr = managername] |
| [lmgr = managername] |
| [pmgrpri = managerpriority] |
| [maxios = maxconcurrentchannelI/Os] |
| |
| mvol (mv) vname = volumename |
| [newname = newvolumename] |
| [ldev = logicaldevice#] |
| [transient = %ofdiscfortransientobjects] |
| [permanent = %ofdiscforpermanentobjects] |
| [vclass = volumeclass] |
| |
__________________________________________________________________________
Example 5-3. I/O Configurator HELP ALL Command Output
To view the syntax for a specific I/O configurator command, enter HELP
commandname at the I/O configurator prompt. For example, to get
information about the ADEV command, you would enter HELP ADEV.
___________________________________________________________________________
| |
| |
| io>HELP ADEV |
| |
| adev (ad) ldev = #/#,#,... |
| path = devicepath |
| id = productid |
| [rsize = recordsize] |
| [outdev = outputdevice] |
| [mode = JOB|DATA|INTERACTIVE| DUPLICATIVE| |
| INPUT|OUTPUT|AUTOREPLY|NLIO|NONE] |
| [class = classname,...|NONE] |
| [cmode = IN|OUT|CIO|NCIO|RANDOM| |
| DEFAULT] |
| [pmgr = physicalmanagername] |
| [lmgr = logicalmanagername] |
| [pmgrpri = physicalmanager priority] |
| [mpetype = compmodetype] |
| [mpesubtype= compmodesubtype] |
| [devname = devicename] |
| io> |
| |
___________________________________________________________________________
Example 5-4. I/O Configurator Command HELP Output
Using I/O Configurator commands
The I/O configurator commands let you list, modify, add, and delete four
types of objects: classes, devices, paths, and volumes. You can also
use the I/O configurator to modify addresses with the MADDRESS command.
In addition to these specific functions, the I/O configurator includes
the commands that are common to all SYSGEN configurators: CLEAR, EXIT,
HELP, HOLD, and OCLOSE.
Table 5-1. IO Configurator Command Matrix
----------------------------------------------------------
| | | | | |
| | List | Modify | Add | Delete |
| | | | | |
----------------------------------------------------------
| | | | | |
| Class | LCLASS | MCLASS | ACLASS | DCLASS |
| | | | | |
----------------------------------------------------------
| | | | | |
| Device | LDEV | MDEV | ADEV | DDEV |
| | | | | |
----------------------------------------------------------
| | | | | |
| Path | LPATH | MPATH | APATH | DPATH |
| | | | | |
----------------------------------------------------------
| | | | | |
| Volume | LVOL | MVOL | AVOL | DVOL |
| | | | | |
----------------------------------------------------------
| | | | | |
| Address | | MADDRESS | | |
| | | | | |
----------------------------------------------------------
Viewing the current configuration
To get information about the current configuration, either displayed on
screen or printed, using the LCLASS, LDEV, LPATH, and LVOLcommands as
described in the following table.
Table 5-2. I/O Configurator List Commands
-----------------------------------------------------------------------------------------------
| | | |
| Command | Definition | Examples |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| LCLASS | Lists the class name or names you specify | LCLASS DISC |
| | with the command, the class modes, and the | LCLASS (DISC,LP) |
| | devices associated with the classes in the | |
| | I/O configuration. A class name is an | |
| | identifier to which numerous devices can be | |
| | assigned. Unlike LDEV numbers, device | |
| | class names are not unique to each device. | |
| | For example, all of your system's printers | |
| | could be assigned the class name LP. (LP, | |
| | which stands for "line printer," is a | |
| | common device class name.) For more | |
| | information, refer to the Controlling | |
| | System Activity (32650-90155). It provides | |
| | detailed information about device class | |
| | names, their modes of operation, and how | |
| | they are assigned in the system. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| LDEV | Lists the attributes of the specified | LDEV CLASS=(LP,EPOC) |
| | logical device or devices. If you omit the | LDEV (4/9,11/14) |
| | LDEV number, all of the I/O devices and | |
| | their characteristics are listed. Each | |
| | configured logical device (LDEV) has a | |
| | uniquely assigned LDEV number which | |
| | identifies a physical device associated | |
| | with a system. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| LPATH | Lists information about the adapters and | LPATH PATH=4 |
| | I/O devices on a specified path level. You | LPATH,1 |
| | can list a specific path, list paths a | LPATH MANAGER=CIPER_DM |
| | specific level, or list all paths | |
| | associated with an I/O manager. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| LVOL | Lists the attributes of the specified | LVOL MEMBER1 |
| | volume, which is one disk pack. Each | |
| | volume is a member of a volume set and | |
| | contains a volume label, a label table, and | |
| | a free space map. When you enter the LVOL | |
| | command for a specific volume, you will see | |
| | the volume's LDEV number, the amount of | |
| | transient and permanent space it has, its | |
| | class status, and the volume class it | |
| | belongs to. | |
| | | |
-----------------------------------------------------------------------------------------------
Printing the configuration information.
You can use the OFFLINE option to send the output of the listing
commands, LCLASS, LDEV, LPATH or LVOL, to the file SYSGLIST. Using
OFFLINE does not immediately generate printed output. The information is
sent to SYSGLIST until you either enter the OCLOSE command or exit
SYSGEN. Exiting SYSGEN or using OCLOSE closes SYSGLIST and prints the
file.
For example, to print information about all devices with device class
DISC and LP on your system, do the following:
1. At the I/O Configurator prompt (>io) enter:
io>LCLASS (DISC,LP) DEST=OFFLINE
Or, you can enter the command this way:
io>LCLASS (DISC,LP) OFFLINE
2. To close the file SYSGLIST and print the information, enter
io>OCLOSE
Sample configuration data.
Below is an example of the kind of information you might see if you
entered the LDEV command, without additional parameters, at the I/O
configurator prompt on a Series 925 system.
_____________________________________________________________________
| |
| |
| io>LDEV |
| LDEV: 1 DEVNAME: OUTDEV: 0 MODE: |
| ID: HP7937H RSIZE: 128 DEVTYPE: DISC |
| PATH: 4.1.0 MPETYPE: 3 MPESUBTYPE: 10 |
| CLASS: DISC SPOOL |
| |
| LDEV: 2 DEVNAME: OUTDEV: 0 MODE: |
| ID: HP7937H RSIZE: 128 DEVTYPE: DISC |
| PATH: 4.1.1 MPETYPE: 3 MPESUBTYPE: 10 |
| CLASS: DISC SPOOL |
| |
| LDEV: 3 DEVNAME: OUTDEV: 0 MODE: |
| ID: HP7937H RSIZE: 128 DEVTYPE: DISC |
| PATH: 4.1.2 MPETYPE: 3 MPESUBTYPE: 10 |
| CLASS: DISC SPOOL |
| |
| LDEV: 4 DEVNAME: OUTDEV: 0 MODE: |
| ID: HP7937H RSIZE: 128 DEVTYPE: DISC |
| PATH: 4.1.3 MPETYPE: 3 MPESUBTYPE: 10 |
| CLASS: DISC SPOOL |
| |
| LDEV: 6 DEVNAME: OUTDEV: 0 MODE: |
| ID: HP2566A RSIZE: 66 DEVTYPE: LP |
| PATH: 4.5.6 MPETYPE: 32 MPESUBTYPE: 9 |
| CLASS: LP |
| |
| LDEV: 7 DEVNAME: OUTDEV: 0 MODE: |
| ID: HP7980A RSIZE: 128 DEVTYPE: TAPE |
| PATH: 4.5.3 MPETYPE: 24 MPESUBTYPE: 5 |
| CLASS: TAPE |
| |
| LDEV: 10 DEVNAME: OUTDEV: LP MODE: JA |
| ID: HP7980A RSIZE: 128 DEVTYPE: TAPE |
| PATH: 4.5.4 MPETYPE: 24 MPESUBTYPE: 5 |
| |
| LDEV: 20 DEVNAME: OUTDEV: 20 MODE: JAID |
| ID: HP2392A RSIZE: 40 DEVTYPE: TERM |
| PATH: 4.2.0 MPETYPE: 16 MPESUBTYPE: 0 |
| CLASS: CONSOLE |
| |
| LDEV: 100/111 NMMGR |
| |
| io> |
| |
_____________________________________________________________________
Example 5-8. Listing Configured Devices: Series 925 System
Adding Objects in SYSGEN
When you use SYSGEN to add objects to the system configuration, there are
four I/O Configurator commands available: ACLASS, ADEV, APATH and AVOL.
They are defined in the table below. For more detailed information read
Performing System Manager Tasks (32650-90004).
Table 5-3. I/O Configurator Add Commands
-----------------------------------------------------------------------------------------------
| | | |
| Command | Definition | Examples |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| ACLASS | Creates a new class name and associates | ACLASS EPOC 19 |
| | devices to the new class. You use the | ACLASS PLATES 31/34 |
| | ACLASS command to add a class name | MODE=RANDOM |
| | designation to a device that is already | |
| | configured with the ADEV command. You also | |
| | specify the mode with this command, which | |
| | can be one of JOB (accepts jobs and | |
| | sessions), IN (input only), OUT (output | |
| | only), CIO (concurrent I/O), NCIO | |
| | (nonconcurrent I/O), RANDOM (direct-access | |
| | device such as a disk), and DEFAULT (a mode | |
| | assigned when the system is initialized). | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| ADEV | Adds a device to an existing I/O path that | ADEV LDEV=30 PATH=4.5.9 |
| | is configured to the device adapter level. | ID=HP2688A |
| | At a minimum, you must specify the LDEV, | ADEV 8 PATH=2/4.2.1 |
| | the path, and ID number, but you may also | ID=HP7978B RSIZE=132 |
| | specify the record size, an output device | |
| | associated with the device, the device | |
| | operation mode, the class, a class mode | |
| | (other than the default assigned to the | |
| | device), physical and logical device | |
| | managers, the priority level of the | |
| | physical device manager, the compatability | |
| | mode type and subtype,and a device name. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| APATH | Defines the I/O path to an adapter, not to | APATH PATH=4.2 |
| | a device. (To add device level paths, you | ID=HP27113A |
| | use the ADEV command.) If the path has | |
| | already been defined, you will get an | |
| | error. At a minimum, you must enter the | |
| | path and an ID, which is either the | |
| | Hewlett-Packard product number or a | |
| | mnemonic name that designates different | |
| | uses of the same product. You may also | |
| | specify the physical and logical device | |
| | managers, the execution priority of the | |
| | physical device manager, and the maximum | |
| | number of concurrent I/Os to expect. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| AVOL | Adds a new volume to the system volume set | AVOL VNAME=MEMBER2 LDEV=4 |
| | configuration. You must specify a unique | VCLASS=PROD |
| | name you give to each volume member and its | |
| | logical device number. In addition, you | |
| | may also specify the volume class and the | |
| | amounts of transient and permanent disk | |
| | space allocated on the volume. | |
| | | |
-----------------------------------------------------------------------------------------------
You use the NMMGR program to add non-local devices such as terminals,
serial printers, UPS hardware and other objects to a system. To learn
how to configure UPS devices, read "Introducing the UPS and UPS
Monitor/iX Software" later in this chapter. To learn how to use NMMGR to
configure other devices, read Configuring Systems for Terminals,
Printers, and Other Serial Devices (32022-61000).
Changing Configurations in SYSGEN
When you use SYSGEN to change the system configuration, there are five
I/O Configurator commands available: MADDRESS, MCLASS, MDEV, MPATH, and
MVOL. They are defined in the table below and explained in the following
sections.
Table 5-4. I/O Configurator Modify Commands
-----------------------------------------------------------------------------------------------
| | | |
| Command | Definition | Examples |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| MADDRESS | Modifies the I/O path from one that exists | MADDRESS 2/4.0.2 6/4.0.3 |
| | to a new path that does not already exist. | |
| | You specify the old path and the new path, | |
| | both of which must have the same number of | |
| | levels. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| MCLASS | Changes I/O class information including the | MCLASS CLASS =LP |
| | class mode, the class name, and the devices | NEWCLASS=BIGPRN MODE=OUT |
| | associated with the class. | MCLASS BONSAI SMALLPRN |
| | | 28/29 |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| MDEV | Changes the attributes of a configured | MDEV 8 18 HP7978H 4.3.0 |
| | device. You specify the LDEV number of the | MODE=JOB |
| | device you want to modify, then enter the | |
| | new paramaters. This commands changes the | |
| | LDEV number itself, the device ID, the | |
| | device path, class, mode, record size, | |
| | physical and logical device manager, the | |
| | compatability mode type and subtype, and | |
| | the device name. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| MPATH | Changes the attributes of an I/O path. You | MPATH 4.1 HP27113A |
| | can modify the path name, the product ID, | MPATH 2/4.3 PMGR=HPIB_DAM |
| | the physical and logical device managers, | |
| | the execution priority of the physical | |
| | device manager, and the maximum number of | |
| | concurrent I/Os to expect. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| MVOL | Modifies the attributes of a volume set | AVOL VNAME=MEMBER2 |
| | member. You can modify the volume name, | TRANSIENT=30 PERMANENT=70 |
| | volume class and the amounts of transient | |
| | and permanent disk space allocated on the | |
| | volume. | |
| | | |
-----------------------------------------------------------------------------------------------
Deleting Objects in SYSGEN
When you use SYSGEN to delete objects from the system configuration,
there are four I/O Configurator commands available to you: DCLASS, DDEV,
DPATH, and DVOL. They are defined in the table below and explained in the
following sections.
Table 5-5. I/O Configurator Delete Commands
-----------------------------------------------------------------------------------------------
| | | |
| Command | Definition | Examples |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| DCLASS | Removes one or more class names from the | DCLASS EPOC |
| | system. If the class does not exist, or if | DCLASS (EPOC,FASTLP) |
| | you attempt to delete the DISC, CONSOLE, or | |
| | TAPE classes, SYSGEN displays an error | |
| | message. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| DDEV | Removes a specific device, range of | DDEV LDEV=123 |
| | devices, all products of a given product | DDEV ID=HP2932A |
| | identification, all devices of a given | |
| | type, or all devices of a given class name. | |
| | You cannot delete the system disk (LDEV 1) | |
| | or the system console (LDEV 20). | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| DPATH | Deletes an I/O path and, optionally, all | DPATH 4.2 |
| | the I/O paths below it in the | DPATH 2/8.2 |
| | configuration. If there are I/O paths | |
| | below the one you are deleting, SYSGEN | |
| | prompts you to confirm the action before | |
| | deleting them. If an I/O path is currently | |
| | used by a configured device, SYSGEN issues | |
| | an error and does not delete the path. | |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| DVOL | Deletes a volume member from the system | DVOL MEMBER2 |
| | configuration. To implement the change, | |
| | you must create a system load tape with the | |
| | new configuration and then use it to do an | |
| | INSTALL. | |
| | | |
-----------------------------------------------------------------------------------------------
Changing the configuration online
A new command file, DOIONOW, has been added to MPE/iX which allows the
system manager to immediately implement device configuration changes made
with SYSGEN. This command allows you to keep the system online and
available to users more of the time, and gives you the flexibility to
change the configuration on an "as needed" basis.
To change the configuration while the system is online, do the following:
1. Make the necessary changes to the configuration with the I/O
Configurator. (This process is no different than it was before;
for more information, read the previous section of this chapter
"Using SYSGEN's I/O Configurator".
2. Keep the configuration changes and exit SYSGEN. The information is
saved in the file LOG4ONLN.PUB.SYS, which is used by the DOIONOW
command.
3. At the CI prompt, execute the DOIONOW command by entering:
:DOIONOW
4. DOIONOW passes the LOG4ONLN file, which contains the new
configuration information, to IOCONFIG, which begins making the
changes. If LOG4ONLN is not found, you will see the following
error message displayed on the console:
NO PENDING SYSGEN CONFIG CHANGES
The DOIONOW command creates a log file, ONLNOLOG.PUB.SYS, which is used
to record the commands executed by IOCONFIG. If the DOIONOW command
generates an error, you may view this same log file to determine the
cause. This log file is purged and a new one is created prior to
invoking the new configuration, which means that it only contains
information for the last execution of IOCONFIG. Once you have found the
problem, you can then edit the input file for the DOIONOW command,
LOG4ONLN.PUB.SYS, to avoid duplicating the events that created the error.