ADDACC (Add Access Code)

ADDACC Command syntax diagram

 

Purpose

The Add Access Code (ADDACC) command defines a new access code to the system. Subsequent use of the new code is allowed when a document is filed either during a document interchange session or when the Add Document Library Authority (ADDDLOAUT), Edit Document Library Object Authority (EDTDLOAUT), Remove Document Library Object Authority (RMVDLOAUT), Grant Access Code Authority (GRTACCAUT), Revoke Access Code Authority (RVKACCAUT), or Remove Access Code (RMVACC) commands are used. The ADDACC command identifies both the added access code and the descriptive text associated with it.

Restriction: This command is shipped with public *EXCLUDE authority. Use of this command is restricted to the security officer, users with *ALLOBJ (all object) authority, and users to whom authority has been granted by using the Grant Object Authority (GRTOBJAUT) command.

 

Required Parameters

ACC

Specifies the access code being added to the system. The access code is a decimal number ranging from 1 through 2047, and it must not be currently defined on the system.

*AVAIL: The system chooses the next free access code and adds it to the system; the user must specify the text. The access code selected is returned in a completion message.

access-code: Specify a decimal number ranging from 1 through 2047.

TEXT

Specifies the user-defined text that briefly describes the access code. More information on this parameter is in commonly used parameters.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Examples for ADDACC

Example 1: Adding an Access Code

ADDACC  ACC(700)  TEXT('programmers')

This command adds access code 700 to the system. This access code is authorized to all programmers (after the GRTACCAUT command is run). It is used when filing documents to which all programmers may have access.

Example 2: Adding Next Available Access Code

ADDACC  ACC(*AVAIL)
  TEXT('department managers')

This command adds the next available access code to the system. This access code is authorized to all department managers (after the GRTACCAUT command is run). It is used when placing in the document library objects to which all department managers may have access. The system returns a message containing the access code that was being used.

Error messages for ADDACC

*ESCAPE Messages

CPF897B

Mail Log Conversion failed.

CPF9001

Add access code request failed.

CPF9009

System requires file &1 in &2 be journaled.

CPF9845

Error occurred while opening file &1.

CPF9846

Error while processing file &1 in library &2.

CPF9847

Error occurred while closing file &1 in library &2.