---

This API call is used to retrieve data about a change request, either for inquiry purposes or as a precursor to updating it.

Usage:

set ok=$$crget^%vcapi(userid,chref,.chtype,.chname,.chouser,.chodate,.chcuser,.chcdate,.chauser,.chadate,.chstatus,.chdesc,.obvs,.chcomm,.err)

Inputs:

userid	VC/m user ID (derived from host operating system if null)
chref	Change request code
obvs	Flag indicating whether to return list of objects in a work file or a local array. Null = Return list in local array Not null = Return list in global array using obvs as key

Outputs:

$$crget	1 = Operation succeeded 0 = Operation failed
chtype	Change request type. Must exist in change request type file
chname	Change request name
chouser	Owner user ID
chodate	Planned release date (ccyymmdd format)
chcdate	Creation user ID
chcuser	Creation date and time (ccyymmddhhmmss format)
chauser	Last amendment user ID
chadate	Last amendment date and time (ccyymmddhhmmss format)
chstatus	Change request status
chdesc(1..n)	Change request description lines
obvs	If obvs not null, key to work file ^%vcsel(obvs,obv) containing list of objects attached to change request
obvs(obv)	If obvs is null, array of objects (object/variant.version) attached to change request
chcomm(1..n)	Change request comment lines
err	Error message if operation failed

Error messages:

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