Preparing Printer Configuration for Datatels UI 4.

Purpose
The NC Community College System Office is providing the following information about printer configuration to prepare for Datatels new User Interface UI 4.2. Our intent is to bring all customers into conformity with the configuration that is currently supported by Datatel and the NCCCS template. These instructions should be performed by all NCCCS colleges. The following steps will be covered: 1. Install the latest UNIX script files from ROC Software (EasySpooler customers only). 2. Implement Colleague system configuration changes. 3. Test the printer lookup feature, and print a job from Colleague.

1. Install Latest EasySpooler Script Files (EasySpooler Customers only)

Please understand that these changes will impact all environments on the Colleague server at the same time that they are implemented. Therefore, you should be prepared to implement and test these changes during a time when no users are on the Colleague server. If the changes are implemented correctly a standard EasySpooler installation should work for all versions of Datatels User Interface, including UI 2.3 Desktop, UI Web, UI 4.1 and UI 4.2. If you have customised any print subroutines, these should be reviewed in detail before making changes. 1. Contact ROC software to obtain the latest version of their script files. This should include a file to replace the UNIX lpstat command. 2. Follow their instructions for installation of their script files only. 3. Do not change any UNIX system configuration files. (Explained in the next section.) 4. Test printer function. (See Section 3 for testing steps.) Do not continue until printer functions are tested and working correctly.

2. Colleague System Configuration

Datatel does not support custom configuration of the system definitions records. In the past, they supported an Envision subroutine for EasySpooler as of Release 18 this is no longer the case. The obsolete subroutine name is S_EASYSPOOLER_PRINT_INFO. Datatel provided instructions in AnswerNet document 6586 - EasySpooler setup for Colleague R18 on UNIX, but for NCCCS the instruction in step 3 is unnecessary, because the NCCCS template file /usr/local/udtparams incorporates the variable setting when it is read from /etc/profile. Furthermore, step 4 in AnswerNet document 6586 is redundant and should not be performed. Instead, to ensure that the correct version of the configuration files is in place, we have provided the following detailed instructions. Note: These examples are for the test environment and should be duplicated in your other environments as necessary after testing is complete: 1. EasySpooler clients should make sure that section 1 of this document has been completed before proceeding. 2. Verify that all users are logged out of the environment. 3. Use a terminal session and log in as the datatel user. UI42_PrintSpoolerPreparation_v4.docx Last Updated: 5/2/2011 1:38 PM Page 1 of 4

Preparing Printer Configuration for Datatels UI 4.2

login: datatel Password: Last login: Tue Apr 19 15:24:31 from 10.10.10.20 Sun Microsystems Inc. SunOS 5.10 Generic January 2005 Reading custom profile ... Terminal is set to 'xterm' sun:/export/home/datatel>282-$

4. Change directory and access the colon prompt for the environment.
sun:/export/home/datatel>282-$ cd /datatel/coll18/test/apphome sun:/datatel/coll18/test/apphome>283-$ udt UniData Release 7.2 Build: (3786) (c) Copyright Rocket Software, Inc. 1988-2009. All rights reserved. Current UniData home is /usr/ud72/. Current working directory is /datatel/coll18/test/apphome. Envision Initialized Enter Database Password for User 'datatel': :

5. Edit the SYSDEFS UNIX_CONTROL record. Make a note of line 6 and exit.
:AE SYSDEFS UNIX_CONTROL Top of "UNIX_CONTROL" in "SYSDEFS", 20 lines, 461 characters. *--: P 001: -cvf 002: mt -f 003: 0 004: PTERM -HALF NOLF -ERASE "" -KILL "" 005: sort 006: S_SUN_PRINT_INFO 007: S_UNIX_BATCH_PROC 008: lpstat -a 009: ps -aefo s,pid,args | egrep 'udt|udapi_slave' | fgrep -v grep | tr -s ' ' '\011' | cut -f2 | sort 010: ps -aefo s,pid,args | fgrep PHANTOM | fgrep -v fgrep | tr -s ' ' '\011' | cut -f2 | sort 011: ps -fo s,pid,ppid,args | tr -s ' ' '\011' | cut -f2,3,4 | sort 012: stty susp '^-' 013: SUN 014: tar -cvf $1 $2 015: tar -xmovf $1 $2 016: tar -tvf $1 $2 017: mt -f $1 rewind 018: mt -f $1 weof 019: mt -f $1 fsf 020: 1 Bottom. *--: EX Quit "UNIX_CONTROL" in file "SYSDEFS" unchanged. :

6. Copy the the UNIX_CONTROL_SUN record so that it overwrites the existing UNIX_CONTROL record. Note the use of the comma in the command! UI42_PrintSpoolerPreparation_v4.docx Last Updated: 5/2/2011 1:38 PM Page 2 of 4

Preparing Printer Configuration for Datatels UI 4.2

:COPY FROM SYSDEFS UNIX_CONTROL_SUN,UNIX_CONTROL OVERWRITING

7. Edit the SYSDEFS UNIX_CONTROL record again and confirm that it is the same as seen here. Do not change any values.
:AE SYSDEFS UNIX_CONTROL Top of "UNIX_CONTROL" in "SYSDEFS", 20 lines, 461 characters. *--: 6 006: S_SUN_PRINT_INFO *--: EX Quit "UNIX_CONTROL" in file "SYSDEFS" unchanged.

The above example is the default and should not be changed. 8. Edit the SYSDEFS OS_CONTROL record. If it exists it should be deleted.
:AE SYSDEFS OS_CONTROL Top of "OS_CONTROL" in "SYSDEFS", 1 line, 24 characters. *--: P 001: S_EASYSPOOLER_PRINT_INFO Bottom. *--: FD Record "OS_CONTROL" in file "SYSDEFS" ***** You are about to DELETE the ENTIRE record from the file! OK? n/y > Y Deleted "OS_CONTROL" from file "SYSDEFS".

Note: This completes the return to a default configuration for printing. (EasySpooler users only: printing is now handled by the UNIX replacement file for the lpstat command.)

3. Test Colleague Printing

Perform your test printing with UI 2.3 Desktop and any other version of the Datatel User Interface that you are currently using. 1. Select a short report that you would like to send to a printer. 2. When you get to the printer form in Colleague, select P for Printer Spooler in the Output Device field. 3. In the Printer field, type three dots to perform a lookup (). 4. Confirm that the defined printers are displayed in the lookup form. 5. Send a report to the printer and confirm that it is successful. Repeat the steps in Section 2 Colleague System Configuration, for each Colleague environment, and confirm that printer operation is normal after the changes have been made. Troubleshoot problems with the CIS Help Desk.

UI42_PrintSpoolerPreparation_v4.docx Last Updated: 5/2/2011 1:38 PM

Page 3 of 4

Preparing Printer Configuration for Datatels UI 4.2

4. References Datatel Inc., User Interface 4.2 Installation and Administration for Release 18, January 28, 2011. Datatel Inc., AnswerNet document 6223 UNIX_CONTROL needed for retrieving PIDs of background jobs, September 15, 2010. Datatel Inc., AnswerNet document 6586 EasySpooler setup for Colleague R18 on Unix, March 22, 2011. Datatel Inc., AnswerNet document 7091 Required changes for UniObjects, September 9, 2009. Datatel Inc., AnswerNet document 8183 Known Issues Related to UI 4.2, Jan 25, 2011. Rocket Software, Inc. Managing Printers in UniData, Administering UniData on UNIX Platforms. UniData 7.2. UDT-720-ADMU-1. Newton, MA: 2010. p15-15.

UI42_PrintSpoolerPreparation_v4.docx Last Updated: 5/2/2011 1:38 PM

Page 4 of 4