z/OS JCL 변수

BFGCUSTM 스크립트에서 대체 값, JCL 변수 및 구성 특성을 사용할 수 있습니다.

다음 표에는 MFT 명령 PDSE 라이브러리 데이터 세트의 BFGCUSTM JCL 스크립트에 대한 대체 값이 나열되어 있습니다. BFGCUSTM 작업을 제출하기 전에 이러한 대체 값을 적당한 값으로 바꿔야 합니다.

표 1. BFGCUSTM JCL 스크립트에 대한 대체 값
대체 변수	값
++library++	포함하는 MFT 명령 PDSE 라이브러리의 데이터 세트 이름입니다.
++bfg_java_home++	Java 설치의 위치입니다.
++mq_path++	IBM® MQ for z/OS® UNIX System Services Components 디렉토리의 경로입니다. 예를 들어, /mqm/V9R2M0입니다. 이는 MFT 설치의 전체 경로를 제공하는 데 사용됩니다(예: /mqm/V9R2M0/mqft).

다음 표에서는 MFT 명령 PDSE 라이브러리 데이터 세트 ([Variables] 섹션) 에서 BFGCUSTM JCL 스크립트에 대한 BFGSTDIN DD문의 환경 변수를 설명합니다. BFGCUSTM 작업을 제출하기 전에 대체 값으로 지정된 모든 변수(두 개의 더하기 부호 ++로 묶여 있는 값)를 적당한 값으로 바꿔야 합니다.

표 2. 환경 변수
환경 변수	값
LIBRARY	포함하는 MFT 명령 PDSE 라이브러리의 데이터 세트 이름입니다.
TMPDIR	임시 파일용 z/OS UNIX System Services 디렉토리.
BFG_PROD	IBM MQ for z/OS UNIX System Services Components 디렉토리 아래의 mqft 디렉토리에 대한 전체 경로입니다(예: /mqm/V9R2M0/mqft).
BFG_DATA	z/OS용 Managed File Transfer 에 대한 데이터 디렉토리의 위치이며, `DATA_DIR`에 대한 경로입니다.
BFG_JAVA_HOME	Java 설치의 위치입니다.
BFG_JVM_PROPERTIES	BFG_JVM_PROPERTIES 환경 변수의 값을 설정합니다. 이러한 특성은 Java 가상 시스템으로 전달됩니다. 에서 값을 설정하세요. 를 사용하는 IBM MQ 9.4.5 경우 `-Dfile.encoding=COMPAT` 또는 `-Dfile.encoding=IBM-1047` 로 IBM Semeru Runtime 21 설정하세요. 이 값은 가 기본 파일 인코딩으로 UTF-8 을 사용하지만 MFT 는 IBM Semeru Runtime 21IBM-1047 인코딩을 필요로 하기 때문에 필수입니다. 이전 IBM MQ 버전에서는 이 환경 변수가 선택 사항입니다.
BFG_GROUP_NAME	mqm 파일 그룹은 일반적으로 MFT 구성 데이터 파일 및 명령과 연관됩니다. 따라서 mqm 그룹의 구성원인 모든 사용자는 MFT 구성에 액세스하고 변경할 수 있습니다. 자세한 정보는 IBM MQ의 MFT 에 대한 파일 시스템 권한을 참조하십시오. z/OS 시스템의 경우, 파일 그룹은 z/OS UNIX System Services (z/OS UNIX) 파일 시스템 엔티티이며 mqm 파일 그룹이 반드시 정의되지는 않습니다. BFG_GROUP_NAME 환경 변수를 사용하여 MFT 구성 데이터 파일에 대한 z/OS UNIX 파일 시스템 그룹을 연관시킬 수 있습니다. 예를 들어, z/OS UNIX 쉘 프롬프트에서 다음을 사용하십시오. `export BFG_GROUP_NAME=FTEGB` 이는 현재 z/OS UNIX 세션에 대해 이후에 작성되는 구성 파일과 연관될 그룹 `FTEGB` 를 정의합니다. BFG_GROUP_NAME을 공백 값으로 설정하거나 제거할 수 있습니다. 참고: BFGCUSTM을 처음 실행할 때 여러 사용자 ID가 MFT 구성을 사용하는 경우 BFG_GROUP_NAME을 모든 필수 사용자 ID가 액세스할 수 있는 그룹으로 설정하는 것이 중요합니다. BFGCUSTM이 다시 실행되면 BFG_GROUP_NAME을 변경하지 않아야 합니다. 그렇지 않으면 BFG_DATA에서 참조하는 디렉토리의 모든 파일 및 디렉토리에 대한 z/OS UNIX 그룹 파일 권한도 새 BFG_GROUP_NAME 설정을 반영하도록 변경해야 합니다.
BFG_WTO	BFG_WTO가 YES, ON 또는 TRUE로 설정되면 z/OS 로깅이 사용 가능으로 설정됩니다. 에이전트 이벤트 로그에 기록된 메시지가 JCL에서 에이전트를 실행하는 경우 자동화 제품에 쉽게 액세스할 수 있도록 허용하는 z/OS 연산자 로그 기능에도 기록되는지 여부를 제어합니다. 라우팅 코드는 프로그래머 정보(11)이고 디스크립터 코드는 정보 제공(12)입니다.
SERVICE_TYPE	MFT 명령 라이브러리가 에이전트 또는 로거용인지 여부를 지정합니다. 올바른 값은 AGENT 또는 LOGGER입니다.
이름	SERVICE_TYPE 값인 에이전트 또는 로거의 이름입니다.
QMGR	SERVICE_TYPE 값인 에이전트 또는 로거와 연관된 로컬 큐 관리자의 이름입니다.
OUTPUT_CLASS	SYSOUT 데이터 세트의 출력 클래스입니다. 기본값은 *이며 작업 명령문의 MSGCLASS 매개변수와 동일한 출력 클래스를 요청합니다.
MQ_PATH	IBM MQ for z/OS UNIX 구성요소 디렉토리의 경로입니다.
MQ_HLQ	IBM MQ 데이터 세트의 상위 레벨 규정자입니다.
MQ_LANG	필수인 언어입니다.
DB2_HLQ	선택사항. ' Db2® ' 데이터 집합에 대한 상위 수준 한정자.
JOBCARD1	JCL 명령 작업의 헤더 1행입니다.
JOBCARD2	JCL 명령 작업의 헤더 2행입니다.
JOBCARD3	JCL 명령 작업의 헤더 3행입니다.
ADMIN_JOB1	관리 작업의 헤더 1행입니다.
ADMIN_JOB2	관리 작업의 헤더 2행입니다.
ADMIN_JOB3	관리 작업의 헤더 3행입니다.
FTE_CONFIG	마이그레이션을 위한 기존 MFT 구성입니다. 마이그레이션이 필요하지 않은 경우 공백 값으로 설정하십시오.
CREDENTIAL_PATH	마이그레이션을 위한 신임 정보 파일에 대한 경로(예: /u/user1/agent3)입니다. 마이그레이션 명령 BFGAGMG 및 BFGLGMG JCL 스크립트의 마이그레이션에만 필요합니다. 마이그레이션이 필요하지 않은 경우 공백 값으로 설정하십시오. 또한 다음에 유의하십시오.
DB_PROPS_PATH	마이그레이션할 데이터베이스 로거 특성 파일을 지정합니다. 이 옵션은 특성 파일이 다음 기본 이름 및 경로를 사용하지 않는 경우에만 필요합니다. config_directory/coordination_qmgr/databaselogger.properties. 마이그레이션이 필요하지 않은 경우 공백 값으로 설정하십시오.

다음 표에서는 MFT 명령 PDSE 라이브러리 데이터 세트의 BFGCUSTM JCL 스크립트에 대한 BFGSTDIN DD문의 필수 MFT 구성 특성을 설명합니다. BFGCUSTM 작업을 제출하기 전에 대체 값으로 지정된 특성(두 개의 더하기 부호 ++로 묶여 있는 값)을 공백이 아닌 적당한 값으로 바꿔야 합니다. 이 특성은 MFT 구성 특성에 대한 대체를 정의합니다. 에이전트 또는 로거 특성을 추가하여 에이전트 또는 로거를 환경에 맞게 사용자 정의할 수 있습니다. 모든 속성 목록은 구성 속성 파일을 참조하십시오.

표 3. BFGSTDIN DD문에 대한 필수 구성 특성
특성	값
coordinationQMgr	에이전트 또는 로거가 연관된 구성에 대한 조정 큐 관리자의 이름입니다.
coordinationQMgrHost	선택사항. 조정 큐 관리자가 실행 중인 시스템의 호스트 이름입니다. 이 특성 값을 공백으로 두면 바인딩 모드 연결이 가정됩니다.
coordinationQMgrPort	선택사항. 조정 큐 관리자가 대기하고 있는 포트 번호입니다. 이 매개변수는 coordinationQMgrHost 특성을 공백이 아닌 값으로 지정한 경우에만 사용됩니다.
coordinationQMgrChannel	선택사항. 조정 큐 관리자에 연결하는 데 사용할 채널입니다. 이 매개변수는 coordinationQMgrHost 특성을 공백이 아닌 값으로 지정한 경우에만 사용됩니다.
connectionQMgr	에이전트 또는 로거가 연관된 구성에 대한 명령 큐 관리자의 이름입니다.
connectionQMgrHost	선택사항. 명령 큐 관리자가 실행 중인 시스템의 호스트 이름입니다. 이 특성 값을 공백으로 두면 바인딩 모드 연결이 가정됩니다.
connectionQMgrPort	선택사항. 명령 큐 관리자가 대기하고 있는 포트 번호입니다. 이 매개변수는 connectionQMgrHost 특성을 공백이 아닌 값으로 지정한 경우에만 사용됩니다.
connectionQMgrChannel	선택사항. 명령 큐 관리자에 연결하는 데 사용할 채널입니다. 이 매개변수는 connectionQMgrHost 특성을 공백이 아닌 값으로 지정한 경우에만 사용됩니다.