Add Department (QOKADDDP) API


  Required Parameter Group:

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(*)

  Default Public Authority: *USE

  Threadsafe: No

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.


Authorities and Locks

Adding a department requires *SECADM (security administrator) authority.


Required Parameter Group

Department
INPUT; CHAR(10)

The department name to add. The department name must not be blank.

Title
INPUT; CHAR(50)

The descriptive title of the department. The title can be left blank.

Manager
INPUT; CHAR(16)

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.

Reports to department
INPUT; CHAR(10)

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.

Allow duplicate departments
INPUT; CHAR(1)

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.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.


Error Messages

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.

API introduced: V3R6

[ Back to top | Office APIs | APIs by category ]