Z-ADD01A

This document covers the following topics:


Description

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.

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 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.

Return Codes

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

Subprograms

Z-120
Z-122
Z-123
Z-135
Z-147
Z-150
Z-162
Z-190
Z-1200&0