Return and reason codes

When the CSVDYNEX macro returns control to your program, GPR 15 (and retcode, if you coded RETCODE) contains a return code. When the value in GPR 15 is not zero, GPR 0 (and rsncode, if you coded RSNCODE) contains a reason code.

Macro CSVEXRET provides equate symbols for the return and reason codes. The equate symbols associated with each return code are as follows:

0: CSVDYNEXRC_OK
4: CSVDYNEXRC_WARN
8: CSVDYNEXRC_INVPARM
C: CSVDYNEXRC_ENV
10: CSVDYNEXRC_COMPERROR

The following table identifies the hexadecimal return and reason codes and the equate symbol associated with each reason code. xxxx indicates information that you might need to provide to IBM® support personnel.

Table 1. Return and Reason Codes for the CSVDYNEX Macro
Return Code	Reason Code	Equate Symbol Meaning and Action
00	—	Meaning: The CSVDYNEX request completed successfully. The result depends on the request: DEFINE - An exit is defined. ADD - An exit routine is added. MODIFY - An exit routine is modified. REPLACE - An exit routine is replaced. DELETE - An exit routine is deleted. UNDEFINE - The definition of an exit is removed. ATTRIB - Attributes of an exit are changed. LIST - Information about exit routines is listed. CALL - An exit routine or exit routines are called. RECOVER - Recovery for an exit routine is completed; there are no more exit routines to call. QUERY - For QTYPE=ADD, an exit routine that was added through a PROG=xx system parameter or a SETPROG or SET PROG=xx operator command is associated with the exit. For QTYPE=CALL, an active exit routine is associated with the exit. The current JOBNAME and STOKEN of this exit routine match the JOBNAME and STOKEN criteria specified when the exit routine was associated with the exit. Action: None.
04	xxxx0401	CSVDYNEXRSNALREADYEXISTS Meaning: The request completed successfully. The result depends on the request: For ADD: the exit routine was already associated with the exit. For DEFINE: the exit already exists. Action: Make sure you specified the correct exit or exit routine name.
04	xxxx0402	CSVDYNEXRSNDOESNOTEXIST Meaning: One of the following: For DELETE, MODIFY, or REPLACE: the exit routine is not associated with the exit. For UNDEFINE: the exit is not defined. Action: Make sure you specified the correct exit or exit routine name.
04	xxxx0403	CSVDYNEXRSNNOTALLDATARETURNED Meaning: For LIST: not all the data was returned because the answer area is not large enough. Action: Check the answer area field EXAAHTLEN in the CSVEXAA mapping macro to see how much space is required to return the information. Expand the ANSAREA to hold all the information. Issue the CSVDYNEX macro again, specifying, on the ANSLEN parameter, a fullword containing a value large enough to contain the entire answer area.
04	xxxx0406	CSVDYNEXRSNNOMODULES Meaning: For CALL: no active exit routines associated with the exit match the current JOBNAME or STOKEN; that is, no exit routines were invoked. For QUERY (QTYPE=ADD), no exit routines (active or inactive) are currently associated with the specified exit through a PROG=xx parameter, SETPROG command, SET PROG=xx command, or CSVDYNEX REQUEST=ADD macro. For QUERY (QTYPE=CALL), no active exit routines associated with the exit match the current JOBNAME or STOKEN; that is, no routines will be invoked by CSYDYNEX REQUEST=CALL. Action: None.
04	xxxx0407	CSVDYNEXRSNMOREMODULES Meaning: One of the following: For a CALL request that specified RETINFO=ALL: there are more exit routines to call. For a RECOVER request: there are more exit routines to call. Action: If you want the rest of the exit routines to be called for this exit, issue the CALL request again, specifying the NEXTTOKEN value returned from this request.
04	xxxx0408	CSVDYNEXRSNUSERKEYDELETENOFORCE Meaning: A DELETE request was made for an exit that was defined to be PSW key 8 or higher or ANYKEY=YES with FASTPATH=YES. The request did not specify FORCE=YES. The system changes the state of the exit routine to inactive and does not free the storage for that module. Action: If you are sure that the exit routine can be deleted from the system, reissue the DELETE request, specifying FORCE=YES.
04	xxxx0409	CSVDYNEXRSNQUERYNOTFOUND Meaning: A QUERY request was made for an exit that has not been defined. Action: Make sure you specified the correct exit name.
04	xxxx040A	CSVDYNEXRSNIMPLICITLYDEFINED Meaning: A QUERY request was made for an exit that has been defined implicitly rather than explicitly. You define an exit implicitly when: You add exit routines to an exit before the exit has been defined You set attributes for an exit using the ATTRIB request before the exit has been defined. Action: Make sure you specified the correct exit name.
08	xxxx0801	CSVDYNEXRSNBADPARMLIST Meaning: Program error. The system is unable to access the parameter list. Action: Make sure the parameter list you passed is in the correct PSW key.
08	xxxx0802	CSVDYNEXRSNSRBMODE Meaning: Program error. A program running in SRB mode entered a request that required task mode. Action: For the specified request, do not issue the CSVDYNEX macro while running in SRB mode.
08	xxxx0803	CSVDYNEXRSNNOTENABLED Meaning: Program error. A program issued the CSVDYNEX macro while running disabled for I/O or external interrupts. Action: Issue the CSVDYNEX macro while running enabled for I/O or external interrupts.
08	xxxx0804	CSVDYNEXRSNNOTAUTHORIZED Meaning: Program error. The caller is not authorized to issue the CSVDYNEX macro for the specified request. Action: See the authorization requirements described in the standard syntax for the specific request you issued.
08	xxxx0805	CSVDYNEXRSNHOMENOTPRIMARY Meaning: Program error. The system could not perform the function because the home address space is different from the primary address space. Action: For the specified request, do not issue the CSVDYNEX macro while running in cross memory mode.
08	xxxx0806	CSVDYNEXRSNBADANSAREAALET Meaning: Program error. For LIST: the ALET of the area specified on the ANSAREA parameter is incorrect. Action: Ensure that the ALET is 0, or that the ALET represents a valid entry on the DU-AL. If you specified register notation “(n),” make sure that the ALET in register n is correct.
08	xxxx0807	CSVDYNEXRSNBADANSAREA Meaning: Program error. For LIST: the system found an error when accessing the answer area specified on the ANSAREA parameter. Action: Ensure that the answer area address specified on the ANSAREA parameter is valid.
08	xxxx0808	CSVDYNEXRSNBADANSLEN Meaning: Program error. For a LIST request: the length of the answer area specified on the ANSLEN parameter is not equal to or greater than the length of the EXAAHDR structure in the CSVEXAA mapping macro. Action: Expand the ANSAREA to a size large enough to contain the information. On the ANSLEN parameter, specify a fullword containing a value that is equal to or greater than the length of the EXAAHDR structure in the CSVEXAA mapping macro.
08	xxxx0809	CSVDYNEXRSNBADREQUESTTYPE Meaning: Program error. The system found an incorrect request type in the parameter list created by the CSVDYNEX macro. Action: Verify that your program is not overwriting the parameter list, and that the execute form of the macro correctly addresses the parameter list. If you are using the modify form of the macro, make sure you specified the COMPLETE option on at least one invocation.
08	xxxx080A	CSVDYNEXRSNBADESTAE Meaning: Program error. The CSVDYNEX macro could not establish an ESTAEX recovery routine. `xxxx` is the return code from the ESTAEX service. Action: See the description of the ESTAEX macro for the action associated with the `xxxx` return code.
08	xxxx080B	CSVDYNEXRSNRESERVEDNOT0 Meaning: Program error. The system found a non-zero reserved field in the parameter list that the CSVDYNEX macro created. Action: Verify that your program is not overwriting the parameter list, and that the execute form of the macro correctly addresses the parameter list. If you are using the modify form of the macro, make sure you specified the COMPLETE option on at least one invocation.
08	xxxx080D	CSVDYNEXRSNBADPARMLISTALET Meaning: Program error. The system found an error in the ALET for the parameter list mapped by the CSVEXAA macro. Action: Ensure that the ALET is 0 or that the ALET represents a valid entry on the DU-AL.
08	xxxx080E	CSVDYNEXRSNBADVERSION Meaning: Program error. The system found an incorrect version number in the parameter list that the CSVDYNEX macro created. Action: Verify that your program is not overwriting the parameter list, and that the execute form of the macro correctly addresses the parameter list. If you are using the modify form of the macro, make sure you specified the COMPLETE option on at least one invocation.
08	xxxx080F	CSVDYNEXRSNLOCKED Meaning: Program error. For DEFINE, ADD, MODIFY, REPLACE, DELETE, UNDEFINE, ATTRIB and LIST requests: the caller holds a lock. Action: Before you issue CSVDYNEX with the specified request, release any locks held.
08	xxxx0814	CSVDYNEXRSNNOFASTPATH Meaning: Program error. The CALL request with FASTPATH=YES is not valid for this exit. Action: Redefine the exit to allow FASTPATH processing, or specify FASTPATH=NO on the CALL request.
08	xxxx0815	CSVDYNEXRSNBADDSNAREA Meaning: Program error. The system cannot access the data set name. Action: Make sure you specify the DSNAME parameter with the correct field.
08	xxxx0816	CSVDYNEXRSNBADRETAREA Meaning: Program error. The system cannot access the return area. Action: Make sure you specify the RETAREA parameter with the correct field.
08	xxxx0817	CSVDYNEXRSNBADWORKAREA Meaning: Program error. The system cannot access the work area. Action: Make sure you specify the WORKAREA parameter with the correct field.
08	xxxx0818	CSVDYNEXRSNBADOPEN Meaning: Program error. The system is unable to open the specified data set. Action: Ensure that: You specified the DSNAME parameter correctly The data set is partitioned The system can locate the data set.
08	xxxx0819	CSVDYNEXRSNEXITNAMENOTFOUND Meaning: Program error. For MODIFY, REPLACE, DELETE, CALL, and RECOVER: the system cannot locate the exit name. Action: Make sure you specify the correct exit name on the EXITNAME parameter.
08	xxxx081A	CSVDYNEXRSNBADRETLEN Meaning: Program error. For a CALL or RECOVER request: the return area is not large enough for even one entry. Action: Provide a large enough return area on the RETAREA parameter. The minimum area size can be calculated using the assembler expression L'EXRETHDR+L'EXRETINFO.
08	xxxx081B	CSVDYNEXRSNREG2INRUB Meaning: Program error. For a CALL request: an exit routine is called for an exit that is defined AMODE=24 or AMODE=DEFINED. The call specifies a register update block (RUB) that uses register 2. Action: Do not specify in the RUB that GPR2 is to be passed to the exit routine.
08	xxxx081C	CSVDYNEXRSNMODULENOTFOUND Meaning: Program error. For an ADD, MODIFY, or REPLACE request: the system could not locate the exit routine. Action: Make sure you specified the MODNAME parameter correctly.
08	xxyy081D	CSVDYNEXRSNNORESMGR Meaning: Program error. The system was unable to establish a resource manager for the exit routine. `yy` contains the return code from RESMGR. Action: See the return codes from the RESMGR macro.
08	xxxx081E	CSVDYNEXRSNBADNEXTTOKEN Meaning: Program error. For a CALL request: the value you specified on NEXTTOKEN is not valid. Action: Make sure the field you specified on the NEXTTOKEN parameter is not overlaid.
08	xxxx081F	CSVDYNEXRSNWORKAREABADDATA Meaning: Program error. For a RECOVER request: the work area contains bad data. Action: Make sure that: The field you specified on the WORKAREA parameter field is not overlaid The work area parameter field is the same one that was specified on the CALL request The work area parameter field was not changed between the CALL request and the RECOVER request You zeroed the first word of the work area before issuing the CALL request.
08	xxxx0820	CSVDYNEXRSNBADDSNAMEALET Meaning: Program error. The system found an error in the ALET that qualifies the data set name area you specified on the DSNAME parameter. Action: Make sure you specified the ALET correctly. If you specified DSNAME=(n), you might not have set up ARn correctly.
08	xxxx0821	CSVDYNEXRSNBADRETAREAALET Meaning: Program error. For a CALL request: the system found an error in the ALET that qualifies the return area you specified on the RETAREA parameter. Action: Make sure you specified the ALET correctly. If you specified RETAREA=(n), you might not have set up ARn correctly.
08	xxxx0822	CSVDYNEXRSNBADEXITNAME Meaning: Program error. For a DEFINE, ADD, MODIFY, REPLACE, DELETE, UNDEFINE, ATTRIB, CALL or RECOVER request: you specified an incorrect exit name on the EXITNAME parameter. The first character is either 0 or blank. Action: Correct the exit name.
08	xxxx0823	CSVDYNEXRSNBADMODNAME Meaning: Program error. For an ADD, MODIFY, or REPLACE request: you specified an incorrect exit routine name on the MODNAME parameter. The first character is either 0 or blank. Action: Correct the exit name.
08	xxxx0824	CSVDYNEXRSNBADRUB Meaning: Program error. For a CALL request: the system encountered an error while accessing the RUB. Action: Make sure the RUB area is valid.
08	xxxx0825	CSVDYNEXRSNBADRUBALET Meaning: Program error. For a CALL request: the system found an error in the ALET that qualifies the RUB area you specified on the RUB parameter. Action: Make sure you specified the ALET correctly. If you specified RETAREA=(n), you might not have set up ARn correctly.
08	xxxx0826	CSVDYNEXRSNBADSDWA Meaning: Program error. For a RECOVER request: the system encountered an error while accessing the SDWA passed as a parameter on the RECOVER request. Action: Make sure the SDWA address you provided on the SDWA parameter is the one the system provided to the recovery routine.
08	xxxx0827	CSVDYNEXRSNBADAMODE Meaning: Program error. For an ADD, MODIFY, or REPLACE request: one of the following occurred: An exit routine with AMODE=31 is being added to an exit that requires that its exit routines have AMODE=24. An exit routine with AMODE=24 is being added to an exit that requires that its exit routines have AMODE=31. Action: Make sure the AMODE attributes of the exit routine to be added conform to the exit definition.
08	xxxx0828	CSVDYNEXRSNBADKEY Meaning: Program error. One of the following: For DEFINE: the input key you specified on the KEY parameter is not valid. For CALL FASTPATH=YES: the caller's key does not match the key that the exit requires, according to its definition. Action: One of the following: For DEFINE: specify a valid key. For CALL FASTPATH=YES: change your key using the MODESET macro to match the key that the exit requires, according to its definition. Or redefine the key requirement for the exit.
08	xxxx0829	CSVDYNEXRSNBADALLOC Meaning: Program error. For an ADD, MODIFY, or REPLACE request: the system is unable to allocate the data set you specified on the DSNAME parameter. Action: Ensure that: You specified the proper data set The data set is partitioned The data set can be located by the system.
08	xxxx082A	CSVDYNEXRSNNOTREENTRANT Meaning: Program error. For an ADD, MODIFY, or REPLACE request: an exit routine that is not reentrant is being added to an exit that requires that its exit routines be reentrant. Action: Do not add a non-reentrant exit routine to an exit that is defined to call only reentrant routines.
08	xxxx082C	CSVDYNEXRSNBADABENDCONSEC Meaning: Program error. For a DEFINE request, an exit that is defined as FASTPATH=YES and ABENDCONSEC=YES does not accept a PSW key value that is 8 or higher, or ANYKEY=YES. Action: Correct your REQUEST=DEFINE request.
08	xxxx082D	CSVDYNEXRSNBADESPIE Meaning: Program error. A problem state caller issuing the CALL request with FASTPATH=NO cannot have SPIE or ESPIE routines in effect. Action: Do not issue the CALL request when you have SPIE or ESPIE routines in effect.
08	xxxx082E	CSVDYNEXRSNNOTAPFAUTHORIZED Meaning: Program error. For an ADD, MODIFY, or REPLACE request, the system cannot load the exit routine from the data set you specified on the DSNAME parameter. The data set is not APF-authorized. Action: Specify a data set that is APF-authorized.
08	xxxx0830	CSVDYNEXRSNBADEXAAVER Meaning: For the LIST request, an incorrect EXAAVER value was provided to the system. Action: Check for possible storage overlay.
08	xxxx0831	CSVDYNEXRSNANYKEYNOTRENT Meaning: For the DEFINE request, ANYKEY=YES was specified without REENTRANT=REQ specified. Action: Correct your REQUEST=DEFINE request.
08	xxxx0832	CSVDYNEXRSNBADPOS Meaning: For the ADD request, an incorrect POS value was provided to the system. Action: Check for possible storage overlay.
08	xxxx0833	CSVDYNEXRSNBADEXRETVER Meaning: For the CALL or RECOVER request, an incorrect EXRETVER value was provided to the system. Action: Check for possible storage overlay.
0C	xxxx0C02	CSVDYNEXRSNNOSTORAGE Meaning: Environmental error. The system does not have the storage to complete the request. Action: Contact the system programmer. There is a common storage shortage.
10	xxxx1001	CSVDYNEXRSNCOMPERROR Meaning: System error. Action: Record the return and reason codes and contact the appropriate IBM support personnel.