CLOSE-VIRTUAL-DEVICE-DIALOG

Close dialog with virtual printer

Component:	SPOOL
Functional area:	Controlling spoolout job
Domain:	SPOOL-PRINT-SERVICES
Privileges:	STD-PROCESSING PRINT-SERVICE-ADMINISTRATION

Function

This command closes the dialog between the virtual device and the application procedure in which the call takes place. It is executed in batch mode only.

The command is part of a set of four commands which enable an application to be created in the form of an S procedure (for an example, see the OPEN-VIRTUAL-DEVICE-DIALOG command). These commands manage the dialog between a virtual device and the application which was started in batch mode as an S procedure:

• OPEN-VIRTUAL-DEVICE-DIALOG

• GET-JOB-FROM-VIRTUAL-DEVICE

• RETURN-JOB-TO-VIRTUAL-DEVICE

• CLOSE-VIRTUAL-DEVICE-DIALOG

Format

CLOSE-VIRTUAL-DEVICE-DIALOG                                                                                                              

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error; command successfully processed
	32	SCP0974	Unexpected command
5	32	SCP0974	Memory request error

Notes

1. If the dialog cannot be established, the command is rejected and a return code is set.

2. If no initialization took place (OPEN-VIRTUAL-DEVICE-DIALOG command), the command is rejected and a return code is set.

3. This command can only be used in batch mode.

4. Spin-off processing is activated each time an error is detected.