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

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

book

Article ID: 55549

calendar_today

Updated On:

Products

Deliver View

Issue/Introduction

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.

 

Environment

Release:
Component: CSPOOL

Resolution

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=<virtual printer name>. 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,<virtual printer name>.*ALL    This turns on the vpstrace 
TV,<virtual printer name>.*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 <virtual printer name> 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    (nnnnnnnn )          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    (nnnnnnnn )          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        
          <vitual printer name>    AAAA                           08,5A  CLOSE DISABLED
x         <vitual printer name>    BBBB      RPPTV      000              OPEN  ENABLED 
          <virual printer name>    CCCC    VPIPRT1      000              OPEN  ENABLED 
          <virtual printer name>   DDDD    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            
<vitual printer name>    

  • 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         <vitual printer name>                                           



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



Spool    (nnnnnnnn )          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                    
<vitual printer name>                                           *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    (nnnnnnnn )          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                    
<vitual printer name>