Z-ADD01T

This document covers the following topics:


Description

Add a nickname for an address at an external node. This subprogram also applies to an external node which uses the transport service.

This subprogram does not apply to an internal Con-nect address. To add a nickname for an internal Con-nect address, you must use Z-ADD01B.

If you know the Node-name, but do not know the physical address of the external node (Node-parameters) which has been defined by the administrator, you can invoke Z-GET74 prior to Z-ADD01T to obtain the physical address information.

This subprogram does not check whether the information you specify in the Node-parameters corresponds to the information which has been defined by the administrator. Thus, you can specify different address information in the Node-parameters. However, it is your responsibility to specify the correct information.

The parameters Last-name and First-name can be specified for a specific user at the transport service node. When you are an administrator and add a nickname in cabinet SYSCNT, this information can later be used by all local users in the address management system.

Parameters

Parameter Format In Out Remarks
Return-code N2 O X Input -1: no ET.
Cabinet A8 R   The cabinet in which the nickname is to be added.
Password A8 R   The password of the above cabinet.
Nickname A20 R   The nickname to be added.
ISN P8   X The ISN of the new nickname.
Last-name A32 O   The last name of a user at the transport service node.
First-name A32 O   The first name of a user at the transport service node.
Description A60/1:4 O   A brief description for the nickname.
Folder-name A15 O   The folder in which the nickname is to be stored. You must not specify a TRS folder or system folder (except Work). Default: Work.
File-name A15 O   The file within the above folder in which the nickname is to be stored.
Node-name A8 R   The name of an existing transport service node which has been added by the administrator.
Node-parameters A250/1:7 R   The physical address of the transport service node. See External Communication.
Post-flag A1 O   Default: blank. Marking this flag is only useful, if you send mail using the online Con-nect. If marked, a window appears and you can enter additional information before the mail is sent. Therefore, do not mark this flag if you use Z-MAILA to send mail, since the window does not appear in this case.

Return Codes

00 Success
02 Invalid cabinet name
03 Password incorrect
10 Function not valid for a system folder
55 Requested folder/file does not exist
56 Requested folder is a TRS folder
73 Invalid folder/file name
91 Invalid name
92 Nickname already exists
93 External node does not exist
94 Node-name is required

Subprograms

Z-120
Z-122
Z-123
Z-135
Z-147
Z-150
Z-162
Z-190
Z-192
Z-1200&0