Subcommands

FONT Subcommand
FONT lname
Specifies a font to be mapped. FONT is the default if FONT, OB2CMR, or OB2R is not specified.
lname
Specifies the local name for a font. This is an unquoted alphanumeric name of 1 to 16 characters that is to be used in this page definition. The name must be unique within this page definition. lname is the name used in the FONT or DOFONT commands which define the font.
OB2CMR Subcommand
OB2CMR lname {AUDIT | INSTR | LINK}
Specifies a color management resource (CMR) and its process mode for a data object specified within an included object. CMRs are secondary objects when used at this level. An object specified here will be mapped with object scope.
Note: See AFP Color Management for more information about using the CMR subcommand.
cmr-lname
Specifies The CMR local name. This name must have been defined with a DEFINE CMR command.
processing-mode-parameter
Specifies the processing mode for the CMR.
AUDIT
CMRs with the audit processing mode refer to processing that has already been applied to a resource. In most cases, audit CMRs describe input data and are similar to ICC input profiles.

The audit processing mode is used primarily with color conversion CMRs. In audit processing mode, those CMRs indicate which ICC profile must be applied to convert the data into the Profile Connection Space (PCS).

INSTR
CMRs with the instruction processing mode refer to processing that is done to prepare the resource for a specific printer using a certain paper or another device. Generally, instruction CMRs refer to output data and are similar to ICC output profiles.

The instruction processing mode is used with color conversion, tone transfer curve, and halftone CMRs. In instruction processing mode, these CMRs indicate how the system must convert a resource so it prints correctly on the target printer. The manufacturer of your printer should provide ICC profiles or a variety of CMRs that you can use. Those ICC profiles and CMRs might be installed in the printer controller, included with the printer on a DVD, or available for download from the manufacturer's Web site.

LINK
This CMR defines a direct color conversion from an input color space to a device output color space; process the CMR as a link CMR. This processing mode is only valid for device link (DL) CMRs. The PPFA command RENDER is not used with device link (DL) CMRs as such CMRs specify the intended rendering intent internally. This function requires print server (PSF) and printer support which is in addition to the original CMR support.
OB2R Subcommand
OB2R [i2name | 'i2name' | C'i2name' | E'i2name' | A'i2name' X'hhhh']
Specifies a secondary object to be mapped.

If an included object contains a reference to one or more secondary objects, you must identify them at this point. Specify the internal name for the secondary resource as specified in the included resource. If the internal name contains special characters such as periods or blanks, then quotes must surround the name.

i2name
An unquoted name up to 250 characters long will be folded to upper case and translated into EBCDIC if necessary.
‘i2name’
A quoted name up to 250 characters long will be accepted as-is with no case folding or translation.
C‘i2name’
A quoted name with a C for Character will be treated the same as a quoted name of up to 250 characters. No folding or translation will be done.
E‘i2name’
A quoted name with an E for EBCDIC entered with up to 250 characters will be accepted as-is if on an EBCDIC platform or translated to EBCDIC if on an ASCII platform. The translation will be made with no case folding.
A'i2name’
A quoted name with an A for ASCII entered with up to 250 single-byte characters will be accepted as-is if on an ASCII platform or translated to ASCII if on an EBCDIC platform. The translation will be made with no case folding.
X‘hhhh’
A quoted name with an X for Hexadecimal entered with up to 500 hexadecimal characters. The characters will be translated to hexadecimal, but no assumptions of data type will be made.
OB2XNAME Subcommand
OB2XNAME {x2name | 'x2name' | C'x2name' | E'x2name' | A'x2name' | 
X'hhhh' | U8'x2name' | U16'x2name ' | X8'hhhh' | X16'hhhh '}
Specifies the external name for a secondary resource object. If the name contains special characters or blanks, then quotes must surround the name.
x2name
An unquoted name up to 250 characters long will be folded to upper case and translated into EBCDIC if necssary.
‘x2name’
A quoted name up to 250 characters long will be accepted as-is with no case folding or translation.
C‘x2name’
A quoted name with an C for Character will be treated the same as a quoted name up to 250 characters. No folding or translation is done.
E‘x2name’
A quoted name with an E for EBCDIC entered with up to 250 single-byte characters will be accepted as-is if on an EBCDIC platform or translated to EBCDIC if on an ASCII platform. The translation will be made with no case folding.
A‘x2name’
A quoted name with an A for ASCII entered with up to 250 single-byte characters will be accepted as-is on an ASCII platform or translated to ASCII if on an EBCDIC platform. The translation will be made with no case folding.
U8‘x2name’
A quoted name with a U8 for UTF-8 entered with up to 250 single-byte characters will be translated to UTF-8.
U16‘x2name’
A quoted name with a U16 for UTF-16 entered with up to 125 single-byte characters will be translated to UTF-16.
X‘hhhh’
A quoted name with an X for Hexadecimal entered with up to 500 hexadecimal characters. The characters will be translated to hexadecimal, but no assumption of data type will be made.
X8‘hhhh’
A quoted name with an X8 for UTF-8 HEX entered with up to 500 single-byte hexadecimal characters will be translated to hexadecimal and assumed to be data type UTF-8. There must be a multiple of 2 hexadecimal characters entered.
X16‘hhhh’
A quoted name with an X16 for UTF-16 HEX entered with up to 500 single-byte hexadecimal characters will be translated to hexadecimal and assumed to be data type UTF-16. There must be a multiple of 4 hexadecimal characters entered.
OB2ID Subcommand
OB2ID {n | type-name}
Specifies a component type identifier for a secondary resource, as specified in object-type list adjustments..

Object Types That Can Be Referenced as Secondary Resources

Type Name Component ID Description of OID Type Name
PDFRO 26 PDF Resource Object (new)
RESCLRPRO 46 Resident Color Profile Resource Object
IOCAFS45RO 47 IOCA FS45 Resource Object Tile (new)
n
An object type number from the Component ID column of Table Object Types That Can Be Referenced as Secondary Resources.
type-name
An object type name from the Type name column of Table Object Types That Can Be Referenced as Secondary Resources.

Example:

In the example below, the fonts ocaf, fontA, and fontABI and the CMR rtvc are mapped in the Object Environment Group (OEG) of an object that is being included in the page.

Without the EXTREF commands, only the font varb would be mapped because only it is being called out in the PPFA source code. Also, without the EXTREF command, the CMR rvtc will not be mapped.

    Note:
  1. The fonts coded in the EXTREF commands must also be defined in a FONT command.
  2. If rtvc is coded with a CMR command (as in the commented out CMR command) it will be mapped, but will be active for the entire page. Coding it with an EXTREF command makes it active only for the object in whose OEG it is mapped.
PAGEDEF cmr42   replace yes;                                                    
     FONT  varb  gt10   ;           /*Variable data          */                 
     FONT  ocaf CS N40090 CP 000395; /* mapped in OEG        */                 
     DOFONT fontA 'Arial'  Height 12;                                           
     DOFONT fontABI 'Arial Bold Italic'                                         
            UDTYPE EBCDIC CP 'T1V10500';                                        
                                                                                
     DEFINE rvtc CMRNAME                                                        
  'RevVideoTC001.000@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@'         
       '@@@@@@'                                                                 
                                                                                
     SETUNITS  LINESP .25 in ;      /* Line spacing          */                 
                                                                                
     PAGEFORMAT  rept1   TOPMARGIN .25 in;                                      
       EXTREF ocaf;                                                             
       EXTREF fontA;                                                            
       EXTREF fontABI;                                                          
       EXTREF OB2CMR rvtc instr;                                                
                                                                                
   /*  CMR rvtc  instr;     **/                                                 
       LAYOUT 'startline' BODY  newpage POSITION .5 in SAME FONT varb;          
       LAYOUT 'plaindata' BODY          POSITION .5 in NEXT FONT varb;

Parent topic: EXTREF Command