This document covers the following topics:
Add a user-defined object.
This subprogram can be called iteratively to add an object of any length. The user-defined object must be specified by its Object-number, which must have been previously defined by the system administrator.
A user-defined object must not use a GDA of its own, since this destroys the GDA of Con-nect.
| Parameter | Format | In | Out | Remarks |
|---|---|---|---|---|
| Return-code | N2 | O | X | Input -1: no ET. |
| Cabinet | A8 | R | The cabinet in which the user-defined object is to be added. | |
| Password | A8 | R | The password of the above cabinet. | |
| Object-number | N2 | R | The number of the user-defined object to be added. | |
| Object-name | A32 | R | The name of the user-defined object to be added. | |
| Object-format | A1 | O | Can be any user-defined object format. If the object is a document, this can also be a Con-nect document format. See Document Formats. | |
| Folder-name | A15 | O | The folder in which the user-defined object 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 user-defined object is to be stored. | |
| Description | A60/1:4 | O | A brief description for the user-defined object. | |
| User-data | A60/1:4 | O | Can be any information included by the user. | |
| Private-flag | A1 | O | If marked, the user-defined object is a private object. | |
| Security-flags | A4 | O | The security levels for Read, Modify, Copy and Print. Values 0 to 9. The four values must be numeric. | |
| Text-array | A251/1:20 | O | Can be any text included by the user. | |
| ISN | P8 | X | The ISN of the new user-defined object. | |
| Work-parameter | A21 | For internal use. See The Work Parameter. |
| 00 | Success |
| 02 | Invalid cabinet name |
| 03 | Password incorrect |
| 10 | Function not valid for a system folder |
| 51 | Invalid name |
| 52 | Object with specified name already exists |
| 53 | Requested object does not exist (has not been defined by administrator) |
| 55 | Requested folder/file does not exist |
| 56 | Requested folder is a TRS folder |
| 58 | No directory record created |
| 61 | Invalid security code(s) |
| 68 | Object is not a user-defined object |
| 73 | Invalid folder/file name |
Z-120
Z-122
Z-123
Z-135
Z-147
Z-150
Z-162
Z-190
Z-1200&0