이 절에서는 Net.Data의 시동 및 실행에 필요한 기본적인 단계의 수행 방법에 대해 설명합니다. 기본 단계는 다음과 같습니다.
이 절에서의 단계를 실행한 후 요청을 처리할 때 Net.Data를 사용하는 데 있어 문제가 있는 경우, "문제점 분석"를 참조하여 문제 해결 방법을 찾으십시오.
1단계--Net.Data 프로그램 오브젝트를 CGI-BIN 라이브러리로 복사
CGI-BIN 라이브러리로 복사해야 할 Net.Data 프로그램 오브젝트는 QTCP 라이브러리에 위치한 DB2WWW입니다. CRTDUPOBJ(이중 오브젝트 작성) 명령을 사용하여 프로그램 오브젝트를 복사하십시오.
*PUBLIC 사용자에 대한 DB2WWW 프로그램 오브젝트의 오브젝트 권한은 *EXCLUDE로 설정됩니다. CGI 프로그램이 실행되는 사용자 프로파일이 프로그램 오브젝트에 액세스할 수 있도록, CGI-BIN 디렉토리에 있는 DB2WWW 프로그램 오브젝트를 변경하십시오. *PUBLIC 사용자에 대한 프로그램 오브젝트 권한을 *USE로 변경하거나, DB2WWW 프로그램 오브젝트에 대한 사용자 프로파일 액세스를 부여함으로써 이와 같이 할 수 있습니다.
AS/400용 인터넷 연결(Internet Connection), V3R2 및 V3R7은 QTMHHTP1 사용자 프로파일 하에서만 CGI 프로그램을 수행합니다.
2단계--Net.Data 지시문을 HTTP 구성 파일에 추가
WRKHTTPCFG(HTTP 구성에 대한 작업) 명령의 옵션 1(추가) 또는 옵션 13(삽입)을 사용하여 다음을 수행하십시오.
아직 없는 경우, Enable GET Y1" 및 Enable POST Y2" 지시문을 사용자가 방법을 작동시킨 구성 파일의 섹션에 추가하십시오. 파일내 지시문에 따라, 사용자 화면은 그림 1과 같을 것입니다.
+--------------------------------------------------------------------------------
HTTP 구성에 대한 작업
시스템: SYSNAM01
옵션을 입력한 후 Enter키를 누르십시오.
1=추가 2=변경 3=복사 4=제거 5=표시 13=삽입
일련
Opt 번호 항목
00010 # * * * * * * * * * * * * * * * * * * * * * * * * * * #
00020 # HTTP CONFIGURATION FOR NET.DATA TESTING #
00030 # #
00040 HostName sysnam01.location.company.com
00050 Port 80
00060 #-----------------------------------------------------
00070 # Methods Enabled
00080 #
00090 Enable GET Y1"
00100 Enable POST Y2"
00110 #
00120 #-----------------------------------------------------
계속...
F3=나감 F5=화면정리 F6=목록 인쇄 F12=취소 F17=위 F18=아래
F19=편집 순서
+--------------------------------------------------------------------------------
그림 1. HTTP 구성에 대한 작업(WRKHTTPCFG) -- 화면 1
그림 2에 표시된 Map 및 Exec 명령문을 추가하십시오. 다음 화면에는 이들 명령문이 추가된 후의 지시문을 보여 줍니다.
+--------------------------------------------------------------------------------
HTTP 구성에 대한 작업
시스템: SYSNAM01
옵션을 입력한 후 Enter키를 누르십시오.
1=추가 2=변경 3=복사 4=제거 5=표시 13=삽입
일련
Opt 번호 항목
00130 #-----------------------------------------------------
00140 # Mapping/Pass Rules + Executables
00150 #
00160Y1" Map /cgi-bin/db2www/* /QSYS.LIB/CGI.LIB/DB2WWW.PGM/*
00170Y1" Map /CGI-BIN/DB2WWW/* /QSYS.LIB/CGI.LIB/DB2WWW.PGM/*
00180 #
00190 #
00200Y2" Exec /QSYS.LIB/CGI.LIB/*
00210 Pass /WWW/html/*
00220 #-----------------------------------------------------
계속...
F3=나감 F5=화면정리 F6=목록 인쇄 F12=취소 F17=위 F18=아래
F19=편집 순서
+--------------------------------------------------------------------------------
그림 2. HTTP 구성에 대한 작업(WRKHTTPCFG) -- 화면 2
Map 지시어 Y1"은 Net.Data 프로그램이 사용자 시스템에 상주하는 라이브러리에 "/cgi-bin/db2www/*" 형식으로 항목을 대응시킵니다. (문자열 끝에 있는 별표(*)는 문자열 뒤에 오는 모든 문자를 가리킵니다.）지시문은대소문자를 구분하므로, map 명령문은 대문자와 소문자 모두로 포함되어야 합니다. 이 예에서 Map 명령문은 같은 위치로 대응됩니다.
Exec 지시어 Y2"는 HTTP 서버가 CGI 라이브러리에 있는 모든 CGI 프로그램을 실행하도록 합니다. 프로그램이 지시문에 상주하는 라이브러리(프로그램 자체가 아님)를 지정합니다. CGI 라이브러리에 있는 다른 *PGM 오브젝트가 실행되지 못하도록 하려면 오브젝트 액세스에서 *PUBLIC과 QTMHHTP1을 제외시키십시오.
다음과 같이 STRTCPSVR CL 명령을 사용하여 구성 파일의 변경 사항이 효력을 발휘하도록 하려면 HTTP 명령을 재시작해야 합니다.
STRTCPSVR *HTTP RESTART(*HTTP)
Net.Data는 Pass 지시어를 사용하지 않음에 유의하십시오. 사용자의 URL을 단순화하려면, Net.Data 초기설정 파일에 있는 MACRO_PATH 명령문을 사용하십시오. 다음 단계로 가십시오.
3단계--Net.Data 초기설정 파일 작성
Net.Data 초기설정 파일 작성은 선택적입니다. 초기설정 파일을 사용하는 것의 장점은 프로그램에 대한 참조가 짧고 URL이 짧다는 것과, 사용자의 웹 매크로 파일에 파일을 포함시킬 수 있다는 것입니다. 그러나, 사용자 자신의 언어 환경을 작성하려는 경우 초기설정 파일 작성은 필수적입니다.
초기설정 파일이 작성되지 않은 경우, 파일에 지원 언어 환경만 있는 초기설정 파일("지원 언어 환경" 참조)이 구성된 것처럼 Net.Data가 실행됩니다. 모든 매크로, 포함, 및 실행가능 참조가 완전하게 규정되어야 합니다.
초기설정 파일이 작성된 후 갱신되면, 변경사항의 효력을 발생시키기 위해 HTTP 서버를 종료한 후 다시 시작할 필요가 없습니다. Net.Data는 HTTP 서버 작업에 의한 초기 호출 중에 초기설정 파일을 한 번 읽습니다. 후속 Net.Data 호출시에 Net.Data가 초기설정 파일을 읽을 필요가 없도록, 구성 자료가 저장됩니다. 그러나, 초기설정 파일을 변경한 경우, Net.Data는 초기설정 파일의 변경되었음을 감지한 후 다시 초기설정 파일을 읽습니다.
초기설정 파일을 작성하려면 CRTSRCPF(소스 실제 파일 작성) 명령을 사용하십시오. 구성 명령문의 텍스트는 모두 한 행으로 되어야 하므로, 레코드 길이가 240인 초기설정 파일을 만드는 것이 좋습니다. 파일은 DB2WWW 프로그램 오브젝트가 상주하는 라이브러리에 작성되어야 합니다. 파일명은 "INI"여야 합니다. 멤버명은 "DB2WWW"여야 합니다. 구성 명령문을 파일에 추가하려면 소스 항목 유틸리티(SEU)를 사용하십시오.
그림 3은 초기설정 파일의 예입니다. 각 구성 명령문의 텍스트는 모두 한 행으로 되어야 합니다. (판독을 위해 ENVIRONMENT 명령문은 여러 행에 표시되어 있습니다.）아래의 Net.Data 초기설정 파일에는 총 6개의 구성 명령문(공백 행 제외)이 있음에 유의하십시오. 사용자의 웹 매크로에 언어 환경을 사용하지 않으려는 계획인 경우, ENVIRONMENT 명령문은 필요하지 않습니다. 또한, 경로 구성 명령문도 지정할 필요가 없습니다.
+----------------------------------------------------------------------- MACRO_PATH /WWW/MACRO;/QSYS.LIB/WWW.LIB/MACRO.FILE INCLUDE_PATH /WWW/MACRO;/QSYS.LIB/WWW.LIB/MACRO.FILE EXEC_PATH /QSYS.LIB;/QSYS.LIB/WWW.LIB ENVIRONMENT(DTW_REXX) /QSYS.LIB//QTCP.LIB/QTMHREXX.SRVPGM ( ) ENVIRONMENT(DTW_SQL) /QSYS.LIB/QTCP.LIB/QTMHSQL.SRVPGM (IN DATABASE, LOGIN, PASSWORD, TRANSACTION_SCOPE, SHOWSQL, DB_CASE, DTW_SET_TOTAL_ROWS, OUT DTWTABLE, SQL_CODE, TOTAL_ROWS ) ENVIRONMENT(DTW_SYSTEM) /QSYS.LIB/QTCP.LIB/QTMHSYS.SRVPGM ( ) +----------------------------------------------------------------------- 그림 3. Net.Data 초기설정(INI) 파일 목차
4단계--Net.Data 웹 매크로 작성
웹 매크로를 작성하기 전에 우선 웹 매크로가 상주할 파일 시스템을 결정해야 합니다. 웹 매크로가 QOpenSys 같은 UNIX 종류의 파일 시스템에 저장되거나, 또는 라이브러리 파일 시스템(QSYS.LIB)에 저장되거나, Net.Data에는 차이가 없습니다. 웹 매크로를 여러 파일 시스템에 저장하고자 할 수도 있습니다.
사용자의 웹 매크로를 저장하기로 선택한 파일 시스템에 따라, 디렉토리나 라이브러리를 작성해야 할 것입니다. 몇가지 예는 다음과 같습니다.
CRTDIR DIR('/WWW')
CRTDIR DIR('/WWW/macro')
CRTLIB LIB(WWW) CRTSRCPF FILE(WWW/MACRO) RCDLEN(240)
일단 디렉토리나 라이브러리를 작성하면 웹 매크로를 작성하고 이를 디렉토리나 라이브러리에 복사해야 합니다. 소스 항목 유틸리티를 사용하여 사용자의 AS/400 시스템상에 소스 실제 파일 멤버를 작성할 수 있습니다. CPYTOSTMF(스트림 파일로 복사) CL 명령을 사용하여 소스 실제 파일 멤버로부터 파일 시스템(예. "루트") 디렉토리로 멤버를 복사할 수 있습니다. 예를 들어, WWW 라이브러리에 MACSAMP라는 소스 실제 파일 멤버와 MACRO라는 소스 실제 파일을 작성했고, 멤버에 다음과 같은 텍스트가 포함되었다고 가정합시다.
%HTML(HelloWorld) {
<P>Hello World
%}
멤버를 "루트" 파일 시스템에 있는 /WWW/macro 디렉토리로 복사하려면 다음과 같이 CPYTOSTMF를 사용해야 할 것입니다.
CPYTOSTMF FROMMBR('/qsys.lib/www.lib/macro.file/MACSAMP.mbr')
TOSTMF('/WWW/macro/MACSAMP') STMFOPT(*REPLACE) ENDLINFMT(*LF)
5단계--오브젝트에 사용자 프로파일 권한 부여
CGI 프로그램이 실행되는 사용자 프로파일에는 웹 매크로에서 참조되는 모든 오브젝트 및 URL이 참조하는 매크로에 대한 적절한 액세스 권한이 있어야 합니다.
AS/400용 인터넷 연결(Internet Connection), V3R2 및 V3R7은 QTMHHTP1 사용자 프로파일 하에서만 CGI 프로그램을 수행했습니다.
사용자의 웹 매크로를 저장하기로 선택한 파일 시스템에 따라, Net.Data CGI 프로그램이 실행되는 사용자 프로파일을 웹 매크로로 권한부여해야 할 것입니다. QTMHHTP1 사용자 프로파일 권한을 제공하는 몇가지 예는 다음과 같습니다.
CHGAUT OBJ('/WWW') USER(QTMHHTP1) DTAAUT(*RX)
CHGAUT OBJ('/WWW/macro') USER(QTMHHTP1) DTAAUT(*RX)
CHGAUT OBJ('/WWW/macro/*') USER(QTMHHTP1) DTAAUT(*RX)
GRTOBJAUT OBJ(WWW) OBJTYPE(*LIB) USER(QTMHHTP1) AUT(*USE) GRTOBJAUT OBJ(WWW/MACRO) OBJTYPE(*FILE) USER(QTMHHTP1) AUT(*USE)
또한, 다음과 같이 CHGAUT CL 명령을 사용하여 QSYS.LIB 파일 시스템에 있는 오브젝트에 권한을 부여할 수도 있습니다.
CHGAUT OBJ('/QSYS.LIB/WWW.LIB') USER(QTMHHTP1) DTAAUT(*RX)
CHGAUT OBJ('/QSYS.LIB/WWW.LIB/MACRO.FILE') USER(QTMHHTP1) DTAAUT(*RX)
언어 환경별 권한부여 고려사항에 대해서는 "지원 언어 환경"의 각 언어 환경 섹션에 설명되어 있습니다.
6단계--Net.Data 웹 매크로 호출
OS/400용 Net.Data은 공통 게이트웨이 인터페이스(CGI) 프로그램으로서만 호출될 수 있습니다. Net.Data는 다음과 같은 방법으로 호출할 수 있습니다.
<A HREF="http://{<I>web-server}/cgi-bin/db2www/{macro-file}/
{HTML-block}?name=val&...">any text</A>
<FORM METHOD={method} ACTION=http://{web-server}/cgi-bin/db2www/
{macro-file}/{HTML-block}?name=val&...>any text</FORM>
http://{<I>web-server}/cgi-bin/db2www/{<I>macro-file}/{<I>HTML-block}
<I>?name=val&...
| 방법 | get 또는 post를 지정할 수 있습니다. 이들은 HTML 2.0에 지정됩니다. get 방법은 제한이 있으므로 사용하지 않는 것이 좋습니다. |
| 웹서버 | 이것은 시스템 관리자에 의해 정의된 웹 서버명입니다. 예를 들면, www.imb.com. 매크로가 국지적으로 존재하는 경우, http://www.ibm.com/을 생략하고 상대적 URL만 필요합니다. |
| 매크로-파일 | 이것은 Net.Data 적용업무 개발 프로그램에 의해 정의된 웹 매크로명입니다. 여기에 지정하는 것은 MACRO_PATH 명령문이 지정된 Net.Data 초기설정 파일이 있는지의 여부와 직접적으로 관련되어 있습니다. MACRO_PATH가 지정되지 않은 경우, 완전 규정화된 경로명을 웹 매크로로 지정해야 할 것입니다. 예를 들어, MACRO_PATH가 초기설정 파일에 지정되지 않은 경우, 매크로 파일은 /QSYS.LIB/WWW.LIB/MACRO.FILE/MACSAMP.MBR이 될 것입니다. 그러나, 초기설정 파일에 MACRO_PATH 명령문이 있는 경우 매크로-파일은 MACSAMP.MBR이 될 것입니다. |
| HTML-블록 | 이것은 사용자가 호출중인 웹 매크로내의 HTML 블록명입니다. |
| ?name=val& | 사용자 적용업무에서 전달될 수 있는 선택적 매개변수입니다. 예를 들어, 사용자 ID를 전달하면 여러번 입력할 필요가 없고, 다른 매크로를 호출하는 웹 매크로명을 전달하면 뒤로 다시 갈(back out) 수 있습니다. |
이미 작성된 샘플 매크로를 호출하는 데 필요한 URL(MACRO_PATH 명령문이 없다고 가정함)은 다음과 같습니다.
http://server/cgi-bin/db2www/WWW/MACRO/MACSAMP/HelloWorld
http://server/cgi-bin/db2www/QSYS.LIB/WWW.LIB/MACRO.FILE/MACSAMP.MBR/HelloWorld