Troubleshooting
Problem
MSAR writes and MSAR commands are not responsive, and report a 236,0,1 error in IBM FileNet Image Services
Symptom
MSAR Writes are pending. Cannot run MSAR commands such as eject, Insert, etc.
The IS elog showed the following errors:
2010/01/12 11:39:19.524 236,0,1 <fnsw> dtp a 6 (12585.1.91 0x3129.1) ... [CRITICAL]
LSI_get_directory_from_surf_file macro: surf_file='010000.dat' has no slashes '/' Caller: FILE='../src/LSI.c' LINE=776
Diagnosing The Problem
Use MKF_tool to view what paths are set for the MSAR surfaces. This is the MSAR Surface Creation Directory that can be see in Configuration Editor (fn_edit) on the Storage Libraries Tab.
1. Start MKF_tool from the command line.
>MKF_tool
2. Use the select commands on lib_surfaces for some MSAR surfaces to see the path in surf_file.
<MKF_tool>se lib_surfaces * where surface_id=10000
surface_id..........10000 library.................0 unit_indicator..........2 unit_number.............6
name_length............11 disk_type..............21
surf_file............"010000.dat"
<MKF_tool>se lib_surfaces * where surface_id=10010
surface_id..........10010 library.................0 unit_indicator..........2 unit_number.............2
name_length............22 disk_type..............21
surf_file............"/msarstage/010010.dat"
<MKF_tool>se lib_surfaces * where surface_id=10024
surface_id..........10024 library.................0 unit_indicator..........2 unit_number............10
name_length............22 disk_type..............21
surf_file............"/msarstage/010024.dat"
3. For surface 10000, the path does not show the folder the surface is stored in.
Resolving The Problem
The location of the MSAR Surface needs to be corrected.
1. Stop IS software
>initfnsw -y stop
2. Startup just the MKF Databases.
>fn_util startdb
3. Start MKF_tool from a command line.
>MKF_tool
4. Use the allowupdates command in MKF_tool to enable the update command. If you do not have the current monthly password for MKF_tool, you can get it my contacting Support.
<MKF_tool> allowupdates
<password> (Enter the monthly password.)
>Updates now allowed
5. Modify the surf_file in the lib_surfaces table to have the full path name.
(Example: Change the surf_file to contain "/msarstage/010000.dat" )
<MKF_tool> update lib_surfaces * where surface_id=10000 set surf_file="/msarstage/010000.dat"
6. Verify the contents of surf_file looks correct.
<MKF_tool>se lib_surfaces * where surface_id=10000
surface_id..........10000 library.................0 unit_indicator..........2 unit_number.............6
name_length............11 disk_type..............21
surf_file............"/msarstage/010000.dat"
7. Exit MKF_tool.
<MKF_tool> quit
8. Stop the MKF Databases.
>fn_util stopdb
9. Restart Image Services.
>initfnsw start
10. Once Image Services has completed the start up, start DOC_tool.
>DOC_tool
11. Use the active command in DOC_tool a few times to verify the writes are being satisfied.
<DOC_tool> ac
<DOC_tool> ac
<DOC_tool> ac
12. Exit DOC_tool.
<DOC_tool> quit
Was this topic helpful?
Document Information
Modified date:
17 June 2018
UID
swg21417967