Z-GET01

This document covers the following topics:


Description

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.

Parameters

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.

Return Codes

00 Success
02 Invalid cabinet name
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

Subprograms

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