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

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

book

Article ID: 57382

calendar_today

Updated On:

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
======================================================