During a compile I receive message SYM014 PROTSYM OUT OF SPACE. How do I free space?

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

Question: 

When compiling and program for CA InterTest and loading the program  source code into the PROTSYM file I receive message SYM014 PROTSYM OUT OF SPACE. How do I quickly free space in the PROTSYM file?

Answer:

The PROTSYM file is the VSAM repository that stores the CA  InterTest source code. Sometimes the PROTSYM fills up during compile or assembly time and space needs to be freed. The CA InterTest for CICS batch utility program IN25UTIL is used to maintain the PROTSYM. This utility is outlined in the Testing and Fault Management Symbolic guide Chapter Maintaining a PROTSYM file.

Usually an out of space condition on the PROTSYM surfaces during normal business hours and many users are affected by this condition. To minimize the impact on the application programming staff we recommend you use the IN25UTIL PURGE= option to free space. This option does not require you to close the PROTSYM using the CICS CEMT command since the PROTSYM FCT is defined READ only to CICS.

In the example below the option PURGE=135 was used to remove programs from the PROTSYM file that we not compiled or assembled within 135 days. You can also use the DELETE= parameter to delete very large programs or programs flagged in UPDATE MODE. The default password is 12345678 and is required when using the PURGE or DELETE parameters.

In order to see how much space is available in a PROTSYM file you can execute the PROTSYM batch utility program IN25UTIL with the REPORT option. The JCL below was used to produce this report. This report lists all programs in the PROTSYM file. It also lists any files in UPDATE mode. In UPDATE mode programs will need to be deleted (DELETE=PGMNAME) in order for the user to recompile their program. 

//REPORT   EXEC PGM=IN25UTIL,REGION=4096K
//STEPLIB  DD DSN=INTERTEST.R91.CAVHLOAD,DISP=SHR
//MESSAGE  DD SYSOUT=*
//OUTPUT   DD SYSOUT=*,DCB=(RECFM=FBM,LRECL=121,BLKSIZE=2420)
//PROTSYM  DD DISP=SHR,DSN=INTERTEST.PROTSYM
//CARDS    DD *
PASSWORD=12345678
REPORT
//

UTIL001 REPORT
    CA-INTERTEST  - PROTSYM STATUS REPORT -
    SYSTEM REPORT: NUMBER OF AVAILABLE UNUSED RECORDS =       3651
                    NUMBER OF ACTIVE PROGRAMS          =         10
                    NUMBER OF USED RECORDS             =       1063
                    NUMBER OF RECORDS HELD BY UPDATES  =          0
                    LAST SUCCESSFUL UTILITY RUN        = 03/29/2007
     PROGRAMS ON FILE :
          NAME   LANG    DATE     TIME  DAYS-OLD  TOTAL-RECS  LISTER-#RECS
          CURRDATE  COLE 04/05/2007  13.42    612         25     ALL -   20
          WRITEREC  COLE 04/05/2007  15.55    612         55     ALL -   45
UTIL011 CA-INTERTEST BATCH UTILITY RUN COMPLETED

 

To free additional records in this PROTSYM file you can submit the JCL below to execute IN25UTIL using the PURGE=135 and REPORT options. Specifying these options will purge all programs that have not been compiled or assembled within 135 days, and generates a PROTSYM report so you can see how many programs were removed and records freed.

//REPORT   EXEC PGM=IN25UTIL,REGION=4096K
//STEPLIB  DD DSN=CA INTERTEST.CAILIB,DISP=SHR
//MESSAGE  DD SYSOUT=*
//OUTPUT   DD SYSOUT=*,DCB=(RECFM=FBM,LRECL=121,BLKSIZE=2420)
//PROTSYM  DD DISP=SHR,DSN=INTERTEST.R91.PROTSYM
//CARDS    DD *
PASSWORD=12345678
PURGE=135
REPORT
//

Additional Information: 

Please review related technical document TEC531436  

To maintain the PROTSYM file please reference the Release 9.1 CA Application Quality and Testing Tools Symbolic Guide