OpenFrame/TACF Error Codes

This chapter describes the scope of error codes and individual errors associated with OpenFrame/TACF.

1. Overview

The following is an overview of the scope of error codes and associated modules in OpenFrame/TACF (hereafter TACF).

Error Code Base Module Description

-18000

TACF

Manages user authentication and resource access control.

2. TACF (-18000)

The TACF module is responsible for user authentication and resource access control. This section lists the error codes that can occur in the TACF module, descriptions of errors and suggested corrective actions.

TACF_ERR_MEMORY_ALLOC (-18003)

Description

Failed to allocate system memory.

Action

Check if the system has sufficient available memory.

Note

TACF_ERR_INTERNAL (-18004)

Description

An internal error occurred during the command execution.

Action

Contact TmaxSoft Technical Support.

Note

TACF_ERR_INVALID_REQUEST (-18005)

Description

An invalid input parameter has been used to call a function.

Action

Contact TmaxSoft Technical Support.

Note

TACF_ERR_NOT_IMPLEMENTED (-18006)

Description

tacfmgr is used to add/change/delete/find groups or users when the OS authentication has been enabled.

Action

Use the functions provided by the OS, instead of tacfmgr.

Note

TACF_ERR_NOT_INITIALIZED (-18007)

Description

TACF functions are used without the TACF module having been correctly initialized.

Action

Perform the following to ensure that TACF initialization has been successfully completed.

  • Check whether directory permissions set to the VALUE of the DATA_DIR key are correct, in the DIRECTORY section of the ofsys subject, under OpenFrame Configuration.

  • Check whether the directories set to the VALUE of the LOG_DIR key are valid, in the DIRECTORY section of the ofsys subject, under OpenFrame Configuration.

Note

For more information about the ofsys subject, refer to OpenFrame Configuration Guide.

TACF_ERR_STORAGE_CONFIGURATION (-18008)

Description

The items in the dbconn.conf file for OpenFrame Configuration have been incorrectly set as follows:

  • USERNAME has not been specified or the string length exceeds 31 bytes.

  • ENPASSWD has not been specified.

  • DATABASE has not been specified.

Action

Check whether you can connect to the database.

Note

For more information about the dbconn.conf file, refer to OpenFrame Base Guide.

TACF_ERR_BUFFER_OVERFLOW (-18009)

Description

The internal buffer size has been exceeded.

Action

Check the number of profiles for users, groups, data sets, resources, permissions and connections, and then delete any unnecessary profiles.

Note

TACF_ERR_MAX_COUNT_LIMIT (-18010)

Description

The internal buffer size has been exceeded.

Action

Check the number of profiles for users, groups, data sets, resources, permissions and connections, and then delete any unnecessary profiles.

Note

TACF_ERR_INVALID_GENERIC_TYPE (-18011)

Description

The name of a data set or resource profile contains an invalid character.

Action

Check the data set or resource profile name.

Note

Refer to "4.1.2. Generic Data Set Profiles" in OpenFrame TACF Administrator’s Guide.

TACF_ERR_DISCONNECTED(-18012)

Description

The database has been disconnected.

Action

Check the database connection status.

Note

TACF_ERR_DUPLICATE_GROUP (-18101)

Description

An attempt was made to add a duplicate group that already exists.

Action

Change the name of the group to add.

Note

TACF_ERR_GROUP_NOT_FOUND (-18102)

Description

The group profile for the group is not found.

Action

Check whether the group profile exists. If no group profile exists, request the security administrator to create one.

Note

TACF_ERR_DUPLICATE_USER (-18103)

Description

An attempt was made to add a duplicate user that already exists.

Action

Change the ID of the user to add.

Note

TACF_ERR_USER_NOT_FOUND (-18104)

Description

The user profile for the user is not found.

Action

Check whether the user profile exists. If no user profile exists, request the security administrator to create one.

Note

TACF_ERR_USER_REVOKED (-18105)

Description

An attempt was made to log in to the system as a user in REVOKE status.

Action

Request the security administrator to change the user status.

Note

TACF_ERR_CLASS_NOT_FOUND (-18109)

Description

The class profile for the class is not found.

Action

Check whether the class profile exists. If no class profile exists, request the security administrator to create one.

Note

TACF_ERR_DUPLICATE_PROFILE (-18110)

Description

An attempt was made to add a duplicate data set or general resource that already exists.

Action

Change the name of the data set or general resource to add.

Note

TACF_ERR_PROFILE_NOT_FOUND (-18111)

Description

The profile for the data set or general resource is not found.

Action

Check whether the profile for the data set or general resource exists. If no profile exists, request the security administrator to create one.

Note

TACF_ERR_DUPLICATE_MEMBER (-18113)

Description

An attempt was made to add a duplicate member that already exists in the group resource.

Action

Delete the duplicate member and retry.

Note

TACF_ERR_DUPLICATE_ACCESS_LIST (-18114)

Description

An attempt was made to add a duplicate access list that already exists.

Action

Check whether the access list to add is correct.

Note

TACF_ERR_VERIFICATION_FAILURE (-18201)

Description

Failed to authenticate the user.

Action

Check whether the ID and password of the user are correct.

Note

TACF_ERR_NOT_AUTHORIZED (-18202)

Description

There is no sufficient access rights for the data set or general resource.

Action

Request the security administrator to grant access to the data set or general resource.

Note

TACF_ERR_GROUP_NOT_CONNECTED (-18203)

Description

An attempt was made to connect a user to a specific group that does not exist.

Action

Check whether the group profile exists.

Note

TACF_ERR_OWNER_NOT_FOUND (-18204)

Description

The user or group to specify as OWNER is not found.

Action

Check whether the profile for the user or group exists.

Note

TACF_ERR_NOTIFY_NOT_FOUND (-18205)

Description

The user to specify as NOTIFY is not found.

Action

Check whether the profile for the user exists.

Note

TACF_ERR_SUPGROUP_NOT_FOUND (-18208)

Description

The profile of the group to specify as a superior group is not found.

Action

Check if the specified superior group profile exists.

Note

TACF_ERR_SUPGROUP_AND_OWNER (-18209)

Description

The name of the OWNER group is different from that of the superior group, when both groups have been specified.

Action

Specify the same name for both the OWNER group and the superior group.

Note

TACF_ERR_DFTGROUP_NOT_FOUND (-18210)

Description

The profile of the default group is not found.

Action

Request the security administrator to create the default group.

Note

TACF_ERR_NER_PASSWD_REQUIRED (-18211)

Description

The current password has expired.

Action

Change the password.

Note

Refer to the information about password change interval in OpenFrame TACF Administrator’s Guide.

Note

TACF_ERR_LOGIN_NOT_ALLOWED (-18212)

Description

An attempt was made to log into the system outside the specified days or hours.

Action

Check the days and hours specified in the user profile.

Note

Refer to the information about WDAY and WTIME from "2.3 USER Profile" in OpenFrame TACF Administrator’s Guide.

TACF_ERR_PASSWORD_INCORRECT (-18213)

Description

The current password specified with the PASSWORD command is incorrect.

Action

Check the current password.

Note

TACF_ERR_SUSPENDED_USER (-18214)

Description

A locked user account attempted to access the system.

Action

Wait until the account is unlocked and retry.

Note

Refer to the description for the "ACCOUNTLOCK status" from "Chapter 2. User Management" in OpenFrame TACF Administrator’s Guide.

TACF_ERR_NOT_PROTECTED (-18301)

Description

An access permission was requested for a data set or general resource not protected in TACF.

Action

Register the profile associated with the data set or general resource in TACF.

Note

TACF_ERR_CONNECT_FAILURE (-18901)

Description

Failed to connect to the database.

Action

Check if there is no problem in connecting to the database.

Note

TACF_ERR_EXECUTE_STATEMENT (-18902)

Description

An internal error occurred while executing an SQL query.

Action

Contact the system administrator.

Note

TACF_ERR_DECLARE_CURSOR (-18903)

Description

An internal error occurred while using a database cursor.

Action

Contact the system administrator.

Note

TACF_ERR_FETCH_CURSOR (-18904)

Description

An internal error occurred while fetching the results of a query.

Action

Contact the system administrator.

Note

TACF_ERR_DUPLICATE_RECORD (-18905)

Description

An attempt was made to add a duplicate record with the same key value in the database.

Action

Check whether the profile for the record to add already exists.

Note

TACF_ERR_RECORD_NOT_FOUND (-18906)

Description

The corresponding record does not exist in the database.

Action

Contact the system administrator.

Note