CFGDSTSRV (Configure Distribution Services)

CFGDSTSRV Command syntax diagram

 

Purpose

The Configure Distribution Services (CFGDSTSRV) command changes the configuration of the distribution network. The user can add, change, remove, and display entries from the distribution queues table, the routing table, and the secondary system name table. A detailed description of configuring a distribution network is in the SNA Distribution Services book.

 

Restrictions

1. This command is shipped with public *EXCLUDE authority and the QPGMR and QSYSOPR user profiles have private authorities to use the command.
   
2. Before this command is run for the first time, the QSNADS subsystem must be started to create the internal systems network architecture distribution services (SNADS) objects that this command uses.
   
3. Messages that report errors about system names or distribution queues may show or print different characters than the user entered because of internal system transformations. The internal value for a system name or distribution queue may differ from the characters shown by the CFGDSTSRV command depending on the language being used for the work station.

 

Optional Parameters

OPTION

Specifies an option from the Distribution Services Menu display that bypasses the initial menu and goes directly to the indicated table. The user can specify the distribution queues table, routing table, or secondary system name table without showing the Distribution Services Menu display.

*SELECT: The option is selected from the Distribution Services Menu display.

1: The distribution queues table function, which identifies all the distribution queues for systems adjacent to the local system, is used.

An example of the distribution queues function is in the SNA Distribution Services book.

2: The routing table function, which describes explicit or default entries for the destination systems in the SNADS network to which distribution queue entries can be routed, is used. An example of the routing table function is in the SNA Distribution Services book.

3: The secondary system name function, which lists all names by which the system is known, is used. An example of the secondary system name function is in the SNA Distribution Services book.

Example for CFGDSTSRV

CFGDSTSRV  OPTION(1)

This command shows the distribution queues' table entries.

Configuration changes may be made to existing distribution queues, or additional distribution queues may be configured.

Error messages for CFGDSTSRV

*ESCAPE Messages

CPF8802

Distribution queue &1 was not found.

CPF8805

Special value for System name/Group not permitted or not used correctly.

CPF8806

Value &1 not valid for system name or system group.

CPF8807

Error occurred while using QSNADS journal.

CPF8809

Errors detected on SNADS internal queues.

CPF8814

Queue &1 not found.

CPF9845

Error occurred while opening file &1.

CPF9846

Error while processing file &1 in library &2.

CPF9847

Error occurred while closing file &1 in library &2.

CPF9850

Override of printer file &1 not allowed.

CPI8854

DSNX error while journaling.