Utilities Descriptions
MPE documents | |
 Complete PDF | |
| Table of Contents | |
| Index |
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 RUN ASOCTBL.PUB.SYS >devclass=username.acctname
AUTOINST
See the System Software Maintenance Manual for information on this utility.
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="[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
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:
Add a language to, or remove a language from, the configuration file.
Display and modify local formats of a configured language.
Display the languages supported by Hewlett-Packard.
Display the language currently configured.
Modify the system default language.
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 RUN LINKEDIT.PUB.SYS;INFO=nfostring
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.
logtool RUN LOGTOOL.PUB.SYS
MAKECAT
Use the MAKECAT utility to access, maintain, and change the following message catalogs:
CATALOG.PUB.SYS, which contains system error messages.
CICAT.PUB.SYS, which contains the HELP catalog.
ser-defined catalogs for various applications.
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:
Input/Output (I/O) Configurator. Configures local devices.
Logging (LOG) Configurator. Configures user and system logging processes.
Miscellaneous (MISC) Configurator. Configures miscellaneous items.
System File (SYSFILE) Configurator. Changes the list of files dumped to an SLT.
SYSGEN sysgen>command name
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.
:cstm cstm> RU 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:
Commands that operate on sets and end with 'SET'.
Commands that deal with classes and end with 'CLASS'.
Commands that control volumes and end with 'VOL'.
Miscellaneous commands.
VOLUTIL RUN VOLUTIL.PUB.SYS volutil> command name volutil> command name
|
Chapter 2 Utilities |
Chapter 3 Intrinsics Descriptions |