Novell Help Librarian Data File Version 1.00 COPYRIGHT (c) 1985 by Novell, Inc. All Rights Reserved. Abandon PRINTDEF Help 1 of 1 PRINTDEF's printer definitions or form definitions have been changed. You can verify your decision to exit PRINTDEF. If you exit PRINTDEF, all changes will be lost. Exit Options Help 1 of 1 PRINTDEF's printer definitions or form definitions have been changed. Before you exit you must either accept or reject the changes. This is your last chance to save your modified database. You have the following options: Save database, then EXIT The current database is written to disk before exiting PRINTDEF. EXIT without saving database Changes to the database are lost before exiting PRINTDEF. Do Not EXIT The database will not be overwritten; your changes will not be discarded. Available Printer Definitions Help 1 of 1 This window lists files that contain printer definition information and the names of the printers they define. The files are from the specified directory. Only files with the extension .PDF are included in the list. Active keys: Terminate import process and return to Print Device Options menu. Mark or unmark currently highlighted file Insert selected printer name and definition into the Defined Print Devices list; or, insert all marked definition files. Display Function's Escape Sequence Help 1 of 2 This window displays the selected function's escape sequence. If a character in the escape sequence has an ASCII value less than 33 or equal to 127, the character is displayed as a delimited acronym. If the character's ASCII value is greater than 127, it is displayed as a delimited ASCII value. The value is a decimal number. The angle brackets (< and >) are used as delimiters. If the function's escape sequence contains a single left angle bracket (<), the bracket is displayed as a double left angle bracket (<<). The following screen shows the relationship between the ASCII values and the delimited ASCII acronyms. Display Function Help 2 of 2 ASCII Delim Ctrl ASCII Delim Ctrl ASCII Delim Ctrl ASCII Delim Ctrl Value Acr Char Value Acr Char Value Acr Char Value Acr Char ----- ----- ---- ----- ----- ---- ----- ----- ---- ----- ----- ---- 0 10 ^J 20 ^T 30 1 ^A 11 ^K 21 ^U 31 2 ^B 12 ^L 22 ^V 32 3 ^C 13 ^M 23 ^W 127 4 ^D 14 ^N 24 ^X 5 ^E 15 ^O 25 ^Y 6 ^F 16 ^P 26 ^Z 7 ^G 17 ^Q 27 8 ^H 18 ^R 28 9 ^I 19 ^S 29 Duplicate .PDF Filename Help 1 of 1 The name you have chosen for your exported .PDF file matches a .PDF file in the destination directory. If you select Yes, your exported .PDF file will overwrite the existing .PDF file in the destination directory. If you select No, you can change the name of your .PDF file. Edit Device Name Help 1 of 1 A printer device name must be - unique (no two names can be the same); - no longer than 32 characters; - case sensitive (for display purposes); - case insensitive (for comparison purposes). The printer device name should be easily recognized by network users. Edit Mode Name Help 1 of 1 A mode name must be - unique (no two names can be the same); - no longer than 32 characters; - case sensitive (for display purposes); - case insensitive (for comparison purposes). The mode name should be a meaningful name that network users can associate with a particular printing process. Edit .PDF Filename Help 1 of 1 A .PDF filename must - be no longer than eight characters; - have no extension (no period in the name); - be case insensitive; - be composed of valid filename characters. The .PDF filename should reflect the name of the print device that is being exported. PRINTDEF adds a .PDF extension to the filename. Destination Directory Help 1 of 1 Specify the server, volume, and directory path that describes the destination of the .PDF file. To change the directory path, volume, or server, use . To set the desired export path, use and . You need Create, Write, and Search rights in the directory you want to export to. Active keys: Abandon export and return to Print Device Options menu. Change directory, volume, or server. Enter .PDF filename and then export .PDF file to currently displayed path location. Function Definition Help 1 of 1 To define a PRINTDEF function, fill in the function name and escape sequence. Press to exit the menu. Active keys: Back up to previous level. Arrow keys Move field cursor to the other field. Select current field for editing. CoPyRiGhT=(c) Copyright 1989 - 1993 Novell, Inc. All Rights Reserved. VeRsIoN=3.75 Function Help: Introduction Help 1 of 7 Most printers can be software controlled by interpreting a certain sequence of characters as control characters (an escape sequence). PRINTDEF lets the network supervisor define PRINTDEF functions. These functions are similar to escape sequences, except that ASCII characters can be used in any part of the sequence. PRINTDEF regards characters that have an ASCII value of less than decimal 33 or greater than decimal 126 as special characters; they must be entered using a delimited token. The space character can be entered as is or as a delimited token. A space is displayed as a delimited token. Except for delimited tokens, characters in a function follow the "used as is" rule: the characters displayed are the actual characters that make up the function. The following screens explain the use of delimited tokens. Function Help: Delimited Tokens Help 2 of 7 PRINTDEF functions can contain special characters when delimited tokens are included in the function. A delimited token has two parts--the delimiters and the token. The three types of delimiters Angle brackets < and > Backwards slash \ Caret ^ Since these characters function as delimiters, they are exceptions to the "used as is" rule. To enter a left angle bracket (<), backwards slash (\), or caret (^), you must enter two characters. The right angle bracket (>) can be used as is. For example, a function that contains the string \\<<^^> will be interpreted as \<^>. The "double" rule is used when entering and displaying PRINTDEF functions. Function Help: Delimited Tokens Help 3 of 7 The other part to a delimited token is the token. A token can be a number, character, or a valid character string. Numbers are used in conjunction with the angle bracket or backwards slash delimiters and can be entered in decimal or hexadecimal. To enter a hexadecimal number, use a 0x or 0X prefix. A number without the hexadecimal prefix is assumed to be decimal. For example, the ASCII escape character can be input by the delimited numbers <27>, <0x1b>, <0X1B>, \27, \0x1b, or \0X1B. You can enter any ASCII character value from 0 to 255 using this method. Character tokens can be used with angle bracket or caret delimiters. Valid characters are A through Z and a through z. Delimited character tokens are the same as ASCII control characters. In other words, ^A has an ASCII value of 1, ^B has an ASCII value of 2, etc.K) Function Help: Delimited Tokens Help 4 of 7 Character string tokens are the names or acronyms of ASCII control characters. The name is case insensitive. For example, the ASCII escape character can be input by the delimited strings , , or . The syntax for a delimited token is delimited_token = delimited_number, delimited_character, or delimited_string. delimited_number = or \number_token. delimited_character = ^character_token or <^character_token>. delimited_string = . number_token = 0 - 255 or 0x0 - 0xFF. character_token = A - Z or a - z. string_token = (see pages 5-7 of this help context).^, Function Help: Examples and Valid String Tokens Help 5 of 7 The following are examples of three equivalent functions: ^^ == <0x1B><0xF>\0x5E<0x7F>^A == \27<15><94><127>\1 ASCII Value VALID STRING TOKENS ----- ---------------------------------------------------------------- 0 NUL, NULL 1 SOH, ^A, START OF HEADER, START_OF_HEADER, STARTOFHEADER 2 STX, ^B, START OF TEXT, START_OF_TEXT, STARTOFTEXT 3 ETX, ^C, END OF TEXT, END_OF_TEXT, ENDOFTEXT 4 EOT, ^D, END OF TRANSMISSION, END_OF_TRANSMISSION, ENDOFTRANSMISSION 5 ENQ, ^E, ENQUIRE 6 ACK, ^F, ACKNOWLEDGE 7 BEL, ^G, BELL)0 ASCII Value VALID STRING TOKENS Help 6 of 7 ----- ---------------------------------------------------------------- 8 BS, ^H, BACK SPACE, BACK_SPACE, BACKSPACE 9 TAB, ^I, HT, HORIZONTAL TAB, HORIZONTAL_TAB, HORIZONTALTAB 10 LF, ^J, LINE FEED, LINE_FEED, LINEFEED 11 VT, ^K, VERTICAL TAB, VERTICAL_TAB, VERTICALTAB 12 FF, ^L, FORM FEED, FORM_FEED, FORMFEED 13 CR, ^M, RET, CARRIAGE RETURN, CARRIAGE_RETURN, CARRIAGERETURN 14 SO, ^N, SHIFT OUT, SHIFT_OUT, SHIFTOUT 15 SI, ^O, SHIFT IN, SHIFT_IN, SHIFTIN 16 DLE, ^P, DATA LINK ESCAPE, DATA_LINK_ESCAPE, DATALINKESCAPE 17 DC1, ^Q, DEVICE CONTROL 1, DEVICE_CONTROL_1, DEVICECONTROL1 18 DC2, ^R, DEVICE CONTROL 2, DEVICE_CONTROL_2, DEVICECONTROL2 19 DC3, ^S, DEVICE CONTROL 3, DEVICE_CONTROL_3, DEVICECONTROL3 20 DC4, ^T, DEVICE CONTROL 4, DEVICE_CONTROL_4, DEVICECONTROL4 ASCII Value VALID STRING TOKENS Help 7 of 7 ----- ------------------------------------------------------------- 21 NAK, ^U, NEGATIVE ACKNOWLEDGE, NEGATIVE_ACKNOWLEDGE, NEGATIVEACKNOWLEDGE 22 SYN, ^V, SYNCHRONOUS 23 ETB, ^W, END OF TRANSMISSION BLOCK, END OF TRANS BLOCK, END_OF_TRANSMISSION_BLOCK, ENDOFTRANSMISSIONBLOCK 24 CAN, ^X, CANCEL 25 EM, ^Y, END OF MEDIUM, END_OF_MEDIUM, ENDOFMEDIUM 26 SUB, ^Z, SUBSTITUTE 27 ESC, EC, ESCAPE 28 FS, FILE SEPARATOR, FILE_SEPARATOR, FILESEPARATOR 29 GS, GROUP SEPARATOR, GROUP_SEPARATOR, GROUPSEPARATOR 30 RS, RECORD SEPARATOR, RECORD_SEPARATOR, RECORDSEPARATOR 31 US, UNIT SEPARATOR, UNIT_SEPARATOR, UTILSEPARATOR 32 SP, SPACE 127 DEL, DELETE Function Name Help 1 of 1 A function name must be - unique (no two names can be the same); - no longer than 32 characters; - case sensitive (for display purposes); - case insensitive (for comparison purposes). A function name should be easily recognized by network users. For example, you could use the name used in the printer's manual. Export Device Filename Help 1 of 1 The exported filename can be no longer than eight characters. (When you export a printer definition to a file, PRINTDEF appends a .PDF extension to the filename.) The filename should reflect the name of the device being exported. For example, a device with a defined name of LINE PRINTER might have an export filename of LINE_PRN. In the directory, PRINTDEF would save the printer's name and definition as LINE_PRN.PDF. Source Directory Help 1 of 1 Specify the server, volume, and path that describe where the .PDF can be retrieved. To change the directory, volume, or server, use . After creating the import path, use and to verify the path and list .PDF files in that directory. You need Read, Open, and Search rights in the directory you want to import to. Active keys: Abandon import and return to Print Device Options menu. Change the directory, volume, or server. Import the .PDF file from the currently displayed directory. Print Device Options Help 1 of 2 The print device options are explained below. EDIT PRINT DEVICE: Create, delete, or modify printer names and definitions. IMPORT PRINT DEVICE: Insert a previously exported printer name and definition. EXPORT PRINT DEVICE: Save the selected printer name and definition to a .PDF file. An example on the following screen explains how to use these options. Print Device Options Help 2 of 2 A user logged in to server A can send a print job across the internetwork to a printer attached to server B. The PRINTDEF database on server A must contain the definition for the printer attached to server B. The supervisor for server B can export the printer's definition to a .PDF file. Then the supervisor for server A can import the printer definition and save the database. Server B's definition will then be available on server A. No Directory Read Rights Help 1 of 1 You need the Read right to import from the specified directory. No Directory Write Rights Help 1 of 1 You need the Write right to export to the specified directory. No Files in Directory Help 1 of 1 When you import a device definition (.PDF file), PRINTDEF searches the selected directory with a *.PDF filename search pattern. Other Device Functions Help 1 of 1 This lists printer functions that are not part of the currently selected mode. To edit the mode's definition, append or insert one or more of these functions. The order of the mode's associated functions is important. Active keys: Exit and return to the current mode's list of functions. Mark Associate the marked functions. Associate the selected function. Form Definition Help 1 of 1 Active keys: Back up to previous level. Up, Left Move field cursor to previous field. Down, Right Move field cursor to next field. Select current field for editing. Form Length Help 1 of 1 The form length is the number of lines per page. It must be within the range of 1 to 255 (inclusive). Form Name Help 1 of 1 A form name must - be unique (no two names can be the same); - have an alphabetic first letter; - not contain spaces (underscores are okay); - be no longer than 12 characters; - be case insensitive. Form Number Help 1 of 1 The following criteria apply to form numbers: - They must be unique (no two numbers can be the same). - They must be within the range of 0 to 255 (inclusive). Form Width Help 1 of 1 The form width is the number of characters per line. It must be within the range of 1 to 999 (inclusive). Defined Print Devices Help 1 of 1 This is a list of currently defined print devices. You can add, delete, and modify print device names and definitions. Active keys: Exit list of devices and return to Print Device Options menu. Mark Mark or unmark the selected device. Edit the selected print device name. Add a new print device name to the list. Edit the selected print device definition. Delete the selected print device name and definition. Exit Options Help 1 of 2 PRINTDEF's printer definitions or form definitions have been changed. The following options are available: Save database, then EXIT The current database is written to disk before exiting PRINTDEF. EXIT without saving database Changes to the database are lost before exiting PRINTDEF. Do not EXIT Return to PrintDef Options menu. Changes that were made are NOT lost and the old database is NOT overwritten. Exit Options Help 2 of 2 If an error occurs during the writing of the database, the following suggestions may be helpful: Make sure the database pathname is SYS:PUBLIC\NET$PRN.DAT. Check that the database file is not open. Check that the database is not locked. (It does not need to be opened to be locked.) Make sure there is enough disk and directory space on volume SYS. Export Print Device Help 1 of 1 This is a list of currently defined print devices. The device definitions are written to .PDF files. Active keys: Abandon export and return to Defined Print Devices menu. Edit the highlighted print device definition. Form List Help 1 of 1 This window lists defined form names and associated form numbers. You can add, delete, and edit form names and definitions. Active keys: Exit and return to the PrintDef Options menu. Edit highlighted form name. Add new form name and definition. Edit or examine highlighted form definition. Delete highlighted form name and definition. Mode's Associated Functions Help 1 of 1 This screen lists functions associated with the current mode. To edit the mode's definition, append, insert, or remove functions. The order of the associated functions is important. Active keys: Exit list of functions and return to list of modes. Mark Toggle marking for selected function. Added functions are inserted in front of marked function. If a function is marked: insert before marked function. If no function is marked: append to end of list. Examine selected function. Remove selected or marked functions from the list. Edit Device Options Help 1 of 1 Edit Device options are Device Modes View the selected device's mode names and mode definitions. Device Functions View the selected device's function names and function definitions; add new function names and definitions or delete existing function names and definitions. Function List Help 1 of 3 This screen lists currently defined function names and escape sequences. The escape sequence can contain any ASCII character. If the escape sequence takes more than 32 characters to display, it is truncated. Active keys: Exit list of functions and return to Edit Device Options menu. Mark Mark or unmark the highlighted function. Edit the selected function. Create a new function and its escape sequence. Examine the selected function's escape sequence. Delete the selected function and its escape sequence.D` Function List Help 2 of 3 If a character in the function's escape sequence has an ASCII value less than 33 or equal to 127, the character is displayed as a delimited ASCII acronym. If the character's ASCII value is greater than 127, it is displayed as a delimited ASCII value. The value is displayed as a decimal number. The angle brackets (< and >) are used as delimiters. They enclose the ASCII acronym or ASCII value. If the function's escape sequence contains a single left angle bracket (<), the bracket is displayed as a double left angle bracket (<<) to distinguish it from a delimiter. The following screen shows the delimited ASCII acronyms and their associated ASCII values. Function List Help 3 of 3 ASCII Delim Ctrl ASCII Delim Ctrl ASCII Delim Ctrl ASCII Delim Ctrl Value Acr Char Value Acr Char Value Acr Char Value Acr Char ----- ----- ---- ----- ----- ---- ----- ----- ---- ----- ----- ---- 0 10 ^J 20 ^T 30 1 ^A 11 ^K 21 ^U 31 2 ^B 12 ^L 22 ^V 32 3 ^C 13 ^M 23 ^W 127 4 ^D 14 ^N 24 ^X 5 ^E 15 ^O 25 ^Y 6 ^F 16 ^P 26 ^Z 7 ^G 17 ^Q 27 8 ^H 18 ^R 28 9 ^I 19 ^S 29 Import Print Device Help 1 of 1 This window lists defined print devices. The selected device definition is written to a .PDF file. Active keys: Abandon import and return to Print Device Options menu. Select edited print device name. PRINTDEF Options Help 1 of 3 The main PRINTDEF options are: Print devices Import, export, and edit printer names and definitions. Forms Create, delete, or modify form names and definitions. Active keys: Read the next page of help. Read the previous page of help. Exit help. Shows function key assignments. PRINTDEF Overview Help 2 of 3 The network supervisor uses PRINTDEF to define modes of operation and forms for network printers. Network users can examine the print device and and form definitions. PRINTDEF creates a database of device and form definitions. Only a network supervisor can create or delete PRINTDEF's database. PRINTCON and NPRINT access PRINTDEF's database and use the device definitions when submitting print jobs to a print server. PRINTDEF Terms Help 3 of 3 FUNCTION: The individual escape sequence or control code character string that controls a printing characteristic of a printer. MODE: An ordered group of functions that configures a printer for a particular print job. DEVICE: Any printing device that can be defined or controlled by PRINTDEF. (In PRINTDEF, the term "printer" has the same meaning as "device.") FORM: A form may be single sheets of paper, continuous-feed paper, sales orders, labels, etc. PRINTDEF Mode Help 1 of 1 This screen lists modes for the selected printer. A mode is made up of one or more defined printer functions. You can add, delete, or modify mode names and mode definitions. Active keys: Exit this list and return to the list of devices. Mark Mark or unmark the highlighted mode. Edit the selected mode name. Add a new mode name to the list. Edit or examine the selected mode. Delete the selected mode. Exit Help 1 of 1 If changes were made to the PRINTDEF database, select Yes. Another menu will appear that allows you to save the changes and exit PRINTDEF. If no changes were made, select Yes. The Exit Options menu will appear. Select "EXIT Without Saving Data Base." Select No to return to the PrintDef Options menu. Your changes will not be discarded, but the database will remain unchanged. Form Definition Help 1 of 1 A form definition is composed of a name, number, length, and width. If you need a form defined, contact your network supervisor. Defined Print Devices Help 1 of 1 This window lists defined print devices. Your network supervisor can add, delete, and modify print device names and definitions. Active keys: Exit and return to the PrintDef Options menu. Examine the selected print device definition. Form List Help 1 of 1 This window lists defined forms and their associated form numbers. The network supervisor can add, delete, and modify form names and definitions. Active keys: Exit and return to the PrintDef Options menu. Examine the selected form definition. Mode's Associated Functions Help 1 of 1 This window lists functions associated with the currently selected mode. The network supervisor can add, delete, and reorder this mode's associated functions. Active keys: Exit this list and return to the list of modes. Examine the selected function. Edit Device Options Help 1 of 1 Device Modes Examine the device's mode names and mode definitions. Device Functions Examine the device's function names and function definitions.oz Function List Help 1 of 2 This window lists device functions. It shows the function names and the associated function. If the function is longer than 32 characters in length, it is truncated. The angle brackets (< and >) are used as delimiters. They enclose an ASCII acronym or an extended ASCII value. The values are in decimal. If the function string contains a single left angle bracket (<), it will be displayed as a double left angle bracket (<<). Active keys: Exit and return to the previous menu. View the selected function. Function List Help 2 of 2 ASCII Delim Ctrl ASCII Delim Ctrl ASCII Delim Ctrl ASCII Delim Ctrl Value Acr Char Value Acr Char Value Acr Char Value Acr Char ----- ----- ---- ----- ----- ---- ----- ----- ---- ----- ----- ---- 0 10 ^J 20 ^T 30 1 ^A 11 ^K 21 ^U 31 2 ^B 12 ^L 22 ^V 32 3 ^C 13 ^M 23 ^W 127 4 ^D 14 ^N 24 ^X 5 ^E 15 ^O 25 ^Y 6 ^F 16 ^P 26 ^Z 7 ^G 17 ^Q 27 8 ^H 18 ^R 28 9 ^I 19 ^S 29 PRINTDEF Overview Help 1 of 3 The network supervisor can use PRINTDEF to define modes of operation and forms for network printers. Network users can examine the printer definitions and form definitions. PRINTDEF creates a database of device and form definitions. Only a network supervisor can create or delete PRINTDEF's database. PRINTCON and NPRINT access PRINTDEF's database and use the device definitions when submitting print jobs to a print server.C PRINTDEF Options Help 2 of 3 The main PRINTDEF options are Print devices Examine printer names and definitions. Forms Examine form names and definitions. The following are PRINTDEF terms. FUNCTION: The individual escape sequence or control code character string that controls a printing characteristic of a printer. PRINTDEF Terms Help 3 of 3 MODE: An ordered group of functions that configures a printer for a particular print job. DEVICE: Any printing device that can be defined or controlled by PRINTDEF functions. In PRINTDEF, the term "printer" has the same meaning as "device." FORM: Single sheets of paper, continuous-feed paper, sales orders, labels, etc. PRINTDEF Mode Help 1 of 1 This screen lists modes for the currently selected printer. A mode is made up of one or more defined printer functions. The network supervisor creates modes for network printers. Active keys: Examine the selected mode. Exit this list and return to the list of devices. Exit PRINTDEF Help 1 of 1 Select Yes to exit PRINTDEF. Select No to return to the PRINTDEF Options menu.