Using the Color Mapping Tool

To use the Color Mapping Tool to create a color mapping table:

1. Copy the sample input source file (APSRSCMT) and edit it to reflect your color mapping needs (see Figure 46).
2. Copy the sample JCL (APSRRCMT) to call the Color Mapping Tool (see Figure 45) and make these changes:
   • Change the JOB card to reflect your ID and system information.
   • Change the STDIN statement to point to the input source data set for the color mapping table.
   • Change the STDOUT statement to point to the output data set in the PSF object container library.
   Note:

   The PARM statement is case-sensitive; therefore, lowercase and uppercase characters in the PARM statement are very important.
   Figure 45. Sample JCL for Color Mapping Tool

   //APSRRCMT JOB 'account #','name',MSGLEVEL=(1,1)                      
   //**START OF SPECIFICATIONS*****************************************/ 
   //*                                                                */ 
   //*    NAME: APSRRCMT                                              */ 
   //*                                                                */ 
   //*    DESCRIPTIVE NAME: JCL to run the Color Mapping Table Tool   */ 
   //*                                                                */ 
   //*    FUNCTION: This JCL will invoke Color Mapping Table Tool.    */ 
   //*                                                                */ 
   //*    Licensed Materials - Property of IBM                        */ 
   //*    5655-B17                                                    */ 
   //*    (C) Copyright IBM Corp. 1999, 2000                          */ 
   //*                                                                */ 
   //*    NOTES:                                                      */ 
   //*       - Change the JOB card to meet installation requirements  */ 
   //*       - Replace 'hlq' with your high-level qualifier           */ 
   //*       - Replace 'vvvvvv' with the volume serial number for     */ 
   //*         the output data set                                    */ 
   //*       - Note that the PARM field is case-sensitive:            */ 
   //*         lower and upper case characters are important          */ 
   //*                                                                */ 
   //*    CHANGE ACTIVITY:                                            */ 
   //* $00=LAPS0008,HPRF320,000425,BDKULMM: Initial version           */ 
   //****END OF SPECIFICATIONS*****************************************/ 
   //*                                                                */ 
   //CMT    EXEC PGM=APSRCMT,REGION=4M,                                  
   //       PARM='/-i //DD:STDIN -o //DD:STDOUT'                         
   //STDIN    DD DSN=hlq.MYCMT.SOURCE(M1COLOR),DISP=SHR                  
   //STDOUT   DD DSN=hlq.CMT.AFPDS(M1COLOR),                             
   //         DISP=(NEW,CATLG),                                          
   //         DCB=(RECFM=VBM,LRECL=8205,BLKSIZE=8209),                   
   //         UNIT=SYSALLDA,VOL=SER=vvvvvv,SPACE=(TRK,(5,1,2))          
   //SYSUDUMP DD SYSOUT=* 

3. Submit the APSRRCMT JCL. The Color Mapping Tool reads the source statements and generates a color mapping table object data set.
4. In order for PSF to find the new color mapping table object, you must do one of these:
   • Ask your system programmer to put the new color mapping table object in an existing object container library that the PSF startup procedure already uses.
   • Put the new color mapping table object in a new partitioned data set. Then, ask your system programmer to add the partitioned data set to the list of object container libraries in the startup procedure.
   • Specify the new color mapping table data set on the USERLIB parameter in the OUTPUT JCL statement of your print-submission job request.
   • Code the color mapping table inline in the print data set.
5. Specify your color mapping table object name on the COLORMAP parameter in the OUTPUT JCL statement of your print-submission job request.