| 1 | Department | Input | Char(10) |
| 2 | Title | Input | Char(50) |
| 3 | Manager | Input | Char(16) |
| 4 | Reports to department | Input | Char(10) |
| 5 | Allow duplicate departments | Input | Char(1) |
| 6 | Error code | I/O | Char(*) |
The Add Department (QOKADDDP) API adds departments to the system distribution directory. To add and remove members from within a department use the DEPT parameter on the Add Directory Entry (ADDDIRE) and Change Directory Entry (CHGDIRE) CL commands.
Adding a department requires *SECADM (security administrator) authority.
The department name to add. The department name must not be blank.
The descriptive title of the department. The title can be left blank.
The department manager's user ID and address. The first 8 characters contain the user ID and the last 8 contain the address. The manager user ID and address must exist in the system distribution directory if specified. The manager field can be left blank.
The department to which this department reports. If a department that does not exist in the system distribution directory is specified, it is automatically created. This field can be left blank.
Whether to allow duplicate department names. The valid values are:
| 0 | Do not allow duplicate department names. |
| 1 | Allow duplicate department names. |
The department name value is not case sensitive when checking for duplicate departments.
The structure in which to return error information. For the format of the structure, see Error Code Parameter.
| Message ID | Error Message Text |
|---|---|
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF89A3 E | Operation not successful due to authority reasons. |
| CPF89A4 E | Operation not successful due to data validation reasons. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
| CPF9A8D E | Error occurred with &5 API. Reason code is &1. |
| Top | Office APIs | APIs by category |