Command reference for the Problem Insights server

Edit online

This topic provides a command reference for Problem Insights server instances installed on z/OS® UNIX System Services.

For Problem Insights server on Linux®, see Command reference for OCI containers.

Table 1. Commands for operating the Problem Insights server
Action Command
Start the server (and the common services).
System Display and Search Facility (SDSF) command: 
/S GLASTART
z/OS UNIX System Services command:
./bin/zoa-svc-control.sh --start

These commands load the message libraries when they are run for the first time.
Stop the server (and the common services).
System Display and Search Facility (SDSF) command: 
/S GLASTOP
z/OS UNIX System Services command:
./bin/zoa-svc-control.sh --stop
Get the status of all the services.
z/OS UNIX System Services command:
./bin/zoa-svc-control.sh --status
Start or stop an individual service.
z/OS UNIX System Services command:
./bin/zoa-svc-control.sh --start <service>
./bin/zoa-svc-control.sh --stop <service>
where, <service> can be one of the following:
  • gw: The gateway service
  • kc: The Keycloak authentication service
  • piserver: The Problem Insights server
Load the new gateway service certificate into the Problem Insights server truststore.
z/OS UNIX System Services command:
./bin/getGatewayCert.sh load
Delete the existing gateway service certificate from the Problem Insights server truststore.
z/OS UNIX System Services command:
./bin/getGatewayCert.sh delete
List the message libraries that were imported into the embedded database.
z/OS UNIX System Services command:
bin/analysis.sh getlibrarylist

This command give you the message library ID and locale, which you must use in the commands for exporting or deleting a message library.
Export a message library. Use one of the following commands, depending on whether you want to export the message library to the console or to a file:
Export to the console
z/OS UNIX System Services command:
bin/analysis.sh exportlibrary library_id locale
Export to a file
z/OS UNIX System Services command:
bin/analysis.sh exportlibrary library_id locale path_to_file
Delete a message library. Use one of the following commands, depending on whether you want to have a prompt for user confirmation:
Delete with prompting for user confirmation
z/OS UNIX System Services command:
bin/analysis.sh deletelibrary library_id locale
Delete without prompting for user confirmation
z/OS UNIX System Services command:
bin/analysis.sh deletelibrary -f library_id locale
Import a message library.
z/OS UNIX System Services command:
bin/analysis.sh importlibrary path_to_file
Delete data match results that are over 30 days old. Use one of the following commands, depending on whether you want to have a prompt for user input:
Delete with prompting for user input
z/OS UNIX System Services command:
bin/analysis.sh purgeResults
Delete without prompting for user input
These commands include the argument -f, which forces the deletion without prompting for user input.
z/OS UNIX System Services command:
bin/analysis.sh purgeResults -f
Generate a new
bootstrap.properties file
from the current configuration setup.
z/OS UNIX System Services command:
bin/analysis.sh createBootstrap
Encrypt text, such as a password.
z/OS UNIX System Services command:
bin/analysis.sh encrypt text_to_encrypt