This document covers the following topics:
Modify a nickname for an address at an external node. This subprogram also applies to an external node which uses the transport service.
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-MOD01T 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 modify a nickname in cabinet SYSCNT, this information can be used by all local users in the address management system.
Parameters which are not completed in the parameter list are deleted from the nickname information. Thus, to retain the existing values, you must specify them once more before you invoke this subprogram. There is one exception: when you do not specify Folder-name and File-name, the nickname is automatically stored in folder Work.
| 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 modified. | |
| Password | A8 | R | The password of the above cabinet. | |
| Nickname | A20 | R* | X | The nickname to be modified. Input: either Nickname or ISN; not both. |
| ISN | P8 | R* | X | The ISN of the nickname to be modified. Input: either ISN or Nickname; not both. You can invoke Z-GET01T prior to Z-MOD01T to obtain the ISN for the desired 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. Can only be used when Last-name was specified. | |
| 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 | O | The name of an existing transport service node which has been added by the administrator. | |
| Node-parameters | A250/1:7 | O | The physical address of the transport service node. See External Communication. | |
| Post-flag | A1 | O | 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. | |
| Private-flag | A1 | O | If marked, the nickname is a private object. | |
| Security-flags | A4 | O | The security levels for Read, Modify, Copy and Print. Values 0 to 9. |
| 00 | Success |
| 02 | Invalid cabinet name or - in batch mode only - locked cabinet |
| 03 | Password incorrect |
| 04 | ISN was not found |
| 08 | Supply either ISN or name, not both |
| 09 | ISN does not point to correct object |
| 15 | Invalid administrator status |
| 55 | Requested folder/file does not exist |
| 56 | Requested folder is a TRS folder |
| 73 | Invalid folder/file name |
| 91 | Invalid nickname |
| 93 | External node or address does not exist |
| 95 | Node name is required |
Z-120
Z-122
Z-123
Z-147
Z-150
Z-192
Z-1200&0