Open System Services Management and Operations Guide (G06.29+, H06.07+)

Managing Servers
Open System Services Management and Operations Guide—527191-005
4-30
Configuring the OSS Message-Queue Server
Configuring the OSS Message-Queue Server
You configure the OSS message-queue server by changing its entries in the Enscribe
database ZOSSSERV file. The following procedure assumes that no applications that
use message queues have been started yet:
1. To stop the OSS message-queue server, enter this OSS Monitor SCF command:
STOP SERVER $ZPMON.#ZMSGQ
2. Use the OSS Monitor SCF ALTER SERVER Command to change the ZOSSSERV
entry for the OSS message-queue server.
a. To reassign the process to a new primary or backup processor, change the
corresponding processor entry. If you do not explicitly assign a backup
processor, the backup server process is started in the next higher-numbered
processor after the processor that runs the primary server process.
b. To change behavior associated with use of the automatic startup service,
change the corresponding BACKUPCPUOK, MAXWAITTIME,
DESIREDSTATE, or AUTORESTART entry.
c. To change the message-queue configuration, change the corresponding
MSGMQB, MAXMQID, MAXMSG, or MSGMSIZE entry. The attribute values
appropriate to the best performance on a specific system depend on factors
unique to each site’s configuration and mix of applications.
Use nondefault values to tune message-queue performance on your system
only after gathering performance data, analyzing process memory
requirements, and considering the effects of a default configuration on system
overhead because of the volume of interprocess communication involved.
3. To restart the server, enter this OSS Monitor SCF command:
START SERVER $ZPMON.#ZMSGQ
If you use the STARTOSS utility at your site, you can also configure the OSS
message-queue server to be started by that utility. To do so, add the server name to
the OSSINFIL file. See OSSINFIL File on page C-19 for more information.
Configuring the OSS Sockets Local Server
You configure an OSS sockets local server by changing its entries in the Enscribe
database ZOSSSERV file. The following procedure assumes that no applications that
use AF_UNIX sockets have been started yet:
1. To stop the OSS sockets local server, enter this OSS Monitor SCF command:
STOP SERVER $ZPMON.#ZPLS
2. Use the ALTER SERVER Command to change the ZOSSSERV entry for the OSS
sockets local server: