DELETEW: Delete workmod

z/OS MVS Program Management: Advanced Facilities

DELETEW: Delete workmod

z/OS MVS Program Management: Advanced Facilities
SA23-1392-00

DELETEW deletes a workmod. You must issue either the SAVEW or LOADW function call before the DELETEW unless PROTECT=NO has been specified. DELETEW resets the workmod token to the null state.

The syntax of the DELETEW call is:

[symbol]

IEWBIND

FUNC=DELETEW

[,VERSION=version]
[,RETCODE=retcode]
[,RSNCODE=rsncode]
,WORKMOD=workmod
[,PROTECT={YES | NO}]

FUNC=DELETEW: Specifies that a workmod is deleted.
VERSION=1 | 2 | 3 | 4 | 5 | 6 | 7 | 8: Specifies the version of the parameter list to be used. The default value is VERSION=1.
RETCODE=retcode — RX-type address or register (2-12): Specifies the location of a fullword integer that is to receive the return code returned by the binder.
RSNCODE=rsncode — RX-type address or register (2-12): Specifies the location of a 4-byte hexadecimal string that is to receive the reason code returned by the binder.
WORKMOD=workmod — RX-type address or register (2-12): Specifies the location of an 8-byte area that contains the workmod token for this request.
PROTECT={YES | NO}: Specifying PROTECT=N allows the binder to delete a workmod that has been altered but not yet saved or loaded.
The value for PROTECT can be abbreviated as Y or N.

Processing notes

The binder is sensitive to the state of the DCB pointed to by the DCBPTR in an INCLUDE call. The DCB must not be closed and reopened while the binder accesses the corresponding data set during a dialog. Once it is opened initially for an INCLUDE call, it must remain open until after the binder's ENDD call takes place.

Note that if you do alter your DCB as described above, using DELETEW is not enough to reaccess your data set at a later time during the same binder dialog. This only causes the data set's information to remain with the dialog, and such information is no longer valid once the DCB is closed. An attempt to reuse the altered DCB in the same binder dialog might produce unpredictable results. To avoid this, end your dialog (ENDD) and start a new one (STARTD).

Return and reason codes

The common binder API reason codes are shown in Table 1.

Return Code	Reason Code	Explanation
00	00000000	Normal completion. Workmod has been deleted.
08	83002624	Unexpected error from SIGCLEAN.
12	83000707	The workmod was in an altered state, and PROTECT=YES was specified or defaulted. The delete request is rejected.

Parameter list

If your program does not use the IEWBIND macro, place the address of the DELETEW parameter list in general purpose register 1.

Table 1. DELETEW parameter list

`PARMLIST`	`DS`	`0F`
	`DC`	`A(DELETEW)`	Function code
	`DC`	`A(RETCODE)`	Return code
	`DC`	`A(RSNCODE)`	Reason code
	`DC`	`A(WORKMOD)`	Workmod token
	`DC`	`A(PROTECT+X'80000000')`	Protect flag and end-of-list indicator
`DELETEW`	`DC`	`H'15'`	DELETEW function code
	`DC`	`H'version'`	Interface version number
`PROTECT`	`DC`	`C'Y'`	Protection flag 'Y' = Yes 'N' = No