게이트웨이 서블릿 매개변수
기본적으로 게이트웨이 서블릿에는 하나의 매개변수(hptGatewayProperties)만 정의되어 있습니다. 이 매개변수는 게이트웨이 특성 파일을 지정합니다. 게이트웨이 특성 파일은 게이트웨이 서블릿에 대해 나머지 매개변수를 설정합니다. 기본적으로 게이트웨이 특성 파일은 Java™ 자원 폴더에 있는 gw.properties입니다. 이 파일의 주석은 파운드 기호(#)로 시작됩니다.
또는 hptGatewayProperties 매개변수를 지정한 위치와 동일한 위치에서 게이트웨이 서블릿 매개변수를 설정할 수 있습니다. 하지만 우수 사례는 게이트웨이 특성 파일에서 매개변수를 설정하는 것입니다. 게이트웨이 특성 파일의 매개변수는 웹 애플리케이션 서버에서 지정되는 매개변수를 대체합니다.
연계 특성은 연계 특성 파일에서 설정됩니다. 이 파일은 hptLinkageProperties 게이트웨이 서블릿 매개변수에서 지정됩니다. "웹 트랜잭션 연계 특성"을 참조하십시오.
게이트웨이 서블릿 매개변수는 조회 문자열을 통해 게이트웨이 서블릿에 명령을 전달하는 게이트웨이 조회 매개변수와 동일하지 않습니다. 게이트웨이 조회 매개변수에 대한 정보는 웹 트랜잭션을 위한 게이트웨이 조회 매개변수의 내용을 참조하십시오.
| 서블릿 매개변수 | 매개변수값 | 주석 |
|---|---|---|
| hptDateMask | yyyy/dd/mm | UI 레코드에 숫자가 아닌 날짜 필드가 있는 경우 필수입니다. 이 필드의 경우 티어 2와 티어 3 사이에서 방향에 관계없이 전달되는 날짜/시간 값은 내부적으로 날짜 및 시간에 대한 긴 그레고리력 형식과 일치해야 합니다. hptDateMask 매개변수는 해당 형식을 지정합니다. C++ 프로그램으로 생성된 웹 트랜잭션의 경우 형식은 환경 변수 EZERGRGL에서 지정된 형식과 일치해야 합니다. COBOL 프로그램으로 생성된 웹 트랜잭션의 경우 hptDateMask의 형식은 서버 설치 중에 지정된 날짜/시간 형식과 일치해야 합니다. |
| hptDisableRMIIDManager | Y | 게이트웨이 서블릿은 고유 ID를 사용하여 각 사용자의 세션을 식별합니다. VisualAge® Generator에서는 세션 ID 관리자라는 별도의 프로그램이 해당 ID를 작성했습니다. 게이트웨이 서블릿은 RMI(Remote Method Invocation)를 사용하여 이와 통신했습니다. hptDisableRMIIDManager를 Y로 설정한 경우 EGL은 세션 ID를 작성합니다. 이는 웹 트랜잭션 지원을 가진 프로젝트의 gw.properties 파일에서 사전 설정됩니다. |
| hptEntryApp | web_transaction | 항목 페이지를 제공하는 웹 트랜잭션을 지정합니다.
프로그램 이름은 티어 3 환경의 이름(예: CICS® 정의)과
일치해야 합니다. 또한 프로그램 이름에 대한 항목은 hptLinkageProperties
매개변수가 참조하는 파일에 있어야 합니다. hptEntryPage 또는 hptEntryApp이 필요합니다. 둘 다 지정된 경우에는 hptEntryPage가 사용됩니다. |
| hptEntryPage | /entry_page_jsp | 문서 루트에 대해 상대적인 항목 페이지 JSP를
지정합니다. hptEntryPage 또는 hptEntryApp이 필요합니다. 둘 다 지정된 경우에는 hptEntryPage가 사용됩니다. 항목 페이지 JSP의 HTML 출력에서 사용자가 호출한 웹 트랜잭션의 이름은 hptAppId에 지정되어야 합니다. 또한 웹 트랜잭션을 호출하는 SUBMIT 단추의 이름은 hptExec여야 하고 웹 애플리케이션 서버 세션을 종료하는 SUBMIT 단추의 이름은 hptLogout이어야 합니다. Vagen1EntryPage.jsp는 작업 예제로 제공됩니다. 여기서 각각의 웹 트랜잭션 이름은 <SELECT> 구조의 VALUE 절에 포함되고 해당 구조의 NAME 절은 hptAppId를 참조합니다. |
| hptErrorLog | gateway_servlet_log_file | 선택사항입니다. 이벤트 및 오류의 추적을 위한 로그 파일의 완전한 경로를 지정합니다. 이 매개변수를 지정하지 않으면 추적 정보가 웹 서버에 대한 콘솔로 이동합니다. |
| hptExDateMask | yyyy/dd/mm | 선택사항입니다. 백엔드 웹 트랜잭션에서 사용하는 날짜 형식을 지정하는 hptDateMask와 대조적으로 웹 페이지에서 날짜가 형식화되는 방식을 판별합니다. |
| hptExpiredPasswordPage | /expired_password_page _jsp | 선택사항입니다. 문서 루트에 대해 상대적인 만료된
비밀번호 페이지 JSP를 지정합니다. 만료된 비밀번호 페이지 JSP의 HTML 출력에서 userid 입력 필드의 이름은 hptUserid여야 하고 old-password 입력 필드의 이름은 hptPassword여야 하고 new-password 입력 필드의 이름은 hptNewPassword여야 하고 new-password 입력 확인 필드의 이름은 hptConfirmNewPassword여야 하고 SUBMIT 단추의 이름은 hptExpiredPasswordPageLogin이어야 합니다. ExpiredPasswordPage.jsp는 JSP의 작업 예제로 제공됩니다. hptExpiredPasswordPage 매개변수는 hptLogonCheck도 지정된 경우에만 적용됩니다. |
| hptGatewayProperties | gateway_properties_file | 선택사항입니다. 다른 게이트웨이 서블릿 매개변수가 포함된 파일의 완전한 경로를 지정합니다. |
| hptIDManagerHost | host_name | 선택사항입니다. 세션 ID 관리자가 실행되는 시스템의 TCP/IP 호스트 이름을 지정합니다. 기본값은 localhost입니다. hptDisableRMIIDManager가 Y로 설정되면 사용되지 않습니다. |
| hptLinkageProperties | linkage_properties_file | 필수입니다. 게이트웨이 서블릿과 각각의 웹 트랜잭션 사이의 연결을 설정하는 연계 특성 파일의 완전한 이름을 지정합니다. 웹 트랜잭션 연계 특성을 참조하십시오. |
| hptLogonCheck | fully_qualified_class_name | 선택사항입니다. 사용자 인증을 처리하는 로그온
확인 클래스를 지정합니다. RACFValidateLogin은 작업 샘플로 제공됩니다. 해당 샘플을 사용하려면 다음을 지정하십시오. hptLogonCheck= com.ibm.hpt.gateway. RACFValidateLogin |
| hptLogonPage | /logon_page_jsp | 선택사항입니다. 문서 루트에 대해 상대적인
로그온 페이지 JSP를 지정합니다. 이 매개변수가 생략되거나 hptPublicPassword 및
hptPublicUserid가 있는 경우에는 로그온 페이지가 표시되지 않습니다.
로그온 페이지 JSP의 HTML 출력에서 userid 입력 필드의 이름은 hptUserid여야 하고 password 입력 필드의 이름은 hptPassword여야 하고 SUBMIT 단추의 이름은 hptLogin이어야 합니다. Vagen1LogonPage.jsp는 JSP의 작업 예제로 제공됩니다. |
| hptLogOpt | 1 | 기본적으로 로깅이 켜지고 웹 서버 콘솔에 전송됩니다(hptErrorLog 참조). 로깅을 끄려면 hptLogOpt를 1로 설정하십시오. |
| hptPublicPassword | password | hptPublicUserId와 결합하여 사용자가 hptLogonPage에서 지정된 로그온 화면을 우회할 수 있게 합니다. 설정되면 모든 웹 트랜잭션이 동일한 사용자 ID 아래에서 실행됩니다. |
| hptPublicUserId | user_id | hptPublicPassword와 결합하여 사용자가 hptLogonPage에서 지정된 로그온 화면을 우회할 수 있게 합니다. 설정되면 모든 웹 트랜잭션이 동일한 사용자 ID 아래에서 실행됩니다. |
| hptSessionIdManagerPort | port_number | 세션 ID 관리자의 포트를 지정합니다. 기본 포트를 사용하고 있지 않고 hptDisableRMIIDManager가 Y로 설정되지 않은 경우에만 이 매개변수를 지정하십시오. |
| hptSessionIDPrefix | prefix | 세션 ID 관리자 사용 여부에 관계없이 모든 세션 ID에 자동으로 추가되는 기본 접두부(CU)를 바꿉니다. 길이는 1자 - 3자여야 합니다. |
| hptValidApps | web_tran_name [, web_tran_name ...] | 실행이 허용되는 웹 트랜잭션 이름의 쉼표로 구분된 목록입니다. hptValidApps가 설정되지 않으면 모든 웹 트랜잭션이 실행될 수 있습니다. 설정된 경우에는 목록에 없는 트랜잭션을 실행하기 위해 요청이 전송되면 GatewayServlet에서 오류 메시지를 발행합니다. 이름은 별표 와일드카드 문자로 끝날 수 있습니다. |
hptLogonPage=/Vagen1LogonPage.jsp
hptEntryPage=/Vagen1EntryPage.jsp
#hptEntryApp=WEBTXN1
hptErrorLog=c:/traces/Vagen1Gateway.log
hptLinkageProperties=c:/linktabs/csogwLinkage.properties