z/OS Connect 데이터 변환을 위한 변환
z/OS® Connect 기능은 z/OS용 WebSphere® Application Server, Liberty 환경에서 실행됩니다. BBGLS2JS 및 BBGJS2LS JCL(Job Control Language) 도구를 사용하여 데이터 변환을 용이하게 하기 위해 필요한 z/OS Connect 아티팩트를 생성할 수 있습니다.
BBGLS2JS: z/OS Connect 데이터 변환을 위한 고급 언어에서 바인딩 및 스키마 파일로의 변환
BBGLS2JS JCL(Job Control Language) 프로시저는 상위 레벨 데이터 구조에서 JSON(JavaScript Object Notation) 스키마 및 바인딩 파일을 생성합니다. 생성되는 파일은 z/OS Connect 데이터 변환 프로세스에서 사용됩니다. 이는 CICS®(Customer Information Control Center) Transaction Server Mobile Extensions 기능팩의 DFHLS2JS를 기반으로 합니다.
BBGLS2JS 도구 사용에 대한 사용법 정보 및 예제는 문서를 참조하십시오. 문서가 DFHLS2JS를 참조하는 경우에는 BBGLS2JS를 사용하십시오. https://www.ibm.com/support/knowledgecenter/SSGMCP_5.1.0/com.ibm.cics.ts51.home.doc/library/library_pdf_collections.html
BBGLS2JS에서는 다음과 같은 기호 매개변수가 정의됩니다.
WLPDIR=path: UNIX System Services 파일 시스템에서 WebSphere Application Server Liberty 디렉토리의 이름을 지정하는 필수 매개변수입니다.
TMPDIR=tmpdir: BBGLS2JS가 임시 작업공간으로 사용하는 IBM® z/OS Unix System Services의 디렉토리의 위치를 지정합니다. 작업을 실행하는 데 사용되는 사용자 ID는 이 디렉토리에 대한 읽기 및 쓰기 권한을 가지고 있어야 합니다. 이는 선택적 매개변수이며 지정되지 않은 경우 기본값은 /tmp입니다.
사용자는 java.io.tmpdir 사용자 정의 특성을 코딩할 때 새 임시 작업공간을 사용하기 위해 Java API의 절대 경로를 지정합니다. 스크립트의 경우에는 이 임시 디렉토리를 가리키도록 환경 변수 TMPDIR을 지정합니다.
TMPFILE=tmpprefix 임시 작업공간 파일의 이름을 구성하기 위해 BBGLS2JS가 사용하는 접두부를 지정합니다. 이는 선택적 매개변수이며 지정되지 않은 경우 기본값은 LS2JS입니다.
DFHLS2JS에 대해 문서화된 입력 매개변수는 BBGLS2JS에도 적용할 수 있습니다. PGMNAME 매개변수에 대해 지정되는 값은 생성된 JSON 스키마에서 사용됩니다.
다음 예제에서는 JCL을 작성하여 BBGLS2JS 도구를 실행하는 방법을 보여줍니다.
//LS2JS JOB 'accounting information',name,MSGCLASS=A
//JCLLIB JCLLIB ORDER=EXAMPLE.DSNAME
//JAVAPROG EXEC BBGLS2JS,
// WLPDIR='/opt/IBM/wlp'
//INPUT.SYSUT1 DD *
PDSLIB=TEST.DSNAME
REQMEM=CDATA2
RESPMEM=CDATA2
MAPPING-LEVEL=3.0
MINIMUM-RUNTIME-LEVEL=3.0
CHAR-VARYING=COLLAPSE
STRUCTURE=(requestData,requestData)
JSON-SCHEMA-REQUEST=/u/user1/json/getcustc_request.json
JSON-SCHEMA-RESPONSE=/u/user1/json/getcustc_response.json
LANG=C
LOGFILE=/u/user1/wsbind/getcustc.log
URI=http://myserver.example.org:8080/exampleApp/example
PGMINT=COMMAREA
PGMNAME=GETCUSTC
WSBIND=/u/user1/getcustc.wsbind
/*
BBGJS2LS: z/OS Connect 데이터 변환을 위한 JSON 스키마에서 고급 언어로의 변환
BBGJS2LS JCL 프로시저는 JSON 스키마에서 고급 언어 데이터 구조 및 바인딩 파일을 생성합니다. 생성되는 파일은 z/OS Connect 데이터 변환 프로세스에서 사용됩니다. 이는 CICS Transaction Server Mobile Extensions 기능팩의 DFHJS2LS를 기반으로 합니다.
BBGJS2LS 도구 사용에 대한 사용법 정보 및 예제는 문서를 참조하십시오. 문서가 DFHJS2LS를 참조하는 경우 BBGJS2LS를 사용하십시오. https://www.ibm.com/support/knowledgecenter/SSGMCP_5.1.0/com.ibm.cics.ts51.home.doc/library/library_pdf_collections.html
BBGJS2LS에서는 다음과 같은 기호 매개변수가 정의됩니다.
WLPDIR=path: UNIX System Services 파일 시스템에서 WebSphere Application Server Liberty 디렉토리의 이름을 지정하는 필수 매개변수입니다.
TMPDIR=tmpdir: BBGJS2LS가 임시 작업공간으로 사용하는 z/OS UNIX의 디렉토리의 위치를 지정합니다. 작업을 실행하는 데 사용되는 사용자 ID는 이 디렉토리에 대한 읽기 및 쓰기 권한을 가지고 있어야 합니다. 이는 선택적 매개변수이며 지정되지 않은 경우 기본값은 /tmp입니다.
TMPFILE=tmpprefix 임시 작업공간 파일의 이름을 구성하기 위해 BBGJS2LS가 사용하는 접두부를 지정합니다. 이는 선택적 매개변수이며 지정되지 않은 경우 기본값은 JS2JS입니다.
DFHJS2LS에 대해 문서화된 입력 매개변수는 BBGJS2LS에도 적용할 수 있습니다. PGMNAME 매개변수에 대해 지정되는 값은 생성된 고급 언어 구조의 이름에서 사용됩니다.
다음 예제에서는 JCL을 작성하여 BBGJS2LS 도구를 실행하는 방법을 보여줍니다.
//JS2LS JOB 'accounting information',name,MSGCLASS=A
// SET QT=''''
//JCLLIB JCLLIB ORDER= EXAMPLE.DSNAME
//JAVAPROG EXEC BBGJS2LS,
// WLPDIR='/opt/IBM/wlp'
//INPUT.SYSUT1 DD *
PDSLIB=TEST.DSNAME
REQMEM=CPYBK1
RESPMEM=CPYBK2
JSON-SCHEMA-REQUEST=example.json
JSON-SCHEMA-RESPONSE=example.json
LANG=COBOL
LOGFILE=/u/exampleapp/wsbind/example.log
MAPPING-LEVEL=3.0
CHAR-VARYING=NULL
INLINE-MAXOCCURS-LIMIT=2
PGMNAME=DFH0XCMN
URI=exampleApp/example
PGMINT=COMMAREA
SYNCONRETURN=YES
WSBIND=/u/exampleapp/wsbind/example.wsbind
/*