Previous Topic: When APPC Status Codes and System Field Values are ReturnedNext Topic: System Fields


APPCCODE and APPCERC

If an error description says internal error, request technical support from your site. If your technical support staff cannot remedy the problem, make sure they have the APPCCODE and APPCERC before they call CA Technical Support.

The following table displays an overview of the APPCCODEs (detailed descriptions of the APPCCODEs follow after this table):

APPCCODE

Status

0

OK

-1

Parameter check

-3

Allocation error

-4

Resource failure

-5

Deallocate condition

-6

Program error

-7

SVC error

-8

State error

-9

Unsuccessful

-10

Control session error

-11

Format descriptor error

-12

Send-data error

-13

Receive format error

0: OK

The communications command executed successfully. Control has returned to your CA ADS application. The current state of the conversation depends on the specific communications command you issued.

APPCERC

What it means

0

Data is available for the dialog to receive

1

Information other than data is available for the dialog to receive

-1: Parameter Check

There is a coding error in either the CA ADS application or the remote dialog that must be corrected. The syntax is correct, but there is a mismatch of parameters passed between the two dialogs or the parameters supplied are invalid.

APPCERC

What it means

0

Internal error

10

You issued a CONFIRM command when the conversation was allocated with a synchronization level of NONE

30

Internal error

31

Internal error

32

Internal error

33

Internal error

34

Internal error

35

Internal error

36

Internal error

-3: Allocation Error

The specified conversation cannot be allocated.

APPCERC

What it means

0

Internal error

1

The conversation cannot be allocated because of a condition that is not temporary (for example, a session protocol error). Do not retry the allocation request until the condition is corrected.

2

The conversation cannot be allocated because of a condition that can be temporary (for example, the secondary application is not available). If the condition is temporary, you can retry the allocation request.

3

The remote program rejected the allocation request because it did not understand the TPN. The TPN must be a task code associated with the dialog and defined to CA IDMS/DC if you are trying to allocate an CA ADS task.

4

The task-code-name specified on the ALLOCATE command exists but cannot be started. This is not a temporary condition and must be resolved by a systems programmer. Do not retry the ALLOCATE until the situation is corrected.

5

The task-code-name specified on the ALLOCATE command exists but cannot be started. This is a temporary condition. You can retry the allocation request.

6

The user specified on the SECURITY parameter of the ALLOCATE command is not known to the remote program.

7

Internal error.

8

Internal error.

-4: Resource Failure

A resource failure terminated the conversation prematurely.

APPCERC

What it means

1

The resource failure is not temporary (for example, a session protocol error). Do not retry the transaction until the condition is corrected.

2

The resource failure can be temporary (for example, a power outage, a line failure, or a problem with a modem). You can retry the transaction.

-5: Deallocate Condition

The remote program issued a DEALLOCATE command.

APPCERC

What it means

0

The deallocation was normal.

1

The remote program specified the ABEND option on the DEALLOCATE command or the remote program has abended. Any data remaining in the CA ADS communications buffer is purged.

-6: Program Error

The remote program issued the SEND-ERROR command. There is an error in the local application that must be corrected.

-7: SVC Error

The remote program issued the SEND-ERROR command. There is an error in the local application that must be corrected.

-8: State Error

There is a coding error in your CA ADS application. The CA ADS side of the conversation was not in the correct state to execute the communications command you specified: for example, you tried to issue SEND-DATA while in receive state.

In some cases, you can need to issue a DEALLOCATE ABEND to recover from this error.

-9: Unsuccessful

The conversation command was unsuccessful.

-10: Control Session Error

The CA ADS side of the conversation issued an ALLOCATE command correctly. But the remote program did one of the following:

This code is returned by the ALLOCATE command. This code can indicate an internal error.

-11: Format Descriptor Error

The CA ADS side of the conversation received an internal error from presentation services about the format descriptors.

-12: Send-Data Error

The CA ADS side of the conversation detected an internal error or a conversion error. This code is reported by the SEND DATA command.

-13: Receive Format Error

CA ADS received an error in a formatted conversation. This indicates an internal error. This code is reported by the RECEIVE-AND-WAIT command.