DEALLOCDB command (X'C801')
The distributed data management (DDM) DEALLOCDB command terminates all resources that are associated with a PSB by deallocating the PSB named in the RDBNAM parameter.
Format
Parameters
- DSSHDR
- The 6-byte header that contains information about the data stream structure (DSS).
- LL
- The length specified as a 2-byte binary integer. This length includes LL and CP.
- CP
- X'C801', the 2-byte codepoint of the DEALLOCDB command.
- RDBNAM
A required parameter (X'2110') that contains the IMS PSB name that identifies the target database. The PSB name is a character string up to 8 bytes long. RDBNAM can optionally include the alias name of the IMS data store.
Usage
If no errors occur during the processing of the DEALLOCDB command, the IMS target server returns the DEALLOCDBRM reply message to indicate that the database has been successfully deallocated.
Chained command objects
No command objects can be chained to the DEALLOCDB command.
Positive reply messages
In response to the DEALLOCDB command, the IMS target DDM server returns to the source server the following positive reply messages:
- DEALLOCDBRM (X'CA01')
- Deallocation of database complete.
Error reply messages
In response to the DEALLOCDB command, the IMS target DDM server can return to the source DDM server the following error reply messages:
| Codepoint of reply message | Name of reply message | Meaning of reply message |
|---|---|---|
| X'1232' | AGNPRMRM | Permanent agent error |
| X'124C' | SYNTAXRM | Data stream syntax error |