VisualAge 도움말 시스템은 IBM 소프트웨어 제품에 대한 온라인 도움말 정보를 표시할 수 있게 해줍니다. F1 키를 누르거나 제품 중 하나의 사용자 인터페이스에서 도움말 메뉴 항목을 선택하면, 브라우저가 열리고 제품에 대한 도움말이 표시됩니다. 제품의 온라인 도움말을 시작하거나 사용하는 데 문제가 있는 경우에는 이 문서가 문제를 해결하는 데 도움이 될 수 있습니다.
VisualAge 도움말 시스템은 다음과 같은 세 가지 주 구성요소로 구성됩니다.
대부분의 경우, 세 가지 구성요소 모두 제품이 설치된 시스템에서 수행됩니다.
문제 해결을 시작하려면, 다음의 단계를 실행하십시오.
1.2 특수 고려사항의 요약을 읽은 다음, 나열된 절 중에서 제품 또는 환경에 적용되는 절을 읽으십시오.
다음 IBM 제품들은 2001년 2월 현재 VisualAge 도움말 시스템을 사용합니다.
2000년 11월 이후 릴리스된 IBM 소프트웨어 제품을 사용 중이고 위의 목록에 없을 경우, 명령 프롬프트에 다음과 같이 입력하여 해당 제품이 VisualAge 도움말 시스템을 사용하는지 여부를 판별할 수 있습니다.
vahcfg list /f %IMNINSTSRV% | more
Product:로 시작하는 행에서 제품의 이름을 조사하십시오. 제품이 목록에 표시되면, VisualAge 도움말 시스템을 사용하는 것입니다. 목록에 없거나 명령이 인식되지 않음을 나타내는 메시지가 나오면 IBM 지원 부서에 문의하여 사용 중인 IBM 제품이 VisualAge 도움말 시스템을 사용하는지 여부를 판별할 수 있습니다.
기술된 제품, 환경 또는 문제점이 사용자의 상황과 일치하는 경우, 다음 절을 읽으십시오.
제품의 도움말 메뉴에서, 도움말 홈 페이지(또는 제품의 해당 메뉴 항목)를 선택하십시오. 도움말 메뉴를 사용할 수 없을 경우, 제품의 사용자 인터페이스 중 한 분할영역 내에서 F1 키를 누르십시오. 다음 중 어떤 상황이 발생합니까?
도움말이 제대로 표시될 경우, 다음과 같은 잠재적인 기타 문제점이 있을 수 있습니다.
문제점이 위에 나열된 것 중 하나가 아닐 경우, IBM 서비스 담당자에게 문의하십시오. 자세한 정보는 http://www.ibm.com/software/ad/support를 참조하십시오.
참고: 이 절은 Component Broker 또는 WebSphere Business Components에는 적용되지 않습니다. Component Broker의 경우 doc\readme 디렉토리에 있는 도움말 문제 해결에 관한 정보를 참조하십시오.
VisualAge for Java, 버전 3.5에 아무런 반응이 없으며 데스크탑 아이콘을 사용하여 VisualAge for Java IDE를 실행한다면, 2.1 특수 경우 - VisualAge for Java, 버전 3.5를 참조하십시오.
도움말을 실행하려고 할 때 아무것도 발생하지 않는 경우, 첫번째 단계로 도움말을 명령행에서 시작할 수 있는지 여부를 판별해야 합니다. 이를 수행하려면, 먼저 제품이 설치된 디렉토리를 알아야 합니다. 이후의 텍스트에서 INSTALL_DIR이 나오면 제품이 설치된 실제 디렉토리로 대체해야 합니다(예: x:\ibmvjava 또는 "x:\Program Files\IBM\VisualAge for Java"). 경로에 공백이 들어 있으면 전체 경로(INSTALL_DIR 및 서브디렉토리 또는 파일 이름) 주위에 따옴표를 사용하십시오. 명령행에서 도움말을 시작하려면 다음 단계를 수행하십시오.
g: cd "\Program Files\IBM\VisualAge for Java"
dir /s /b vahelp.exe
다음과 같은 결과가 표시되면,
g:\Program Files\IBM\VisualAge for Java\eab\bin\vahelp.exe
다음과 같이 입력합니다.
cd eab\bin
도움말이 명령행에서 성공적으로 시작되고 도움말을 성공적으로 탐색할 수 있으면, 제품의 사용자 인터페이스에서 도움말 시스템 DLL에 연결하지 못하게 하는 경로를 설정한 방법에 관한 문제점이 있을 수도 있습니다. 2.1 특수 경우 - VisualAge for Java 3.5를 참조하거나, 다른 제품의 경우에는 제품을 설치 해제하고 재설치해 보십시오. 그러면 종종 이러한 문제가 해결됩니다.
해결책 또는 임시 수정으로 명령행에서 도움말 시작에 만족할 경우, 이를 수행하는 아이콘을 데스크탑에 작성할 수 있습니다. 11.0 제품 도움말을 실행시키는 아이콘 작성을 참조하십시오.
도움말이 명령행에서 로드되지 않거나 명령행에서 로드되지만 제품 내에서 로드되지 않을 경우, Windows 레지스트리 내에서 적절한 파일 연관이 브라우저에 대해 설정되지 않았기 때문일 것입니다. 16.0 Windows 레지스트리에 HTML 파일 연관 설정을 참조하십시오.
파일 연관을 변경해도 아무런 도움이 되지 않는다면, 다음을 시도하여 도움말 시스템으로부터 로그 파일을 확보할 수 있습니다.
TMP 환경 변수가 가리키는 디렉토리에, HTML*.C2T 유형을 갖는 하나 이상의 파일이 존재해야 합니다. 이들 파일에는 도움말 시스템에 수행된 요청에 관한 자세한 로그 정보가 들어 있습니다. 이들 파일을 IBM 서비스 담당자에게 전송하여 분석하게 할 수 있습니다. 요청을 지원하기 위한 요금을 지불해야 할 수도 있습니다. 또한 사용자 스스로 이들 파일을 조사하여 실패의 원인을 판별할 수 있는지 알아볼 수도 있습니다.
TEMP 디렉토리에 HTML*.C2T 파일이 없으면, 명령행에서 다시 도움말을 호출하십시오. HTML*.C2T 파일이 명령행에서만 작성된 경우, 문제점은 도움말을 호출하는 제품에 있습니다. 도움말을 호출하여도 로그 파일을 생성하지 않을 경우, 도움말 시스템 자체에 문제점이 있습니다. 두 경우 모두 IBM 서비스 담당자에게 문의할 수 있습니다.
도움말을 요청할 때마다 로그 기능이 불필요한 로그 파일을 생성하므로, 완료되면 제품 도움말 구성 파일에서 HTMLHELP_LOG=1 행을 반드시 제거하도록 하십시오.
어떠한 방법으로도 도움말을 여전히 시작할 수 없으면, 제품 도움말 구성 파일이 유효한지 확인하십시오. 편집기에서 INSTALL_DIR\HELP_DIR\CONFIG_FILE을 연 후 다음을 검증하십시오.
VisualAge for Java, 버전 3.5의 경우, IDE에서 도움말을 시작할 수 없지만 명령행에서 시작할 수 있으면, 잘못된 단축키로 IDE를 호출했을 수도 있습니다. 데스크탑 또는 시작 메뉴 내에서 IDE에 대한 단축키를 수동으로 작성하거나 편집한 다음 해당 단축키로 IDE를 호출했을 때 이러한 상황이 발생할 수도 있습니다. 또한 버전 3.0 또는 3.02에서 작성된 단축키를 사용해오다가, 해당 단축키를 사용하여 버전 3.5를 시작하려고 할 때 발생할 수도 있습니다. 문제점을 판별하려면 다음 단계를 수행하십시오.
시작 메뉴에서 IDE를 호출할 때 도움말이 작동하지만 아이콘이나 일반적으로 사용하는 단축키를 사용할 때 작동하지 않을 경우, 아마도 해당 아이콘이나 단축키가 VAJ_INSTALL_DIR\ide\program\ide.exe를 가리키고 있어서 PATH 환경 변수가 도움말 시스템 DLL을 가리키지 않으므로 IDE를 성공적으로 시작할 수는 있지만 도움말을 지원하지 못하게 됩니다. VAJ_INSTALL_DIR\ide\program\ivjenv.bat를 가리키도록 단축키의 Target 필드를 편집하여 이러한 문제점을 해결할 수 있습니다. 이 일괄처리 파일은 ID E내에서 도움말이 제대로 작동할 수 있도록 Windows 환경 변수를 변경합니다.
도움말을 실행할 때 브라우저를 열거나 포그라운드로 가져올 수 있지만, 브라우저가 localhost:49213에 연결할 수 없을 경우, 다음과 같은 세 가지 가능한 문제점이 있을 수 있습니다.
웹 서버 또는 브라우저의 잘못된 구성에서 가능한 문제점을 해결하려면 다음 하위 절을 각각 검사하십시오.
HTTPDL.EXE는 국지 액세스만을 지원하는 HTTP 서버 프로세스입니다. NetQuestion 구성요소의 일부이며, 로컬 브라우저에 도움말 페이지를 제공하는 데 사용됩니다. HTTPDL.EXE 프로세스가 타스크 목록에 표시되는지 검사하십시오.
타스크가 없으면, 도움말 시스템이 타스크를 시작할 수 없었을 수도 있습니다. 오류 메시지를 리턴하는지 보려면 먼저 명령행에서 호출을 시도하십시오.
NetQuestion이 설치된 디렉토리로 변경하십시오(15.0 NetQuestion 설치 디렉토리 찾기 참조).
소켓 바인딩 실패 오류를 리턴할 경우, HTTPDL.EXE 프로세스가 이미 49213 포트(HTTPDL.EXE 프로세스가 사용하는 TCP/IP 포트)에서 실행 중인 것입니다. 그밖의 오류를 리턴할 경우, IBM 서비스 담당자에게 문의하십시오. 오류를 리턴하지 않을 경우, 타스크 목록을 점검하여 백그라운드로 실행 중인지 확인하십시오. 2000년 02월 12일 이전의 HTTPDL.EXE는 오류를 발견하지 않은 경우 명령 프롬프트를 잠급니다. 이후의 버전은 명령 프롬프트를 잠그지 않고 계속 실행됩니다. 사용자의 버전이 명령 프롬프트를 잠글 경우, Ctrl+Break 키를 누른 후 다음 명령을 실행하여 프로세스를 분리된 프로세스로 시작하십시오.
nqdetach httpdl.exe -r httpd.cnf
이제 브라우저에서 페이지를 재로드하십시오. 페이지가 제대로 표시될 경우, 도움말 시스템이 HTTP 서버를 시작하는 데 문제가 있는 것입니다(또는 Component Broker의 경우, 서버를 로그온시 시작되도록 설정하지 않은 것입니다.) 13.0 NetQuestion 서버 자동 시작을 참조하십시오.
페이지가 여전히 표시되지 않는다면 3.2 HTTPDL.EXE 구성 오류 및 3.3 브라우저에 프록시 대체 필요를 참조하십시오.
경우에 따라 HTTPDL.EXE에서 사용하는, 구성 파일 httpd.cnf가 잘못된 경로 정보를 포함할 수도 있습니다. 제대로 구성되었는지 검증하려면 다음 단계를 수행하십시오.
Serverroot C:\IMNNQ_NT Exec /cgi-bin/* C:\IMNNQ_NT\* Pass /icons/* C:\IMNNQ_NT\* Pass /* C:\IMNNQ_NT\*
표시된 경로가 httpd.cnf 파일이 저장된 디렉토리에 대응하는지 확인하십시오. 그렇지 않으면, 발생하는 모든 항목이 실제 경로를 반영하도록 변경하십시오.
Hostname localhost Port 49213
기존 Hostname 또는 Port 행이 위와 다를 경우 대체하십시오.
브라우저가 프록시 서버를 통해 localhost라는 이름의 시스템을 찾으려고 하기 때문에 때때로 로컬 웹 서버 HTTPDL.EXE에 연결할 수 없습니다. 이와 같은 상황은 일반적으로 브라우저에 수동 또는 자동 프록시 구성이 설정될 때 발생합니다. 수동 프록시 구성을 사용할 경우, 브라우저가 프록시 서버를 통해 localhost를 찾지 않도록 브라우저 설정을 수정할 수 있습니다. 자동 프록시 구성을 사용할 경우, 자동 프록시 구성 파일의 소유자에게 프록시 서버에서 127.0.0.1을 프록시 예외로 추가하도록 요구해야 합니다.
브라우저에 수동 프록시 구성이 설정되었는지 확인하고, 해당할 경우 프록시 재정의를 추가하려면 다음 단계를 수행하십시오. 이러한 지침은 표시된 브라우저 버전에 적용됩니다. 다른 브라우저 버전을 사용 중인 경우, 단계가 다를 수도 있습니다.
Netscape 4.7의 경우:
Internet Explorer 5.0의 경우:
또한 파일이 존재하지만 해당 행이 아직 없는 경우에는 다음 행을 추가하여 %SystemRoot%\system32\drivers\etc\hosts 파일을 갱신해야 합니다.
127.0.0.1 localhost
이 값을 변경했으면 브라우저를 종료한 후 재시작하여 변경사항이 유효하게 해야 합니다.
브라우저 구성 또는 ...\etc\hosts 파일을 변경했으면, 브라우저에서 도움말 홈 페이지를 재로드하십시오. locahost:49213에 연결하려고 할 때 여전히 오류가 표시되면, IBM 서비스 담당자에게 문의하십시오.
도움말을 보려고 할 때 자동 프록시 서버에 액세스할 수 없는 경우, 브라우저가 로컬 주소 127.0.0.1에 대한 localhost를 찾을 수 없을 수도 있습니다. 위의 단계 4(Netscape) 또는 단계 3(Internet Explorer)에서 인터넷에 직접 연결하도록 변경하여 이러한 문제점을 일시적으로 해결할 수 있습니다(프록시 서버를 사용할 수는 없지만).
도움말을 보려고 하거나 탐색하려고 할 때 파일을 찾을 수 없음 오류가 표시되면, 파일이 NetQuestion 설치 디렉토리에 누락된 것입니다. 자세히 알려면 다음 절을 읽으십시오.
도움말을 보려고 할 때 파일을 찾을 수 없음 오류가 표시되면, vahwebx.exe 파일이 NetQuestion 설치 디렉토리에 없는 것입니다. 명령 프롬프트 또는 Windows 탐색기에서 디렉토리를 검사하여 파일이 있는지 확인하십시오. 파일이 있다면, 아마도 NetQuestion 로컬 웹 서버 구성의 문제점입니다. httpd.cnf가 틀린 디렉토리를 가리킬 수도 있습니다. 위의 3.2 HTTPDL.EXE 구성 오류를 참조하십시오. vahwebx.exe 파일이 없으면, 다음 중 하나 이상을 시도할 수 있습니다.
브라우저 페이지를 재로드하십시오. 도움말이 작동할 경우, 문제점이 해결된 것입니다. 파일을 찾을 수 없음 오류가 계속 표시되면, IBM 서비스 담당자에게 문의하십시오. xxxxx 제품에 등록된 도움말이 없음 메시지가 나오면 6.0 도움말 재구성을 참조하십시오.
도움말을 탐색하려고 할 때 파일을 찾을 수 없음 오류가 표시되면, 탐색 양식에 지정된 탐색 프로그램이 올바른 위치에 설치되지 않았을 수도 있습니다. 이름과 위치를 판별하려면 다음 단계를 수행하십시오.
<form action="http://localhost:49213/cgi-bin/ivjsenus.exe"...> <form action="http://localhost:49213/cgi-bin/va4sall.exe"...>
탐색 프로그램의 이름은 "cgi-bin" 뒤에 있는 action= 속성 부분입니다(즉, 위의 예에서 ivjsenus.exe 또는 va4sall.exe).
또한 탐색 결과 페이지의 이미지가 깨지거나, 탐색 양식 머리글을 찾을 수 없음 또는 탐색 양식 바닥글을 찾을 수 없음 메시지가 표시될 수도 있습니다. 이들 오류는 NetQuestion 설치 디렉토리에 다른 파일이 누락될 때 발생합니다. 제품 CD에서 파일을 찾을 수도 있으며, 또는 IBM 서비스 담당자로부터 확보할 수도 있습니다. 파일 이름은 모두 탐색 양식 내부에 지정됩니다. 탐색 양식 소스를 보고 이름을 판별할 수 있습니다. 다음과 같은 숨김 입력 필드의 value= 매개변수를 조사하십시오.
<input type="hidden" name="header" value="ivjhenus.htm"> <input type="hidden" name="footer" value="ivjfoot.htm"> <input type="hidden" name="stars1" value="ivjstar1.gif"> <input type="hidden" name="stars2" value="ivjstar2.gif"> <input type="hidden" name="stars3" value="ivjstar3.gif"> <input type="hidden" name="stars4" value="ivjstar4.gif"> <input type="hidden" name="stars5" value="ivjstar5.gif">
강조표시된 항목은 VisualAge for Java용 항목입니다. 다른 제품에 대한 동일한 항목이 들어 있으며, ivj가 다음과 같이 대체됩니다.
내부 서버 오류 메시지는 일반적으로 웹 서버에서 실행 중인 응용프로그램이 손상되었음을 표시합니다. 또한 program.exe - 응용프로그램 오류라는 제목의 Windows 대화 상자와 "0xnnnnnnnn"의 명령어가 "0xnnnnnnnn"의 메모리를 참조하였음으로 시작하는 메시지가 표시될 수도 있습니다. 확인을 선택하면 해당 대화 상자가 사라지고 브라우저가 내부 서버 오류 메시지를 표시합니다.
이 오류가 탐색 작동시 발생할 경우, 제품 탐색 색인에 문제점이 있을 수도 있습니다. 제품에 대하여 도움말 재구성을 시도한 다음, 탐색 조회를 다시 입력하십시오. 문제점이 해결되지 않으면, IBM 서비스 담당자에게 문의하십시오.
이러한 오류가 도움말을 정상적으로 검색 중일 때 발생할 경우, NTFS 파일 시스템에서 디렉토리 접근 허용에 문제점이 있을 수도 있습니다. Windows NT 또는 Windows 2000 시스템을 로그오프하고, 관리자로 다시 로그온한 다음, NetQuestion 설치 디렉토리와 제품 도움말 디렉토리(제품에 따라 _INSTALL_DIR\doc 또는 INSTALL_DIR\help)에 있는 모든 파일과 폴더의 보안 허용이 Everyone - Full Control로 설정되었는지 확인하십시오. 이를 수행하려면,
권한을 변경한 경우, 대화 상자를 닫은 후 페이지를 재로드하십시오. 권한을 변경하지 않았거나 변경한 후 오류가 계속될 경우, NetQuestion 설치 디렉토리에서 vahelp.cfg 파일을 지운 다음 제품에 대하여 도움말 재구성을 수행하십시오.
내부 서버 오류 메시지가 계속 표시될 경우, IBM 서비스 담당자에게 문의하십시오.
어떤 경우에는 도움말 시스템이 특정 제품에 대하여 도움말을 잘못 구성했거나, 설치를 수정하려고 할 때 사용자가 일부 구성 정보를 제거해야 할 수도 있습니다. 아래의 지시사항을 수행하여 제품의 도움말을 재구성할 수 있습니다. 시작하기 전에, 다음에 대해 알아야 합니다.
이 프로세스의 첫번째 부분에는 도움말이 이미 구성되었으며, 갱신하기만 하면 되는지 여부에 대한 판별이 포함됩니다. 제품에 대한 도움말이 구성되었는지 여부를 판별하려면, 명령 프롬프트에서 다음을 입력하십시오.
vahcfg list /f %IMNINSTSRV% | more
도움말이 구성된 각각의 제품에 대해 일련의 제품과 구성요소 목록이 표시되어야 합니다. 디렉토리가 제품 디렉토리와 일치하는 제품이 있을 경우, 제품의 이름에 주의하십시오. 예를 들어, vahcfg list의 출력이 다음을 포함할 경우
Product: va400 (IBM WebSphere Development Tools for AS/400 Help System) Writable directory: C:\Program Files\IBM\WDT400\help No update files for this product Comp: qadtswin (WebSphere Development Tools for AS/400) Zip file: C:\Program Files\IBM\WDT400\help\qadtswin.zip Index: va45uadt ...
제품 이름은 va400입니다. 제품에 대한 항목이 표시되면, vahcfg regen 명령을 사용하여 도움말을 재구성할 수 있습니다. 제품에 대한 항목이 표시되지 않으면, vahcfg install 명령을 사용하여 도움말을 재구성해야 합니다. 두 가지 경우를 이 절의 뒷부분에서 설명합니다.
vahcfg regen 또는 vahcfg install을 실행하기에 앞서, 문서 디렉토리가 위치한 디스크에 제품 도움말에 대한 탐색 색인을 저장할 충분한 여유 공간이 있는지 또한 확인해야 합니다. 이들 색인은 문서 디렉토리의 *.zip 파일에서 추출되어, vahcfg 프로그램에 의해 문서 디렉토리의 서브디렉토리에 기록됩니다. 일반 규칙으로, 적어도 디스크에 있는 여유 공간의 양이 문서 디렉토리의 zip 파일에서 사용하는 공간의 양과 같아야 합니다.
vahcfg regen을 실행하려면, 다음 명령을 발행하십시오.
vahcfg regen /p prodname /f %IMNINSTSRV%
여기서 prodname은 vahcfg list를 실행할 때 지정한 제품 이름과 일치합니다.
vahcfg install을 실행하려면, 다음 명령을 발행하십시오.
vahcfg install /w docdir /f %IMNINSTSRV%
여기서 docdir은 제품 도움말 파일을 포함하는 디렉토리에 대한 전체 경로입니다. 해당 디렉토리에 공백이 포함될 경우(예: c:\Program Files\IBM\...), 전체 디렉토리 경로를 따옴표로 묶으십시오.
설치 또는 재생성을 수행하였으면(약간의 시간이 걸릴 수도 있음), 도움말을 재로드하십시오. 정정하고자 하는 문제점이 계속될 경우, 6.5 vahcfg regen 또는 vahcfg install로부터 로그 파일 확보의 단계를 따르고, IBM 지원 담당자에게 문의하고, 로그 파일을 IBM 지원 담당자에게 보내십시오.
vahcfg regen 또는 vahcfg install을 사용하여 제품에 대한 도움말을 재생성하거나 설치하려고 시도하고 이러한 시도로 도움말 문제점이 해결되지 않은 경우, 다음을 시도하여 IBM 서비스 담당자가 문제점을 자세히 진단하는 데 사용할 수 있는 로그 파일을 생성하십시오.
그런 다음, 생성된 로그 파일을 IBM 서비스 담당자에게 제공할 수 있습니다.
vahcfg의 일부 이전 버전에서는 로그 파일을 생성하지 않습니다. 로그 기능을 지원하지 않는 버전은 모든 출력을 화면에 인쇄합니다. 로그 기능을 지원하는 버전은 정보가 로그되는 위치를 표시하는 메시지를 인쇄합니다.
NetQuestion 탐색 시스템은 거의 가장 일반적인 탐색 조회에 일치하는 것을 찾을 때 가장 빠릅니다. 문자열 a*에 일치하는 항목을 탐색할 경우, 탐색 시스템은 문자 a로 시작하는 적어도 한 단어를 포함하는 모든 문서를 찾아야 하므로, 시간이 더 오래 걸립니다. 그러나 특수한 것을 탐색하는 경우, 길어도 수 초 내에 탐색 결과를 얻을 수 있습니다. 탐색이 너무 길어지면(예를 들어, 1분을 초과할 경우), Windows 2000 시스템에서 Netscape Navigator 4.5 이상을 사용할 때 문제점이 발생할 수도 있습니다.(이러한 문제점은 일부 Windows NT 시스템에서도 또한 발생합니다.)
일부 Windows 2000 시스템의 Netscape(버전 4.5에서 4.74 및 그외 가능한 것)에는 온라인 도움말 탐색 속도를 매우 느리게 만들 수 있는, 알려진 문제점이 있습니다. 이러한 Netscape 버전에서 양식을 제출할 경우, Netscape 응용프로그램은 원격 시스템에서 응답을 받을 때까지 시스템에 있는 대부분의 사용할 수 있는 프로세서 주기를 사용합니다.(이러한 탐색을 수행하는 동안 Windows 작업 관리자를 열고, 프로세스 탭으로 전환한 다음, CPU 열머리글 클릭하여 이를 확인할 수 있습니다. 여기에 기술된 문제점이 발생할 경우, netscape.exe가 목록 맨 위에 표시되며 CPU 시간의 97-99%를 사용하게 됩니다.)
이러한 CPU 사용은 원격 탐색을 수행할 경우(예를 들어, 웹 사이트에서) 일반적으로 문제가 되지 않습니다. 그러나 제품의 탐색 프로그램이 사용자의 로컬 시스템에서 실행 중이므로, Netscape가 이토록 많은 CPU 시간을 사용한다는 사실은 탐색을 수행하는 탐색 프로그램에 할당되는 CPU 시간이 매우 적어진다는 것을 의미합니다. 따라서 1초 이내에 결과를 리턴해야 할 탐색 조치가 Windows 2000에서는 몇 분이 걸리게 될 수도 있습니다.
매번 탐색을 제출한 후에 Netscape가 아닌 다른 창을 선택하여 Windows 2000의 이러한 성능 문제점을 방지할 수 있습니다. 이 방법은 일반적으로 Netscape가 응답을 대기하는 동안 CPU 주기를 초과해서 사용하지 못하게 하며, 이러한 창 전환을 수행한 후 일반적으로 1초 이내에 탐색 결과를 표시합니다. 일관성이 떨어지기는 하지만 동일한 기술이 Windows NT에서도 작동합니다.
또다른 방법으로 Microsoft Internet Explorer를 사용하여 도움말을 볼 수 있으며, 성능 문제점은 이 브라우저에서는 발생하지 않습니다.
브라우저에서 도움말 시스템 탐색을 수행할 때 다음과 같은 오류 메시지 중 하나가 표시될 수도 있습니다.
이러한 메시지는 다음과 같은 두 가지 상황에서 표시될 수 있습니다.
리턴 코드 73은 일반적으로 완전히 빈 탐색 요청에서는 리턴되지 않으며, 종료어로만 이루어진 탐색 요청에서 리턴됩니다. 탐색 문자열이 완전히 비어 있지 않을 때(또한 종료어로만 이루어진 탐색이 아닐 때) 빈 탐색 요청임을 나타내는 메시지가 표시될 경우, 탐색 양식이 손상되었을 수도 있습니다. 탐색 양식 hgssrch.htm 및 hgcsrch.htm을 제품 도움말 디렉토리(일반적으로, INSTALL_DIR\doc 또는 INSTALL_DIR\help)에서 찾아서 IBM 서비스 담당자에게 이를 제공하십시오.
탐색을 시도할 때 그 밖의 기타 오류 메시지가 표시될 수도 있습니다. 오류가 다음 중 하나일 경우, IBM 서비스 담당자에게 문의하기 전에 권장된 조치를 수행하십시오.
원인: 도움말 클라이언트가 탐색 서비스를 시작할 수 없습니다.(또는 Component Broker의 경우, 탐색 서비스가 로그온시 자동으로 시작되도록 설정되어 있지 않습니다.) 이러한 상황은 로컬 시스템(http://localhost:49213) 또는 원격 도움말 서버에서 탐색 중인지 관계없이 발생할 수 있습니다.
권장 조치(로컬 도움말):
3.1 HTTPDL.EXE가 실행 중이 아님(특히, autostart 레지스트리 항목 가져오기에 관한 절을 참조하여 로그온시 탐색 서비스가 자동으로 시작되게 하십시오. 빠른 해결책으로, 명령 프롬프트를 열어서 다음과 같이 입력할 수 있습니다.
imnss start server이 명령이 다음과 같은 행을 포함하는 메시지를 리턴할 경우,
The search service has been started.rc=33 오류 없이 탐색을 다시 수행할 수 있습니다.
권장 조치(원격 제공 도움말):
시스템을 재부트한 후 현재 아무도 시스템에 로그온하지 않았기 때문에 서버 시스템의 NetQuestion 탐색 프로세스가 실행되고 있지 않을 수도 있습니다. 14.0 부팅시 NetQuestion 탐색 서비스 시작을 참조하십시오.
원인: 탐색 프로그램이 탐색 요청에서 유효한 색인 이름을 확보하지 못했습니다. 탐색 양식이 손상되었거나, 지정한 색인이 등록되지 않았거나, NetQuestion 설치에 문제점이 있을 수도 있습니다.
권장 조치: 먼저, 제품 도움말 디렉토리(INSTALL_DIR\doc 또는 INSTALL_DIR\help)에서 모든 hg*.htm 파일을 삭제하십시오. 그런 다음 제품에 대한 도움말 재구성을 시도하십시오. 문제점이 계속될 경우, NetQuestion 재설치를 수행한 후 다시 제품에 대한 도움말을 재구성해야 할 수도 있습니다.
원인: 탐색 양식이 존재하지 않는 탐색 양식 머리글 또는 바닥글(탐색 결과 위 또는 아래에 놓일 HTML 부분을 포함하는 파일)을 지정하였습니다.
권장 조치: 자세한 정보는 4.2 탐색 시도시 파일을 찾을 수 없음 오류를 참조하십시오.
원인: 너무 많은 단어가 일치하는 탐색 조회를 입력하였습니다. 탐색 엔진은 1024개를 넘는 서로 다른 단어가 일치하는 조회를 처리할 수 없습니다. 예를 들어, 탐색 문자열 "a* b* c* d*"(따옴표를 사용하지 않고)를 입력한 경우, 문자 a, b, c 또는 d 중 하나로 시작하는 단어를 포함하는 모든 문서를 요청하는 것입니다. 너무 많은 단어가 이러한 탐색 기준에 일치하기 때문에, 탐색 엔진이 의미있는 정렬된 탐색 일치사항의 목록을 생성할 수 없으며 따라서 탐색을 시도하지 않습니다.
권장 조치: 보다 적은 단어가 일치하는 탐색 요청을 입력하십시오.
원인: 논리적으로 유효하지 않은 탐색 조회를 입력했습니다. 예를 들어, 탐색 조회 "-java"(java라는 단어를 포함하지 않는 모든 문서 표시)는 유효하지 않습니다.
권장 조치: 적어도 하나의 위반되지 않는 조건을 포함하는 탐색 요청을 입력하십시오.
원인: 탐색 프로그램이 성공적인 탐색 작동에 필요한 환경 변수를 읽을 수 없는 경우 이러한 오류가 발생할 수 있습니다. NetQuestion의 HTTPDL.EXE 웹 서버가 아닌 웹 서버에서 실행되도록 도움말을 구성한 경우, 특정 환경 변수를 탐색 CGI(탐색 양식 내의 <form> 태그의 "action=" 매개변수에서 호출되는 프로그램)에서 볼 수 있도록 웹 서버 설정을 변경해야 할 수도 있습니다. 일부 웹 서버에서, 시스템 환경 변수는 기본적으로 숨겨져 있습니다. 탐색 CGI가 액세스해야 하는 변수는 IMNINSTSRV 및 IMNINST입니다. Netscape 엔터프라이즈 서버는 기본적으로 환경 변수를 숨기는 웹 서버의 일례입니다.
권장 조치: 해당 환경 변수를 웹 서버 CGI 응용프로그램에 수동으로 내보내거나, 모든 로컬 환경 변수를 CGI에서 볼 수 있도록 웹 서버 설정을 수정하십시오. 이를 수행하려면 Netscape 엔터프라이즈 서버에서 다음 단계를 따르십시오.
set imn
시스템이 다음을 IMNINST 및 IMNINSTSRV 변수에 대한 설정값을 리턴합니다.
IMNINST=help IMNINSTSRV=C:\IMNNQ_NT
Init fn="init-cgi" IMNINSTSRV=c:/imnnq_nt Init fn="init-cgi" IMNINST=help
"경고: 구성 파일을 수동으로 편집하였습니다. 이 단추를 사용하여 최신 구성 파일을 로드하십시오."
구성 파일 로드를 클릭하십시오.
그밖의 웹 서버의 경우, CGI 응용프로그램이 환경 변수를 볼 수 있게 작성하는 데 관한 정보는 웹 서버 문서를 참조하십시오.
원인: rc=32 오류 또는 NETQ.CFG 파일을 언급하는 오류는 NetQuestion이 제품 색인을 제대로 액세스할 수 없을 때 발생합니다. NetQuestion 설치 또는 특정 색인이 손상되었기 때문에 발생하거나, 재부트 후 주어진 색인에 관하여 처음으로 탐색을 수행할 때 발생할 수 있습니다. 이러한 오류의 몇 가지 양식에 대한 메시지가 NETQ.CFG 파일을 언급하지만, 이 파일은 실제로 존재하지 않습니다. 오류는 다른 NetQuestion 색인 구성 파일의 문제점을 의미합니다.
권장 조치: 문제점의 가능한 원인을 판별하고 아래에 설명된 대로 수정하십시오.
탐색시 rc=76 오류 메시지가 리턴될 경우, 하나 이상의 탐색 색인을 재설정해야 할 수도 있습니다. 색인을 재설정하려면 다음 단계를 수행하십시오.
일부 상황에서 도움말을 제대로 작동하게 하는 유일한 방법은 NetQuestion을 설치 해제했다가 재설치한 다음, VisualAge 도움말 시스템을 사용하는 제품에 대하여 도움말을 재구성하는 것입니다. NetQuestion을 설치 해제하면 VisualAge 도움말 시스템을 사용하지 않는 IBM DB2와 같은, 제품에서 사용하는 탐색 색인이 제거되어 NetQuestion 재설치 후 해당 제품에 대한 도움말을 탐색하지 못하게 될 수도 있습니다. 탐색 색인을 복원하려면 미심쩍은 제품을 재설치해야 합니다.
다음에 나오는 지침에 있는 모든 명령을 명령 프롬프트로부터 발행하십시오. 시작하기 전에, NetQuestion 설치 디렉토리를 판별해야 합니다.
NetQuestion 디렉토리에 있는 NetQuestion 설치 해제 프로그램인, uninstnq.exe는 색인이 등록되지 않은 경우에만 NetQuestion을 제거합니다. 각각의 해당 제품에 대하여 vahcfg remove 명령을 발행하여 IBM VisualAge 도움말 시스템을 사용하는 제품에서 등록한 모든 색인을 제거할 수 있습니다. 다음 단계를 수행하십시오.
모든 제품을 제거한 후 다음 명령을 입력하여 다른 제품에 대한 색인이 아직 등록되어 있는지 검사할 수 있습니다.
imnixlst
결과 목록이 DB2, CXX 또는 VAC로 시작하는 항목을 포함할 경우, VisualAge 도움말 시스템을 사용하지 않는 DB2, IBM C 및 C++ 컴파일러 또는 VisualAge C++ 4.0과 같은 제품에 색인을 등록했을 수도 있습니다. NetQuestion 수동 설치 해제를 계속할 경우, 이들 색인이 손실되며 해당 제품의 도움말을 다시 탐색할 때 각각의 제품을 재설치해야 합니다. 색인이 계속 나열되고 해당 제품에 대한 탐색 기능을 사용하지 않거나 해당 제품을 재설치하고자 할 경우, 다음과 같이 나머지 색인을 삭제하십시오.
이름이 IVJ3, VJ32, IWZ 또는 VA45로 시작하는 색인이 나열된 경우, vahcfg install을 사용하여 나중에 복원할 수 있으므로 이들을 삭제하는 것이 안전합니다.
NetQuestion 오류로 인하여 나머지 색인을 모두 삭제할 수 없는 경우, NetQuestion을 수동으로 제거해야 합니다(아래 11.4 절 참조).
uninstnq 명령을 발행한 후 NetQuestion 디렉토리가 거의 빌 때까지 잠시 기다리십시오. 디렉토리에 imn* 또는 imq*로 시작하는 파일이 없어야 합니다. 완료되려면 최대 10분까지 기다려야 할 수도 있습니다. 10분 후 디렉토리에 아직 imn* 또는 imq* 파일이 들어 있으면, 탐색 서비스에 아직도 색인이 등록되어 있거나(11.2 절로 돌려보내야 하는 경우) NetQuestion 설치가 손상되었을 수도 있습니다(11.4 절 계속 수행). 그렇지 않은 경우, 재부트한 후 11.5 절로 이동하십시오.
uninstnq.exe를 사용하여 NetQuestion을 제거할 수 없는 경우, 다음과 같이 수동으로 제거할 수 있습니다.
환경 변수를 변경하거나 제거하려면, 다음 플랫폼 특정 단계를 수행하십시오.
NetQuestion을 재설치하려면, 제품 CD를 준비하거나 IBM 서비스 담당자로부터 NetQuestion 설치 zip 파일을 구해야 합니다. 다음의 제품에는 제품 CD에 NetQuestion의 설치 가능 사본이 있습니다.
그밖의 제품의 경우, ntq_sbcs.iss라는 파일을 탐색하여 CD에 NetQuestion의 설치 가능 사본이 있는지 여부를 판별할 수 있습니다. 이 파일을 포함하는 디렉토리에 NetQuestion 설치를 시작할 수 있는 setup.exe 파일이 있어야 합니다.
IBM에서 설치 zip 파일을 구한 경우, 임시 디렉토리에 압축을 푸십시오.
NetQuestion의 설치 가능 사본을 확보했으면, 다음 단계를 수행하십시오.
도움말 시스템에서 수동으로 제거(11.1 절에서 지시된 대로 vahcfg remove를 사용하여)한 각 제품에 대해 6.0 도움말 재구성에서 설명된 대로 vahcfg install을 실행하십시오. 이제 제품 도움말을 찾아보고 탐색할 수 있습니다. 오류가 계속되면, 이 문서의 다른 절에서 가능한 해결책을 검사하거나 IBM 서비스 담당자에게 문의하십시오.
제품 사용자 인터페이스내에서 도움말을 실행할 수 없는 경우, 아이콘을 두 번 클릭하여 도움말을 실행 아이콘을 작성할 수 있습니다(문제점을 해결하는 동안 적어도 한 번 사용할 수 있도록).
주
다음과 같이 제품 도움말을 실행할 단축키를 작성할 수 있습니다.
instance "INSTALL_DIR\DOC_DIR\CONFIG_FILE" open index.htm
여기서 INSTALL_DIR은 제품이 설치된 디렉토리이고, DOC_DIR은 보통 doc 또는 도움말이며, CONFIG_FILE은 제품 도움말 구성 파일의 이름입니다(VisualAge for Java용 ivjhlp.cfg의 경우에는, 2.0 도움말 시작시 아무 반응이 없음에서 기타 제품의 디렉토리 및 구성 파일 이름 결정에 대한 정보를 참조하십시오). 해당 경로에 공백이 들어 있을 경우 구성 파일에 대한 전체 경로를 따옴표로 묶으십시오.
아이콘을 오른쪽 마우스 단추로 클릭하고, ...\Profiles\All Users\Start Menu 아래 Windows 설치 디렉토리에서 아래로 이동한 Windows 탐색기의 팝업 메뉴에서 복사를 선택한 다음 아이콘을 해당 디렉토리 또는 적절한 서브디렉토리로 붙여넣어서 시작 메뉴에 작성한 아이콘을 추가할 수 있습니다.
조직의 다른 구성원이 워크스테이션에 설치된 NetQuestion 및 도움말 시스템 코드를 사용하지 않고 네트워크를 통해 온라인 도움말을 보고 탐색할 수 있도록, Windows NT 또는 Windows 2000 웹 서버에 도움말 시스템을 설치 및 구성할 수 있습니다.
제품 참고사항
이러한 네트워크 설치를 수행하려면, Microsoft PWS(Peer Web Services) 또는 Microsoft IIS와 같은 웹 서버 소프트웨어가 서버에 설치되어 있어야 합니다. 웹 서버에는 스크립트 디렉토리가 있습니다.(PWS 및 IIS에서, 스크립트 디렉토리는 일반적으로 x:\inetpub 아래에 있습니다.) 서버 소프트웨어를 설치한 후, 다음 단계를 완료하십시오.
vahwebx.exe vahwebx.cat vahelp.cfg *foot.htm *head.htm *henus.htm
처음 세 개의 파일은 필수입니다. 후속 파일은 존재할 경우 복사해야 하지만, NetQuestion 디렉토리에서 누락된 경우 x:\inetpub\scripts 디렉토리에 필요하지 않습니다.
HTML_HOSTNAME=server.city.domain.organization CGI_BIN_DIR=scripts START_LITE_DAEMON=0 START_NETQ_DAEMON=0
이제 사용자는 F1 키를 누르거나 IBM 응용프로그램 내에서 도움말 메뉴 항목을 선택하여 서버 기반 도움말을 간단히 액세스할 수 있습니다. 또는 다음 URL을 사용하여 도움말을 액세스할 수 있습니다.
http://YourHostname/scripts/vahwebx.exe/help/prodname/Extract/0/index.htm
여기서, prodname은 다음과 같습니다.
나중에 서버 시스템에서 vahcfg install 또는 vahcfg regen을 실행할 경우, 위의 단계 3에서 맵핑 파일을 다시 편집해야 합니다.
사용자가 제품 도움말 구성 파일이 서버를 가리키도록 수정했으면, 다음 명령을 안전하게 실행하여 제품 도움말 디렉토리에서 모든 *.toc, *.htm 및 *.zip 파일과 탐색 색인 파일을 삭제할 수 있습니다.
vahcfg remove /p prodname /f %IMNINSTSRV%
또는 간단히 *.toc, *.htm 및 *.zip 파일을 수동으로 삭제할 수도 있습니다. 그러나, 이 방법은 제품 도움말 디렉토리 아래에 있는 색인 디렉토리를 삭제하지 않으므로, 이들 또한 수동으로 삭제해야 합니다.
네트워크로 연결된 도움말 구성에서 서버를 구성하고 있다면, 이 절 대신 14.0 부트시 NetQuestion 탐색 서버 시작을 참조하십시오.
시스템에 두 개의 레지스트리 항목을 설정하여 로그온시 자동으로 시작하도록 HTTP 및 탐색 서버를 설정할 수 있습니다. 이들 항목을 설정하려면, 다음 단계를 수행하십시오.
REGEDIT4 [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run] "IMNNQ"="nqdetach.exe imnss.exe start server" "IMNNQ NetQ Web Server"="nqdetach.exe httpdl.exe -r %IMNINSTSRV%\\httpd.cnf"
다음 번에 로그온할 때(또는 Windows 95 또는 Windows 98에서 재부트할 때) 서버가 자동으로 시작될 수 있도록 두 개의 항목을 가져옵니다.
도움말이 자체 시스템에서가 아닌 서버에서 제공되는 네트워크화된 도움말 구성을 사용 중인 경우, 원격 시스템에서 탐색을 수행할 때 문제점이 발생할 수도 있습니다. NetQuestion 탐색 디먼을 자동으로 시작되도록 설정한 경우(제품 설치시 또는 13.0 NetQuestion 서버 자동 시작의 단계를 수행한 후), 사용자가 서버 시스템에 로그인할 때까지 디먼이 실제로 시작되지 않습니다. 이는 시스템이 재부트된 후 시스템 사용자가 처음으로 로그온하기 전까지 탐색 디먼이 실행되지 않음을 의미합니다. 그러나 , Windows Task Scheduler를 사용하여 부팅시 탐색 디먼을 시작할 수 있습니다. 이 절의 지침은 도움말을 제공하는 시스템에 적용됩니다.
참고: 네트워크 도움말 구성을 사용하지 않을 경우, 이 절의 단계를 수행할 필요가 없습니다.
시작하기 전에, NetQuestion 설치 디렉토리를 판별해야 합니다. 또한 약간의 수동 레지스트리 정리를 수행할 수도 있습니다. 레지스트리는 로그온시 NetQuestion 탐색 디먼을 시작하기 위한 항목을 포함합니다. 부팅시 디먼을 시작하려는 경우, 레지스트리 항목이 필요하지 않습니다. 레지스트리를 정리하려면, 다음을 수행하십시오.
이제 Windows에 부팅시 서버를 시작하도록 지시할 수 있습니다. 먼저, Microsoft Windows Task Scheduler가 도움말 서버로 작동하는 시스템에 설치되었는지 검사하십시오.
도움말 서버에서 부팅시 시작하도록 NetQuestion 탐색 서버를 설정하려면, 다음을 수행하십시오.
참고: 도움말 서버 시스템이 재부트된 후, 로그인 화면이 표시된 다음 Windows가 탐색 서버를 시작하기 전까지 1분 이상이 걸릴 수도 있습니다.
명령 프롬프트를 열고 다음을 입력하여 NetQuestion 설치 디렉토리의 위치를 판별할 수 있습니다.
set IMNINSTSRV
돌려보내는 디렉토리는 NetQuestion 설치 디렉토리입니다. 변수를 설정하지 않은 경우, Windows 레지스트리에서 찾아서 설치 디렉토리를 판별할 수 있습니다. 명령 프롬프트에서 regedit를 입력한 다음, 레지스트리 항목을 HKEY_LOCAL_MACHINE\SOFTWARE\IBM\NetQuestion\CurrentVersion\Installation Directory 키로 확장하십시오. 해당 키의 "Directory" 항목이 NetQuestion 설치 디렉토리를 가리켜야 합니다.
Windows 95 및 Windows 98에서, IMNINSTSRV 환경 변수가 설정되지 않았지만 레지스트리에서 디렉토리를 찾을 수 없는 경우, autoexec.bat 파일을 편집해야 할 수도 있습니다.(Windows ME에서 이러한 조건이 발생한 경우, 17.0 Windows ME에 대한 특수 고려사항을 참조하십시오.) NetQuestion 설치 프로세스가 NetQuestion 디렉토리에 저장된 imnenv.bat 일괄처리 파일을 호출하는 명령을 추가하도록 autoexec.bat를 수정해야 합니다. 추가 명령은 다음과 같습니다.
if exist _NETQ_DIR_\imnenv.bat call _NETQ_DIR_\imnenv.bat
이 행이 누락되거나 _NETQ_DIR_이 틀린 디렉토리를 가리킬 경우, 올바른 NetQuestion 디렉토리를 사용하여 행을 추가하십시오. 또한 autoexec.bat 내에서 호출되는 imnenv.bat 일괄처리 파일이 실제로 존재하는지와 다른 NetQuestion 디렉토리가 아닌 현재 디렉토리를 가리키는 항목을 포함하는지 확인해야 합니다. imnenv.bat의 내용은 다음과 같습니다.
@echo off set IMNINSTSRV=_NETQ_DIR_ set IMNINST=help set PATH=PATH;%IMNINSTSRV%
브라우저 또는 명령행에서 도움말을 실행시킬 수 없다면 HTML에 대한 적절한 파일 연관이 설정되지 않은 것입니다. 도움말 시스템 클라이언트 코드는 레지스트리 항목을 사용하여 이들 파일 연관에 기초한 기본 시스템 브라우저를 판별합니다. 레지스트리 편집기를 사용하여 파일 연관을 검사할 수 있습니다.
이러한 항목이 보이지 않으면 다음과 같이 항목을 추가할 수 있습니다.
Netscape Communicator의 경우:
user_pref("browser.wfe.ignore_def_check", true);
Internet Explorer의 경우:
Windows ME를 사용 중인 경우, NetQuestion 환경 변수를 로드하도록 autoexec.bat를 변경하면 재부트해도 유효하지 않을 수 있습니다. 재부트 후 변경사항이 사라질 수도 있습니다. 이렇게 되면 NetQuestion 환경 변수가 정의되지 않은 상태로 남아서 다음과 같은 종류의 실패를 야기합니다.
재부트 후 환경 변수가 제대로 설정되었는지 여부를 검사하여 도움말 문제점의 원인이 될지를 판별할 수 있습니다. 아직 설정되지 않은 경우, Windows 시스템 디렉토리에 있는 msconfig.exe 프로그램을 사용하여 다음 환경 변경사항을 수행하십시오.
Component Broker는 사용자 인터페이스에서 F1 또는 도움말 메뉴 조치로부터 도움말을 시작하는 부분인, VisualAge 도움말 시스템의 클라이언트 부분을 사용하지 않습니다. 이러한 사실은 두 가지 중요한 의미를 갖습니다.
Component Broker는 doc\readme 디렉토리에 도움말 문제점 해결에 관한 추가 정보를 제공합니다.
설치된 도움말이 부분적으로나 또는 전체적으로 중국어(로케일 zh_CN), 대만어(zh_TW), 한국어(ko_KR) 또는 일본어(ja_JP)로 작성된 시스템에서는 vahcfg 및 NetQuestion 명령을 다음과 같이 변경해야 합니다.
vahcfg regen /p vj32 /f %IMNINSTSRV% /l ja_JP
로케일을 포함하는 데 실패하면 탐색 색인과 NetQuestion 탐색 시스템이 손상될 수도 있습니다.
| SBCS 명령 | DBCS 명령 |
| imnixlst | imqixlst |
| imnixdel | imqixdel |
| imnss start server | imqss -start dbcshelp |
NetQuestion이 1바이트 및 2바이트 탐색 시스템에 대해 서로 다른 실행 파일과 서버를 사용하기 때문에 이러한 변경이 필요합니다.