How to create and close a VPSTRACE file for Virtual Printer problem debugging?

Document ID : KB000055549
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

VPSTRACEs are used to debug file create problems when using the virtual printer interface. The NODE parameter can be used to create VPSTRACE files by adding VPSTRACE=cccccccc or VPSTRACE=*ALL, but sometimes it isn't easy to use.

Solution:

The easiest way to do this is with commands issued to the started task. All you need is the virtual printer name that you want to trace. This is found on the NODE statement as parameter VPS=A31IVP06. Once you have the correct virtual printer name you can issue the below commands. First start the trace. Then run the print transaction to create the report file. Once the file is created in CA Spool you will need to stop the vpstrace.

TV,A31IVP06.*ALL   This turns on the vpstrace 
TV,A31IVP06.*STOP   This turns off the vpstrace

Another way of doing this is through the menu interface. You would need to have full authority to the CA Spool menu. I will use A31IVP06 as the virtual printer for this example.

  1. Sign on to the menu

  2. From the main menu screen select option V - Display virtual printers


Spool    (BIEHE02 )          CA-Spool r11              Ln       -       /
Sub LV31 Nje          RN          RG       RU          Col      to      of
--------------------------------------------------------------------------
Command ===> v                                                            
                                                                          
                    F    -  Display files awaiting print                  
                    FA   -  Display all files                             
                    P    -  Display printers                              
                    N    -  Display NJE nodes                             
                    V    -  Display virtual printers                      
                    ?    -  Help                                          
                    OP   -  Set owner prefix                              
                    PP   -  Set printer prefix                            
                    RP   -  Set report prefix                             
                    RG   -  Set related group                             
                    RN   -  Set related printername                       
                                                                          
                    SUB  -  Set subsystem name                            
                    NJE  -  Set NJE name 


  • Find your virtual printer in the list, type X in the action field then enter.


Spool    (BIEHE02 )          Virtual printers          Ln     1 -     4
Sub LV31 Nje          RN          RG       RU          Col    1 to   54
------------------------------------------------------------------------
Command ===>                                                            
                                                                        
Action    VPS name  Prt name  Prt alias  Sessions  Rc     Status        
          PU11      DP11                           08,5A  CLOSE DISABLED
x         A31IVP06  PRTV      RPPTV      000              OPEN  ENABLED 
          A31IVP05  PRTVPI1   VPIPRT1    000              OPEN  ENABLED 
          A31IVP00  PRTVPI2   VPIPRT2    000              OPEN  ENABLED
  • This takes you to an extended display screen for that one virtual printer.


Spool    (BIEHE02 )          Virtual printers          Ln     1 -     1
Sub LV31 Nje          RN          RG       RU          Col    1 to   53
-----------------------------------------------------------------------
Command ===>                                                           
                                                                       
Action    VPS name  Curr plu  File seqno  Records  Clu       Trace Plu 
          A31IVP06     

  • Type M in the action field next to the virtual printer then enter.


Spool    (BIEHE02 )          Virtual printers          Ln     1 -     1 /     1
Sub LV31 Nje          RN          RG       RU          Col    1 to   53 of   53
-------------------------------------------------------------------------------
Command ===>                                                                   
                                                                               
Action    VPS name  Curr plu  File seqno  Records  Clu       Trace Plu         
m         A31IVP06                                           


  • This allows you to tab over to the Trace field, type in *ALL, then enter which will start the vpstrace.


Spool    (BIEHE02 )          Virtual printers          Ln     1 -     1 /     1
Sub LV31 Nje          RN          RG       RU          Col    1 to   53 of   53
-------------------------------------------------------------------------------
Command ===>                                                                   
                                                                               
Action    VPS name  Curr plu  File seqno  Records  Clu       Trace Plu         
          A31IVP06                                           *ALL    


  • Once you have created your report file and the VPSTRACE file which is still open and highlighted, you would go back through all of the above actions and once you get to the modify screen where you see *ALL in the Trace field, tab over to the Trace field and blank out the *ALL characters then enter. This will close the VPSTRACE file and you will be able to browse, select or back up the file.


Spool    (BIEHE02 )          Virtual printers          Ln     1 -     1 /     1
Sub LV31 Nje          RN          RG       RU          Col    1 to   53 of   53
-------------------------------------------------------------------------------
Command ===>                                                                   
                                                                               
Action    VPS name  Curr plu  File seqno  Records  Clu       Trace Plu         
          A31IVP06