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

Document ID : KB000057382
Last Modified Date : 31/05/2018
Show Technical Document Details
Introduction:
How to use the probe utility to run commands from the command line (including examples)
Background:
Customers need some guidance on how to run probe commands from the command line.
Environment:
- UIM 8.x or higher
Instructions:
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> /NMS/NMS-Server/NMS-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

To run a probe command:

C:\Program Files (x86)\Nimsoft\bin>pu.exe -u <username> -p <password> /NMS/NMS-Server/NMS-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 <username@abc.com> -p <password> /NMS/NMS-Server/NMS-Robot/controller

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

...\Program Files (x86)\Nimsoft\bin>pu.exe -u <user> -p <password> /NMS/NMS-Server/NMS-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 xxxxxxxx -p xxxxxxxx /NMS/NMS-Server/NMS-Robot/cdm

May 31 11:59:35:016 pu: SSL - init: mode=0, cipher=DEFAULT, context=OK
======================================================
Address: /NMS/NMS-Server/NMS-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 /NMS/NMS-Server/NMS-Robot/cdm _restart

or

C:\Program Files (x86)\Nimsoft\bin>pu.exe -R -u xxxxxxxx -p xxxxxxxx /NMS/NMS-Server/NMS-Robot/cdm

May 31 12:00:00:583 pu: SSL - init: mode=0, cipher=DEFAULT, context=OK
======================================================
Address: /NMS/NMS-Server/NMS-Robot/cdm Request
: _restart
======================================================
Additional Information:
See also:
Run Probe Commands from a DOS Prompt
https://docops.ca.com/display/UIM83/Run+Probe+Commands+from+a+DOS+Prompt