Utilities Descriptions

ASOCTBL

Use the ASOCTBL utility to distribute operator commands for specific devices to standard MPE/iX users. This utility creates a table that associates users with device classes in a file called ASOCIATE.PUB.SYS. Users gain access to the corresponding device class with the ASSOCIATE command. The user then has exclusive access to the operator commands that control that device until their association is terminated by logging off or issuing the DISASSOCIATE command. In ASOCTBL, > is the prompt.

   ASOCTBL
   >devclass=username.acctname|

   RUN ASOCTBL.PUB.SYS
   >devclass=username.acctname|

AUTOINST

AUTOINST restores the information contained on the FOS and SUBSYS tapes, sets up the necessary account structure, and creates a customized system load tape (SLT).

   AUTOINST

BULDACCT

BULDACCT runs only on MPE/iX. Use it to take a snapshot of the directory structure on the source system, then recreate it on the destination system. Use BULDACCT to migrate a set of accounts from one volume set to another.

BULDACCT has been enhanced to work with MPE/iX hierarchical directory structures. The hierarchical directory information for accounts, groups, and users is written to BULDJOB1. BULDJOB1 contains the commands used to recreate hierarchical directories and the ACDs associated with each of them.

   BULDACCT

   BULDACCT;INFO="processing_options"

   BULDACCT:processing_options

BUILDINT

Use the BUILDINT utility to build or change compatibility mode (CM) intrinsic disk files. BUILDINT accepts SPL procedure head declarations (OPTION EXTERNAL is required) and optional commands as input data. If no commands are issued, the procedure head declarations are added to the intrinsic file. Any input data that is not a procedure head terminates input; at this point, the program prints a formatted list of all intrinsics and terminates.

   RUN BUILDINT.PUB.SYS

   BUILDINT

CLKUTIL

CLKUTIL reads and sets the hardware clock. The clock is used for timestamps and time displays. It is usually set to Greenwich Mean Time (GMT). CLKUTIL is a standalone utility, and runs only on the physical console at the ISL prompt.

   ISL> CLKUTIL

DEBUG

DEBUG is used primarily by system programmers, who use it to set breakpoints within programs, and to display and modify data stacks and registers. Access through the DEBUG command is available only to users with privileged mode (PM) capability. Nonprivileged users can get limited access with the ;DEBUG option of the RUN command to debug their applications; the DEBUG utility will not allow them privileged access to the system.

   DEBUG

   RUN PROGNAME;DEBUG

	CAUTION: Normal MPE safeguards are bypassed in privileged mode. When attempting to modify privileged data on disk, it is possible to destroy file integrity, or the MPE operating system itself. Hewlett-Packard is not responsible for changes you make to the operating system or system files. For more information, talk to your Hewlett-Packard service representative.

DIRMIG

DIRMIG (The Directory Migration Tool) utility simplifies the migration of your environment from MPE V/E systems to MPE/iX systems. DIRMIG uses an MPE V/E SYSDUMP tape to transport data including the system directory (account structure), UDCs, user logging IDs, user files and information specifically related to user volumes.

   DIRMIG

   RUN DIRMIG.PUB.SYS

DISCFREE

The DISCFREE utility displays information about the system's free disk space, total volume space capacity, and disk allocation for single volumes or for the whole system. It also determines disk volume fragmentation and transient and permanent disk space limits. DISCFREE displays disk allocation data only for mounted MPE/iX volumes, not scratched volumes; use the DSTAT command to identify currently mounted volumes.

DISCFREE

DISCFREE"[[format]][,ldev]"

   RUN DISCFREE.PUB.SYS;INFO="[<\esc>format][,ldev]"

DISCUTIL

DISCUTIL is a standalone utility that you use to request various disk operations. Use it with the RECOVER command of VOLUTIL to save, and subsequently recover, files from a system that has become logically inoperable. This program can be invoked only at the Initial System Load prompt (ISL>).

   ISL> DISCUTIL

DUMP

The MPE/iX utility DUMP takes a snapshot or dump of system memory. It helps you, or HP support personnel, track down problems in system operation. To use, first request a non destructive boot; this saves the machine's hardware state. Then enter the DUMP command; this lets DUMP take control and dump the processor internal memory, main memory, and all allocated secondary storage marked as dumpworthy.

   ISL>DUMP

EDIT/3000

EDIT/3000 creates and manipulates ASCII files. Use EDIT/3000 commands to insert, delete, replace, modify, search for, and manipulate individual characters, strings of characters, or entire lines of characters. EDIT/3000 can be run in interactive or batch mode.

   EDITOR

FCOPY

Use FCOPY to copy and translate files. You identify the input file and output file. You can request one or more optional functions, such as converting data, copying files from other systems, appending files, extracting subsets of files, or displaying binary files in ASCII format.

The FCOPY utility can be copied from the HFS directories into accounts and groups. Files can be opened from HFS directories into existing files in other HFS directories.

   FCOPY FROM=filename;TO=filename[;options]

In the following example, the file /dir1/doc/print.es is copied to the file myfile in the PUB group of the SYS account.

   FILE FOO=/dir1/doc/print.es|FCOPY from=*FOO; to=myfile.pub.sys|

FSCHECK

The file system check utility (FSCHECK) is a native mode program for detecting and repairing inconsistencies found in the file directories and file label tables of the MPE/iX operating systems. It also provides the additional ability to query and display various attributes of these objects. It is a standalone utility and should be the only program running on the system when it is in use.

   FSCHECK

	WARNING! Do not use this utility without proper service center support. Unauthorized use will void you warranty and may cause data loss.

GENCAT

Use the GENCAT utility to modify a source catalog, or expand a formatted message catalog (for instance, a message catalog in the user's native language). You don't need any special capabilities to use it.

   GENCAT

   RUN GENCAT.PUB.SYS

I7DB8CNV

I7DB8CNV converts the character data in an IMAGE data base from any Hewlett-Packard 7-bit national substitution set to ROMAN8. The program is a special version of the program DBLOAD.PUB.SYS and the conversion is done as part of a database load. Generally, DBUNLOAD.PUB.SYS and DBUTIL.PUB.SYS,ERASE are invoked before I7DB8CNV.

   RUN I7DB8CNV.PUB.SYS

IOMAP

IOMAP is a standalone utility that identifies the actual configuration of the system and its paths and devices. Use it to map all existing I/O components in the system and to test I/O system components, using IOMAP's selftest and loopback diagnostics. Run IOMAP from the initial system loader (ISL) prompt; it can only be run on a down system. IOMAP shows processor identification (model, identification, processor board revisions, cache sizes, coprocessors, and main memory) and I/O configuration (paths and components for all cards). By comparing this information with system configuration information, you can see if the hardware that is physically available is the same as the hardware that is configured into the system. Also see SYSMAP.

   ISL> IOMAP

KSAMUTIL

Use KSAMUTIL to manage compatibility mode Keyed Sequential Access Method (CM KSAM) files. You can create a CM KSAM file, rename both the data and key files, save a temporary file as a permanent file, clear all data from a file, purge a file, and verify the contents and access history of an existing file. The file information may be displayed to the terminal or to a printer. KSAMUTIL runs either in session or in batch mode. You can issue MPE/iX commands within KSAMUTIL, if you put a colon (:) in front of the command name.

   KSAMUTIL

   RUN KSAMUTIL.PUB.SYS

LANGINST

Use LANGINST to configure language-specific information onto your HP 3000. You must logon as MANAGER.SYS to run LANGINST. You can do the following tasks with LANGINST:

   LANGINST

LINK EDITOR/XL

Link Editor/XL prepares native mode (NM) compiled object files for execution on 900 Series HP 3000 computers. You can also use Link Editor/XL to create and maintain relocatable and executable libraries. To invoke it and use it interactively, enter LINKEDIT at the MPE/iX prompt. Use the RUN command to invoke Link Editor/XL and specify an information string.

   LINKEDIT

or

   RUN LINKEDIT.PUB.SYS;INFO=infostring

LOGGING (Security Auditing)

You can request that the operating system keep records of particular users, as well as particular events. A new log file is begun automatically every time you reboot. You can also request that a new file be started.

LOGTOOL

The System and Memory Log Analysis Tool (LOGTOOL) can manipulate two types of log files: system log files, and the memory log file. Functions on the various system log files include deleting/clearing the files and displaying their contents. Commands are executed immediately after they are received. LOGTOOL is available in multi-user mode, but some functions require a diagnostic security level.

   SYSDIAG
   DUI> RUN LOGTOOL

MAKECAT

Use the MAKECAT utility to access, maintain, and change the following message catalogs:

   RUN MAKECAT.PUB.SYS

N7MF8CNV

N7MF8CNV converts data in MPE text and data files, such as EDIT/XL files, from Hewlett-Packard 7-bit national substitution character set to ROMAN8. The user is prompted for language and file type (text or data). For a text file, each record is converted as one field. For a data file, the user will be prompted on each file for the starting position and length of each field (portion of a record) to be converted.

   N7MF8CNV

   RUN N7MF8CNV.PUB.SYS

NLIOUTIL

NLIOUTIL is used to dynamically activate the Native Language I/O (NLIO) subsystem for Asian and Middle East/African (MEA) peripheral devices (terminals and printers). NLIO is the basic input and output system integrated into the MPE/iX operating system for Native Language Support (NLS). Once activated by NLIOUTIL, properly configured native devices may use the Native Language I/O facility. Also see NMMGR.

   NLIOUTIL

   RUN NLIOUTIL.PUB.SYS;INFO=infostring

NLUTIL

NLUTIL is a utility program used to verify a variety of Native Language Support (NLS) languages and corresponding character sets available on the operating system. You can have a complete listing printed on the system printer; you can display a table showing the currently configured languages and their character set types.

   NLUTIL

   RUN NLUTIL.PUB.SYS

NMMGR

The Node Management Services Configuration Manager is a menu-driven utility you use to configure your HP 3000's data communications subsystems.

   NMMGR

OCA

The Object Code Analyzer is an interactive migration utility used primarily to detect migration incompatibilities in compatibility mode applications. When moving from MPE V/E to MPE/iX, OCA is part of the migration tool set, and the output helps you make your migration plan. Run on MPE/iX systems, OCA identifies incompatibilities that could prevent moving applications from compatibility mode (MPE XL CM) to native mode (MPE XL NM).

OCT

The Object Code Translator translates compatibility mode (CM) object code into functionally equivalent HP Precision Architecture (HP-PA) native instructions. OCT appends translations to the end of a destination file. The resulting file can then be executed on either an MPE V/E-based system or an MPE/iX-based system.

   OCTOMP

PATCH

You may only use PATCH on compatibility mode (CM) programs. Use it to access, display, and/or modify a program file's object code without recompiling the program. You can make simple changes to program instructions or to global stack area variables. PATCH requires the memory location of the target program symbols, the beginning locations of each program unit, and the offsets for each line of code from these locations.

   PATCH

   RUN PATCH.PUB.SYS|

	CAUTION: PATCH bypasses normal MPE/iX safeguards and will modify the contents of privileged program files. When attempting to modify privileged data on disk, it is possible to destroy file integrity, or the MPE operating system itself. Hewlett-Packard is not responsible for changes you make to the operating system or system files. For more information, talk to your Hewlett-Packard service representative.

PXUTIL

The PXUTIL utility is run by the System Manager to perform operations related to the UID/GID databases. The PXUTIL utility requires exclusive access to the databases. The main function of PXUTIL is to initially create the UID/GID databases, as well as to synchronize existing database files with the current directory. The utility scans through MPE's directory creating UID entries for all existing users and GID entries for all existing accounts. Pressing BREAK during the operation of PXUTIL, aborts the process without affecting the existing HPUID.PUB.SYS or HPGID.PUB.SYS files. The PXUTIL utility opens existing files exclusively, and opens two "new" files with the same names.

   RUN PXUTIL.PUB.SYS
   PXUTIL> update

SAINT

SAINT is an interactive utility program that analyzes system libraries to produce executable images known as boot images. Its primary function is to produce a boot image for the operating system.

	WARNING! Do not use this utility without service center support. Unauthorized use will void your warranty and may cause data loss.

SEGMENTER

SEGMENTER manages and prepares compatibility mode (CM) code segments. You can invoke it directly, with the SEGMENTER command. Use it to manage code segments in USL's (user subprogram libraries), RL's (relocatable libraries) and SL's (segmented libraries) and to group RBM's (relocatable binary modules) into code segments. Invoked indirectly (at PREP time), you can use SEGMENTER to define run-time parameters and to group CM program statements into RBM's and code segments with source program statements.

   SEGMENTER

SLPATCH

SLPATCH displays or modifies the contents of a Segmented Library (SL) file. Also see SEGMENTER. Before using this utility you should be familiar with machine-executable instructions and the internal format of segmented library files in the HP 3000 system environment.

   SLPATCH

   RUN SLPATCH.PUB.SYS

	CAUTION: SLPATCH bypasses normal MPE/iX safeguards and will modify the contents of privileged program files. When attempting to modify privileged data on disk, it is possible to destroy file integrity, or the MPE operating system itself. Hewlett-Packard is not responsible for changes you make to the operating system or system files. For more information, talk to your Hewlett-Packard service representative.

SOMPATCH

SOMPATCH is used for binary modification of a native mode spectrum object module (SOM) program or library file. Binary modification is referred to normally as patching. This utility also provides online help for command syntax and function.

	WARNING! Do not use this utility without service center support. Unauthorized use will void your warranty and may cause data loss.

SORT-MERGE/XL

Use SORT to sort files based on single or multiple key items. You can sort data alphabetically, numerically, or in a collating sequence you define; you can request ascending or descending order. Use MERGE to merge data from two or more sorted files into a single, new file. SORT-MERGE/XL operates from within a program, or as a standalone utility in either interactive or batch mode.

   SORT

   RUN SORT.PUB.SYS

   MERGE

   RUN MERGE.PUB.SYS

SPUTIL

The Native Mode Spooler Utility Program (SPUTIL) allows you to list, manipulate, and transfer spooled device files (spoolfiles) that are created and maintained by MPE/iX. SPUTIL is an MPE/iX replacement for the MPE CM SPOOK5 program.

SPUTIL opens the formal file designator SPUTIN as its $STDIN(X) and the formal file designator SPUTOUT as its $STDLIST. You may redirect these files as desired with a file equation. However the record width of any redirected SPUTOUT should not be less than 80 bytes; otherwise displays and messages may generate an error when SPUTIL directs them to SPUTOUT.

   SPUTIL

STANDARDS

System bootstrap, initial program load (IPL), and initial system load (ISL) standard provides a standard interface through which any Hewlett-Packard Precision Architecture (PA-RISC) computer can boot any operating system. This standard also provides a common user interface for booting PA-RISC systems.

	WARNING! The use of this information without service center support will void your warranty and may cause data loss.

STORE/RESTORE

Use STORE/RESTORE to store and restore one or more files and directories to and from tape. Options let you store files for backup, transport, or archiving purposes.

   STORE fileset[;parameters]

   RESTORE storfile[;parameters]

SWITCH ASSIST TOOL

The Switch Assist Tool is an interactive utility that makes the job of creating an application with modules written both in native and compatibility modes easier to implement. Output is in the form of PASCAL/iX source code.

   SWAT

   RUN SWAT.PUB.SYS

SYSGEN

Use SYSGEN to modify your system configuration. Changes are written to disk or to tape. They do not become effective until the system is restarted. SYSGEN has a global module and four configurator modules:

    SYSGEN
   sysgen>command name

SYSMAP

SYSMAP displays the hardware configuration of a system by mapping I/O devices, CPU boards and memory boards. It displays device type, product number, logical device number (ldev) and device address. SYSMAP is part of the Online Diagnostics Subsystem. To use SYSMAP, first you enter SYSDIAG and get the Diagnostic User Interface prompt. Then you enter RUN SYSMAP and get ENTER MAP>, the SYSMAP prompt. Also see IOMAP.

   SYSDIAG
   DUI> RUN SYSMAP
   ENTER MAP>

TERMDSM

Use the TERMDSM tool to diagnose, dump, and reset logical devices, ports, and data communications and terminal controllers (DTCs). TERMDSM also performs status checks of ports and DTC's.

   SYSDIAG
   DUI > RUN TERMDSM

tic

The tic utility compiles source terminfo descriptions. The compiled entry is installed under the /usr/lib/terminfo directory hierarchy. If the TERMINFO environment variable is set, results are placed in the directory it points to instead. Entries are stored in directories that match the first character of their name. The entry for the VT-100 terminal, for example, is stored in /usr/lib/terminfo/v/vt100.

   tic.hpbin.sys /product/curses/lib/terminfo/ansi

TTUTIL

TTUTIL is a screen-driven program that lets you modify characteristics of serial port connections (such as flow control, modem control, printer control and character handling) by modifying the terminal type file assigned to the port. You can create, modify or view an existing terminal or printer type file..

   RUN TTUTIL.PUB.SYS

   TTUTIL

untic

The untic utility decompiles a terminfo binary file into its source format. If a TERMINFO environment variable is set, the untic utility searches the specified directory; otherwise, untic assumes the file is in the directory /usr/lib/terminfo. The output of an untic decompile is sent to the standard output

   untic.hpbin.sys ansi

V7FF8CNV

In VPLUS/XL forms files, V7FF8CNV converts text and literals from a Hewlett-Packard 7-bit national substitution character set to ROMAN8 character set.

   V7FF8CNV

   RUN V7FF8CNV.PUB.SYS

VERSION

VERSION is a native mode utility program that displays program file information. For compatibility mode (CM) program files, it displays segment, stack, data reference base, and capabilities. For native mode (NM) executable files, it displays information on procedures, libraries, capabilities, stack, heap, entry names, and $version strings. ($version string information is displayed for NM object files and nonexecutable library files.) If VERSION is invoked without a file name or a file set for input, the VERSION> prompt continues until EXIT or a colon (:) is entered. If the input to VERSION is a file set, every file in the set will be processed even if an error occurs processing a previous file. If there is an error opening a file, the file system error will be displayed in addition to the VERSION error message.

   VERSION

   VERSION filename

   VERSION "filename [,search string]"

The search string is the name of a particular $version string in a system object module SOM. (Not applicable for CM program files.) The quotes are required if a search string is specified.

VOLUTIL

Use VOLUTIL commands to manipulate volume sets: to manage and maintain individual volumes, volume sets, and volume classes, and to make inquiries about their contents, availability, and status. You can use any MPE/iX system command from within VOLUTIL by entering a colon (:) before the command name. VOLUTIL commands are organized into four groups:

   VOLUTIL

   RUN VOLUTIL.PUB.SYS

   volutil> command name

   volutil> command name