Add Secondary System Name (ADDDSTSYSN)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Add Distribution Secondary System Name (ADDDSTSYSN) command allows you to add an entry to the distribution services secondary system name table. The table contains the names of all of the alternate (or alias) system names for which this system receives and may redirect distributions. The SNA distribution services (SNADS) function automatically directs distributions with the local system as the destination system name, so the local system cannot be added to the secondary system name table.

System names and group names are translated to the graphic character set and code page 930 500, using the job's coded character set identifier (CCSID).

Restrictions:

Top

Parameters

Keyword Description Choices Notes
SYSNAME Secondary system name Element list Required, Positional 1
Element 1: System name Character value
Element 2: System group Character value
TEXT Text Character value, *BLANK Optional
Top

Secondary system name (SYSNAME)

Specifies the alternate system name and system group name being added to the distribution services secondary system name table. You cannot specify the current system name unless you specify a non-blank system group name.

You can specify a maximum of 8 characters for the system name and a maximum of 8 characters for the group name.

This is a required parameter.

Top

Text (TEXT)

Specifies the text that briefly describes the object.

The possible values are:

*BLANK
No text is specified.
'description'
Specify a maximum of 50 characters of text enclosed in apostrophes.
Top

Examples

ADDDSTSYSN   SYSNAME(SYS2LAJ1 ROCHESTR)

This command adds the system named SYS2LAJ1 ROCHESTR to the distribution services secondary system name table. The local system will receive distributions that contain SYS2LAJ1 ROCHESTR as the destination system name.

If the local system is named SYS2LAJ1, this command allows the local system to participate in a network that requires a group name of ROCHESTR for each participating system.

Top

Error messages

*ESCAPE Messages

CPF8807
Error occurred while using QSNADS journal.
CPF8818
Secondary system name table entry &1 &2 not found.
CPF8835
System name/Group &1 &2 already specified.
CPF8837
System name/Group &1 &2 in use by another distribution services function.
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.
CPF9899
Error occurred during processing of command.
Top