This document covers the following topics:
Modify 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 a transport service node. To modify a nickname for a transport service node, you must use Z-MOD01T.
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-MOD01A 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.
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-GET01 prior to Z-MOD01A to obtain the ISN for the desired 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 | O | The length of the Node-parameters. If you do not know the length, you should not specify a value. | |
| 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 |
| 03 | Password incorrect |
| 04 | ISN 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 name |
| 93 | External node or address does not exist |
| 94 | Node-name is not a spool file node name |
Z-120
Z-122
Z-123
Z-147
Z-150
Z-1200&0