Logon to product application RCs

Overview

The following reason codes are returned when a logon is attempted to a Beta Systems product application via the BSA TCP/IP server or the BSA Communication Integrator (CI). RC<>0 indicates that logon was unsuccessful. The RC received is a RACF return code in most cases, with the following two exceptions:

RC=24

The subsystem could not be reached. The subsystem was either not active, or a TCP/IP connection problem has occurred.

RC=99

This RC is set by the BSA TCP/IP server or CI and indicates a specially defined Beta Systems information code. Please see the table below for more information.

Return codes

RC

IRC

Description

4

4

The user is not defined.

8

8

Invalid password.

8

12

Password has expired.

8

16

Either the length of the new password is invalid, or the password history is invalid.

  • The minimum length of a password is defined in the parameter file of the server under keyword SECURITY-PWD-LENGTH.
  • The minimum number of history records for a password is defined in the parameter file of the server under keyword SECURITY-PWD-HISTORY.

8

20

User is not defined to RACF (z/OS only).

8

24

RACF verify has failed (z/OS only).

8

28

User is revoked.

8

32

User is not active (z/OS only).

8

36

RACF group is revoked (z/OS only).

8

52

RACF does not allow access to the application (z/OS only).

8

nn

Various RACF return/reason codes may appear, depending on the z/OS RACF version in use. See the IBM documentation for a description of the return and reason codes.

99

256

The license for the selected add-on is invalid.

99

252

The security environment in z/OS is not active, or contains errors, or is not correctly structured.

99

256

The license for the selected application running under z/OS is not valid.

99

260

The maximum number of users licensed to work at the same time with the application in z/OS has been exceeded.

99

264

The application has attempted to log on via a port that is not defined for this application under z/OS.

99

268

The application has attempted access to an incorrect product version, for example an attempt was made to address an STC running under BSA V3 from an STC running under BSA V4.

99

272

Only SSLAUTH communication is permitted for this port, but the client did not pass or submit a certificate.

99

276

The application requires PKI, but no license is available for PKI.

99

280

The application attempted access to a product that is running with an invalid BSA level.

99

284

The application has attempted access via a port that has not been defined for the logon process (for example, BSM port or service port).

99

296

The application has not submitted a user ID for identification, but a user ID is required.

0

300

During logon, the logon exit was found to have no function (for example, IEFBR14).

0

304

The logon check was suppressed by the logon exit (RC 4).

99

308

Logon was rejected by the logon exit (RC 8).

99

312

The application submitted a password and a new passphrase, or a passphrase and a new password. Only password/new password is permitted or passphrase/new passphrase, but not a password/passphrase combination.

99

316

The passphrase exceeds the maximum permitted length of 100 characters.

99

320

The logon exit used does not support passphrases.

99

324

The logon exit has rejected the passphrase.