---

This API call invokes a change request status change. If objects are linked to a change request, this function may trigger object transfers, depending on how VC/m has been configured.

Note: lcode1,addr1,lcode2 and addr2 should be obtained by first making a call to crstval.

Usage:

set ok=$$crstmod^%vcapi(userid,chref,function,chstatus,lcode1,.addr1,lcode2,.addr2,.err,[msg])

Inputs:

userid	VC/m user ID (derived from host operating system if null)
chref	Change request code
function	Transfer function code, e.g. XFER, IN, OUT
chstatus	New status
lcode1	From location
addr1(psa)	Array of 'from' physical locations
lcode2	To location
addr2(psa)	Array of 'to' physical locations
msg	0 = Do not display audit trail messages on screen (default) 1 = Display audit trail messages

Outputs:

$$crstmod	1 = Operation succeeded 0 = Operation failed
err	Error message if status change not valid

Error messages:

vc1018	Invalid function code	Function code must exist
vc1019	Invalid change request status code	Status code cannot be null
vc1020	Invalid change request status code	Status code does not exist for this change request type