DPSB call

The DPSB call is used to deallocate IMS DB resources.

Format

Call Name	DB/DC	IMS DB	DCCTL	DB Batch	TM Batch
DPSB	X	X

Parameters

aib

Specifies the application interface block (AIB) that is used for the call. This parameter is an input and output parameter.

These fields must be initialized in the AIB:

AIBID

Eye catcher. This 8-byte field must contain DFSAIBbb.

AIBLEN

AIB lengths. This field must contain the actual length of the AIB that the application program obtained.

AIBRSNM1

Resource name. This 8-byte, left-justified field must contain the PSB name.

AIBSFUNC

Subfunction code. This field must contain one of the 8-byte subfunction codes as follows:

bbbbbbbb (Null)
PREPbbbb

Usage

The DPSB call is used by an application running in a z/OS® application region to deallocate a PSB. If the PREP subfunction is not used, the application must activate sync-point processing prior to issuing the DPSB. Use the z/OS Resource Recovery Services (RRS) SRRCMIT/ATRCMIT calls to activate the sync-point process. Refer to z/OS MVS Programming: Resource Recovery for more information on these calls.

If the DPSB is issued before changes are committed, and, or locks released, the application will receive:

AIBRETRN = X'00000104'
AIBREASN = X'00000490'

The thread will not be terminated. The application should issue a SRRCMIT or SRRBACK call, and retry the DPSB.

The PREP sub-function allows the application to issue the DPSB prior to activating the sync-point process. The sync-point activation can occur at a later time, but still must be issued.