This document covers the following topics:
Return information about a nickname for an address at an external node or for an internal Con-nect address.
This subprogram does not apply to a transport service node. To return information about a nickname for a transport service node, you must use Z-GET01T.
The parameters Node-name, Node-parameters, Parameter-length and Post-flag only apply to an external address. They do not apply to an internal address.
This subprogram is generally used with Z-MOD01A to allow the modification of addressee information. The addressee information is then used by Z-MAILA for the distribution of mail.
| Parameter | Format | In | Out | Remarks |
|---|---|---|---|---|
| Return-code | N2 | O | X | Input -1: no ET. |
| Cabinet | A8 | R | X | The cabinet in which the nickname for which you want to get information is stored. If the nickname is not found in the specified cabinet, but found in cabinet SYSCNT, SYSCNT is returned. |
| Password | A8 | R | The password of the above cabinet. | |
| Nickname | A20 | R* | X | The nickname for which you want to get information. Input: either Nickname or ISN; not both. |
| ISN | P8 | R* | X | The ISN of the nickname for which you want to get information. Input: either ISN or Nickname; not both. |
| Description | A60/1:4 | X | The description of the nickname. | |
| Folder-name | A15 | X | The folder in which the nickname is stored. | |
| File-name | A15 | X | The file within the above folder in which the nickname is stored. | |
| Node-name | A8 | X | The name of the external node which has been added by the administrator. Applies only to an external nickname. | |
| Node-parameters | A250 | X | The physical address of the external node. Applies only to an external nickname. See External Communication. | |
| Parameter-length | N3 | X | Depends upon the Node-parameters. Applies only to an external nickname. | |
| Post-flag | A1 | X | Applies only to an external nickname. If marked, a window appears and you can enter additional information before the mail is sent. However, the window only appears when you use the online Con-nect. If you use Z-MAILA to send mail, the window does not appear. |
| 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 |
| 24 | Security violation |
| 91 | Invalid name |
| 93 | The nickname does not exist |
Z-120
Z-122
Z-123
Z-147
Z-1200&0