Examples of probe utility commands that can be used in programs.

Products

• DX Unified Infrastructure Management (Nimsoft / UIM)
• Unified Infrastructure Management for Mainframe

Issue/Introduction

How to use the probe utility to run commands from the command line (including examples)

Customers need some guidance on how to run probe commands from the command line.

Environment

- UIM 8.x or higher

Resolution

Available commands for a given probe can be listed by running the base command:

...\Program Files (x86)\Nimsoft\bin>pu.exe -u <user> -p <password> /Domain/Hub/Robot/<probe_name>

Usage: pu.exe [options] <nim-address> [command] [data]

        -i    interactive mode
        -u    user  user name
        -p    password      password to the NimBUS
        -s    SID  a valid SID
        -t    sec   timeout in seconds
        -H    host  use probe host
        -P    port   use probe port
        -d    level  set debug level
        -L    list commands on probe <default>
        -I    show probe info
        -R    restart probe
        -S    stop probe

The <nim-address> should be of the form:

/UIMDomain/HubName/RobotName/ProbeName

To run a probe command:

C:\Program Files (x86)\Nimsoft\bin>pu.exe -u <username> -p <password> /Domain/Hub/Robot/hub get_info

To list all available commands for a given probe, in this case the robot/controller probe see the example below:

E:\Program Files (x86)\Nimsoft\bin>pu.exe -u <[email protected]> -p <password> /Domain/Hub/Robot/controller

You don't need to specify the -L option.

...\Program Files (x86)\Nimsoft\bin>pu.exe -u <user> -p <password> /Domain/Hub/Robot/controller

This base command lists all of the possible pu commands you can use for a given probe, so for example this will list all the command arguments for cdm:

C:\Program Files (x86)\Nimsoft\bin>pu.exe -u <username> -p <password>/Domain/Hub/Robot/cdm

May 31 11:59:35:016 pu: SSL - init: mode=0, cipher=DEFAULT, context=OK
======================================================
Address: /Domain/Hub/Robot/cdm Request
: _command
======================================================
_status         PDS_PCH           9 detail%d
_command        PDS_PCH           9 detail%d
_debug          PDS_PCH          40 level%d,trunc_size%d,trunc_time%d,now%d
_stop           PDS_PCH           0 NULL
_restart        PDS_PCH           0 NULL
loglevel        PDS_PCH           8 level%d
uptime          PDS_PCH           0 NULL
get_info        PDS_PCH           0 NULL
get_top_n_processes PDS_PCH          18 no_of_processes%d
cpu_status      PDS_PCH           3 id
memory_status   PDS_PCH           0 NULL
disk_status     PDS_PCH          15 filesys,vgroup
disk_file_system_regex_status PDS_PCH          13 regex,vgroup
disk_shared_file_system_regex_status PDS_PCH          28 filesys,user,password,r
egex
connection_status PDS_PCH           0 NULL
cpu_history     PDS_PCH           0 NULL
memory_history  PDS_PCH           0 NULL
disk_history    PDS_PCH           7 vgroup
get_export      PDS_PCH           9 detail%d
cluster_info    PDS_PCH           0 NULL
get_token       PDS_PCH           7 string
is_aix          PDS_PCH           0 NULL
get_os          PDS_PCH           0 NULL

To restart a probe, e.g., the cdm probe, you can run a command such as this:

C:\Program Files (x86)\Nimsoft\bin>pu.exe -u xxxxxxxx -p xxxxxxxx /Domain/Hub/Robot/cdm _restart

or

C:\Program Files (x86)\Nimsoft\bin>pu.exe -R -u <username> -p <password> /Domain/Hub/Robot/cdm

May 31 12:00:00:583 pu: SSL - init: mode=0, cipher=DEFAULT, context=OK
======================================================
Address: /Domain/Hub/Robot/cdm Request
: _restart
======================================================

Additional Information

Examples:

Get a list of robots under a hub

pu -u administrator -p <password> /domain/hub/robot/hub getrobots "" "" > get_robots.txt

Reload a single webapp on a robot running wasp

pu -u administrator -p <password> /domain/hub/robot/wasp reload_webapp cabi

Restart a robot

pu -u administrator -p <password> -H <robot_ip> -P 48000 _stop

Update a user tag

pu -u administrator -p <password> /domain/hub/robot/controller probe_config_set controller /controller os_user1 "test"

List installed packages

pu -u administrator -p <password> /domain/hub/robot/controller inst_list_summary

Reset the keystore on wasp

pu -u administrator -p <password> /domain/hub/robot/wasp ssl_reinitialize_keystore

Run a plugin metric correction

pu -u administrator -p <password> /domain/hub/robot/mon_config_service plugin_metric_correction robot_name <robot_name>

Delete device snmpcollector

pu -u administrator -p <password> /domain/hub/robot/snmpcollector remove_snmp_device host <device_ip>

Add device snmpcollector

via pu command for v1 or v2c:

pu -u administrator -p <password> /domain/hub/robot/snmpcollector add_snmp_device <device_ip> snmpv2c <MYDescription> 161 <community_string>

via pu command for v3:

pu -u administrator -p <password> /domain/hub/robot/snmpcollector add_snmp_device <device_ip> snmpv3 <MYDescription> 161 "" <mysnmp3username> NoAuthNoPriv

pu -u administrator -p <password> /domain/hub/robot/snmpcollector add_snmp_device <device_ip> snmpv3 <MYDescription> 161 "" <mysnmp3username> AuthNoPriv MD5 <snmp3password>

pu -u administrator -p <password> /domain/hub/robot/snmpcollector add_snmp_device <device_ip> snmpv3 <MYDescription> 161 "" <mysnmp3username> AuthPriv MD5 <snmp3password> AES-128 <snmp3privpassword>