The execute form of the OUTDEL macro modifies and executes the parameter list that was built with the list form of the OUTDEL macro.
The execute form of the OUTDEL macro is written as follows:
| Syntax | Description |
|---|---|
| name | name: Symbol. Begin name in column 1. |
| ␢ | One or more blanks must precede OUTDEL. |
| OUTDEL | |
| ␢ | One or more blanks must follow OUTDEL. |
| NAME=descriptor name addr | descriptor name addr: RX-type address or register (2)-(12). |
| ,MF=(E,list addr) | list addr: RX-type address or register (2)-(12). |
The parameters are explained as follows:
list addr specifies the area that the system uses to store the parameters.
OUTDEL might abnormally terminate with abend codes X'76D' or X'054'. See z/OS MVS System Codes for explanations and programmer responses.
When control returns to the caller, GPR 15 contains a hexadecimal return code and GPR 0 contains a hexadecimal reason code. Note that when you invoke dynamic output to delete an output descriptor, the system has deleted the descriptor only if the return code is zero.
For programmers who want them, symbolic names for reason codes are available in the IEFDORC mapping macro. (See z/OS MVS Data Areas in the z/OS Internet library.) Reason codes are four bytes long.
| Return Code | Reason Code | Meaning and Action |
|---|---|---|
| 00 | 00 | Meaning: The dynamic output request is
successful. Action: None. |
| 04 | 400-407 | Meaning: The dynamic output request failed
because of an error in dynamic output or elsewhere in the system. Action: None. |
| 08 | 380-38B |
Meaning: The dynamic output request failed.
There is an error in an operating system program. Action: Contact the system programmer. |
| 08 | 00 |
Meaning: The dynamic output request failed.
The request was denied by your installation. These reason codes
are defined by your installation. Action: None. |
| 0C | 30B-394 | Meaning: The dynamic output request failed
because the parameter list is incorrectly initialized. Action: None. |
| 10 | 700-702 | Meaning: An abend occurred in the system. Action: Consult the system programmer. |
For programmers who want them, symbolic names for reason codes are available in the IEFDORC mapping macro. (See z/OS MVS Data Areas in the z/OS Internet library.) Reason codes are four bytes long.
The table below documents the reason codes that can occur when the OUTDEL macro returns with a return code of 04 (in GPR15). The symbol for return code 04 is DOENVERR in macro IEFDORC. The “symbol” field in the following table gives the symbolic name for the different reason code values. These symbols can be found in macro IEFDORC.
| Reason Code Hexadecimal (Decimal) | Meaning and Action |
|---|---|
400 |
Symbol: DORCGET1 Meaning: Environmental error. A GETMAIN failed during processing of the dynamic output request. Action: Attempt to allow a larger region for the application and retry the dynamic output request. |
402 |
Symbol: DORCNDES Meaning: Program error. For a delete request, the output descriptor does not exist or it has already been deleted. Action: This can be a logic error in the application. Check the program logic for conditions that could lead to an incorrect (nonexistent) output descriptor name being specified on the delete request. |
403 |
Symbol: DORCBTCH Meaning: Program error. The delete request attempted to delete a JCL-specified output descriptor. A JCL-specified output descriptor cannot be deleted with a dynamic output delete request. Action: This can be a logic error in the application. Check the program logic for conditions that could lead to an incorrect output descriptor name being specified on the delete request. |
404 |
Symbol: DORCESTA Meaning: System error. During dynamic output processing, the system was unable to establish a recovery environment. Action: Determine if your program is doing something that prevents a recovery environment from being established. The most likely reason for this error is that your program is causing all available storage to be used. If the problem cannot be attributed to your program, record the return and reason code, and optionally make a copy of your application. Give this information to your system programmer to supply to the appropriate IBM® support personnel. |
407 |
Symbol: DORCGET2 Meaning: Environmental or system error. A GETMAIN request failed during processing of the dynamic output request. Action: Attempt to allow a larger region for the application and retry the dynamic output request. |
The table below documents the reason codes that can occur when the OUTDEL macro returns with a return code of 08 (returned in GPR15). The symbol for return code 08 is DOREQDNY in macro IEFDORC. The “symbol” field in the following table gives the symbolic name for the different reason code values. These symbols can be found in macro IEFDORC.
| Reason Code Hexadecimal (Decimal) | Meaning and Action |
|---|---|
0 |
Symbol: (none defined) Meaning: Program error. The dynamic output request was denied by your installation. Action: The meaning of this reason code is defined by your installation. Your installation should be able to make recommendations for altering the dynamic output request to conform to installation standards. |
380 |
Symbol: DORCLNIV Meaning: System error. Action: Contact your system programmer. Provide the system programmer with the return and reason code. Once the problem has been corrected, retry the dynamic output invocation. For the system programmer: The dynamic output installation exit has a logic error. Dynamic output processing detected an incorrect parameter list length. The installation exit maps the dynamic output parameter list (macro IEFDOCNP). Determine why the DOCNLEN field was incorrectly set and correct the problem. |
381 |
Symbol: DORCNZF1 Meaning: System error. Action: Contact your system programmer. Provide the system programmer with the return and reason code. Once the problem has been corrected, retry the dynamic output invocation. For the system programmer: The dynamic output installation exit has a logic error. Unused bits passed back from the dynamic output installation exit were not set to zero. The installation exit maps the dynamic output parameter list (macro IEFDOCNP). Determine why the unused bits in the DOCNFNC1 field are not zero and correct the problem. |
382 |
Symbol: DORCNZF2 Meaning: System error. Action: Contact your system programmer. Provide the system programmer with the return and reason code. Once the problem has been corrected, retry the dynamic output invocation. For the system programmer: The dynamic output installation exit has a logic error. Unused bits passed back from the dynamic output installation exit were not set to zero. The installation exit maps the dynamic output parameter list (macro IEFDOCNP). Determine why the unused bits in the DOCNFNC2 field are not zero and correct the problem. |
383 |
Symbol: DORCNZR1 Meaning: System error. Action: Contact your system programmer. Provide the system programmer with the return and reason code. Once the problem has been corrected, retry the dynamic output invocation. For the system programmer: The dynamic output installation exit has a logic error. Unused bits passed back from the dynamic output installation exit were not set to zero. The installation exit maps the dynamic output parameter list (macro IEFDOCNP). Determine why the DOCNRSV1 reserved field is not zero and correct the problem. |
384 |
Symbol: DORCNZR2 Meaning: System error. Action: Contact your system programmer. Provide the system programmer with the return and reason code. Once the problem has been corrected, retry the dynamic output invocation. For the system programmer: The dynamic output installation exit has a logic error. Unused bits passed back from the dynamic output installation exit were not set to zero. The installation exit maps the dynamic output parameter list (macro IEFDOCNP). Determine why the DOCNRSV2 reserved field is not zero and correct the problem. |
385 |
Symbol: DORCIVID Meaning: System error. Action: Contact your system programmer. Provide the system programmer with the return and reason code. Once the problem has been corrected, retry the dynamic output invocation. For the system programmer: The dynamic output installation exit has a logic error. A portion of the dynamic output parameter list was improperly set. The installation exit maps the dynamic output parameter list (macro IEFDOCNP). Determine why the DOCNID field was not properly initialized and correct the problem. |
386 |
Symbol: DORCIVVR Meaning: System error. Action: Contact your system programmer. Provide the system programmer with the return and reason code. Once the problem has been corrected, retry the dynamic output invocation. For the system programmer: The dynamic output installation exit has a logic error. The DOCNVERS field contains an incorrect parameter list version. The installation exit maps the dynamic output parameter list (macro IEFDOCNP). Determine why the DOCNVERS field was not properly initialized and correct the problem. |
387 |
Symbol: DORCNOFN Meaning: System error. Action: Contact your system programmer. Provide the system programmer with the return and reason code. Once the problem has been corrected, retry the dynamic output invocation. For the system programmer: The dynamic output installation exit has a logic error. A portion of the dynamic output parameter list was improperly set. The installation exit maps the dynamic output parameter list (macro IEFDOCNP). Either the DOCNNEW or the DOCNDEL bit must be set in the DOCNFNC1 field. Determine why no function bit (create or delete) was set and correct the problem. |
308 |
Symbol: DORCIVFN Meaning: System error. Action: Contact your system programmer. Provide the system programmer with the return and reason code. Once the problem has been corrected, retry the dynamic output invocation. For the system programmer: The dynamic output installation exit has a logic error. A portion of the dynamic output parameter list was improperly set. The installation exit maps the dynamic output parameter list (macro IEFDOCNP). Only one function bit (either DOCNNEW or DOCNDEL) should be set in the DOCNFNC1 field. Determine why more than one function bit (create or delete) was set and correct the problem. |
389 |
Symbol: DORCIVTP Meaning: System error. Action: Contact your system programmer. Provide the system programmer with the return and reason code. Once the problem has been corrected, retry the dynamic output invocation. For the system programmer: The dynamic output installation exit has a logic error. A text unit pointer was specified for a delete request. The installation exit maps the dynamic output parameter list (macro IEFDOCNP); the text unit pointer was specified in field DOCNTXTP. |
38A |
Symbol: DORCIVEQ Meaning: System error. Action: Contact your system programmer. Provide the system programmer with the return and reason code. Once the problem has been corrected, retry the dynamic output invocation. For the system programmer: The dynamic output installation exit has a logic error. A conditional ENQ indicator was specified for a delete request. The installation exit maps the dynamic output parameter list (macro IEFDOCNP); the conditional ENQ bit was specified using DOCNCENQ in field DOCNFNC2. Determine why a conditional ENQ indicator was specified and correct the problem. |
38B |
Symbol: DORCIVNM Meaning: System error. Action: Contact your system programmer. Provide the system programmer with the return and reason code. Once the problem has been corrected, retry the dynamic output invocation. For the system programmer: The dynamic output installation exit has a logic error. Dynamic output processing received an incorrect output descriptor name from the installation exit. Check the output descriptor name returned to the dynamic output service. The first character must be an alphabetic (capitalized) character or a national character (#, @, or $). The remaining characters must be alphabetic (capitalized) characters, national characters (#, @, or $), or numbers. There can be no intervening blanks. The installation exit maps the dynamic output parameter list (macro IEFDOCNP); the output descriptor name is in the DOCNNAME field. |
391 |
Symbol: DORCNZR0 Meaning: System error. Action: Contact your system programmer. Provide the system programmer with the return and reason code. Once the problem has been corrected, retry the dynamic output invocation. For the system programmer: The dynamic output installation exit has a logic error. Unused bits passed back from the dynamic output installation exit were not set to zero. The installation exit maps the dynamic output parameter list (macro IEFDOCNP). Determine why the DOCNRSV0 reserved field is not zero and correct the problem. |
500 |
Symbol: DORCINST Meaning: System error. Action: Contact your system programmer. Provide your system programmer with the return and reason code. Once the operating system program has been corrected, retry the dynamic output invocation. For the system programmer: There is a program error in the dynamic output installation exit. The return code from the dynamic output installation exit is 8, but the reason code is not within the allowable range defined for the dynamic output installation exit. Determine why the installation exit is returning a reason code that is outside the allowable range and correct the error. |
501 |
Symbol: DORCINRC Meaning: System error. Action: Contact your system programmer. Provide your system programmer with the return and reason code. Once the operating system program has been corrected, retry the dynamic output invocation. For the system programmer: There is a program error in the dynamic output installation exit. The return code from the dynamic output installation exit is zero but the reason code is not zero. Determine why the installation exit is returning a nonzero reason code but a zero return code for the dynamic output request and correct the error. |
502 |
Symbol: DORCINRT Meaning: System error. Action: Contact your system programmer. Provide your system programmer with the return and reason code. Once the operating system program has been corrected, retry the dynamic output invocation. For the system programmer: There is a program error in the dynamic output installation exit. The return code from the dynamic output installation exit is not within the allowable range defined for the dynamic output installation exit. Determine why the installation exit is returning a return code that is outside the allowable range and correct the error. |
503 |
Symbol: DORCINKE Meaning: System error. Action: Contact your system programmer. Provide your system programmer with the return and reason code. Once the operating system program has been corrected, retry the dynamic output invocation. For the system programmer: There is a program error in the dynamic output installation exit. The return code from the dynamic output installation exit is zero, but the installation exit has returned a nonzero value in register 1. Although this is an OUTDEL request, when control is returned from the installation exit for an OUTADD request, register 1 contains the value of the key that is in error. Determine why the installation exit is returning a nonzero value in register 1 and a zero return code for the dynamic output request and correct the error. |
6000-7FFF |
Symbol: (none defined) Meaning: Program error. The dynamic output request was denied by your installation. Action: The meaning of this reason code is defined by your installation, and indicates the reason the dynamic output request was denied. Your installation should be able to make recommendations for altering the dynamic output request to conform to installation standards. |
OUTDEL returns a return code of 0C for errors detected in the caller's parameters. The list form of the OUTDEL macro generates a parameter list. When the caller invokes the execute form of the OUTDEL macro, this parameter list is filled in with the parameters coded on the execute form of the OUTDEL macro. The OUTDEL service verifies this parameter list.
The table below documents the reason codes that can occur when the OUTDEL macro returns with a return code of 0C (in GPR15). The symbol for return code 0C is DOINVPRM in macro IEFDORC. The “symbol” field in the following table gives the symbolic name for the different reason code values. These symbols can be found in macro IEFDORC.
| Reason Code Hexadecimal (Decimal) | Meaning and Action |
|---|---|
30B |
Symbol: DORCIVNP Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
30C |
Symbol: DORCIVLN Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
311 |
Symbol: DORCMTUP Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
380 |
Symbol: DORCLNIV Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
381 |
Symbol: DORCNZF1 Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
382 |
Symbol: DORCNZF2 Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
383 |
Symbol: DORCNZR1 Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
384 |
Symbol: DORCNZR2 Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
385 |
Symbol: DORCIVID Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
386 |
Symbol: DORCIVVR Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
387 |
Symbol: DORCNOFN Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
388 |
Symbol: DORCIVFN Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
389 |
Symbol: DORCIVTP Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
38A |
Symbol: DORCIVEQ Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
38B |
Symbol: DORCIVNM Meaning: Program error. Dynamic output processing received an invalid output descriptor name. Action: Check the output descriptor name supplied to the dynamic output service. The first character must be an alphabetic (capitalized) character or a national character (#, @, or $). The remaining characters must be alphabetic (capitalized) characters, national characters (#, @, or $), or numbers. There can be no intervening blanks. Correct the problem and retry the dynamic output invocation. |
38C |
Symbol: DORCIVRZ Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
38D |
Symbol: DORCIVDZ Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
38E |
Symbol: DORCIVHB Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
390 |
Symbol: DORCP0C4 Meaning: Program error. An 0C4 ABEND occurred when the system referenced the parameter list The parameter list is generated by the list form of the OUTDEL macro. Action: Check to see if the parameter list has the same storage key as the program that uses the execute form of the macro to invoke dynamic output. Also check to see if your program passed a bad pointer or address. |
391 |
Symbol: DORCNZR0 Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
392 |
Symbol: DORCONEU Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
393 |
Symbol: DORCREUS Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
394 |
Symbol: DORCREON Meaning: Program error. There is an error in the use of the OUTDEL macro. The execute form of the OUTDEL macro creates assembler instructions in your program. The list form of the macro reserves storage for the input parameter list that is used by the execute form of the macro. An error has been detected in the assembler instructions or in the parameter list storage. Another task might have altered the assembler instructions' storage or the parameter list's storage. Action: Correct the problem and retry the OUTDEL invocation. |
OUTDEL returns a return code of 10 for system ABENDS that occurred during dynamic output OUTDEL processing.
The table below documents the reason codes that can occur when the OUTDEL macro returns with a return code of 10 (in GPR15). The symbol for return code 10 is DOSYSERR in macro IEFDORC. The “symbol” field in the following table gives the symbolic name for the different reason code values. These symbols can be found in macro IEFDORC.
| Reason Code Hexadecimal (Decimal) | Meaning and Actions |
|---|---|
700 |
Symbol: DORCABND Meaning: System error. An ABEND occurred in the dynamic output control routine. Action: Record the return and reason code, and optionally make a copy of your application. Give this information to your system programmer to supply to the appropriate IBM support personnel. |
701 |
Symbol: DORCSJAB Meaning: System error. An ABEND occurred during this dynamic output request. Action: Record the return and reason code, and optionally make a copy of your application. Give this information to your system programmer to supply to the appropriate IBM support personnel. |
702 |
Symbol: DORCXABD Meaning: System error. An ABEND occurred in the dynamic output installation exit. Action: Notify your system programmer. The dynamic output installation exit might have a logic error. If a change is made to the installation exit, it might be possible to retry the dynamic output invocation. |
OUTDEL NAME=DESCR2,MF=(E,PLIST)