The job setup dialog

for OMNIS Studio version 1.2
by Michael Monschau

The job setup dialog behavior. How to open it and how to save job setup data with a report.
Contents
Prompting for Job Setup	
Saving job setup with report	
Printing from disk or memory	

Prompting for Job Setup
Traditionally the job setup dialog only existed for the Macintosh platform. In version 1.2 it exists on all platforms. The job setup dialog allows you to pick things like output trays, the pages to be printed etc. The commands ‘Print report’ and ‘Prepare for print’ have an option to prompt for job setup. Until 1.2 there was no way to prompt for job setup if the notation was used to print a report. What’s more, unless the report destination is the Printer, the job setup dialog will not appear.
Both issues have been addressed for 1.2. A report instance has a new notational method $openjobsetup() which allows you to prompt for the job setup once you have created a report instance. If you specify kTrue as the parameter to $openjobsetup, the job dialog will be opened regardless of the destination.
The job setup dialog can only be opened once a report instance has been created and prior to the first print record. It can be during construction or immediately after.
The following example code implements the prompting of the job setup in the construct of the report.
##### Method '$construct' #####
No.	Parameter			Type			Subtype		Init.Val/Calc
1		pPrompt				Boolean	
No.	Local Variable	Type			Subtype		Init.Val/Calc
1		ok						Boolean	
No.	Method text
1		If pPrompt
2			Do $cinst.$openjobsetup(kTrue) Returns ok
3			If not(ok) ;; the user has canceled, close the instance and quit
4				Do $cinst.$close()
5				Quit method 
6			End If
7		End If

Saving job setup with report
If the job setup dialog is opened when printing to either the disk or memory report destination, all information set in the job setup dialog will be saved with the report. However, the job setup information is not cross platform so the report must be printed on the same platform if the job setup information is to be used. 
Printing from disk or memory
In version 1.2 the commands ‘Print report from disk’ and ‘Print report from memory’ do not have an option to prompt for job setup. This may be a problem to some people and will be rectified in the next version of OMNIS Studio.