ADJUST

ADJUST는 애플리케이션에서 데이터 변환 처리 또는 데이터 엑세스를 위해 사용하는 기능이다. 데이터 변환하는 경우 사용하는 코드 페이지 및 동작에 따라 호출하는 API가 달라진다. 본 부록에서는 각 API의 기능과 사용법에 대해서 설명한다.

1. JCVEBCC(JCVJEBC)

JCVEBCC는 SJIS 코드를 기반으로 반각 데이터를 전각 데이터로 변환하는 기능을 수행한다. JCVJEBC 또한 동일한 기능을 수행한다.

다음은 JCVEBCC를 호출하는 예제이다.

WORKING-STORAGE SECTION.
01 P1      PIC S9(9) COMP.
01 P2      PIC S9(4) COMP.
01 P3      PIC X(10).
01 P4      PIC S9(4) COMP.
01 P5      PIC X(20).
01 P6      PIC S9(4) COMP.
...
PROCEDURE DIVISION.
CALL 'JCVJEBC' USING P1, P2, P3, P4, P5, P6.

파라미터

다음은 JCVEBCC를 호출하는 경우에 사용하는 각 항목에 대한 설명이다.

파라미터	설명
P1	JCVEBCC의 수행 결과를 반환하는 항목이다.
P2	변환 처리할 데이터의 길이를 입력하는 항목이다.
P3	변환 처리할 데이터를 입력하는 항목이다.
P4	변환 처리 후 반환받을 데이터의 길이를 입력하는 항목이다.
P5	변환 처리된 데이터를 항목하는 변수이다.
P6	변환 처리된 데이터의 길이를 반환하는 항목이다. 변환에 실패한 경우 0을 반환한다.

파라미터

설명

JCVEBCC의 수행 결과를 반환하는 항목이다.

변환 처리할 데이터의 길이를 입력하는 항목이다.

변환 처리할 데이터를 입력하는 항목이다.

변환 처리 후 반환받을 데이터의 길이를 입력하는 항목이다.

변환 처리된 데이터를 항목하는 변수이다.

변환 처리된 데이터의 길이를 반환하는 항목이다. 변환에 실패한 경우 0을 반환한다.

반환값

JCVEBCC의 수행 결과로 반환되는 값에 대한 설명이다.

P1	설명
0	JCVEBCC 가 정상 수행된 경우에 반환하는 값이다.
4	변환 처리된 데이터의 길이가 반환받을 데이터의 길이보다 긴 경우에 반환하는 값이다.
8	변환 처리할 데이터 내에 탁점 또는 반탁점과 함께 사용할 수 없는 문자가 입력된 경우에 반환하는 값이다.
12	변환 처리할 데이터가 잘못 입력된 경우에 반환하는 값이다.
16	JCVEBCC를 호출하는 경우에 전달한 변수에 문제가 있는 경우에 반환하는 값이다.
20	CPM 파일(코드 페이지 매핑 파일) 오픈에 실패한 경우에 반환하는 값이다.

2. JCVKISC

JCVKISC는 KIS 코드 페이지의 데이터를 SJIS 코드 페이지 데이터로 변환하는 기능을 수행한다.

다음은 JCVKISC를 호출하는 예제이다.

WORKING-STORAGE SECTION.
01 P1      PIC S9(9) COMP.
01 P2      PIC S9(4) COMP.
01 P3      PIC X(10).
01 P4      PIC S9(4) COMP.
01 P5      PIC X(10).
01 P6      PIC S9(4) COMP.
...
PROCEDURE DIVISION.
CALL 'JCVKISC' USING P1, P2, P3, P4, P5, P6.

파라미터

다음은 JCVKISC를 호출하는 경우에 사용하는 각 항목에 대한 설명이다.

파라미터	설명
P1	JCVKISC의 수행 결과를 반환하는 항목이다.
P2	변환 처리할 데이터의 길이를 입력하는 항목이다.
P3	변환 처리할 데이터를 입력하는 항목이다.
P4	변환 처리 후 반환받을 데이터의 길이를 입력하는 항목이다.
P5	변환 처리된 데이터를 반환하는 항목이다.
P6	변환 처리된 데이터의 길이를 반환하는 항목이다. 변환에 실패한 경우 0을 반환한다.

파라미터

설명

JCVKISC의 수행 결과를 반환하는 항목이다.

변환 처리할 데이터의 길이를 입력하는 항목이다.

변환 처리할 데이터를 입력하는 항목이다.

변환 처리 후 반환받을 데이터의 길이를 입력하는 항목이다.

변환 처리된 데이터를 반환하는 항목이다.

변환 처리된 데이터의 길이를 반환하는 항목이다. 변환에 실패한 경우 0을 반환한다.

반환값

JCVKISC의 수행 결과로 반환되는 값에 대한 설명이다.

P1	설명
0	JCVKISC 가 정상 수행된 경우에 반환하는 값이다.
4	변환 처리된 데이터의 길이가 반환받을 데이터의 길이보다 긴 경우에 반환하는 값이다.
12	변환 처리할 데이터가 잘못 입력된 경우에 반환하는 값이다.
16	JCVKISC를 호출하는 경우에 전달한 변수에 문제가 있는 경우에 반환하는 값이다.
20	CPM 파일(코드 페이지 매핑 파일) 오픈에 실패한 경우에 반환하는 값이다.

3. JCVKNAC

JCVKNAC는 카타카나 데이터를 히라가나 데이터로 변환하는 기능을 수행한다.

다음은 JCVKNAC를 호출하는 예제이다.

WORKING-STORAGE SECTION.
01 P1      PIC S9(9) COMP.
01 P2      PIC S9(4) COMP.
01 P3      PIC X(10).
01 P4      PIC S9(4) COMP.
01 P5      PIC X(10).
01 P6      PIC S9(4) COMP.
...
PROCEDURE DIVISION.
CALL 'JCVKNAC' USING P1, P2, P3, P4, P5, P6.

파라미터

다음은 JCVKISC를 호출하는 경우에 사용하는 각 항목에 대한 설명이다.

파라미터	설명
P1	JCVKNAC의 수행 결과를 반환하는 항목이다.
P2	변환 처리할 데이터의 길이를 입력하는 항목이다.
P3	변환 처리할 데이터를 입력하는 항목이다.
P4	변환 처리 후 반환받을 데이터의 길이를 입력하는 항목이다.
P5	변환 처리된 데이터를 반환하는 항목이다.
P6	변환 처리된 데이터의 길이를 반환하는 항목이다. 변환에 실패한 경우 0을 반환한다.

파라미터

설명

JCVKNAC의 수행 결과를 반환하는 항목이다.

변환 처리할 데이터의 길이를 입력하는 항목이다.

변환 처리할 데이터를 입력하는 항목이다.

변환 처리 후 반환받을 데이터의 길이를 입력하는 항목이다.

변환 처리된 데이터를 반환하는 항목이다.

변환 처리된 데이터의 길이를 반환하는 항목이다. 변환에 실패한 경우 0을 반환한다.

반환값

JCVKNAC의 수행 결과로 반환되는 값에 대한 설명이다.

P1	설명
0	JCVKNAC 가 정상 수행된 경우에 반환하는 값이다.
4	변환 처리된 데이터의 길이가 반환받을 데이터의 길이보다 긴 경우에 반환하는 값이다.
12	변환 처리할 데이터가 잘못 입력된 경우에 반환하는 값이다.
16	JCVKNAC를 호출하는 경우에 전달한 변수에 문제가 있는 경우에 반환하는 값이다.
20	CPM 파일(코드 페이지 매핑 파일) 오픈에 실패한 경우에 반환하는 값이다.

4. JRDJAFC

JRDJAFC는 일본어 파일의 내용을 필드 또는 레코드 단위로 읽어오는 기능을 수행한다.

다음은 JRDJAFC를 호출하는 예제이다.

WORKING-STORAGE SECTION.
01 P1
  02 P1-1  PIC S9(9) COMP.
  02 P1-2  PIC X(8).
01 P2      PIC S9(4) COMP.
01 P3      PIC X(200).
01 P4      PIC S9(4) COMP.
01 P5      PIC X(5).
01 P6      PIC S9(4) COMP.
01 P7
  02 P7-1  PIC S9(4) COMP.
  02 P7-2  PIC S9(4) COMP.
...
PROCEDURE DIVISION.
CALL 'JRDJAFC' USING P1, P2, P3, P4, P5, P6, P7.

파라미터

다음은 JRDJAFC를 호출하는 경우에 사용하는 각 항목에 대한 설명이다.

파라미터	설명
P1-1	JRDJAFC의 수행 결과를 반환하는 항목이다.
P1-2	접근할 일본어 파일의 식별 코드를 입력하는 항목이다.
P2	읽어올 데이터의 길이를 입력하는 항목이다.
P3	읽어온 데이터를 반환하는 항목이다.
P4	레코드 단위로 읽을 경우에 레코드 키의 길이를 입력하는 항목이다.
P5	레코드 단위로 읽을 경우에 레코드 키를 입력하는 항목이다.
P6	레코드 내의 특정 필드를 읽을 경우에 필드 위치를 입력하는 항목이다.
P7-1	읽어온 데이터의 길이를 반환하는 항목이다.
P7-2	JRDJFC의 수행 결과에 대한 정보를 반환하는 항목이다(Openframe 에서는 무의미한 항목이므로 지원하지 않는다).

파라미터

설명

P1-1

JRDJAFC의 수행 결과를 반환하는 항목이다.

P1-2

접근할 일본어 파일의 식별 코드를 입력하는 항목이다.

읽어올 데이터의 길이를 입력하는 항목이다.

읽어온 데이터를 반환하는 항목이다.

레코드 단위로 읽을 경우에 레코드 키의 길이를 입력하는 항목이다.

레코드 단위로 읽을 경우에 레코드 키를 입력하는 항목이다.

레코드 내의 특정 필드를 읽을 경우에 필드 위치를 입력하는 항목이다.

P7-1

읽어온 데이터의 길이를 반환하는 항목이다.

P7-2

JRDJFC의 수행 결과에 대한 정보를 반환하는 항목이다(Openframe 에서는 무의미한 항목이므로 지원하지 않는다).

반환값

JRDJAFC의 수행 결과로 반환되는 값에 대한 설명이다.

P1-1	설명
0	JRDJAFC 가 정상 수행된 경우에 반환하는 값이다.
8	지정한 레코드 키 또는 필드 위치에 읽을 데이터가 없을 경우에 반환하는 값이다.
16	읽어올 데이터의 크기가 저장할 공간보다 큰 경우에 반환하는 값이다.
20	파일에서 읽은 데이터를 저장할 메모리 할당에 실패한 경우에 반환하는 값이다.
24	일본어 파일의 OPEN을 실패한 경우에 반환하는 값이다.
36	파일의 접근에 실패한 경우에 반환하는 값이다.

5. SJIS2JIS(JIS2SJIS)

SJIS2JIS는 SJIS 코드 페이지의 데이터를 JIS 코드 페이지 데이터로 변환하는 기능을 수행한다. JIS2SJIS는 반대의 기능을 수행하며 사용법은 동일하다.

다음은 SJIS2JIS를 호출하는 예제이다.

WORKING-STORAGE SECTION.
01 P1      PIC S9(9) COMP.
01 P2      PIC S9(4) COMP.
01 P3      PIC X(10).
01 P4      PIC S9(4) COMP.
01 P5      PIC X(20).
01 P6      PIC S9(4) COMP.
...
PROCEDURE DIVISION.
CALL 'SJIS2JIS' USING P1, P2, P3, P4, P5, P6.

파라미터

다음은 SJIS2JIS를 호출하는 경우에 사용하는 각 항목에 대한 설명이다.

파라미터	설명
P1	SJIS2JIS의 수행 결과를 반환하는 항목이다.
P2	변환 처리할 데이터의 길이를 입력하는 항목이다.
P3	변환 처리할 데이터를 입력하는 항목이다.
P4	변환 처리 후 반환받을 데이터의 길이를 입력하는 항목이다.
P5	변환 처리된 데이터를 항목하는 변수이다.
P6	변환 처리된 데이터의 길이를 반환하는 항목이다. 변환에 실패한 경우 0을 반환한다.

파라미터

설명

SJIS2JIS의 수행 결과를 반환하는 항목이다.

변환 처리할 데이터의 길이를 입력하는 항목이다.

변환 처리할 데이터를 입력하는 항목이다.

변환 처리 후 반환받을 데이터의 길이를 입력하는 항목이다.

변환 처리된 데이터를 항목하는 변수이다.

변환 처리된 데이터의 길이를 반환하는 항목이다. 변환에 실패한 경우 0을 반환한다.

반환값

SJIS2JIS의 수행 결과로 반환되는 값에 대한 설명이다.

P1	설명
0	SJIS2JIS 가 정상 수행된 경우에 반환하는 값이다.
4	변환 처리된 데이터의 길이가 반환받을 데이터의 길이보다 긴 경우에 반환하는 값이다.
8	변환 처리할 데이터 내에 탁점 또는 반탁점과 함께 사용할 수 없는 문자가 입력된 경우에 반환하는 값이다.
12	변환 처리할 데이터가 잘못 입력된 경우에 반환하는 값이다.
16	SJIS2JIS 호출하는 경우에 전달한 변수에 문제가 있는 경우에 반환하는 값이다.
20	CPM 파일(코드 페이지 매핑 파일) 오픈에 실패한 경우에 반환하는 값이다.