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:
- This command is shipped with public *EXCLUDE authority, and the QPGMR and QSYSOPR user profiles have private authorities to use the command.
- The secondary system name table does not operate with SystemView distribution services (SVDS) types of distributions.
| 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 |