FAQ 1303: How to uncompress files in the Siebel File Server with

the original file names?

Last Modified:
Area(s):
Release(s):
Database(s):
App Server OS(s):
Latest release tested against:

10 October 2002
System Administration
V5 (Siebel 99-Enterprise), V6 (Siebel 2000-Enterprise)
DB2
All
V7 (Enterprise)

The Siebel File System stores all file attachments in a compressed format with a proprietary
naming convention. Neither Siebel InterActive nor the Fulcrum SearchServer can access or read
these files directly. If either of these modules is used, maintain a copy of all file attachments in an
uncompressed format in a separate directory accessible to SearchServer or Siebel InterActive.
Because the Siebel client also stores file attachments in a compressed format, Fulcrum cannot be
used for local searches on the client unless an uncompressed directory is also maintained there.
The utility program SSEMUZIP.EXE is provided on the Siebel Server in order to maintain this
uncompressed directory, however SSEMUZIP.EXE decompresses the document and appends the
Siebel name to the original document name. For example: When a file named "Timesheet.xls" is
added to the Siebel File System Siebel compresses the file and renames it to the Table Name,
Row Id and Revision Id and adds .SAF as the extension. Example: S_LIT_1-JH_1-3.SAF
Table Name = S_LIT, Row Id = 1-JH, Revision Id = 1-3
After SSEMUZIP.EXE uncompresses the file the name is modified and contains the Siebel
information. The sample becomes:
Timesheet_S_LIT_1-JH_1-3.xls
Environment
Applicable for both Windows and Solaris machines.
Workaround
This workaround involves writing SQL statements and is intended for advanced users. The results
from running the SQL statements will create statements that will use the SSEUNZIP.EXE to extract
the file. SSEUNZIP.EXE decompresses one file at a time and allows the file to be renamed. After
running the SQL statements the results will be copied to a batch file that will be run in DOS to
extract the files to the directory of choice with the original file names. The following SQL can be
used as a guide. Run separate SQL Statements for each table that contains documents. Here are
the values that may have to be modified:
Siebel Server directory: c:\siebsrvr

Siebel File System directory: c:\siebfile

Export directory: c:\lit
Table Name: S_LIT
MS SQL Server specific
SELECT 'c:\siebsrvr\bin\sseunzip.exe c:\siebfile\S_LIT_' + ROW_ID + '_' +
FILE_REV_NUM + '.SAF "c:\lit\' + FILE_NAME + '.' + FILE_EXT + '"' FROM
S_LIT WHERE FILE_NAME IS NOT NULL
Use MS Query Analyzer to run the SQL statements. Log in and change to the
Siebel database. Change the following settings:
Under the Query menu choose Current Connection Options
Check the "No count display" box, then open the Advanced Tab and Uncheck the
"Print headers" box. Apply
Oracle specific
SELECT 'c:\siebsrvr\bin\sseunzip.exe c:\siebfile\S_LIT_' || ROW_ID || '_' ||
FILE_REV_NUM || '.SAF "c:\lit\' || FILE_NAME || '.' || FILE_EXT || '"' FROM S_LIT
WHERE FILE_NAME IS NOT NULL;
Use SQL Plus to run the SQL statements. Log into the Siebel database instance
and change the following Options for the Environment: Buffer Width = 300,
Line Size = 300, Page Size = 50000, underline=<leave this blank>.
Next Steps
Copy the SQL statements from above and modify them for the environment. Run the statements.
The results should look like the following:
c:\siebsrvr\bin\sseunzip.exe c:\siebfile\S_LIT_00-1ACQ6_0-4L.SAF "c:\lit\Narrative Service Top 10
Most Serviced Products.doc"
c:\siebsrvr\bin\sseunzip.exe c:\siebfile\S_LIT_00-192ZO_0-VK.SAF "c:\lit\Product Line
Briefing.doc"
c:\siebsrvr\bin\sseunzip.exe c:\siebfile\S_LIT_0-AIXG_0-VL.SAF "c:\lit\Sales Pipeline Briefing.doc"
Now copy these statements into a text file and call it extract.bat. Make sure there is a carriage
return at the end of the file. Now run this batch file from MS DOS and it will decompress the Siebel
File System to the directory specified with the original file names.
NOTE: The batch file calls SSEUNZIP.EXE once for each file. This means that if there are 500
files in a particular table then SSEUNZIP.EXE is called 500 times. This process is slow, but it does
work. The results from running the SSEUNZIP.EXE will look like the following:

C:\>extract.bat
C:\> c:\siebsrvr\bin\sseunzip.exe c:\siebfile\S_LIT_00-192ZO_0-VK.SAF "c:\lit\Product Line
Briefing.doc"
Siebel Enterprise Applications SSEUNZIP, Version 5.5 [2427] ENU
Copyright (c) Siebel Systems, Inc. 1995-1998.
This software is the property of Siebel Systems, Inc., 1855 South Grant Street,
San Mateo, CA 94402-2667.
User warrants that any use of this software is governed by the terms and conditions of the Siebel
Systems Software License and Services Agreement which has been executed and with which the
user agrees to comply.
UNAUTHORIZED POSSESSION, DISCLOSURE OR USE OF THIS SOFTWARE OR THE
INFORMATION CONTAINED HEREIN IS PROHIBITED BY FEDERAL AND STATE LAW.
If you have received this software in error, please notify us by telephone immediately at (650) 2955000.
Unzipped 1 files.