2 Oracle Access Manager for CICS Messages

This chapter describes the messages issued by Oracle Access Manager for CICS while running under z/OS.

Oracle Access Manager for CICS messages begin with the prefix "CIC-."

The following messages are described in this chapter:

2.1 Messages CIC-00001 to CIC-99999

CIC-00001E UNKNOWN COMMAND: Cause: The command, as entered, is unknown.; Action: Correct the command input and reenter the command.

CIC-00002E INVALID PARAMETER: Cause: The command specifies an invalid parameter.; Action: Check the command syntax, correct the parameters, and reenter the command.

CIC-00003E INVALID SYNTAX: Cause: The command, as entered, is incorrect.; Action: Check the command syntax for missing values or parentheses and reenter the command.

CIC-00004E INVALID VALUE: Cause: A keyword parameter specifies an invalid value.; Action: Correct the keyword parameter value and reenter the command.

CIC-00005E INVALID NUMBER: Cause: The command specifies an invalid value. The value must contain only numeric characters.; Action: Check the command syntax and reenter the command.

CIC-00007I CICS ATTACH xxxx SUCCESSFULLY INITIALIZED FOR ssn: Cause: Oracle Access Manager for CICS has initialized.; Action: None. This is an informational message.

CIC-00009E INVALID SSN: Cause: The specified SSN value is not valid or does not point to an active Oracle subsystem.; Action: Bring up the Oracle subsystem first; or contact your Oracle system administrator.

CIC-00010E INVALID NAME: Cause: The specified NAME parameter is not the name of an active Oracle Access Manager for CICS adapter.; Action: If the name is correct, then ensure the adapter is active. If the name is incorrect, then specify the correct name in the NAME parameter and reenter the command.

CIC-00011I SHUTDOWN IN PROGRESS FOR xxxx: Cause: Oracle Access Manager for CICS is shutting down.; Action: None. This is an informational message.

CIC-00012I SHUTDOWN COMPLETE FOR xxxx: Cause: Oracle Access Manager for CICS has ended.; Action: None. This is an informational message.

CIC-00013I ADAPTER NOT ACTIVE: Cause: The referenced Oracle Access Manager for CICS adapter is not active.; Action: None. This is an informational message.

CIC-00015E EXITS=YES REQUIRED IN SIT: Cause: Oracle Access Manager for CICS requires EXITS=YES.; Action: Contact your CICS system administrator for assistance.

CIC-00016E ADAPTER ALREADY ACTIVE: Cause: The Oracle Access Manager for CICS adapter being started is already active.; Action: None. This is an informational message.

CIC-00018E PROGRAM xxxx NOT FOUND: Cause: The module xxxx is not in a CICS library or the PPT; or, the version of the thread table is outdated.; Action: Ensure the module is in the correct library, is defined to CICS by RDO (CEDA) or PPT, and that the thread table has been compiled using the current distribution libraries. If so, then contact your CICS system administrator.

CIC-00017E UNABLE TO LOAD xxxx DUE TO AUTHORIZATION FAILURE: Cause: An attempt to load the module failed due to a NOTAUTH exception condition.; Action: Contact your CICS system administrator for assistance.

CIC-00023I CICS ATTACH xxxx INITIALIZED FOR ssn, SOME ERRORS OCCURRED: Cause: An error occurred while trying to initialize one or more threads.; Action: To determine the status of the threads, enter the DISPLAY THREADS command. The Oracle subsystem startup parameters might need to be adjusted.

CIC-00024E INITIALIZATION FOR xxxx FAILED. ORACLE ERROR CODE nnnn: Cause: An Oracle database server error occurred, preventing the completion of Oracle Access Manager for CICS initialization.; Action: Refer to the book Oracle Database Error Messages for information about the error code. The error probably occurred when you logged on to the Oracle server.

CIC-00025E EITHER MODNAME OR SSN, NAME, AND MAXTHREADS IS REQUIRED: Cause: To initialize the interface, Oracle Access Manager for CICS requires the name of a definition module assembled with the ORACICS macro or the SSN, NAME, and MAXTHREADS parameters.; Action: Enter the required parameters.

CIC-00026I EMERGENCY SHUTDOWN INVOKED FOR xxxx DUE TO ssn FAILURE: Cause: The Oracle server is no longer available.; Action: Restart Oracle Access Manager for CICS after restarting the corresponding Oracle server.

CIC-99999 MANUAL RESTART REQUIRED: Cause: The retry limit for the maximum number of consecutive occurrences of an OSDI loss of service condition has occurred. This message will immediately precede a CIC-00026 emergency shutdown message.; Action: For more information on CICS, refer to the Oracle Database System Administration Guide for IBM z/OS (OS/390).

Oracle Access Manager for CICS will issue a CICS transaction abend "ORAP" under the following circumstances:

A PURGE is issued from the active transaction display
A SQL COMMIT/ROLLBACK statement is issued and AM4CICS has been started with COMMIT(CICS).
A STOP IMMEDIATE FORCE statement is issued and there are active transactions. In this instance, AM4CICS will "ORAP" transactions which are connected to Oracle at the next call to the database. Shutdown will take effect when all the existing transactions have exited.
AM4CICS has determined the database is no longer available and is in the process of performing an emergency shutdown. For more information on CICS, refer to Oracle Database System Administration Guide for IBM z/OS (OS/390).
An application has not been linked with the ORACSTUB.