VC/m Documentation |

Change Request Callouts

The following callouts relate to actions associated with change requests. They can be specified in the following way:

1. Navigate in the folders panel to Setup -> Properties -> Change Requests.

2. In the new dialog, enter the details of each callout into the relevant field. See below for more details.

This callout is called when a change request is updated. It must be written as an extrinsic function.

set err=$$label^routine(fcode,obv,lcode1,lcode2,.chref,.chdesc,.chtype,.chdatex,chrefs(key))

`fcode`	Function code for the transfer (or CHMAINT)
`obv`	Object version being transferred (or null)
`lcode1`	From location code (or null)
`lcode2`	To location code (or null)
`chref`	Change request code
`chdesc`	Change request description
`chtype`	Change request type
`chdatex`	Change request date in a valid input format
`chrefs(key)`	Array of change requests for the object version
Note: When this callout is called from the change request maintenance function, fcode is CHMAINT and the values for obv, lcode1 and lcode2 are null.

`$$`	1 / error message = Change request is valid 0 = Change request is not valid
`chref`	Change request code
`chdesc`	Change request description
`chtype`	Change request type
`chdatex`	Change request date in DD-MMM-[CC]YY format

This callout is called when a change is made to the status of a change request. It must be written as an extrinsic function.

set ok=$$label^routine(chtype,chref,chostat,chstat,.err)

`$$`	1 / error message = Change request status change is valid 0 = Change request is not valid
`err`	Error message if status change is not valid

This callout is called when details of a change request are saved. It must be written as a line label or routine call.

do label^routine("CHMAINT",null,null,null,chref)

chref Change request code