Using additional utilities for the Linux option

The following sections describe for additional views and utilities that you can access from the EZLNX menu.

Linux Test view

The Linux Test (FSLTEST) view, displays the output from the /opt/bmc/mml/mmldtest script as a list of return codes and messages. You can use the FSLTEST view in conjunction with the Alarm Definition MMLXET01 script (supplied with MainView for Linux — Servers) to create Alarms or ALERTs based on message activity that appears in this view. See MainView Alarm Manager for additional information about using Alarms and ALERTs.

Two sample test scripts are delivered in the BBSAMP data set. The default script, BBSAMP(MMLDTEST), tests for error messages in the /var/bmc/mml/mmldtest.log file and displays any nonzero messages.

The second script, BBSAMP(MMLDTST2), tests the amount of used disk space in the /tmp directory, and will issue an RC=8 error message if the used disk space exceeds the MAXDSK threshold (default=90%).

You can modify either script. Copy the script to UBBSAMP(MMLDTEST) to make any modifications. Use the Linux PTF Update option to download the updated UBBSAMP(MMLDTEST) script in addition to the latest PTF files.

Note

Any changes in the UBBSAMP(MMLDTEST) script should be tested to ensure it runs within the Reply Timeout setting (default=20 seconds).

Linux Test view

W1 =FSLTEST===========LNX0001==*========DDMMMYYYY==10:24:32====MVLNX===
RC Test Output
------ ------------------------------------
0 No error messages in /var/bmc/mml/mmldtest.log

Linux SHELL Command dialog

The Linux SHELL Command (SHELL) dialog, allows you to run a Linux shell command without having to log on to the remote Linux system. You have the option of running the command in the foreground or background. When the command is run in the foreground, the output is captured and displayed.

To run the command in the background for long-running commands (such as those that run longer than the default 20 second specification for the Reply Timeout setting), specify Y in the Run in background field. The output from the command is written to a default location in the /var/bmc/mml/mmldsrv.log file.

Linux SHELL Command dialog

|------------------- SHELLCMD - Run Linux Shell Command (sh) -----------------|
| COMMAND ===>                                              SCROLL ===> PAGE |
| |
| Linux Image Name: LNX0001 |
|   |
| Shell Command: |
|/bin/pwd |
| |
| |
|   |
|   |
| Run in background? N |
|                                                                             |
| END to execute shell command |
| CANCEL to NOT execute shell command |
| HELP to view related help |
|                                                                             |
|-----------------------------------------------------------------------------|

Linux PTF Update dialog

The Linux PTF Update (UPDATE) dialog, allows you to update the BMC data server and collector programs on multiple Linux target machines by specifying an asterisk (*) or a question mark (?) in the target pattern. The asterisk wildcard character represents multiple characters and the question mark wildcard character represents a single character.

|--------------------- UPDATE - Update Linux data server --------------------|
| COMMAND ===>                                              SCROLL ===> PAGE |
| |
| Target Pattern:         LNX0001 |
| DSN Hi-level Qualifier: |
| |
|BMC.MVLNX |
|                 |
| MVS Host:            MVS01 |
| TSO Userid:TSOUSR1 |
| TSO Password: |
| RTServer MVS Host:MVS01 |
| RTServer MVS Port:5101 |
| Linux Data Server Userid:mmldusr |
| Linux Data Collector Vendor:B                  (B=BMC,V=Velocity) |
| Update BMC bgscollect?N (y/n)                  |
| |
| Are you sure?: (y/n)                  |
| |
| END to run UPDATE command |
| CANCEL to NOT run UPDATE command |
| HELP to view related help |
|                                                         |
|----------------------------------------------------------------------------|

For example, specifying the TEST* target pattern updates all MainView Linux image names that start with characters TEST. The data set name (DSN) hilevel qualifier specifies where the BBSAMP and RPMS data sets reside and specifies where to download the latest PTF versions after a PTF has been applied. This value should match the BBCHILV parameter in the MainView for Linux — Servers PAS startup process.

The MVS host, and TSO user ID and password are used to FTP the latest PTF versions from the BBSAMP and RPMS data sets. The RTServer host and port specifies which RTServer the Linux target will use. The Linux data server user ID is the nonroot user ID that installs and runs the data server and bgscollect data collector. The default is mmldusr.

The Linux data collector vendor specifies which Linux data collector vendor you are going to use. The default is BMC. If you select BMC, then the bgscollect data collector is used.

If you select Velocity, the bgscollect data collector will not be installed or used, and the Linux data will be collected from the z/VM Velocity Software ESALPS data collector.

If you specify BMC as the Linux data collector, you have the option of updating the BMC bgscollect program. You only need to specify Yes when a PTF has updated the bgscollect program. If the UPDATE command is run, it submits an /opt/bmc/mml/mmldinst shell command to each Linux data server target. The output from the command is saved in the /tmp/mmldinst.log file.

Linux Help view

The Linux Help (FSLMANL) view, displays a list of man pages from the /opt/bmc/mml/whatis file. When you press Enter on one of the command lines, it will invoke the (FSLMAN) view which displays the output from the specified Linux man command.

W1 =FSLMANL===========LNX0001==*========DDMMMYYYY==15:08:30====MVLNX====D=
> man                               Move cursor to linux command you want
                                     more info about, and then press ENTER
------------------------------------

admin   - create and administer SCCS files (DEVELOPMENT)
alias   - define or display aliases
ar   - create and maintain library archives
asa               - interpret carriage-control characters
at               - execute commands at a later time
awk               - pattern scanning and processing language
basename       - return non-directory portion of a pathname
batch           - schedule commands to be executed in a batch queue
bc               - arbitrary-precision arithmetic language
bg               - run jobs in the background
break           - exit from for, while, or until loop
c99               - compile standard C programs
cal               - print a calendar
cat               - concatenate and print files
cd               - change the working directory
cflow           - generate a C-language flowgraph (DEVELOPMENT)
chgrp           - change the file group ownership
chmod           - change the file modes

W1 =FSLMAN============LNX0001==*========DDMMMYYYY==15:09:35====MVLNX===
> man cat                           Press ENTER on the page to switch
between the manual page sections.
------------------------------------

CAT(1)    User CommandsCAT(1)

NAME
cat - concatenate files and print on the standard output

SYNOPSIS
   cat [OPTION] [FILE]...

DESCRIPTION
   Concatenate FILE(s), or standard input, to standard output.

   -A, --show-all
   equivalent to -vET

   -b, --number-nonblank
   number nonblank output lines