crdel - Delete a Change Request


This API call deletes a change request.

Usage:

set ok=$$crdel^%vcapi(userid,chref,.err,[msg])

Inputs:

userid VC/m user ID (derived from host operating system if null)
chref Change request code
msg 0 = Do not display audit trail messages on screen (default)
1 = Display audit trail messages

Outputs:

$$crdel 1 = Operation succeeded
0 = Operation failed
err Error message if operation failed

Error messages:

vc1015 Change request is locked Another user or process is currently updating the same change request.
vc1016 Invalid change request number A null change request code is not permitted
vc1017 Change request does not exist The change request code supplied does not exist

Note: If audit trail messages are to be displayed on the screen, the msg argument must be set to 1. If there is not one already open, this will open a message window at the bottom of the screen. After all API calls have been completed, the message window should be closed by making a call to mterm^%vc1aud as follows:

s %msg=1 d mterm^%vc1aud