This document covers the following topics:
Add a nickname for an address at an external node. This subprogram applies only to an external node which uses the spool file.
This subprogram does not apply to an internal Con-nect address or a transport service node. To add a nickname for an internal Con-nect address, you must use Z-ADD01B. To add a nickname for a transport service node, you must use Z-ADD01T.
This subprogram is similar to Z-ADD01 with the one exception that the additional parameter Work-address has been introduced.
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-ADD01A 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.
| 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 | X | The nickname to be added. | |
| ISN | P8 | X | The ISN of the new nickname. | |
| 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 node which has been added by the administrator. | |
| Node-parameters | A250 | R | The physical address of the external node. See External Communication. | |
| Parameter-length | N3 | R | The length of the Node-parameters. | |
| 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. | |
| Work-address | A190/1:3 | O | The work address. You must redefine this parameter. For all required redefinitions, see the example program for Z-ADD01B. |
| 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 | Name already exists |
| 93 | External node or address does not exist |
| 99 | The node is not a spool file node |
Z-120
Z-122
Z-123
Z-135
Z-147
Z-150
Z-162
Z-190
Z-1200&0