sdcp
tool
sdcp
is the Service Data Collection and Packaging tool.
sdcp
is an OSS shell script that can be used to collect and package important
data from IBM® MQ for HPE NonStop
V8.1. The primary purpose of
sdcp
is to reduce the time and effort required from users and IBM Support in
gathering the most critical and commonly required data in support of the technical analysis of a
PMR.
sdcp
gathers data about the IBM MQ
installation and the queue managers running in that installation. Data is also collected about the
general operating environment on the HPE NonStop Server. Queue managers do not need to be stopped
when running sdcp
.
No customer application message data is collected to avoid inadvertently collecting sensitive
information. Use of IBM MQ utilities to collect queue,
channel, and authority information can be excluded if necessary. sdcp
requires no
interactive input from the user and makes no modifications to the system, IBM MQ installation, or the queue managers.
Usage
sdcp
runs from the OSS shell and requires a logged-in user ID that is an
administrator of the IBM MQ installation.
The command line interface is as follows:
sdcp [-d] [-e] [-f] [-w workdir] [-m queuemgr] [-p pmrNumber] [-x]
Where:
- -d
-
Enables OSS shell debug output for the script
- -e
-
Excludes the use of IBM MQ utility programs to collect configuration and status information about running queue managers. If not specified, IBM MQ command line utilities are used to collect this data for running queue managers.
- -f
-
Enables the fully detailed collection of certain items, including the WHOHAS utility. The full level of detailed data collection can take over an hour on some systems and is usually not necessary. Only use this parameter if directed to by IBM Support. If not specified, a normal level of detail is collected.
- -w
-
Is the name of an OSS directory where
sdcp
stores temporary files that it uses while running, and where the final output is created. If not specified, the current working directory is used. - -m
-
queuemgr is the name of the queue manager to collect data for. If not specified,
sdcp
collects data for all queue managers in the installation. - -p
-
pmrNumber defines the final archive and intermediate file name prefix, and must be formatted as an IBM Support PMR number, branch and country code; with each item being separated by a dot (.) or comma (,). For example, 11111.222.333.
Note: The use of the-p
flag is recommended when collecting data for submission to IBM Support. Proper use of this flag will ensure that the file gets uploaded to the appropriate storage location. - -x
- Enables the use of amqxdbg during gathering of SDCP data. This can lead to the creation of FFSTs in the global error directory.
For simple usage, just typing sdcp
causes the collection of data from the
installation, plus all queue managers in that installation (whether running or not).
To reduce the volume of data and the time taken to collect the data, you can run
sdcp
to collect data for a specific queue manager:
sdcp -m qmgr
-e
parameter to exclude the use of IBM MQ utilities to collect data for running queue
managers:sdcp -m qmgr -e
sdcp -w /home/fred -m QM1 -p 99999,888,777