This document covers the following topics:
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.
| 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. |
| 00 | Success |
| 02 | Invalid cabinet name or - in batch mode only - locked cabinet |
| 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 |
Z-120
Z-122
Z-123
Z-135
Z-147
Z-150
Z-162
Z-190
Z-192
Z-1200&0