Setting up sleep wait
Problem Description :
Setting up sleep wait printers
Resolution :
The first step in setting up the sleep-wake process is to identify each printer that will be used in the process on the validation form GTVPRNT.
Once printers are identified, in the 'Printer Command' field, put the print command exactly as it would look if submitted from the command line prompt, using an 'at sign' @ as the place holder for the filename to be printed.
Examples: print/queue=ln01 @ VAX-VMS
lp -d talaris1 @ UNIX
(Note: If you find that a banner (blank) page is being generated by a sleep-wake process, set the print command to "lp -d printername @ -o nobanner". This should prevent the banner page from printing.)
When logging into Banner forms, those that may use Sleep-wake begin by displaying a form that allows you to indicate a printer for each of a number of functions. Printers can be identified here or by going directly to SOADEST or TOADEST. The specific printer to which you want the output to print must be identified for each function. Put EXACTLY the same name as used for the printer 'Code' on the GTVPRNT form.
Each user may select the same printer so it is possible to have several users all sending their print jobs to a single printer.
Using GJAPCTL, each job that is to be run in sleep-wake must be started for each printer that is to be used. When doing this, the Printer in the Printer Control block should be left as null (blank).
Enter COLLECTOR or select the option that relates to the collector file for the appropriate parameter in each job. For the Printer parameter, specify the printer that will receive the job's output. Use EXACTLY the same printer Code as entered on SOADEST or TOADEST which was also defined on GTVPRNT. Each printer specified in SOADEST or TOADEST needs to be entered here so each process (job) may need to be run multiple times, once for each printer that will be...See Document...
Additional documentation:
The first step in setting up the sleep-wake process is to identify each printer that will be used in the process on the validation form GTVPRNT.
Once printers are identified, in the 'Printer Command' field, put the print command exactly as it would look if submitted from the command line prompt, using an 'at sign' @ as the place holder for the filename to be printed.
Examples: print/queue=ln01 @ VAX-VMS
lp -d talaris1 @ UNIX
(Note: If you find that a banner (blank) page is being generated by a sleep-wake process, set the print command to "lp -d printername @ -o nobanner". This should prevent the banner page from printing.)
When logging into Banner forms, those that may use Sleep-wake begin by displaying a form that allows you to indicate a printer for each of a number of functions. Printers can be identified here or by going directly to SOADEST or TOADEST. The specific printer to which you want the output to print must be identified for each function. Put EXACTLY the same name as used for the printer 'Code' on the GTVPRNT form.
Each user may select the same printer so it is possible to have several users all sending their print jobs to a single printer.
Using GJAPCTL, each job that is to be run in sleep-wake must be started for each printer that is to be used. When doing this, the Printer in the Printer Control block should be left as null (blank).
Enter COLLECTOR or select the option that relates to the collector file for the appropriate parameter in each job. For the Printer parameter, specify the printer that will receive the job's output. Use EXACTLY the same printer Code as entered on SOADEST or TOADEST which was also defined on GTVPRNT. Each printer specified in SOADEST or TOADEST needs to be entered here so each process (job) may need to be run multiple times, once for each printer that will be used.
Set the run in sleep-wake parameter to 'Y' and specify a sleep interval. The sleep interval needs to be listed as 10 or more seconds.
At any time, the status of the sleep-wake process can be checked by using GJASWPT. The sleep-wake process can also be discontinued for a job from here. To discontinue the process, set the Continue to Run field to "N". If it subsequently needs to be restarted this would be done through GJAPCTL. The cycle time can also be reset using GJASWPT.
The GJASWPT form can also be used to view statistics regarding how many rows were processed per wakeup, and the total number of rows processed since the job was submitted. You can also determine if the job ended abnormally by viewing the Abnormal Termination? field. If there is a 'Y' in this field, something caused the job to fail - check your log files.
Each time you perform a save function on a form that is affecting sleep-wake, a record is created in the appropriate collector file. This record includes the identification of the printer entered by the user on SOADEST or TOADEST. If a printer is not specified for the appropriate job on these forms, the output generated by the job will not print. When the correct time is reached in the sleep-wake cycle, the job looks to the collector file and prints the relevant document to the specified printer for all records found in the file.
At the end of the day, the sleep-wake process for each job and printer needs to be closed. This is done by going to GJASWPT and changing the Continue parameter to 'N'. An alternative is to run a script at the end of the day that does this for all sessions.
The following collector tables are used in the sleep-wake process:
SFRSCHD Schedules SFRCBRQ
SHRTRTC Transcripts SHTTRAN
TGRRCPT Receipts TBRCRCP
TSRCBIL Invoices TBRCBRQ
TGRMISC Misc Receipts TBRCMIS
TSRSSUM Student Summary TBRSCUM
CAPP compliance requests and enrollment verifications are not printed using sleep-wake, but the printer to which output should be directed can be specified on SOADEST.
Please note that if you are having difficulty in starting the sleep-wake process, you'll need to check GJASWPT. You may need to turn the process off and restart it for a particular printer.
Daily process
Check GJASWPT to see that the Continue to Run box has an N in it. If it doesn't change the Y to an N and save.
Use GJAPCTL to run each of the processes for each of the printers that will be used. For example, run SHRTRTC for printer1, printer2, printer3, etc.
Check GJASWPT for each of the job/printer combinations to be sure that the Continue to Run box now has a Y in it and that the Abmormal Termination box has an N in it. This will indicate that the job is running.
Enter the correct printer destination values on SOADEST.
At the end of the day, set the Continue to Run box on GJASWPT to N.
Note: On occasion, an institution may need to print schedules and/or bills for multiple terms in sleep-wake. In order to send the output to the same printer for more than one term, the same physical printer needs to be defined on GTVPRNT with different code. The destination in the Command field can be the same, but the Printer Code needs to be a unique value.
Once a printer is set up with multiple codes, the same job (SFRSCHD, TSRCBIL, etc.) needs to be initiated on GJAPCTL for multiple terms with a unique printer code specified for each term. With this setup, the same job can be sent to the same physical printer even though the printer codes that would be entered on SOADEST or TOADEST would be different.
Also, in order to avoid having to return to SOADEST or TOADEST each time a term is changed, a user can run multiple sessions of Banner with each dedicated to a specific term.
Revision Date : 3/14/2007
Keywords : banner