This document covers the following topics:
Return the work and home address for a cabinet or nickname, including Cc and Miscellaneous information.
This subprogram is similar to Z-GET01C with the exception that it also returns the Cc and Miscellaneous information. In addition, the parameter list contains new fields and the parameters are sorted according to their appearance in the online screen. Exception: Last-name, First-name, Initial and Sex are sorted differently in the parameter list.
The Cc parameters are only valid for cabinets (object number 5). For nicknames (object number 1) they are always empty.
This subprogram can be used by different types of users. Depending on the type of user, the following functions are allowed:
Cabinet Administrator
Return the addresses for cabinets (except for cabinet SYSCNT), for
nicknames in cabinet SYSCNT, or for nicknames in the cabinet administrator's
private cabinet.
System Administrator
Return the address for cabinet SYSCNT, for nicknames in cabinet
SYSCNT, or for nicknames in the system administrator's private cabinet.
Any Other User
Return the addresses for nicknames in cabinet SYSCNT, or for nicknames
in the user's private cabinet.
This subprogram also returns the addresses for nicknames in cabinets that the above listed users are authorized to use (for example, shared cabinets and public cabinets).
You can specify one of the following in the parameter Cabinet-name or Nickname:
to display all addresses alphabetically, you specify an asterisk (*);
to display the addresses for all cabinets or nicknames that start with specific letters, you specify the letters followed by an asterisk (for example, SAG*);
to display the address for a specific cabinet or nickname, you specify its name.
This subprogram can be invoked iteratively, until the return code 77 indicates the end of the list.
The following table shows the parameters that are used for the different functions of this subprogram:
| Function | Cabinet | Cabinet-name | Nickname |
|---|---|---|---|
| Return the address for a cabinet (except SYSCNT). | User ID of a cabinet administrator. | The name of a specific cabinet; or an asterisk (*); or letter(s) followed by an asterisk (*). | |
| Return the address for cabinet SYSCNT. | User ID of a system administrator. | The cabinet name "SYSCNT". | |
| Return a nickname in cabinet SYSCNT. | The cabinet name "SYSCNT" (for system administrators only).
Other users enter their user IDs and should check the output of Nickname-origin for the string "SYSCNT". |
A specific nickname; or an asterisk (*); or letter(s) followed by an asterisk (*). | |
| Return a nickname from the user's private cabinet or from a cabinet that the user is authorized to use. | The name of the cabinet in which the nickname is stored. | A specific nickname; or an asterisk (*); or letter(s) followed by an asterisk (*). |
| Parameter | Format | In | Out | Remarks |
|---|---|---|---|---|
| Return-code | N2 | O | X | Input -1: no ET. |
| Cabinet | A8 | R | X | To return the address for a cabinet, this must be the user ID of a cabinet administrator. To return the address of a nickname, this is usually the ID of the cabinet in which the nickname is stored. For further details, see the above table. |
| Password | A8 | R | The password of the above cabinet. | |
| Cabinet-name | A8 | R* | X | See the description above. Either Cabinet-name or Nickname, not both. |
| Nickname | A32 | R* | X | See the description above. Either Nickname or Cabinet-name, not both. |
| Object-ISN | P10 | X | The ISN of the cabinet or nickname. | |
| Object-number | N2 | X | One of the following: 1=address (nickname), 5=cabinet, 33=user ID (private cabinet). | |
| Private-flag | A1 | X | If marked, this is a private address. | |
| Last-name | A32 | X | Valid only for a private cabinet or external address. | |
| First-name | A32 | X | Valid only for a private cabinet or external address. | |
| Initial | A1 | X | Valid only for a private cabinet or external address. | |
| Sex | A10 | X | Valid only for a private cabinet or external address. | |
| Nickname-for | A44 | X | Valid only for a nickname. Last name and first name delimited by a comma. | |
| Nickname-status | N1 | X | Valid only for a nickname. Validates the structure (e.g. comma) of the parameter Nickname-for. 0=correct, 1=incorrect | |
| Nickname-origin | A8 | X | The name of the cabinet which contains the nickname or the string "SYSCNT" for addresses of cabinets. | |
| Work-company | A32 | X | ||
| Work-title | A32 | X | ||
| Work-department-name | A32 | X | ||
| Work-department-number | A10 | X | ||
| Work-location | A32 | X | ||
| Work-address | A60/1:3 | X | ||
| Work-city | A32 | X | ||
| Work-state | A8 | X | ||
| Work-postal-code | A10 | X | ||
| Work-country | A8 | X | ||
| Work-phone-1-country | N3 | X | ||
| Work-phone-1 | A15 | X | ||
| Work-phone-1-extension | A5 | X | ||
| Work-phone-2-country | N3 | X | ||
| Work-phone-2 | A15 | X | ||
| Work-phone-2-extension | A5 | X | ||
| Mobile-phone-country | N3 | X | ||
| Mobile-phone | A15 | X | ||
| Mobile-phone-extension | A5 | X | ||
| Fax-country | N3 | X | ||
| Fax | A15 | X | ||
| Fax-extension | A5 | X | ||
| Cc-flag | A1 | X | If marked, Cc has been set. | |
| Cc | A20 | X | ||
| Cc-address-type | N2 | X | One of the following: 1=address (nickname), 4=bulletin board, 5=cabinet, 33=user ID. | |
| Cc-address-source | A1 | X | Only if Cc-address-type is 1 (address): S=address is from cabinet SYSCNT. Blank=address is from Cabinet-name. | |
| Cc-last-first-name | A20 | X | Only if Cc-address-type is 1 (external address) or 33 (user ID). Blank if Cc-address-type is 1 and this is not an external address (e.g. nickname for user ID). | |
| Cc-node-name | A8 | X | Only if Cc-address-type is 1 (external address). | |
| Cc-status | A1 | X | Blank=Cc is valid. X=Cc of given Cc-address-type was not found in Con-nect. | |
| Cc-2-flag | A1 | X | If marked, Cc-2 has been set. | |
| Cc-2 | A20 | X | ||
| Cc-2-address-type | N2 | X | One of the following: 1=address (nickname) ,4=bulletin board, 5=cabinet, 33=user ID. | |
| Cc-2-address-source | A1 | X | Only if Cc-2-address-type is 1 (address): S=address is from cabinet SYSCNT. Blank=address is from Cabinet-name. | |
| Cc-2-last-first-name | A20 | X | Only if Cc-2-address-type is 1 (external address) or 33 (user ID). Blank if Cc-2-address-type is 1 and this is not an external address (e.g. nickname for user ID). | |
| Cc-2-node-name | A8 | X | Only if Cc-2-address-type is 1 (external address). | |
| Cc-2-status | A1 | X | Blank=Cc-2 is valid. X=Cc-2 of given Cc-2-address-type was not found in Con-nect. | |
| A64 | X | |||
| Internet | A64 | X | ||
| Home-address | A60/1:2 | X | ||
| Home-city | A32 | X | ||
| Home-state | A8 | X | ||
| Home-postal-code | A10 | X | ||
| Home-country | A8 | X | ||
| Home-phone-country | N3 | X | ||
| Home-phone | A15 | X | ||
| Home-phone-extension | A5 | X | ||
| Home-fax-country | N3 | X | ||
| Home-fax | A15 | X | ||
| Home-fax-extension | A5 | X | ||
| Home-e-mail | A64 | X | ||
| Miscellaneous-header | A12/1:6 | X | ||
| Miscellaneous-description | A64/1:6 | X | ||
| Work-parameter | A83 | For internal use. See The Work Parameter. |
| 00 | Success |
| 02 | Invalid cabinet name or - in batch mode only - locked cabinet |
| 03 | Password incorrect |
| 15 | Invalid administrator status |
| 24 | Security violation |
| 53 | Requested object does not exist |
| 77 | End of list |
| 92 | Supply either Cabinet-name or Nickname, not both |
| 93 | Supply either Cabinet-name or Nickname |
Z-120
Z-122
Z-123
Z-710
Z-723
Z-1200&0
See the example for Z-MOD01D.