Z-MOD01A

This document covers the following topics:


Description

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.

Parameters

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.

Return Codes

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

Subprograms

Z-120
Z-122
Z-123
Z-147
Z-150
Z-1200&0