HP 3000 Manuals HP 3000 Manuals
Using SYSGEN's I/O Configurator (Continued) 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 and explained in the following sections. -------------------------------------------------------------------------------------------- | | | | Command | Definition | | | | -------------------------------------------------------------------------------------------- | | | | ACLASS | Creates a new class name and associates devices to the new class. | | | | -------------------------------------------------------------------------------------------- | | | | ADEV | Adds an I/O device to the system. | | | | -------------------------------------------------------------------------------------------- | | | | APATH | Defines the I/O path to an adapter. The path must not have | | | already been defined. | | | | -------------------------------------------------------------------------------------------- | | | | AVOL | Adds a new volume to the system volume set configuration. | | | | --------------------------------------------------------------------------------------------
NOTE 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-90001).
To add a class name. Use the ACLASS command (abbreviated AC) to add a class name designation to a configured device. You must use the ADEV command to add the device path and designate the LDEV number before using the ACLASS command. To add a class name, at the I/O Configurator prompt (io>), enter: io>ACLASS classname ldev parameter ACLASS has the following parameters: ACLASS (AC) {[CLASS =] classname,...} {[LDEV =] #/#,#,...} [ {IN }] [ {OUT }] [[MODE =] {CIO }] [ {NCIO }] [ {RANDOM }] [ {DEFAULT}] The CLASS and LDEV parameters are required and classname is a standard class name of up to eight characters, such as EPOC or SPOOL. If the specified class name already exists when you attempt to add it, SYSGEN issues an error message. The modes are defined in the following table. -------------------------------------------------------------------------------------------- | | | | Mode | Definition | | | | -------------------------------------------------------------------------------------------- | | | | JOB | Accepts HELLO and JOB logons. | | | | -------------------------------------------------------------------------------------------- | | | | IN | Input only device | | | | -------------------------------------------------------------------------------------------- | | | | OUT | Output only device | | | | -------------------------------------------------------------------------------------------- | | | | CIO | Concurrent I/O | | | | -------------------------------------------------------------------------------------------- | | | | NCIO | Nonconcurrent I/O | | | | -------------------------------------------------------------------------------------------- | | | | RANDOM | Direct-access device (for example, disk) | | | | -------------------------------------------------------------------------------------------- | | | | DEFAULT | Assigned at system initialization | | | | -------------------------------------------------------------------------------------------- To add a class name, enter the ACLASS command, the class name, and the LDEV associated with it. For example, to add the class name EPOC and associate it with LDEV 19, enter: io>ACLASS EPOC 19 To assign a mode to a device. You can assign a mode to the device or accept the default mode assigned by SYSGEN. To assign a mode, enter the ACLASS command, the class name, the LDEVs, and the keyword or positional MODE parameter. For example, to assign the mode RANDOM to logical devices 31 through 34 (using keyword parameters), enter: io>ACLASS PLATES 31/34 MODE=RANDOM To assign the same mode using positional parameters enter: io>ACLASS PLATES 31/34 RANDOM To add devices. Each device configured on your system must have a unique LDEV number. Although you, as system manager, assign LDEV numbers to system devices at your discretion, certain devices must be assigned specific numbers. For example, to boot the operating system from disk, you must mount the system master volume on LDEV 1 and the system console is always LDEV 20. Use the ADEV command (abbreviated AD) to add a device to an existing I/O path that is configured to the device adapter level. At a minimum, you must specify the LDEV, the path, and ID number. You can enter other information either using keywords or positional parameters. To add a device, at the I/O Configurator prompt (io>), enter: io>ADEV ldev pathid otherparameters ADEV has the following parameters: ADEV (AD) {[LDEV =] #/#,#,...} {[PATH =] devicepath} {[ID =] productid} [[RSIZE =] recordsize] [[OUTDEV =] outputdevice] [ {JOB }] [ {DATA }] [ {INTERACTIVE}] [ {IN }] [ {DUPLICATIVE}] [ {OUT }] [[MODE =] {INPUT }] [[CLASS =] classname] [[CMODE =] {CIO }] [ {OUTPUT }] [ {NCIO }] [ {AUTOREPLY }] [ {RANDOM }] [ {NLIO }] [ {DEFAULT}] [ {NONE }] [[PMGR =] physicalmanagername] [[LMGR =] logicalmanagername] [[PMGRPRI =] physicalmanager priority] [[MPETYPE =] compmodetype] [[MPESUBTYPE =] compmodesubtype] [[DEVNAME =] devicename] Below are two examples of adding LDEV 30 to the Series 925 through Series 935 systems. The first example uses keyword parameters, the second uses positional parameters: io>ADEV LDEV=30 PATH=4.5.9 ID=HP2688A io>ADEV 30 4.5.9 HP2688A Below are two examples of adding LDEV 30 to the Series 950 through 980 systems. The first example uses keyword parameters, the second uses positional parameters: io>ADEV LDEV=40 PATH=2/8.1.4 ID=HP7935H io>ADEV 40 2/8.1.4 HP7935H To specify the LDEV, PATH, and ID. When you issue the ADEV command, you must specify the LDEV, PATH, and ID parameters. * Use LDEV to specify the logical device number for the device you are adding. * Use PATH to specify the physical path to reach a device. * Use ID to specify the device you are adding. For example, to add an HP2688A printer as LDEV 17 (using keyword parameters), enter: io>ADEV LDEV=17 PATH=4.3.2 ID=HP2688A Or, to add an HP7978B disk drive as LDEV 30 (using positional parameters), enter: io>ADEV 30 2/8.1.4 HP7978B If a specified LDEV already exists, SYSGEN issues an error message. If you specify a set of devices, the device number in the PATH parameter increases automatically. You can add either a Hewlett-Packard supported device or a device of another kind. * If you are adding a Hewlett-Packard-supported device, enter the product ID (for example, HP7978A) as the ID parameter value. For a complete list of Hewlett-Packard supported devices, read the file IODFAULT.PUB.SYS. * If you are adding a device that is not supported by Hewlett-Packard, enter USER as the product ID. For non-supported devices, you must specify all of the device attributes except class, class mode (CMODE), and device name, which are optional. For example, to configure a nonsupported device as LDEV 40, enter: io>AD 40 36.1.4 USER 132 10 OUTPUT LP DEFAULT& USER_PHYS_MGR USER_LOGICAL_MANAGER PMGRPRI=8& MPETYPE=value MPESUBTYPE=value To specify the RSIZE. The RSIZE parameter specifies the record size (in 16-bit words) of the device you are adding. For example, to add an HP7978B as LDEV 8 with the path 2/4.2.1 and a record size of 264 characters, enter: io>ADEV 8 PATH=2/4.2.1 ID=HP7978B RSIZE=132 If you do not specify the record size parameter, SYSGEN uses the default. To specify the OUTDEV. The OUTDEV parameter specifies the output device associated with the device you are adding. For example, to add an HP2688A printer as LDEV 19 on path 4.1.7 with a record size of 132 characters and LP as the output device, enter: io>ADEV 19 4.1.7 HP2688A 66 OUTDEV=LP The OUTDEV can be either a device number or a device class. If you do not enter this parameter, SYSGEN assigns 0 as the output device for all peripherals except terminals, which are assigned the input device number. To create a streams device. The streams device is the device that accepts batch jobs. To configure the streams device, you must issue the ADEV command once with a specific set of options: MODE=(JOB,DATA)and OUTDEV={an output device or class}. For example, if you choose class LP for OUTDEV, enter: io>ADEV 10 2/4.2.3 HP7978B MODE=(JOB,DATA) OUTDEV=LP& RSIZE=128 CLASS=JOBTAPE You can also use the intrinsic HPDEVCREATE to create a streams file. The parameters you enter, such as device file type, LDEV, major number, minor number and link name, define the file. For more information, read MPE/iX Intrinsics Reference Manual (32650-90028). To specify the MODE. The MODE parameter specifies the device operation mode. Your choices for mode and their meanings are defined below: -------------------------------------------------------------------------------------------- | | | | Value | Definition | | | | -------------------------------------------------------------------------------------------- | | | | JOB | Accepts HELLO and JOB logons. | | | | -------------------------------------------------------------------------------------------- | | | | DATA | Accepts DATA logons. | | | | -------------------------------------------------------------------------------------------- | | | | INTERACTIVE | Refer to the FRELATE intrinsic explanation. | | | | -------------------------------------------------------------------------------------------- | | | | DUPLICATIVE | Refer to the FRELATE intrinsic explanation. | | | | -------------------------------------------------------------------------------------------- | | | | INPUT | Input spooled. | | | | -------------------------------------------------------------------------------------------- | | | | OUTPUT | Output spooled. | | | | -------------------------------------------------------------------------------------------- | | | | AUTOREPLY | Automatically replies to tapes (also called autoallocation). | | | | -------------------------------------------------------------------------------------------- | | | | NLIO | This device is capable of native language I/O. | | | | -------------------------------------------------------------------------------------------- | | | | NONE | None of the above apply. | | | | -------------------------------------------------------------------------------------------- Most devices have a default device mode listed in the ASCII file IODFAULT.PUB.SYS, which you can read. To override the default, you can specify NONE as the mode. Certain devices can have one or more modes only. For example, an HP 7978B tape drive can have the modes: JOB, DATA, INPUT, OUTPUT, AUTOREPLY, and NONE. Since MODE is a repeated parameter, you can specify multiple modes by using parentheses and separating the modes with commas or spaces. For example, to assign two modes, AUTOREPLY and INPUT to an HP7978B tape drive, enter: io>ADEV 40 4.1.7 HP7978B MODE=(AUTOREPLY,INPUT) If you assign an improper mode to a device, SYSGEN issues an error message. For example, you cannot assign a printer the device mode AUTOREPLY. To specify the CLASS. The CLASS parameter associates a group of devices (which are usually related logically or physically) to a class name. For example, to specify the class TAPE for an HP7978B tape drive, enter: io>ADEV 40 4.1.7 HP7978B MODE=AUTOREPLY CLASS=TAPE A device can simultaneously belong to as many as eight classes. Class names may not exceed eight characters and must begin with an alphabetic character. If a specified class name does not exist, SYSGEN assigns it the device access characteristics of DEFAULT, which you can override using the CMODE parameter, described below. To assign no class to a device, specify CLASS=NONE. To specify the CMODE. The CMODE parameter overrides the default class mode for a device. For example, to make all HP7978B tape drives that you are adding to your system output devices only, enter: io>ADEV 40 4.1.7 HP7978B CLASS=TAPE CMODE=OUT If the class already exists, the CMODE entry is ignored. The values for the CMODE parameter are defined in the table below. -------------------------------------------------------------------------------------------- | | | | Value | Definition | | | | -------------------------------------------------------------------------------------------- | | | | IN | Input only device | | | | -------------------------------------------------------------------------------------------- | | | | OUT | Output only device | | | | -------------------------------------------------------------------------------------------- | | | | CIO | Concurrent I/O | | | | -------------------------------------------------------------------------------------------- | | | | NCIO | Nonconcurrent I/O | | | | -------------------------------------------------------------------------------------------- | | | | RANDOM | Direct access device (for example, disk) | | | | -------------------------------------------------------------------------------------------- | | | | DEFAULT | Assign at system initialization | | | | -------------------------------------------------------------------------------------------- To specify the PMGR. The PMGR parameter associates the physical device manager with a specified I/O path. The manager name has a maximum length of 32 characters and may contain numbers, letters, and underline (_) characters. If you do not enter this parameter, SYSGEN uses the default. For example, to specify BUS_CONV_MGR as the physical device manager, enter: io>ADEV 40 4.1.7 HP7978B CLASS=TAPE PMGR=BUS_CONV_MGR To specify the LMGR. LMGR is the name of the logical device manager associated with the specified I/O path. Not all devices have logical device managers. The manager name has a maximum length of 32 characters and may contain numbers, letters, and underline (_) characters. If you do not enter this parameter, SYSGEN uses the default. For example, to specify LOGICAL_DEVICE_MANAGER as the logical device manager, enter: io>ADEV 40 4.1.7 HP7978B CLASS=TAPE& LMGR=LOGICAL_DEVICE_MANAGER To specify the PMGRPRI. The PMGRPRI parameter specifies the priority level at which the physical device manager executes. The priority can range from 1 (the lowest level) to 15 (the highest.) If you don't specify a priority, SYSGEN uses the default. For example, to specify a priority level of 5 for logical device 40, enter: io>ADEV 40 4.1.7 HP7978B CLASS=TAPE PMGRPRI=5 To specify the MPETYPE and MPESUBTYPE. The MPETYPE and MPESUBTYPE parameters specify values for compatibility mode type and subtype. You use them when you are adding a nonsupported device to your configuration. For example, to add a non-Hewlett-Packard printer as LDEV 40, enter: io>AD 40 36.1.4 USER 132 10 OUTPUT LP DEFAULT& USER_PHYS_MGR USER_LOGICAL_MANAGER PMGRPRI=8& MPETYPE=value MPESUBTYPE=value To specify the DEVNAME. The DEVNAME associates a device name with a particular LDEV number, which allows a user to specify the device by name instead of by number. When choosing device names, remember the following rules: * A device name must begin with a letter. * You cannot use a device name of exactly eight characters that begins with the letter "D" followed immediately by one or more digits. * You cannot use the name "VTERM." * No two logical devices may have the same device name. * All device names and class names must be mutually exclusive. For example, to specify the device name TAPEDRIVE for an HP7978B, enter: io>ADEV 40 4.1.7 HP7978B DEVNAME=TAPEDRIVE To create device link files. A device link is, essentially, a permanent, named :FILE command that associates a name with an LDEV. Once created, device links are represented as files and ar visible in directories. Device link files give the MPE/iX shell, the UNIX-like command shell and utilities introduced with Version 4.5 of the operating system, access to devices such as tape drives and printers so that it does not have to know MPE access semantics. As a result, MPE/iX shell utilities such as tar work like their UNIX counterparts. To create a device link file, you can use the MKNOD utility. For example, to create a device link file called tape7 in the current directory, enter: :mknod "tape7,c,0,7" In this example, the first parameter is the device link file name (tape7), the second two parameters (c 0) are required to create device link files, and the fourth parameter (7) is the LDEV number for which you are creating the device link file. To list the device link file you have created, use the LISTFILE command. For example, to list information about tape7, enter: :LISTFILE tape7,2 MPE/iX will respond with something like the following information. In the TYP column, BBd indicates that the device link file is a byte stream format, binary access device file. _____________________________________________________________________________ | | | | | :listfile tape7,2 | | ACCOUNT= SYS GROUP= PUB | | | | FILENAME CODE ------------LOGICAL RECORD----------- ----SPACE---- | | SIZE TYP EOF LIMIT R/B SECTORS #X MX | | | | TAPE7 128W BBd 0 1 1 0 0 * | | | | | | : | | | _____________________________________________________________________________ The file name that you enter follows MPE-escaped syntax rules. So, to create a device link file in a directory other than the current working directory, include the path in the file name. For example, to create the device link file tape7 in the dev directory, enter: :"/dev/tape7/c,0,7"
NOTE You may also use three other methods to create device link files: the mknod POSIX C-library function, the HPDEVCREATE intrinsic, or the MPE/iX shell utility mknod.