Skip to main content

IBM AS400 Connector

Pack Assets​

Templates​

The Centreon Plugin Pack IBM AS400 Connector brings 1 host template:

  • OS-AS400-Connector-custom

It brings the following Service Templates:

Service AliasService TemplateDefaultDiscovery
CommandOS-AS400-Command-Connector
DisksOS-AS400-Disks-ConnectorX
Job-QueuesOS-AS400-Job-Queues-Connector
JobsOS-AS400-Jobs-ConnectorX
Message-QueueOS-AS400-Message-Queue-Connector
Page-FaultsOS-AS400-Page-Faults-ConnectorX
SubSystemOS-AS400-SubSystem-ConnectorX
SystemOS-AS400-System-ConnectorX

Discovery rules​

Rule nameDescription
OS-AS400-Connector-SubSystem-NameDiscover Subsystems and libraries
OS-AS400-Connector-Disk-NameDiscover disks

Collected metrics & status​

Metric nameDescription
statusStatus of the remote command (failed or not)

Prerequisites​

This plugin works in a slightly different way than the common ones. It requires a connector to communicate with the AS400/iSeries system.

You can install the connector using this command:

yum install centreon-plugin-Operatingsystems-AS400-daemon

A connector can act as a relay between several Hosts and several AS400 systems.

Setup​

  1. Install the Centreon Plugin package on every Centreon poller expected to monitor AS400/iSeries ressources:
yum install centreon-plugin-Operatingsystems-AS400-Connector
  1. On the Centreon Web interface, install the IBM AS400 Connector Centreon Plugin Pack on the Configuration > Plugin Packs page:

Configuration​

Host​

  • Log into Centreon and add a new Host through Configuration > Hosts.
  • Fill the "Name", "Alias" & "IP Address / DNS" fields according to your IBM AS400 settings
  • Select the operatingsystems-as400-connector-custom template to apply to the Host
  • Once the template applied, some Macros marked as 'Mandatory' hereafter have to be configured.
MandatoryNameDescription
AS400PASSWORD
AS400USERNAME
CENTREONCONNECOTRHOST(Default: 'localhost')
CENTREONCONNECTORPORT(Default: '8091')
CENTREONCONNECTORPROTO(Default: 'http')
EXTRAOPTIONS(Default: 'Any extra option you may want to add to every command_line (eg. a --verbose flag)')

How to check in the CLI that the configuration is OK and what are the main options for ?​

Once the plugin is installed, log into your Centreon Poller CLI using the centreon-engine user account and test the Plugin by running the following command:

/usr/lib/centreon/plugins//centreon_as400_connector_client.pl \
--plugin=os::as400::connector::plugin \
--mode=job-queues \
--as400-hostname=10.1.2.3 \
--as400-username='myuser' \
--as400-password='mypassword' \
--jobq="QGPL:QBASE" \
--jobq="QGPL:QPGMR" \
--verbose

The expected command output is shown below:

OK: Job queues total: 2 - All job queues are ok | 'jobqueues.total.count'=2;;;0; 'QGPL~QBASE#jobqueue.jobs.active.count'=0;;;0; 'QGPL~QBASE#jobqueue.jobs.scheduled.count'=0;;;0; 'QGPL~QBASE#jobqueue.jobs.held.count'=0;;;0; 'QGPL~QPGMR#jobqueue.jobs.active.count'=0;;;0; 'QGPL~QPGMR#jobqueue.jobs.scheduled.count'=0;;;0; 'QGPL~QPGMR#jobqueue.jobs.held.count'=0;;;0;
Job queue 'QBASE' [library: QGPL] status: RELEASED, active jobs: 0, scheduled jobs: 0, held jobs: 0
Job queue 'QPGMR' [library: QGPL] status: RELEASED, active jobs: 0, scheduled jobs: 0, held jobs: 0

This command checks two different JOBQ (--jobq="QGPL:QBASE" --jobq="QGPL:QPGMR") on a given AS400 system (--as400-hostname=10.1.2.3) using some credentials (--as400-username='myuser' --as400-password='mypassword').

All available options for a given mode can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins//centreon_as400_connector_client.pl \
--plugin=os::as400::connector::plugin \
--mode=queues \
--help

All available options for a given mode can be displayed by adding the --list-mode parameter to the command:

/usr/lib/centreon/plugins//centreon_as400_connector_client.pl \
--plugin=os::as400::connector::plugin \
--list-mode

Troubleshooting​

Please find all the troubleshooting documentation for the Centreon Plugins in the dedicated page