NAME

sysadm − menu interface for system administration

SYNOPSIS

sysadm [ subcommand │ submenu ]

DESCRIPTION

This command, when invoked without an argument, presents a menu of system administration subcommands from which the user selects.  If the optional argument is specified, the named subcommand is run or the named submenu is presented.  Additional accesses can be made to subcommands or submenus residing below the requested optional argument. 

The sysadm command may be given a password.  See admpasswd in the SUBCOMMANDS section. 

SUBCOMMANDS / MENUS

The following menus of subcommands are available.  (The number of bullets ( • ) in front of each item indicates the level of the menu or subcommand.) 

• diskmgmt
disk management menu The subcommands in this menu provide disk usage functions including the ability to format disks and use disks as mountable file systems.

• • checkfsys
check a disk file system for errors checkfsys checks a file system on a disk for errors.  If there are errors, this procedure attempts to repair them. 

• • diskreport
report on disk errors This subcommand shows the user if the system has collected any information indicating that there have been errors while reading the disks. Either summary or full reports can be requested. The summary report provides sufficient information about disk errors to determine if repair should be attempted. If the message "no errors logged" is part of the report, then there is probably no damage. If a number of errors is reported, there is damage and the disk should be repaired. The full report gives additional detail for the expert repair person trouble-shooting complicated problems. NOTE: Reports of disk errors usually result in loss of files and/or damage to data.  It is necessary to restore the repaired disk from a backup. 

• • erase
erase data from disk This procedure erases a disk by overwriting it with null bytes. The main purpose is to remove data that the user does not want seen. Once performed, this operation is irreversible.

• • harddisk
hard disk management menu The subcommands in this menu provide functions for using hard disks. The current disk partitioning of each hard disk can be displayed.

• • • display
display hard disk partitioning display displays the hard disk partitioning.  This provides current disk partitioning information. 

• • • format
format new disks format prepares new disks for use.  Once formatted, programs and data can be written on the disks. 

• • makefsys
create a new file system on a disk makefsys creates a new file system on a disk. It is a front end to the newfs(1M) command. 

• • mountfsys
mount a disk file system mountfsys mounts a file system, found on a disk, making it available to the user.  The file system is unmounted with the umountfsys command.  THE DISK MUST NOT BE REMOVED WHILE THE FILE SYSTEM IS STILL MOUNTED. 
IF THE FILE SYSTEM HAS BEEN MOUNTED WITH THE mountfsys COMMAND, IT MUST BE UNMOUNTED WITH umountfsys. 

• • umountfsys
unmount a disk file system umountfsys unmounts a file system, allowing the user to remove the disk.  THE DISK MUST NOT BE REMOVED UNTIL THE FILE SYSTEM IS UNMOUNTED. 
umountfsys MAY ONLY BE USED TO UNMOUNT FILE SYSTEMS MOUNTED WITH THE mountfsys COMMAND. 

• filemgmt
file management menu The subcommands in this menu allow the user to protect files on the hard disk file systems by copying them onto diskettes and later restoring them to the hard disk by copying them back. Subcommands are also provided to determine which files might be best kept on diskette based on age or size.

• • backup
backup files from integral hard disk to disk or tape backup saves copies of files from the integral hard disk file systems to disk or tape.  There are two kinds of backups: COMPLETE − copies all files (useful in case of serious file system damage) INCREMENTAL − copies files changed since the last backup The normal usage is to do a complete backup of each file system and then periodically do incremental backups. Two cycles are recommended (one set of complete backups and several incrementals to each cycle). Files backed up with backup are restored using restore. 

• • bupsched
backup reminder scheduling menu Backup scheduling is used to schedule backup reminder messages and backup reminder checks. Backup reminder messages are sent to the console to remind the administrator to backup particular file systems when the machine is shutdown or a reminder check has been run during the specified time period. Backup reminder checks specify particular times at which the system checks to see if any backup reminder messages have been scheduled.

• • • schedcheck
schedule backup reminder checks Backup reminder checks are run at specific times to check to see if any reminders are scheduled. The user specifies the times at which the check is to be run. Checks are run for the reminder messages scheduled by schedmsg. 

• • • schedmsg
schedule backup reminder message Backup reminder messages are sent to the console if the machine is shutdown or a reminder has been scheduled. The user specifies the times at which it is appropriate to send a message and the file systems to be included in the message.

• • diskuse
display how much of the hard disk is being used diskuse displays what percentage of the hard disk is currently occupied by files.  The list is organized by file system names. 

• • fileage
list files older than a particular date fileage prints the names of all files older than the date specified by the user. If no date is entered, all files older than 90 days are listed.  If no directory to search is specified, the /usr/admin directory is used. 

• • filesize
list the largest files in a particular directory filesize prints the names of the largest files in a specific directory.  If no directory is specified, the /usr/admin directory is used.  If the number of large files to list is not specified, 10 files are listed. 

• • restore
restore files from "backup" and "store" media to integral hard disk restore copies files from disks and tapes made by backup and store back onto the hard disk.  Individual files, directories of files, or the entire contents of a disk or tape can be restored.  Restores can be performed from both "incremental" and "complete" media.  The names of files stored on the disk or tape can also be listed. 

• • store
store files and directories of files onto disk or tape store copies files from the integral hard disk to disk or tape and optionally allows verification that they worked and to optionally remove them when done.  Typically, these would be files that are to have restrictive access or to be archived.  Single files and directories of files can be stored.  The restore command can be used to put stored files back on the integral hard disk and to list the files stored. 

• machinemgmt
machine management menu Machine management functions are tools used to operate the machine, e.g., turn it off, reboot, or go to the firmware monitor.

• • firmware
stop all running programs then enter firmware mode This procedure stops all running programs, closes any open files, writes out information to the disk (such as directory information), and then enters the firmware mode (machine diagnostics and other special functions that are not available on the UNIX system). 

• • powerdown
stop all running programs, then turn off the machine powerdown stops all running programs, closes any open files, writes out information to disk (such as directory information), and then turns off the machine power. 

• • reboot
stop all running programs then reboot the machine reboot stops all running programs, closes any open files, writes out information to disk (such as directory information), and then reboots the machine.  This can be used to get out of some types of system trouble, such as when a process cannot be killed. 

• • whoson
print list of users currently logged onto the system whoson prints the login ID, terminal device number, and sign-on time of all users who are currently using the computer. 

• networkmgmt
network management menu These subcommands help control the commands which exchange mail and files between machines.

• • uucpmgmt
basic networking utilities menu uucpmgmt allows listing, adding, deleting, and modifying entries in the associated file of each subcommand. 

• • • devicemgmt
manage devices (list, add, delete) This procedure is used to list, add, and delete entries in the Basic Networking Utilities /etc/uucp/Devices file.  This file contains information about devices available for using the commands: uucpf1, cu, and ct.

• • • pollmgmt
manage poll entries (list, add, delete) This procedure is used to list, add, and delete entries in the Basic Networking Utilities /etc/uucp/Poll file.  This file contains polling information including system names and the times (hours) for each system to be polled. 

• • • portmgmt
manage I/O ports (list, modify) This procedure is used to list and modify the entries that control the direction of traffic on the Basic Networking Utilities I/O ports used by uucp, cu, and ct commands. 

• • • systemmgmt
manage remote systems entries (list, add, delete, call) This procedure is used to list, add, and delete entries in the Basic Networking Utilities /etc/uucp/Systems file.  The /etc/uucp/Systems file contains information about the remote systems that can be called by cu and uucp commands.  This procedure can also be used to try to call (via uucp) any remote system that appears in the /etc/uucp/Systems file. 

• securemgmt
security management menu These subcommands are used by the CX/SX Secure OS system. Please see the CX/SX Trusted Facility Manual for more information. 

• softwaremgmt
software management menu

• • listpkg
list packages already installed This subcommand displays a list of currently installed software packages and installation dates.

• syssetup
system setup menu System setup routines allow specification of environment data such as: what the date, time, and time zone is, what administration and system capabilities are to be under password control, what the machine’s name is, etc. The first-time setup sequence is also here.

• • admpasswd
assign or change administrative passwords admpasswd allows setting or changing passwords for administrative commands and logins such as "setup" and "sysadm". 

• • datetime
set the date, time, time zone, and daylight savings time datetime specifies the date, time, time zone, and whether Daylight Savings Time (DST) is observed.  It is normally run once when the machine is first set up.  If DST is observed, automatic observation begins in the spring and returns to Standard Time in the fall.  The machine has to be turned off and turned back on again to guarantee that ALL times are reported correctly.  Most are correct the next time the user logs in. 

• • nodename
set the node name of this machine This allows changing the node name of this machine. The node name is used by various communications networks to identify this machine.

• • setup
set up the user’s machine the very first time setup allows definition of the first login, to set the passwords on the user-definable administration logins and to set the time zone. 

• • syspasswd
assign system passwords syspasswd allows setting system passwords normally reserved for the very knowledgeable user.  For this reason, this procedure may assign those passwords, but may not change or clear them.  Once set, they may only be changed by the specific login or the "root" login. 

• tapemgmt
tape management menu The subcommands in this menu provide functions for using tape media in tape devices.

• • Position
position tape media Position allows positioning of the tape media. 

• • erase
erase data from tape medium This procedure erases a tape medium by writing over it with null bytes. Its main purpose is to remove data that is not to be seen by anyone. Once it is performed, it is irreversible.

• • requests
tape requests management menu requests provides functions for indicating a desired tape is ready, denying specific requests, "premounting" a tape on a specific drive and querying the list of queued tape requests. 

• • • deny_t
cancel tape requests This procedure denies requests for a tape that is unavailable or inappropriate for a particular user.  The name of the tape to be denied is prompted for as well as an optional sequence number for specific requests.  If no sequence number is entered, all requests for the tape are cancelled.

• • • list_t
list all allocated/pending/queued requests This procedure gives a listing of all allocated/pending/queued tape requests.

• • • ready_t
indicate that a desired tape is mounted This procedure indicates that a desired tape is mounted.  It avoids the necessity of taking the drive offline and back online when the tape is mounted.

• • • premount_t
indicate that a specific tape is premounted on a drive This procedure indicates that a specific tape is "premounted" on a drive. It prompts for the name of the tape.  When a tape is premounted on a drive, that drive is only available to the next request for the specified tape and does not require the "offline/online" sequence to satisfy the request. Once the tape is requested successfully and released, the drive reverts to normal availability.

• • drives
tape drive management menu drives provides functions for marking specific tape drives down or up and for examining the status of all tape drives. 

• • • up_t
mark a specific drive up This procedure marks a specific drive up, marking it available to all users.

• • • status_t
check the status of all tape drives This procedure displays the status of all tape drives.

• • • down_t
mark a specific drive down This procedure marks a specific drive down and cancels any pending requests for that drive.  No future requests can allocate the drive.  When the drive is marked back up, it is available to all users.

• • service
tape service management menu service provides functions for starting and stopping the Tape Service and for selecting a new default destination for operator messages from the tape daemon. 

• • • startup
start up the Tape Service This procedure starts up the Tape Service.  It prompts for the following configuration information:  an accounting file for tape requests, mounts and unmounts; a configuration file for tape drives; an interval time between drive tests; an interval time between operator reminders; and an output device for operational messages.

• • • shutdown
terminate the Tape Service This procedure terminates the Tape Service and all tape resourcing activity. It is expected that this option be normally used only for debugging purposes. All requests that have not been successfully satisfied are denied and the daemon exits.

• • • output
change output terminal for operator messages This procedure changes the output terminal for operator messages from the tape daemon.  By default, the system console is used.  All new operator messages are directed to the device specified by the user.

• ttymgmt
terminal management menu This procedure allows management of the computer’s terminal functions.

• • lineset
show tty line settings and hunt sequences The tty line settings are often hunt sequences where, if the first line setting does not work, the line "hunts" to the next line setting until one that does work comes by. This subcommand shows the various sequences with only specific line settings in them. It also shows each line setting in detail.

• • mklineset
create new tty line settings and hunt sequences This subcommand helps in creating tty line setting entries. It is possible to add line settings that are not in the current set or create hunt sequences with only specific line settings in them. The created hunt sequences are circular; stepping past the last setting returns to the first.

• • mktty
create new tty line entries in inittab This subcommand creates new tty entries in the /etc/inittab file. 

• • modtty
show and optionally modify characteristics of tty lines This subcommand reports and allows changing the characteristics of tty lines (also called "ports").

• usermgmt
user management menu These subcommands allow adding, modifying and deleting the list of users that have access to a machine. They can also be placed in separate groups so that they can share access to files within the group yet protect themselves from other groups.

• • addgroup
add a group to the system addgroup adds a new group name or ID to the computer.  Group names and IDs are used to identify groups of users who desire common access to a set of files and directories. 

• • adduser
add a user to the system adduser installs a new login ID on the machine.  A series of questions about the user is asked and then the new entry is made.  More than one user at a time can be entered.  Once this procedure is finished, the new login ID is available. 

• • delgroup
delete a group from the system delgroup allows removing of groups from the computer.  The deleted group is no longer identified by name; however, files may still be identified with the group ID number. 

• • deluser
delete a user from the system deluser allows the removal of users from the computer.  The deleted user’s files are removed from the hard disk and their logins are removed from the /etc/passwd file. 

• • lsgroup
list groups in the system lsgroup lists all the groups that have been entered into the computer.  This list is updated automatically by addgroup and delgroup. 

• • lsuser
list users in the system lsuser lists all the users that have been entered into the computer.  This list is updated automatically by adduser and deluser. 

• • modadduser
modify defaults used by adduser modadduser allows changing of some of the defaults used when adduser creates a new login.  Changing the defaults does not effect any existing logins, only logins made from this point on. 

• • modgroup
make changes to a group on the system

• • • chgname
change a group name chgname allows changing of the name of a group entered when addgroup is run to set up new groups. 

• • moduser
menu of commands to modify a user’s login This menu contains commands that modify the various aspects of a user’s login.

• • • chgloginid
change a user’s login ID This procedure allows changing of a user’s login ID.  Administrative and system logins cannot be changed. 

• • • chgpasswd
change a user’s passwd This procedure allows removal or change of a user’s password. Administrative and system login passwords cannot be changed. To change administrative and system login passwords, see the system setup menu:  sysadm syssetup. 

• • • chgshell
change a user’s login shell This procedure allows changing of the command run upon a user’s login. The login shell of the administrative and system logins cannot be changed by this procedure.

• lpmgmt
LP print service management menu These subcommands help set up and control the LP Print Service system.  This menu can be used to start and stop the print service and check its status; add new printers; and monitor user print requests.

• • printers
printer management menu The subcommands in this menu provide functions for adding new printers to the print service, enabling and disabling printers, for turning on or off the acceptance status of printers, adjusting the alerting schedule for printers in trouble, and examining the printer configuration status.

• • • accept_p
allow printer to accept print requests accept_p prompts for a printer name or printer class that is now ready to accept print requests.  Multiple names can be entered when separated by a space or comma.  NOTE: Accepting print requests for a printer is not enough to cause them to print.  The printer must also be enabled, using the "enable" command in the "printers" menu.  The LP Print Service does not start printing requests until it is told by the user that the printer is ready:  powered on, with paper loaded, with the proper form loaded, etc. 

• • • add_p
add a new printer add_p prompts for a printer name.  Names must be made up of letters, digits, and underscores, and must be no more than 14 characters long. 

• • • delete_p
delete a new printer delete prompts for a printer name to be deleted.  To get a list of known printers, the user can enter "q" and select the "status" command from the "printers" menu.  NOTE: A printer CANNOT be deleted if print requests are currently queued on it.  They must be moved to another printer or allowed to finish printing. A "q" can be entered to return to the main "lpmgmt" menu.  To move the requests, the "requests" submenu can be entered to select the "move" command.  To wait for the print requests to finish, the "printers" submenu can be entered to select the "reject" command which rejects further print requests for the particular printer. 

• • • disable_p
disable printer from printing disable prompts for the names of printers that should stop printing requests.  To get a list of known printers, the user can enter "q" and select the "status" command from the "printers" menu.  Multiple names can be entered when separated by spaces or commas.  A disabled printer is prevented from printing further requests but requests can continue to queue up for the printer.  The user can specify whether any request currently printing can be stopped and put back in the queue, be canceled and discarded, or be allowed to finish printing before the printer is disabled. To stop further requests from being queued, the user completes the "disable" command and returns to the "printers" menu to select the "reject" command. This is a good idea if the printer is to be disabled for a long time.

• • • enable_p
enable printer for printing enable prompts for the names of printers that can start printing requests.  To get a list of known printers, the user can enter "q" and select the "status" command from the "printers" menu.  Multiple names can be entered when separated by spaces or commas. 

• • • reject_p
stop printer from accepting print requests reject prompts for the names of printers or printer classes that are to stop accepting print requests.  To get a list of known printers, the user can enter "q" and select the "status" command from the "printers" menu.  The "accept" command in the "printers" menu allows print requests to be queued again.

• • • status
check status of all printers status displays the status of the printers currently available. 

• • service
print service management menu The subcommands in this menu provide functions for starting and stopping the LP Print Service and for selecting a default destination for print requests.

• • • default
set default print destination default prompts for the names of printers or printer classes to use as the default destination of print requests.  The printer or class must already exist. 

• • • start
start the print service

• • • stop
stop the print service

• • status
print service status menu The subcommands in this menu provide functions for examining various aspects of the print service.  The user can see what printers are active and what printers are pending.

• • • printers
check status of all printers printers lists all of the printers currently available and their run status. 

• • • requests
check status of print requests requests prompts for one or more of the following items: the IDs of print requests whose status is to be displayed, the names of printers or printer classes whose queued requests are to be listed, and/or the names of users whose requests are to be displayed.  (Ambiguous printer or class names must be prepended with lp/ to distinguish them from a user name).  Multiple IDs and/or names can be entered when separated by a space or comma. 

• • • service
display status of print service service displays the run status of the print scheduler. 

EXAMPLES

sysadm adduser
sysadm usermgmt

FILES

The files that support sysadm are found in /usr/admin and /usr/lbin. 
The menu starts in directory /usr/admin/menu. 

SEE ALSO

sysadm(1MS)

CX/UX Administrator’s Reference