File system
Before you install the IBM® MQ client for HP Integrity NonStop Server , make sure that the file system is set up correctly.
Review Hardware and software requirements on HP Integrity NonStop Server systems to make sure that you understand the approximate amount of disk space in the OSS and Guardian file systems that is required for an installation. The OSS file set that is used for the installation requires enough free space for the installation files and the files you create in the installation. The Guardian volume that you use for installation does not require auditing.
Work with your systems administrator to verify the OSS file set and Guardian file system storage requirements, at least for an initial estimate of the storage. The best way to determine more precisely how much storage you would eventually need in production is to produce a prototype configuration and model the message storage requirements, scaling up as necessary for your production system.
OSS file system objects
For the OSS file system objects, this section concentrates on the differences between the HP Integrity NonStop Server installation, and the standard UNIX installation. Multiple independent installations are supported.
The opt and var trees must be present in a common root directory, which is selected at installation time. The opt tree contains files that do not change. For example, this tree contains program, library, dll, header files, and "static" data files. The var tree contains files that might change, and do hold status about the installation itself. Examples of files that this tree holds are configuration files, and log files.
Both the opt and var directories contain a single directory named mqm. The content of both trees is rooted in the opt/mqm and var/mqm directories.
Directory | Purpose | Contents |
---|---|---|
bin | Contains the OSS programs and libraries for an installation |
|
inc | Contains the header files for building IBM MQ applications |
|
lib | Contains the import libraries needed to link applications |
|
license | Contains text versions of the IBM License for the IBM MQ client for HP Integrity NonStop Server product, which is translated into each supported national language |
|
mq.id | Single file that contains information about the build level and install package | All contents in this directory might be used by IBM Support personnel. |
msg | Contains globalization files for use by IBM MQ , in logging and displaying output in the supported national language translations |
The contents include:
|
samp | Contains sample code and executables to illustrate the use of IBM MQ |
|
For more information about the samples that are provided with IBM MQ client for HP Integrity NonStop Server , see Samples for IBM MQ client for HP Integrity NonStop Server.
This table displays a summary of the contents at the top-level of var/mqm:
Directory | Purpose | Contents |
---|---|---|
conv | Contains data conversion files | Binary data that supports the data conversion function for IBM MQ |
errors | Contains installation-wide error logs and FDC files |
Standard content, for example:
|
exits | Stores DLLs containing exit code that is loaded by the queue managers in the installation | This file is empty at installation |
log | Contains log files for recording and controlling units of work | Standard content |
mqs.ini | The installation configuration file | Standard content |
qmgrs | Directory beneath the location where all of the queue manager directories are created | Standard content |
sockets | Directory tree that contains various queue manager control files | Standard content |
trace | Defined location to which trace data is written by IBM MQ | Standard content |
Guardian installation subvolume
The Guardian single installation subvolume contains both the programs and libraries needed at runtime.
File | Description |
---|---|
AMQINST | Internal file that describes installation configuration |
AMQS* | Samples that are built for Guardian |
B*SAMP | Sample build files for the various supported languages |
CMQ* | Header files for the various supported languages, where files ending in:
|
MQ* | Product libraries |
MQS*C | Sample C language source files |
MQS*T | Sample pTAL language source files |
MQS*L | Sample COBOL language source files |
Control commands are also included, for a list, see HP Integrity NonStop Server client commands.