SP-TRANSLATE

Changes the translation table entry for the specified formqueue.

PROMPT

FORMQUEUE TABLE#:

COMMAND SYNTAX

SP-TRANSLATE formqueue tablename

SYNTAX ELEMENTS

formqueue is the formqueue to use the translation table.

tablename is the name of the translation table entry.

NOTES

The translation table comprises characters or character strings which are to be translated to alternative characters or character strings. For example a printing device may not perform an automatic carriage return when a form feed is executed, or it may not be capable of printing lower case characters. In this example, the translation table can be used to map a form feed character to a form feed followed by a carriage return character, and all lower case characters can be mapped to their upper case equivalents. Like this

\f ]\f \r map form feed to form feed followed by carriage return (using char definition).

\141 ] \101 map ASCII lowercase "a" to uppercase "A" (using octal definition).

The translation table entries reside in the /usr/jbc/config directory and uses the naming convention jspxl_tablename.  The default table if none is specifically assigned is jspxl_deflt.  Although the prompt is for table number and can be a number, it also can be a name.

Creating / assigning a translate table:

Create an item in /usr/jbc/config using the jspxl_ naming format

jsh-> COPY /usr/jbc/config jspxl_deflt
TO: jspxl_docrlf

jsh-> ED /usr/jbc/config jspxl_docrlf
jspxl_docrlf
TOP
.B
067 #
I
068+ # Add carriage return to end of lines
069+\n]\n\r
070+
.FI
Record 'jspxl_docrlf' written to file '/usr/jbc/config'

Assign the new table to a formqueue

jsh->SP-TRANSLATE STANDARD docrlf

The translation table will take effect the next time the despool process is started.

RESTRICTIONS

The translation table entry is only examined when the despooler is initiated. The despooling process must therefore be stopped and restarted to effect any changes made either to the formqueue assignment or the translation table.  You can force it to be done by doing a SP-SHUTDOWN then REST-SPOOLER.

Spooler