Creating the User Name Server runtime environment on z/OS

This is part of the larger task of creating a User Name Server on z/OS.

Before you start

To complete this task, you must have completed the following task:
Invoke the mqsicreateusernameserver command to create a User Name Server and its runtime environment. The command syntax is:
mqsicreateusernameserver -c <ComponentDirectory> -q QueueManagerName  [-r RefreshInterval] 

You will be asked to confirm that the parameters you enter are correct. Enter Y to confirm, or N to change the parameters. If you choose to change the parameters, reinvoke mqsicreateusernameserver.

Check that you are using the correct installation path, particularly if you are recustomizing after applying maintenance to an alternate set of WebSphere MQ Integrator Broker libraries. If you are applying service to the broker, you might want a different installation path. Refer to Setting up your OMVS user ID for details of how to change which libraries you use.

If you get the message:
mqsicreateusernameserver: FSUM7351 not found
refer to the steps described in Setting up your OMVS user ID.

The functionality of this command is not the same as on distributed platforms, because no WebSphere MQ-related definitions are performed. You have to follow further steps to complete the User Name Server creation and customization.

Required parameters

-c <ComponentDirectory>
The root directory of the User Name Server you created in the previous step. For example /wmqiv21/MQP1UNS.
-q QueueManagerName
The name of the WebSphere MQ queue manager associated with your User Name Server, for example MQP1.

Optional parameters

-r RefreshInterval
The interval, specified in seconds, at which the User Name Server interrogates the security subsystem for changes to user or group attributes. If an interval is not specified, the User Name Server default interval of 60 seconds is used.

Related concepts
User Name Server

Related tasks
Creating a User Name Server on z/OS
Creating the User Name Server directory on z/OS
Editing the Customization Input File (mqsicompcif) for a User Name Server
Setting up your OMVS user ID

Related reference
mqsicreateusernameserver command
mqsichangeusernameserver command
mqsideleteusernameserver command