변환기 프로그램의 인코딩 기능에 대한 매개변수 목록

매개변수 요약

다음 표에서 매개변수의 이름은 약식으로 표시됩니다: 표의 각 이름 앞에 encode_ 를 붙이면 매개변수의 이름을 알 수 있습니다.

표 1. 인코딩을 위한 매개변수
입력 encode_	입력 encode_	출력 encode_
eyecatcher entry_count function input_data_len user_token	데이터_ptr	reason response

함수

분석기 프로그램 또는 CICS® 호출자가 요청에 대한 변환기 프로그램 이름을 지정하면, 사용자 작성 응용 프로그램이 종료된 후 Encode 가 호출됩니다. 응용 프로그램에서 반환된 COMMAREA의 데이터를 사용하여 응답을 구성합니다.

매개변수

encode_data_ptr

(입력 및 출력)

입력 시, 이것은 CICS 에서 반환된 COMMAREA에 대한 포인터입니다. 어떤 응용 프로그램도 호출되지 않았다면, 이것은 변환기 프로그램의 COMMAREA 생성 함수( Decode )에 의해 생성된 COMMAREA에 대한 포인터입니다.

출력에서, 변환기 프로그램이 CICS 웹 클라이언트에 전송할 수 있도록 저장소의 버퍼에 HTTP 수동으로 구성한 경우, 이것은 응답을 포함하는 버퍼에 대한 포인터입니다. 포인터가 유효한 위치를 가리키도록 해야 합니다. 그렇지 않으면 결과가 예측할 수 없게 됩니다. 버퍼는 더블워드 정렬이어야 합니다. 처음 네 바이트는 버퍼의 길이를 지정하는 32비트 부호 없는 숫자여야 합니다. (COBOL에서는 PIC 9(8) COMP로 지정합니다.) 나머지 버퍼는 응답입니다.

변환 프로그램이 대신 응답을 보내기 위해 EXEC CICS WEB API 명령을 사용한 경우, CICS 이 포인터로 표시된 모든 저장소 블록을 무시하고 삭제합니다. CICS 이 경우, 포인터는 COMMAREA에 대한 포인터로 남아 있을 수 있습니다. 이 경우, 설정은 중요하지 않습니다.

오프셋 모드에서 호출된 CICS 비즈니스 로직 인터페이스에서 변환기가 호출된 경우 이 필드를 출력으로 사용하지 마십시오.

엔코드 엔트리 카운트

(입력 전용)

Encode 함수가 현재 웹 요청에 대해 몇 번 입력되었는지 세는 카운트입니다.

encode_eyecatcher

(입력 전용)

길이 8의 문자열. Encode 의 가치는 >encode .

encode_function

(입력 전용)

상수값으로 설정된 반단어 코드 URP_ENCODE 는 Encode 가 호출되고 있음을 나타냅니다.

encode_input_data_len

(입력 전용)

Decode 가 decode_output_data_len 에 명시한 COMMAREA의 길이입니다.

encode_reason

(출력 전용)

이유 코드 (응답 및 이유 코드 참조).

encode_response

(출력 전용)

응답 (응답 및 이유 코드 참조).

encode_user_token

(입력 전용)

Decode 함수에 의해 출력된 64비트 토큰은 decode_user_token 로 표시됩니다.

encode_version

(입력)

단일 문자 매개변수 목록 버전 식별자, 매개변수 목록의 레이아웃이 변경될 때마다 변경됩니다. CICS 지원되는 릴리스 수준에 있는 경우, 그 값은 문자 0 F0 입니다.

encode_volatile

(입력)

encode_data_ptr 가 가리키는 데이터 영역을 대체할 수 있는지 여부를 나타내는 단일 문자 코드입니다. 가능한 값은 다음과 같습니다.

0: 이 영역은 다른 영역의 일부이며 대체할 수 없습니다.
1: 다음에 의해 가리키는 저장소
encode_data_ptr
를 해제하고 다른 크기의 작업 영역으로 교체할 수 있습니다.

응답 및 이유 코드

encode_response 에 다음 값 중 하나를 반환해야 합니다

기호 값	숫자 값	설명
URP_OK	0	버퍼에 있는 응답은 encode_data_ptr EXEC CICS 의 WEB API 명령어가 응답을 보내는 데 이미 사용되지 않은 경우 클라이언트로 전송됩니다
URP_DISASTER	12	CICS 웹 지원 CICS 예외 추적 항목(추적 포인트 455D )을 작성하고 메시지 DFHWB0122 )를 발행합니다. 요청이 HTTP 인 경우, 상태 코드 501이 웹 클라이언트로 전송됩니다. 요청이 HTTP 아닌 경우, 응답이 전송되지 않고 TCP/IP 소켓이 닫힙니다. CICS 비즈니스 로직 인터페이스 CICS 예외 추적 항목(추적 포인트 455D )을 작성하고, 메시지 DFHWB0122 )를 발행한 다음, 호출자에게 501 응답을 반환합니다.
URP_OK_LOOP	16	CICS 시작점으로 돌아갑니다 디코드 함수. encode_user_token 에 저장된 값은 Decode 변환기 기능이 사용하기 위해 decode_user_token 에 복사됩니다.
다른 모든 값		CICS 웹 지원 CICS 예외 추적 항목(추적 포인트 455E )을 작성하고 메시지 DFHWB0122 )를 발행합니다. 요청이 HTTP 인 경우, 상태 코드 501이 웹 클라이언트로 전송됩니다. 요청이 HTTP 아닌 경우, 응답이 전송되지 않고 TCP/IP 소켓이 닫힙니다. CICS 비즈니스 로직 인터페이스 CICS 예외 추적 항목(추적 포인트 455E )을 작성하고, 메시지 DFHWB0122 )를 발행한 다음, 호출자에게 501 응답을 반환합니다.

encode_reason 에서 32비트 이유 코드를 입력하여 오류 발생 시 추가 정보를 제공할 수 있습니다. CICS 웹 지원이나 CICS 비즈니스 로직 인터페이스는 반환된 이유 코드에 대해 어떠한 조치도 취하지 않습니다. Encode 기능. Encode 함수의 호출로 인해 발생하는 모든 추적 항목에 코드 출력이 나타나는 이유입니다.