I/O Logfile Cache Options

These options allow users to maintain the database that caches the I/O logfile names for use with BeyondInsight for Unix & Linux.

Usage

pbdbutil --iocache [<options>]

Display cached list of I/O log files:

--lstcache=['{ param… }'] Use equals symbol (=) for optional parameter.
| -S['{ param… }'] No space between switch name and optional parameter.
-s <[-|+]attribute> Sort the list of records by attribute name (asc/desc).

 

Remove I/O log file entries from the logfile cache database:

-d '{param…}']

Where the { param… } argument is formatted JSON parameters:

  • {"path":"pattern"}: glob wildcard for logfile path
  • {"loghost":"host1"}: Filter by loghost name
  • {"submithost":"host2"}: Filter by submithost name
  • {"runhost":"host3"}: Filter by runhost name
  • {" submituser":"user1"}: Filter by submituser name
  • {"runuser":"user2"}: Filter by runuser name
  • {"runcmd":"command"}: Filter by run command
  • {"from":"<yyyy-mm-dd HH:MM>"}: Filter I/O logs created on or after this date/time
  • {"to":"<yyyy-mm-dd HH:MM"}: Filter I/O logs created on or before this date/time
  • {"start":<offset>}: Specify record offset (number) when limiting output
  • {"len":<len>}: Specify number of rows when limiting output

Migrate I/O log location cache database (Upgrades only):

-n [--force]

Migrates pre-v10.3.1 I O log location cache database to the new database configuration.

Migration is automatically done during an upgrade via pbinstall. Running this manually is typically not necessary unless circumstances prevented the automatic migration during the upgrade. The optional --force skips backup of the original/obsolete I/O log cache database if it already has been backed up by other methods.

Where the { param } argument is formatted JSON with parameters:

  • "path":"pattern": glob wildcard for logfile path
  • "loghost":"host2": loghost name
  • "submithost":"host1": Filter by submithost name
  • "runhost":"host1": Filter by runhost name
  • "submituser":"user1": Filter by submituser name
  • "runuser":"user1": Filter by submituser name
  • "runcmd":"cmd": Filter by runcmd name
  • "from":"<yyyy-mm-dd HH:MM>": Filter by logfiles opened on or after this date/time
  • "to":"<yyyy-mm-dd> HH:MM": Filter by logfiles opened on or before this date/time
  • "start":<offset>: Specify record offset (number) when limiting output
  • "len":<limit>: Specify number of rows when limiting output