Verastream© Bridge Integrator 4.0

com.attachmate.cicsbridge
Class BridgeException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by com.attachmate.cicsbridge.BridgeException
All Implemented Interfaces:
java.io.Serializable

public class BridgeException
extends java.lang.Exception

Error information for the BridgeAPI

Since:
1.0
See Also:
Serialized Form

Constructor Summary
BridgeException(int errorCode, java.lang.String msg)
           
BridgeException(java.lang.String msg)
           
BridgeException(java.lang.Throwable t)
           
 
Method Summary
 int getErrorCode()
          Returns an error code for the error that occurred.
Negative numbers are client side errors.
Positive numbers are errors that occurred in the host side
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

BridgeException

public BridgeException(java.lang.Throwable t)

BridgeException

public BridgeException(java.lang.String msg)

BridgeException

public BridgeException(int errorCode,
                       java.lang.String msg)
Method Detail

getErrorCode

public int getErrorCode()
Returns an error code for the error that occurred.
Negative numbers are client side errors.
Positive numbers are errors that occurred in the host side
  (Successful completion with no error)
                     0             Successful execution no errors encountered.

                     (Errors that occurred on the client side)
                     -5            Invalid parameter supplied to method
                     -6            Error in sending message to Host CICS
                     -8            Missing parameter object.
                     -9            Invalid terminal model.
                    -15            No Content-Length token in mainframe response.
                    -30            No "HTTP/1.0 200 OK" token found in mainframe response.
                    -35            API function requesting other than the current screen. 
                    -37            No field name supplied.
                    -39            Invalid field index value.
                    -40            Screen name greater than 255 characters.
                    -70            No SetField field data supplied.   
                    -85            Unsuccessful TERMID check out from pool.
                    -99                    Unknown Error

                     (Errors that occurred on the CICS side)
                    200            CICS COMMAREA HAD A LENGTH OF ZERO AT THE START
                    201            UNRECOGNIZED REQUEST FUNCTION CODE IN COMMAREA
                    202            UNRECOGNIZED EYECATCHER IN REQUEST COMMAREA
                    210            INQUIRE TERMINAL FOR CASE FAILED FOR CONNECT
                    212            INQUIRE TERMINAL FOR CONVERSE FAILED
                    214            INQUIRE TERMINAL FAILED
                    215            TERMINAL ID IN USE
                    320            TERMINAL MODEL NUMBER IN CONNECT REQUEST WAS INVALID
                    330            BUFFER SIZE FROM SESSION STATE IS NOT A VALID BUFFSIZE
                    340            USER ID/PASSWORD COMBINATION INVALID
                    401            CICS GETMAIN FOR MSG Q STAGING AREA FAILED
                    410            CICS GETMAIN FOR REPLY VECTOR FAILED
                    460            CICS GETMAIN FOR CREATION OF SESSION STATE DATA FAILED
                    461            CICS GETMAIN FOR CREATION OF MSG AND REPLY ECBS FAILED
                    470            CICS GETMAIN TO HOLD SESSION STATE DATA FAILED
                    600            CICS WRITE TO THE BRIDGE MSG TSQ RESOURCE FAILED
                    610            CICS WRITE TO THE SESSION STATE Q RESOURCE FAILED
                    620            CICS READ OF THE BRIDGE REPLY TSQ RESOURCE FAILED
                    650            CICS READ OF THE STATE TSQ RESOURCE FAILED
                    651            REQUESTED SESSION IS NOT ACTIVE OR VALID
                    700            CICS START APPLICATION TRAN(xxxx) WITH BRIDGE FAILED
                    710            TIMEOUT ON A READ OF THE BRIDGE REPLYQ
                    715            BRIDGE EXIT DETECTED FAILURE WHILE PROCESSING TRANSACTION
                    718            TRANSACTION INQUIRY FAILED
                    755            TRACE REQUEST QNAME IS INVALID
                    760            HOST APPLICATION ISSUED AN EXPLICIT ROLLBACK
                    800            UNRECOG BRIDGE REQUEST VECTOR RETURNED IN REPLY Q DATA
                    801            UNHANDLED BRIDGE VECTOR:  VECTOR = xxxx
                    810            UNRECOG METHOD CODE FOR GET SECURITY INFO IN CONNECT
                    999            UNEXPECTED OR UNKNOWN ERROR CONDITION
                   1001            CICS START OF CLEANUP TRAN(xxxx) FAILED
                   1002            CICS CANCEL OF STARTED ICE FAILED
                   1003            CICS RETRIEVE OF DATA ASSOC WITH ICE START, FAILED
                   1010            INVALID FINDSTRING SCREEN,ROW,COL,STRING COMBINATION
                   1100            CICS SEND MAP WITH MAPPINGDEV AND FRSET FAILED
                   1110            CICS SEND MAP WITH MAPPINGDEV NO FRSET FAILED
                   1120            CICS SEND MAP FOR CESN WITH MAPPINGDEV NO FRSET FAILED
                   1200            CICS LOAD PROGRAM WITH MAPSET FAILED
                   1210            CICS RELEASE PROGRAM WITH MAPSET FAILED
                   1300            SENDKEYS STRING LENGTH = ZERO.
                   1301            INVALID SCREEN INDEX OR SCREEN NAME VALUE
                   1302            PUTSTRING -> PUTSTRINGEX TO VCUT DISPLAY BUFFER FAILED
                   1303            PUTSTRINGEX TO VCUT DISPLAY BUFFER FAILED
                   1304            SENDKEYS PUTSTRING TO VCUT DISPLAY BUFFER FAILED
                   1305            SENDKEYS STRING INVALID, ENDED WITH A SINGLE ESC CHAR
                   1306            UNEXPECTED OR UNKNOWN REQUEST FUNCTION
                   1307            INVALID GETSTRING ROW,COL,LEN COMBINATION FOR MODEL
                   1308            RENDER OF AID KEY IN VCUT DISPLAY BUFFER FAILED
                   1309            PUTSTRING REQUEST ROW IS INVALID FOR MODEL
                   1310            PUTSTRING REQUEST COL IS INVALID FOR MODEL
                   1311            PUTSTRING TEXT LENGTH INVALID FOR MODEL BUFFER SIZE
                   1312            GET FIELD INFORMATION FAILED
                   1313            SET FIELD VALUE FAILED
                   1314            GET ALL FIELD INFORMATION FAILED
                   1320            FIELDCOUNT FAILED
                   1321            FINDFIELD FAILED
                   1322            FINDSTRING FAILED
                   1323            INVALID ROW, COL, POSITION COMBINATION FOR REQUEST
                   1326            GETATTRIBUTES FAILED
                   1327            GETSTRINGEX FAILED FOR PASSWORD
                   1328            GETSTRINGEX FAILED FOR USERID
                   1400            CICS verification failure message from the External Security Manager, in this format:
                        (See the execution tracelog, System.out, or console for more details)
                        CICS VERIFY: INVALID USERID            ESMREASON=numberESMRESP=number
                        CICS VERIFY: INVALID PASSWORD          ESMREASON=numberESMRESP=number
                        CICS VERIFY: UNKNOWN RET FROM THE ESM: ESMREASON=numberESMRESP=number
                        CICS VERIFY: ESM INTERFACE IS NOT INIT ESMREASON=numberESMRESP=number
                        CICS VERIFY: ESM NOT RESPONDING:       ESMREASON=numberESMRESP=number
                        CICS VERIFY: NEW PASSWORD IS REQUIRED: ESMREASON=numberESMRESP=number
                        CICS VERIFY: THE USERID IS REVOKED:    ESMREASON=numberESMRESP=number
                        CICS VERIFY: UNKNOWN RESP CODE:        ESMREASON=numberESMRESP=number
                        CICS VERIFY: UNKNOWN RESP2 CODE:       ESMREASON=numberESMRESP=number
                   1402            CICS Verification failed with External Security Manager: INVALID_PASSWORD
                   1403            CICS Verification failed with External Security Manager: NEW_PASSWORD_REQUIRED
                   1404            CICS Verification failed with External Security Manager: NEW_PASSWORD_NOT_ACCEPTABLE
                   1408            CICS Verification failed with External Security Manager: UNKNOWN_USERID
                   1419            CICS Verification failed with External Security Manager: USERID_REVOKED
                   1432            CICS Verification failed with External Security Manager: USERID_CONTAINS_BLANK
                   1497            CICS Verification failed with External Security Manager: USERID_MISSING
                   1498            CICS Verification failed with External Security Manager: PASSWORD_MISSING
                   1499            CICS Verification failed with External Security Manager: NEW_PASSWORD_MISSING

                     (Errors that occurred calling the Linkable Bridge)

                   91020         CREATE  TERMID FROM AUTOINSTALL IS INVALID 
                   91021         CREATE  NETNAME FROM AUTOINSTALL IS INVALID 
                   91022         CREATE  AUTOINSTALL URM REJECTED BRIDGE INSTALL REQUEST 
                   91023         CREATE  LINK TO AUTOINSTALL URM FAILED 
                   91024         CREATE  SUPPLIED NETNAME INVALID 
                   91025         CREATE  SUPPLIED TERMID INVALID 
                   91026         CREATE  SUPPLIED FACILITYLIKE INVALID
                   91040         CREATE  LINK TO THE DYNAMIC ROUTING URM 
                   91041         CREATE  BRIDGE ROUTING REQUEST REJECTED BY THE DYNAMIC ROUTING URM 
                   91042         CREATE  THE TRANSACTION DEFINITION DOES NOT ALLOW IT TO BE ROUTED TO THE REQUESTED REGION. 
                   91043         CREATE  TRANSACTION REQUEST COULD NOT BE ROUTED TO THE REMOTE REGION DUE TO A CONNECTION ERROR.
                   91044         CREATE  LINK TO AOR FAILED WITH TERMERR 
                   91045         CREATE  REQUEST WAS ROUTED TO A BACK LEVEL CICS THAT DOES NOT SUPPORT LINKABLE BRIDGE
                   91061         CREATE  INVALID FACILITYTOKEN SUPPLIED IN BRIDGE HEADER INFORMATION
                   91062         CREATE  ALL BRIDGE FACILITIES ARE ALLOCATED
                   91063         CREATE  THIS FACILITYTOKEN IS IN USE
                   91064         CREATE  NOT ENOUGH STORAGE TO RUN REQUEST IN ROUTER REGION OR APPLICATION OWNING REGION
                   91065         CREATE  FILE DFHBRNSF IS UNAVAILABLE OR HAS NOT BEEN DEFINED
                   91066         CREATE  THE CICS REGION IS TERMINATING, PROCESSING REQUEST REJECTED
                   91080         CREATE  TRANSACTION NOT ENABLED TO RUN AT SHUTDOWN
                   91082         CREATE  TRANSACTION CAN ONLY BE SYSTEM ATTACHED, NOT VALID UNDER THE BRIDGE
                   91084         CREATE  TRANSACTION IS DISABLED
                   91085         CREATE  TRANSACTION IS NOT FOUND
                   91086         CREATE  TRANSACTION IS NOT RUNNING ON BRIDGE FACILITY
                   91087         CREATE  TRANSACTION PROFILE IS NOT FOUND
                   91100         CREATE  USERID IN SESSION REQUEST DIFFERENT THAN USERID SUPPLIED TO ALLOCATE THE BRIDGE FACILITY
                   91120         CREATE  THE GET MORE DATA REQUEST FAILED BECAUSE THERE WAS NO MORE DATA
                   91121         CREATE  RETRIEVE VECTORS NOT SUPPORTED AFTER INITIAL REQUEST
                   91140         CREATE  INVALID DATA LENGTH SPECIFIED IN BRIDGE HEADER          
                   91141         CREATE  VECTOR IS INVALID          
                   91142         CREATE  ALLOCATE FACILITY REQUEST CONTAINED AN INVALID KEEPTIME OF ZERO    
                   91143         CREATE  MESSAGE CONTAINS NO VECTORS: CONTINUE REQUEST IS INVALID
                   91160         CREATE  TARGET CICS 3270 APPLICATION ABEND
                   92020         LINK    TERMID FROM AUTOINSTALL IS INVALID 
                   92021         LINK    NETNAME FROM AUTOINSTALL IS INVALID 
                   92022         LINK    AUTOINSTALL URM REJECTED BRIDGE INSTALL REQUEST 
                   92023         LINK    LINK TO AUTOINSTALL URM FAILED 
                   92024         LINK    SUPPLIED NETNAME INVALID 
                   92025         LINK    SUPPLIED TERMID INVALID 
                   92026         LINK    SUPPLIED FACILITYLIKE INVALID
                   92040         LINK    LINK TO THE DYNAMIC ROUTING URM 
                   92041         LINK    BRIDGE ROUTING REQUEST REJECTED BY THE DYNAMIC ROUTING URM 
                   92042         LINK    THE TRANSACTION DEFINITION DOES NOT ALLOW IT TO BE ROUTED TO THE REQUESTED REGION. 
                   92043         LINK    TRANSACTION REQUEST COULD NOT BE ROUTED TO THE REMOTE REGION DUE TO A CONNECTION ERROR.
                   92044         LINK    LINK TO AOR FAILED WITH TERMERR 
                   92045         LINK    REQUEST WAS ROUTED TO A BACK LEVEL CICS THAT DOES NOT SUPPORT LINKABLE BRIDGE
                   92061         LINK    INVALID FACILITYTOKEN SUPPLIED IN BRIDGE HEADER INFORMATION
                   92062         LINK    ALL BRIDGE FACILITIES ARE ALLOCATED
                   92063         LINK    THIS FACILITYTOKEN IS IN USE
                   92064         LINK    NOT ENOUGH STORAGE TO RUN REQUEST IN ROUTER REGION OR APPLICATION OWNING REGION
                   92065         LINK    FILE DFHBRNSF IS UNAVAILABLE OR HAS NOT BEEN DEFINED
                   92066         LINK    THE CICS REGION IS TERMINATING, PROCESSING REQUEST REJECTED
                   92080         LINK    TRANSACTION NOT ENABLED TO RUN AT SHUTDOWN
                   92082         LINK    TRANSACTION CAN ONLY BE SYSTEM ATTACHED, NOT VALID UNDER THE BRIDGE
                   92084         LINK    TRANSACTION IS DISABLED
                   92085         LINK    TRANSACTION IS NOT FOUND
                   92086         LINK    TRANSACTION IS NOT RUNNING ON BRIDGE FACILITY
                   92087         LINK    TRANSACTION PROFILE IS NOT FOUND
                   92100         LINK    USERID IN SESSION REQUEST DIFFERENT THAN USERID SUPPLIED TO ALLOCATE THE BRIDGE FACILITY
                   92120         LINK    THE GET MORE DATA REQUEST FAILED BECAUSE THERE WAS NO MORE DATA
                   92121         LINK    RETRIEVE VECTORS NOT SUPPORTED AFTER INITIAL REQUEST
                   92140         LINK    INVALID DATA LENGTH SPECIFIED IN BRIDGE HEADER          
                   92141         LINK    VECTOR IS INVALID          
                   92142         LINK    ALLOCATE FACILITY REQUEST CONTAINED AN INVALID KEEPTIME OF ZERO    
                   92143         LINK    MESSAGE CONTAINS NO VECTORS: CONTINUE REQUEST IS INVALID
                   92160         LINK    TARGET CICS 3270 APPLICATION ABEND
                   93020         DELETE  TERMID FROM AUTOINSTALL IS INVALID 
                   93021         DELETE  NETNAME FROM AUTOINSTALL IS INVALID 
                   93022         DELETE  AUTOINSTALL URM REJECTED BRIDGE INSTALL REQUEST 
                   93023         DELETE  LINK TO AUTOINSTALL URM FAILED 
                   93024         DELETE  SUPPLIED NETNAME INVALID 
                   93025         DELETE  SUPPLIED TERMID INVALID 
                   93026         DELETE  SUPPLIED FACILITYLIKE INVALID
                   93040         DELETE  LINK TO THE DYNAMIC ROUTING URM 
                   93041         DELETE  BRIDGE ROUTING REQUEST REJECTED BY THE DYNAMIC ROUTING URM 
                   93042         DELETE  THE TRANSACTION DEFINITION DOES NOT ALLOW IT TO BE ROUTED TO THE REQUESTED REGION. 
                   93043         DELETE  TRANSACTION REQUEST COULD NOT BE ROUTED TO THE REMOTE REGION DUE TO A CONNECTION ERROR.
                   93044         DELETE  LINK TO AOR FAILED WITH TERMERR 
                   93045         DELETE  REQUEST WAS ROUTED TO A BACK LEVEL CICS THAT DOES NOT SUPPORT LINKABLE BRIDGE
                   93061         DELETE  INVALID FACILITYTOKEN SUPPLIED IN BRIDGE HEADER INFORMATION
                   93062         DELETE  ALL BRIDGE FACILITIES ARE ALLOCATED
                   93063         DELETE  THIS FACILITYTOKEN IS IN USE
                   93064         DELETE  NOT ENOUGH STORAGE TO RUN REQUEST IN ROUTER REGION OR APPLICATION OWNING REGION
                   93065         DELETE  FILE DFHBRNSF IS UNAVAILABLE OR HAS NOT BEEN DEFINED
                   93066         DELETE  THE CICS REGION IS TERMINATING, PROCESSING REQUEST REJECTED
                   93080         DELETE  TRANSACTION NOT ENABLED TO RUN AT SHUTDOWN
                   93082         DELETE  TRANSACTION CAN ONLY BE SYSTEM ATTACHED, NOT VALID UNDER THE BRIDGE
                   93084         DELETE  TRANSACTION IS DISABLED
                   93085         DELETE  TRANSACTION IS NOT FOUND
                   93086         DELETE  TRANSACTION IS NOT RUNNING ON BRIDGE FACILITY
                   93087         DELETE  TRANSACTION PROFILE IS NOT FOUND
                   93100         DELETE  USERID IN SESSION REQUEST DIFFERENT THAN USERID SUPPLIED TO ALLOCATE THE BRIDGE FACILITY
                   93120         DELETE  THE GET MORE DATA REQUEST FAILED BECAUSE THERE WAS NO MORE DATA
                   93121         DELETE  RETRIEVE VECTORS NOT SUPPORTED AFTER INITIAL REQUEST
                   93140         DELETE  INVALID DATA LENGTH SPECIFIED IN BRIDGE HEADER          
                   93141         DELETE  VECTOR IS INVALID          
                   93142         DELETE  ALLOCATE FACILITY REQUEST CONTAINED AN INVALID KEEPTIME OF ZERO    
                   93143         DELETE  MESSAGE CONTAINS NO VECTORS: CONTINUE REQUEST IS INVALID
                   93160         DELETE  TARGET CICS 3270 APPLICATION ABEND
 

Returns:
error code

Verastream© Bridge Integrator 4.0