KOA VTAM Exception Codes

KOA VTAM Exception codes are listed and described below.

%VTAMFDBK (if specified) contains information supplied by VTAM applications in the hexadecimal representation of two full words (16 characters). These two values (usually RPL and ACB error information) are determined by the specific error as described below.

For example, whenever RTNCD and FDBK2 are specified, the first 8 characters contain the hexadecimal representation of the RPL RTNCD field, and the next 8 characters contain the representation of the RPL FDBK2 field. If R15 and R0 are specified, the first 8 characters contain the hexadecimal representation of the contents of Register 15, and the next 8 characters contain the representation of the contents of Register 0.

These codes and their descriptions can be found in the IBM VTAM Programming manual.

Table 205 KOA VTAM Exception Codes

%VTAMRC	%VTAMERR	%VTAMFDBK	Description
0	OK		The last operation completed successfully.
4	UNSOLMSG		An unsolicited (unexpected) message was received. The message can either be accepted (by means of the GETSCREEN command) or rejected (by re-sending the last screen).
8	NODATA		The GETSCREEN command did not receive any new messages from the VTAM application.
12	TIMEOUT		Response was not received from the VTAM application for n seconds. The maximum wait period is specified by the TIMEOUT command or by the KOATIME installation parameter.
16	ERROR-EXIT	RTNCD, FDBK2	A VTAM error exit (SYNAD or LERAD) was activated because of an exception situation. The RTNCD and FDBK2 RPL fields determine the specific error situation.
20	NSEXIT		The NSEXIT VTAM Exit was activated because of a network services exception situation.
24	SESS-NOT-ACT		A KOA communication command failed because the session was no longer active.
28	VTAMREQ	R15 R0	A VTAM command (for example, SEND, RECEIVE) was rejected by the VTAM application. The values of registers 15 and 0 determine the specific error.
32	NOSTORAGE		KOA processing could not continue due to insufficient storage. The REGION parameter (in the JCL procedure) should be increased, and the KOA script should be reactivated.
36	OPEN	ACB error flag	An error occurred while opening the ACB. The error flag indicates the specific reason for the failure.
40	SLUNOTDEF		The terminal name specified in the LOGON command was not defined to VTAM. No new sessions can be initiated.
44	NOFREESLU		Selection of a KOA terminal (SLU) failed because all defined terminals were currently in use; no new sessions can be initiated.
48	NOTACCEPT		An attempt was made to initiate a session with a non-available VTAM application or a VTAM application which is not ready to accept any new sessions.
52	SETLOGON	RTNCD, FDBK2	The SETLOGON VTAM command (which enables KOA to start sessions) could not be executed. The RTNCD and FDBK2 RPL fields determine the specific error situation.
56	REQSESS	RTNCD, FDBK2	The REQSESS VTAM command (which initiates a session with a VTAM application) could not be executed. The RTNCD and FDBK2 RPL fields determine the specific error situation.
60	BIND-REJECT		The specified parameters prevent session initiation. Check the validity of the supplied LOGMODE.
64	RECEIVE	RTNCD, FDBK2	The RECEIVE VTAM command (which accepts a message from a VTAM application) could not be executed. The RTNCD and FDBK2 RPL fields determine the specific error situation.
68	INVALID-DATA		A message (from the VTAM application) which contains invalid data was received. KOA cannot display the data.
72	UNKNOWN- CMD		A message (from the VTAM application) which contains an unknown 3270 command was received. KOA cannot display the data.
76	SEND	RTNCD, FDBK2	The SEND VTAM command (send a message to the VTAM application) could not be executed. The RTNCD and FDBK2 RPL fields determine the specific error situation.
80	KEYLOCKED		The keyboard was locked. Messages cannot be sent to the VTAM application.
84	QUIESCED		The session was halted (as requested by the application). Messages cannot be sent to the VTAM application.
88	CLOSE	ACB error flag	An error occurred while closing the ACB. The error flag indicates the specific reason for the failure.
92	INVREQ		An invalid request from the KOA session handler caused an internal error.