HP 3000 Manuals HP 3000 Manuals
Adding Objects There are four IO configurator commands that you use to add objects to the system: 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 IO 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. 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 one class name. 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. 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 IO 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
NOTE 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.
To configure tape drives for ejection and data compression A new utility, DEVCTRL, allows you to dynamically configure 1/2 inch and DDS tape devices to eject the media following an application rewind or close. In addition, if you have an HPC1504B or HPC1521B DDS drive, you can enable or disable data compression so that the tapes can be created and shared with non-compressing DDS devices. (Note that the compression option does not apply to 1/2 inch tape.) Once you use DEVCTRL to configure the drive, it remains configured in that way until you change it with DEVCTRL again. A powerfail or changes in device ownership do not reset the configuration. DEVCTRL has the following parameters: DEVCTRL {[LDEV =] ###} {[COMPRESSION =] enable/disable/nochange} {[EJECT =] enable/disable/nochange} For example, to enable data compression and the eject feature for LDEV 50, enter: user> DEVCTRL 50 compression=enable eject=enable Or, to enable compression but disable the eject feature (using positional parameters), enter: user> DEVCTRL 50 enable disable To add paths Use the APATH command (abbreviated AP) to add an I/O path to the system configuration. (To add device level paths, you use the ADEV command. For more information on hardware paths, refer to chapter 12.) To add an I/O path, at the IO configurator prompt (io>), enter: io>APATH devicepath productid additional parameters APATH has the following parameters: APATH (AP) {[PATH =] devicepath} {[ID =] productid} [[PMGR =] physicalmgrname] [[LMGR =] logicalmgrname] [[PMGRPRI =] physicalmgrpri] [[MAXIOS =] maxconcurrentchannelIOs] To specify the PATH and ID. You must specify the PATH and ID parameters with the APATH command. If you specify a path that already exists, an error occurs. The product ID is either the Hewlett-Packard product number or a mnemonic name that designates different uses of the same product. For Series 925 through Series 949 systems and for Series 958 systems, you describe the path as follows: * the channel adapter * the channel adapter and device adapter separated by a period (such as 4.2) For the Series 950 through Series 980 systems, you describe the path this way: * just the bus converter * just the channel adapter * the bus converter and channel adapter separated by a slash (such as 2/8) * the bus converter and channel adapter separated by a slash and the device adapter separated by a period (such as 2/8.2) To specify the PATH and ID parameters using keywords and positional parameters, respectively, enter: io>APATH PATH=4.2 ID=HP27113A or io>APATH 4.2 HP27113A To specify the PMGR. The PMGR parameter is the name of the physical device manager associated with the specified I/O path. For example, to specify BUS_CONV_MGR as the physical device manager, enter: io>APATH PATH=4.2 ID=HP27113A PMGR=BUS_CONV_MGR 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 supplies the default. 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. For example, to specify LOGICAL_DEVICE_MGR as the logical device manager using a combination of keywords and positional parameters, enter: io>APATH 2/8.2 HP27113A LMGR=LOGICAL_DEVICE_MGR 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 supplies the default. To specify the PMGRPRI. PMGRPRI is the priority level at which the physical device manager executes and can be between 1 (low) and 15 (high), inclusive. For example, to specify a PMGRPRI of 8, enter: io>APATH PATH=8.2 ID=HP27113A PMGRPRI=8 The I/O default file supplies this parameter if you do not. To specify the MAXIOS. MAXIOS tells the device manager how many concurrent IOs to expect. For example, to specify 20 concurrent I/O devices, enter: io>APATH PATH=4.2 ID=HP27113A PMGRPRI=5 MAXIOS=20 Normally, you do not specify this value. Instead, the I/O default file usually specifies zero, which allows the manager to set itself to its default. To add volumes Use the AVOL command (abbreviated AV) to add a new volume to the system volume set configuration. To add a volume, at the IO configurator prompt (io>), enter: io>AVOL volumemembername ldev additional parameters AVOL has the following parameters: AVOL (AV) {[VNAME =]volumemembername} {[LDEV =]#} [[TRANSIENT =]%discfortransobj] [[PERMANENT =]%discforpermobj] {[VCLASS =]volumeclass}
NOTE You cannot modify the system master volume, MEMBER1, in any way.
To specify the VNAME, LDEV, and VCLASS. The VNAME parameter specifies the unique name you give to each volume member, LDEV specifies the logical device number, and VCLASS specifies the volume class(es) that the identified volume(s) belong to. The volume member name and the volume class must be 32 characters or less. After the first character, which must be alphabetic, numbers, letters, and underline characters are allowed. You may specify up to eight volume classes. For example, to specify MEMBER2 as logical device 4 in the volume class PROD, enter: io>AVOL VNAME=MEMBER2 LDEV=4 VCLASS=PROD To specify the transient/permanent disk space. TRANSIENT is the amount of disk space that is reserved for temporary processes such as stacks and operating system data structures. PERMANENT is the amount of disk space that is reserved for permanent structures such as files, the label table, a tape drive, a disk drive, or a printer. You enter both values as a percentage. For example, to specify the amount of disk space reserved for transient and permanent objects as 50 percent each, enter: io>AVOL VNAME=MEMBER2 LDEV=4 TRANSIENT=50 PERMANENT=50 VCLASS=PROD The total percentage for TRANSIENT and PERMANENT must be at least 100 percent. It can be as high as 200 percent, although this is not recommended.