참조서

웹 레지스트리 함수

웹 레지스트리는 항목을 쉽게 추가, 검색, 삭제할 수 있도록 하기 위해 Net.Data에 의해 유지보수되는 키가 있는 파일입니다. 한 시스템에 여러 개의 Net.Data 웹 레지스트리를 작성할 수 있습니다. 각 레지스트리에는 이름이 있고, 여러 개의 항목이 포함될 수 있습니다. Net.Data는 레지스트리와 그 안에 포함된 항목들을 유지보수하기 위한 함수를 제공합니다.

• DTWR_ADDENTRY

• DTWR_CLEARREG

• DTWR_CLOSEREG

• DTWR_CREATEREG

• DTWR_DELENTRY

• DTWR_DELREG

• DTWR_LISTREG

• DTWR_LISTSUB

• DTWR_OPENREG

• DTWR_RTVENTRY

• DTWR_UPDATEENTRY

제한사항:

• OS/2 사용시 registry, registryVariable 및 registryData 매개변수에 별표(*)를 사용하지 마십시오.

• 웹 레지스트리 함수에 전달되는 각각의 매개변수는 최대 2048자로 제한됩니다.

DTWR_ADDENTRY

목적

항목을 웹 레지스트리에 추가합니다.

형식

@DTWR_ADDENTRY(registry, registryVariable, registryData, index)

@DTWR_ADDENTRY(registry, registryVariable, registryData)

매개변수

표 187. DTWR_ADDENTRY 매개변수

리턴 코드

표 188. DTWR_ADDENTRY 리턴 코드

예

예 1:

@DTWR_ADDENTRY("Myregistry", "Jones", "http://Advantis.com/~Jones/webproj")
 

예 2:

@DTWR_ADDENTRY("URLLIST", "SMITH", "http://www.software.ibm.com/",
     "WORK_URL,")

DTWR_CLEARREG

목적

웹 레지스트리에서 항목을 제거합니다.

형식

@DTWR_CLEARREG(registry)

매개변수

표 189. DTWR_CLEARREG 매개변수

리턴 코드

표 190. DTWR_CLEARREG 리턴 코드

예

예 1:

@DTWR_CLEARREG("Myregistry")
 

DTWR_CLOSEREG

목적

웹 레지스트리를 닫습니다.

형식

@DTWR_CLOSEREG(registry)

매개변수

표 191. DTWR_CLOSEREG 매개변수

리턴 코드

표 192. DTWR_CLOSEREG 리턴 코드

예

예 1: 레지스트리를 닫습니다.

@DTWR_CLOSEREG("/qsys.lib/mylib.lib/myreg.file")
 

DTWR_CREATEREG

목적

새로 웹 레지스트리를 작성합니다.

형식

@DTWR_CREATEREG(registry, security)

@DTWR_CREATEREG(registry)

매개변수

표 193. DTWR_CREATEREG 매개변수

리턴 코드

표 194. DTWR_CREATEREG 리턴 코드

예

예 1:

@DTWR_CREATEREG("myRegistry")
 

예 2:

@DTWR_CREATEREG("URLLIST", "*RWX, *RWX, *R")

DTWR_DELENTRY

목적

웹 레지스트리에서 항목을 삭제합니다.

형식

@DTWR_DELENTRY(registry, registryVariable, index)

@DTWR_DELENTRY(registry, registryVariable)

매개변수

표 195. DTWR_DELENTRY 매개변수

리턴 코드

표 196. DTWF_DELENTRY 리턴 코드

예

예 1:

@DTWR_DELENTRY("Myregistry", "Jones")

예 2:

@DTWR_DELENTRY("URLLIST", "SMITH", "WORK_URL")

DTWR_DELREG

목적

웹 레지스트리 삭제

형식

@DTWR_DELREG(registry)

매개변수

표 197. DTWR_DELREG 매개변수

리턴 코드

표 198. DTWR_DELREG 리턴 코드

예

예 1:

@DTWR_DELREG("Myregistry")

DTWR_LISTREG

목적

웹 레지스트리의 내용을 나열합니다.

형식

@DTWR_LISTREG(registry, registryTable)

매개변수

표 199. DTWR_LISTREG 매개변수

리턴 코드

표 200. DTWR_LISTREG 리턴 코드

사용법 메모

DTWR_LISTREG는 사용자가 전달한 OUT 테이블 변수의 레지스트리 항목에 대한 정보를 리턴합니다. 테이블 변수는, 매개변수로서 LISTREG 레지스트리 연산에 대한 FUNCTION 블록으로 전달되기 전에 사용자 매크로에 정의됩니다.

사용자가 테이블의 최대 행 수에 대해 ALL 옵션을 사용하여 테이블 변수를 정의한 경우, 이 조작을 수행하면 각 테이블 행에 하나씩 테이블에 사용 가능한 모든 레지스트리 항목이 나열됩니다. 한편, 사용자가 테이블 행의 최대 수로 X 값을 지정했는데 지정된 레지스트리에 X 항목보다 많은 항목이 있는 경우, 첫번째 X 항목들만 표시되고, 오류 코드가 전송됩니다. 이 코드는 사용 가능한 테이블 행이 충분치 못해 추가 항목을 표시할 수 없어 부분적인 목록만 표시되었습니다. X 값이 지정된 레지스트리에서 사용 가능한 항목 수를 초과하는 경우, 모든 레지스트리 항목이 표시됩니다.

항상 테이블에는 2개 컬럼이 있습니다. 테이블에 대한 컬럼 헤드는 항상 REGISTRY_VARIABLE 및 REGISTRY_DATA로 설정됩니다.

예

예 1:

%DEFINE RegistryTable = %TABLE(ALL)
 
@DTWR_LISTREG("URLLIST", RegistryTable)

DTWR_LISTSUB

목적

웹 레지스트리에 직속 부속키 항목이 나열됩니다.

형식

@DTWR_LISTSUB(registry, registryTable)

매개변수

표 201. DTWR_LISTSUB 매개변수

리턴 코드

표 202. DTWR_LISTSUB 리턴 코드

사용법 메모

1. DTWR_LISTREG는 사용자가 전달한 OUT 테이블 매개변수의 레지스트리 항목에 대한 정보를 리턴합니다. 테이블 변수는, 매개변수로서 LISTSUB 레지스트리 연산으로 전달되기 전에 매크로에 정의됩니다.

   사용자가 테이블의 최대 행 수에 대해 ALL 옵션을 사용하여 테이블 변수를 정의한 경우, 이 조작을 수행하면 각 테이블 행에 하나씩, 테이블에 사용 가능한 모든 레지스트리 항목이 나열됩니다. 한편, 사용자가 테이블 행의 최대 수로 X 값을 지정했는데 지정된 레지스트리에 X 항목보다 많은 항목이 있는 경우, 첫번째 X 항목들만 표시되고, 오류 코드가 전송됩니다. 이 코드는 사용 가능한 테이블 행이 충분치 못해 추가 항목을 표시할 수 없어 부분적인 목록만 표시되었음을 나타냅니다. X 값이 지정된 레지스트리에서 사용 가능한 항목 수를 초과하는 경우, 모든 레지스트리 항목이 표시됩니다. 테이블에 있는 컬럼의 수는 항상 1입니다.

   테이블에 대한 컬럼 표제는 "REGISTRY_SUBKEY"로 설정됩니다.

2. 이 함수는 Windows95 시스템 레지스트리와 호환되는 운용 시스템상에서만 유효합니다.

예

예 1:

%DEFINE RegistryTable = %TABLE(ALL)
 
@DTWR_LISTSUB("URLLIST", RegistryTable)

DTWR_OPENREG

목적

웹 레지스트리를 엽니다.

형식

@DTWR_OPENREG(registry, commit)

@DTWR_OPENREG(registry)

매개변수

표 203. DTWR_OPENREG 매개변수

리턴 코드

표 204. DTWR_OPENREG 리턴 코드

예

예 1: 확약 제어하에서 레지스트리를 엽니다.

@DTWR_OPENREG("/qsys.lib/mylib.lib/myreg.file", "Y")
 

DTWR_RTVENTRY

목적

웹 레지스트리에서 레지스트리 문자열 값을 검색합니다.

형식

@DTWR_RTVENTRY(registry, registryVariable, registryData, index)

@DTWR_RTVENTRY(registry, registryVariable, registryData)

@DTWR_rRTVENTRY(registry, registryVariable, index)

@DTWR_rRTVENTRY(registry, registryVariable)

매개변수

표 205. DTWR_RTVENTRY 매개변수

리턴 코드

표 206. DTWR_RTVENTRY 리턴 코드

예

예 1:

%DEFINE RegistryData = ""
@DTWR_RTVENTRY("Myregistry", "Jones", RegistryData)

예 2:

@DTWR_RTVENTRY("URLLIST", "SMITH", RegistryData, "WORK_URL")
 

예 3:

@DTWR_rRTVENTRY("Myregistry", "Jones")
 

예 4:

@DTWR_rRTVENTRY("URLLIST", "SMITH", "WORK_URL")

DTWR_UPDATEENTRY

목적

웹 레지스트리에 있는 레지스트리 문자열 값을 갱신합니다.

형식

@DTWR_UPDATEENTRY(registry, registryVariable, newData, index)

@DTWR_UPDATEENTRY(registry, registryVariable, newData)

매개변수

표 207. DTWR_UPDATEENTRY 매개변수

리턴 코드

표 208. DTWR_UPDATEENTRY 리턴 코드

사용법 메모

값에 해당하는 레지스트리 항목명을 변경할 수 없습니다.

예

예 1:

@DTWR_UPDATEENTRY("Myregistry", "Jones", "http://advantis.com/~Jones/personal")

예 2:

@DTWR_UPDATEENTRY("URLLIST", "SMITH", "http://www.software.ibm.com/personal", "WORK_URL")