TJESMGR 명령어
본 장에서는 JOB 실행 명령어, JOB/OUTPUT 명령어, RUNNER SLOT 명령어, INITIATOR 명령어, 데이터 셋 명령어, SPOOL 백업 명령어와 기타 TJESMGR 명령어에 대해 기술한다.
1. 개요
tjesmgr는 JOB과 TJES를 관리하는 기능뿐만 아니라 데이터셋과 관련한 작업과 SPOOL 백업 기능 등을 수행한다. tjesmgr는 TACF 또는 OS 사용자로 로그인을 해야 하며, submit할 JCL에 따로 사용자가 파라미터로 등록되어 있지 않다면 로그인된 사용자는 JOB을 submit하는 사용자가 된다.
tjesmgr는 tjesmgr에 접속한 후 tjesmgr 실행 화면에서 명령어를 수행하는 것이 일반적이지만, UNIX 시스템의 명령어 라인에서 하나의 명령어를 실행하는 것도 가능하다. 실행 방법은 tjesmgr –h를 통해서 확인할 수 있다.
tjesmgr의 명령어들은 TJESMGR 클래스로 TACF에 리소스로 등록할 때 실행 권한을 제어할 수 있다. 자세한 내용은 OpenFrame TACF "운영자 안내서"를 참고한다. |
-
tjesmgr 실행방법
$ tjesmgr -i[ USERID[ [GROUPNAME] ]][/PASSWORD] [command]
다음은 로그인 정보의 방법으로 우선순위가 높은 순으로 나열한 것이다.
-
사용자가 -i 옵션으로 입력하는 경우
-
JCL 내에서 호출되는 PROGRAM이 SACEE 정보를 이용하는 경우(JCL 내의 PGM 파라미터에 의해 해당 툴이 호출되거나 셸 스크립트 등의 간접적인 방법으로 호출될 경우)
-
tacflogin 정보를 이용하는 경우
-
OpenFrame 환경설정에서 가져오는 경우
-
사용자로부터 키보드 입력을 받는 경우
-
-
tjesmgr 사용방법 조회
$ tjesmgr -h
-
tjesmgr 버전 정보 조회
$ tjesmgr -v
다음은 UNIX 명령어 라인에서 PS(Print Screen)를 실행하는 예이다.
$ tjesmgr –iUSERNAME/PASSWORD ps n=TEST
다음의 예는 선행 명령어가 필요한 경우로 명령어 처리를 할 수 없다.
$ tjesmgr –iUSERNAME/PASSWORD
$ PODD JOB00001 di=1
PSJOB 또는 POSPOOL이 먼저 실행되어야 PODD 명령을 실행할 수 있다. 따라서 명령어 라인에서 위의 예제는 실행할 수 없다. 자세한 내용은 PODD(Print Output DD Information) 명령어를 참고한다.
명령어 목록
다음은 각 명령어의 목록이다.
-
JOB 실행 명령어
명령어 설명 입력된 job-ID 또는 job-name에 해당하는 JOB들을 제거(purge)한다.
입력된 job-ID 또는 job-name에 해당하는 JOB들의 상태를 START 상태에서 HOLD 상태로 바꾼다.
입력된 job-ID 또는 job-name에 해당하는 JOB들의 class을 변경한다.
입력된 job-ID에 해당하는 JOB의 우선순위를 변경한다.
입력 JCLFILE에 대하여 PGM 오퍼랜드에 지정된 프로그램이 존재하는지, DD 문에 기술된 데이터셋이 존재하는지, 카탈로그에 등록되어 있는지 여부를 논리적으로 체크한다. 처리가 끝나면 DONE 상태로 JOBQ에 쌓인다.
입력된 job-ID 또는 job-name에 해당하는 JOB들에 중앙 처리 장치의 사용시간에 대한 상대적인 우선순위를 설정한다.
입력된 job-ID 또는 out-number에 해당하는 JOB들의 OUTPUT들을 OUTPUTQ에서 제거한다.
입력된 job-ID 또는 out-number에 해당하는 JOB들의 OUTPUT에 대한 DISPOSITION을 HOLD에서 WRITE로 바꾼다.
입력된 프러시저를 실행하는 STEP을 가진 JOB을 생성한 후 submit한다.
입력된 job-ID 또는 job-name에 해당하는 JOB들을 제거한다.
입력된 job-ID 또는 job-name에 해당하는 JOB들의 상태를 SUSPEND 상태에서 RESUME 상태로 바꾼다.
입력 파라미터에 따라서 JOB을 submit한다.
입력 JCLFILE에 대하여 문법 검사를 실행한다. 문법이 이상이 없으면 DONE 상태로 JOBQ에 쌓인다.
입력된 job-ID 또는 job-name에 해당하는 JOB들의 상태를 HOLD 상태에서 START 상태로 바꾼다.
입력된 job-ID 또는 job-name에 해당하는 JOB들의 상태를 WORKING 상태에서 STOP 상태로 바꾼다.
입력된 job-ID 또는 job-name에 해당하는 JOB들의 상태를 WORKING 상태에서 SUSPEND 상태로 바꾼다.
-
JOB/OUTPUT 명령어
명령어 설명 JOBID별 OUTPUT 상태를 보여준다.
입력된 job-ID의 dd-index 또는 dd-name에 SPOOL을 OpenFrame 환경설정에 tjesmgr 서브젝트, DEFAULT_OPTION 섹션의 VIEWER 키의 VALUE 항목에 설정한 뷰어로 열어준다.
입력된 job-ID에 해당하는 JOB의 OUTPUT 정보를 보여준다.
OUTPUT 리스트들의 상세 정보를 보여준다.
입력된 JOBID에 해당하는 JOB의 SPOOL 정보를 보여준다.
입력 파라미터의 조건에 해당하는 JOBQ에 있는 JOB들에 대한 JOBNAME, JOBID, CLASS, STATUS, RC, NODE, JCL 리스트를 보여준다.
입력 조건에 해당하는 Job History를 출력한다.
입력된 job-ID에 해당하는 JOB의 데이터셋 I/O 횟수를 보여준다.
입력된 job-ID에 해당하는 JOB에 대한 상세 정보를 출력한다.
입력된 job-ID에 해당하는 JOB의 STEP 정보를 출력한다.
-
INITIATOR 명령어
명령어 설명 전체 노드의 TJES를 Boot한다.
해당 클래스의 상태를 변경한다.
명령어 라인에서 입력받은 Runner Slot의 상태를 Active에서 Inactive로 또는 Inactive에서 Active로 변경한다.
해당 Runner Slot의 클래스를 입력으로 받은 클래스로 변경한다.
해당 노드의 모든 JOB을 STOP시킨다.
전체 노드의 상태를 보여준다.
클래스별로 JOB들의 상태 카운트를 보여준다.
해당 노드의 Runner Slot 상태를 보여준다.
전체 노드의 TJES를 다운(down)시킨다.
클래스의 상태를 보여준다.
-
데이터셋 명령어
명령어 설명 입력에 해당하는 from-dataset-name을 to-dataset-name으로 복사하거나 to-volume-serial 볼륨으로 복사한다.
명령을 실행하면 사용자 입력 화면이 나타나고 사용자로부터 입력 받은 조건에 해당하는 Non-VSAM 데이터셋을 생성한다.
입력에 해당하는 Non-VSAM 데이터셋들을 삭제한다.
입력에 해당하는 Non-VSAM 데이터셋을 외부로 반출한다.
외부로 반출한 파일을 읽어서 데이터셋으로 복원한다.
입력 조건에 해당하는 VTOC에 등록되어있는 데이터셋 리스트를 보여준다.
데이터셋의 이름을 변경하거나 볼륨을 변경 또는 두 작업을 모두 수행한다.
명령을 실행하면 사용자 입력 화면이 나타나고 입력 조건에 해당하는 Non-VSAM 데이터셋을 리카탈로그한다.
입력에 해당하는 데이터셋들을 카탈로그에서 삭제한다.
입력에 해당하는 Non-VSAM 데이터셋의 마지막 수정 날짜를 변경한다.
명령을 실행하면 입력을 받을 창이 뜨고 입력 조건에 맞게 GDG 데이터셋을 생성한다.
입력에 해당하는 GDG 데이터셋을 삭제한다.
입력 조건에 해당하는 카탈로그에 등록되어있는 데이터셋 리스트를 보여준다.
입력에 해당하는 데이터셋의 상세정보를 보여준다.
입력에 해당하는 엔트리의 상세정보를 보여준다.
입력에 해당하는 데이터셋의 Lock 정보를 보여준다.
명령을 실행하면 볼륨에 대한 정보를 보여준다.
입력받은 카탈로그를 기본 카탈로그로 하여 데이터셋 관련 명령어에서 사용한다.
-
SPOOL 백업 명령어
명령어 설명 입력에 해당하는 SPOOL을 백업한다.
입력 조건에 해당하는 년/월에 백업된 날짜들을 보여준다.
현재 수행 중이거나 종료된 SPOOL 백업 작업 상태를 보여준다.
수행 중인 백업 작업을 중단한다.
입력 조건에 해당하는 임시 디렉터리에 복원된 SPOOL을 제거한다.
입력 조건에 해당하는 복원된 JOB의 SPOOL을 설정한 뷰어로 열어준다.
입력 조건에 해당하는 복원된 JOB의 SPOOL 정보를 보여준다.
입력 조건에 해당하는 날짜에 백업된 SPOOL 리스트를 보여준다.
입력 조건에 해당하는 복원된 JOB의 상세 정보를 보여준다.
입력 조건에 해당하는 복원된 JOB의 I/O 정보를 보여준다.
입력 조건에 해당하는 백업된 SPOOL의 내용을 조회할 수 있게 임시 디렉터리에 복원한다.
-
기타 명령어
명령어 설명 명령을 실행하면 tjesmgr의 화면을 제거한다.
현재 로그인된 사용자의 ID를 보여준다.
입력한 filepath을 지정한 에디터로 열어준다.
입력한 error-number에 해당하는 에러 메시지를 보여준다.
입력 명령어에 해당하는 명령어 사용법을 보여준다. 명령어를 주지 않은 경우 모든 명령어의 사용법을 보여준다.
입력에 해당하는 라이선스 파일의 정보를 보여준다.
현재 로그인된 USERID로 NOTIFY 처리시킨 JOB의 실행 정보를 보여준다.
OpenFrame 환경설정에 등록되어 있는 프린터의 정보를 보여준다.
사용자 입력 화면이 나타나고 사용자로부터 입력 받은 ID에 해당하는 사용자로 로그인된다.
현재 TSO에 접속한 사용자의 목록을 보여준다.
TJES의 버전정보를 보여준다.
각 명령어의 환경설정 예제에 서브젝트, 섹션, 키에 대한 자세한 설명은 OpenFrame Batch "환경설정 안내서"를 참고한다. |
2. JOB 실행 명령어
JOB 실행 명령어는 JOB을 submit하고 JOB의 상태를 변경할 수 있는 명령어들이다. 본 절에서 해당 명령어의 사용법에 대해서 설명한다.
2.1. CANCEL
입력된 job-ID 또는 job-name에 해당하는 JOB들을 제거(purge)한다. HOLD 상태이거나 START 상태의 JOB들에 대해서만 유효하다.
-
사용법
CANCEL {<job-ID>|N=<job-name>}
2.2. HOLD
입력된 job-ID 또는 job-name에 해당하는 JOB들의 상태를 START 상태에서 HOLD 상태로 바꾼다. HOLD 상태의 JOB은 스케줄링이 되지 않는다. START 상태의 JOB들에 대해서만 유효하다.
-
사용법
HOLD {<job-ID>|N=<job-name>}
2.3. INQUEUECLASS
입력된 job-ID 또는 job-name에 해당하는 JOB들의 class을 변경한다. HOLD 상태이거나 START 상태인 JOB들에 대해서만 유효하다. 주로 해당 클래스의 Runner가 전부 할당되어 있어서 대상 JOB을 바로 실행하지 못하는 경우에 사용하게 된다.
-
사용법
INQUQUECLASS(IC) {job-ID|N=<job-name>} C=<class>
2.4. INQUEUEPRIORITY(IP)
입력된 job-ID에 해당하는 JOB의 우선순위를 변경한다. priority-number로는 0 ~ 15 사이의 값을 지정할 수 있으며, 높을수록 먼저 실행된다.
START나 HOLD의 상태의 JOB에 대해서만 사용이 가능하다.
-
사용법
INQUEUEPRIORITY(IP) <job-ID> <priority-number>
2.5. JEM
입력 JCLFILE에 대하여 PGM 오퍼랜드에 지정된 프로그램이 존재하는지, DD문에 기술된 데이터셋이 존재하는지, 카탈로그에 등록되어 있는지 여부를 논리적으로 체크한다. 처리가 끝나면 DONE 상태로 JOBQ에 쌓인다.
-
사용법
JEM <JCLFILE> [CAT=<catalog-name>] [VOL=<volume-serial>]
다음은 항목에 대한 설명이다.
항목 설명 <JCLFILE>
JCL 이름 또는 UNIX 파일경로를 지정하거나 DATASET 형식으로 지정할 수 있다.
파일 경로를 지정한 경우, L-type의 JCL로 취급한다.
데이터 셋을 지정한 경우, 함께 지정한 CAT 또는 VOL 파라미터를 참조하여 조회하나, 만약 둘 다 지정하지 않았다면 master 카탈로그와 default 볼륨에서 조회한다.
JCL 이름으로 설정하면 OpenFrame 환경설정에 tjes 서브젝트, PROCLIB 섹션의 JCLLIB, USERLIB 키의 VALUE 항목에 설정된 데이터셋에서 JCL을 찾는다. 단, 데이터셋 이름이 JOBnnnnn과 같이 JOBID의 형식과 일치되는 JCL은 사용할 수 없다.
[CAT=<catalog-name>]
JCLFILE을 DATASET 형식으로 설정할 때 데이터셋이 사용자 카탈로그에 등록되어 있다면 CAT=<catalog-name>를 지정한다.
[VOL=<volume-serial>]
JCLFILE을 DATASET형식으로 설정할 때, 데이터셋이 특정 볼륨에서 찾길 원한다면 VOL=<volume-serial>를 지정한다. CAT 파라미터와 같이 사용되는 경우, VOL 파라미터만 적용된다.
2.6. NICE
입력된 job-ID 또는 job-name에 해당하는 JOB들에 중앙 처리 장치의 사용시간에 대한 상대적인 우선순위를 설정한다. WORKING 상태의 JOB들에 대해서만 유효하다.
-
사용법
NICE {<job-ID>|N=<job-name>} <out-number>
다음은 입력 항목에 대한 설명이다.
항목 설명 <job-ID>
JOB ID이다.
<job-name>
JOB 이름이다.
<out-number>
0에서 20까지의 숫자이며, 숫자가 낮을수록 우선순위가 높다. 이 우선순위는 중앙처리장치의 사용시간의 우선순위이며, 입출력의 우선순위는 아니다.
2.9. PSTART
프러시저를 submit한다. 프러시저를 PSTART를 통해 submit을 하게 되면 해당 프러시저를 호출하는 STEP을 가진 JOB을 submit하게 되며, RUN의 동작과 같이 JOBQ에 submit된 job이 등록된다. 이때 프러시저는 카탈로그 프러시저여야 한다.
-
사용법
PSTART(PRS) <procedure-name> [C=<class>] [NODE=<node-name>] [<procedure-parameters>]
다음은 항목에 대한 설명이다.
항목 설명 <procedure-name>
실행하고자 하는 프러시저 이름을 명시한다.
프러시저 이름을 명시면 해당 프러시저를 실행하는 STEP을 가진 JCL이 생성되며, 이를 tjesmgr을 통해 submit한다. 이때 프러시저는 OpenFrame 환경설정에 tjes 서브젝트, PROCLIB 섹션의 PROC00 키의 VALUE 항목에 명시된 데이터셋에서 프러시저를 탐색한다.
[C=<class>]
프러시저를 실행할 JCL의 JOB CLASS를 명시한다.
[NODE=<node-name>]
-
node-name을 지정한 경우 : 지정한 노드에서 JOB이 수행되도록 submit 한다.
-
node-name을 지정하지 않은 경우 : OpenFrame 환경설정에 tjesmgr 서브젝트, DEFAULT_OPTION 섹션의 DEFAULT_RUNNING_NODE 키의 VALUE 항목에 설정된 값에 따라 JOB이 수행되도록 submit한다.
[<procedure-parameter>]
프러시저에서 사용할 기호 파라미터들을 명시한다.
JCL 문법과 같은 방법으로 <key>=<value>와 같이 명시 하며, 콤마(,)를 통해 다수의 파라미터를 명시할 수 있다.
-
2.10. REMOVE
입력된 job-ID 또는 job-name에 해당하는 JOB들을 제거한다. DONE, ERROR, STOP, FLUSH 상태의 JOB들에 대해서만 유효하다.
-
사용법
REMOVE {<job-ID>|N=<job-name>}
2.11. RESUME
입력된 job-ID 또는 job-name에 해당하는 JOB들의 상태를 SUSPEND 상태에서 RESUME 상태로 바꾼다. 즉, 일시정지된 JOB을 다시 실행시킨다. SUSPEND 상태의 JOB들에 대해서만 유효하다.
-
사용법
RESUME {<job-ID>|N=<job-name>}
2.12. RUN
입력 파라미터에 따라서 JOB을 submit한다. submit을 하게 되면 JOB은 START 상태로 JOBQ에 쌓이고 PS 명령어를 통해서 JOBQ에 쌓인 JOB을 확인할 수 있다.
-
사용법
RUN(R) <JCLFILE> [NODE=<node-name>] [STEP=<restart-step>] [CAT=<catalog-name>] [VOL=<volume-serial>]
다음은 항목에 대한 설명이다.
항목 설명 <JCLFILE>
JCL 이름 또는 UNIX 파일경로를 지정해 주거나 DATASET(또는 DATASET(MEMBER)) 형식으로 지정할 수 있다.
파일 경로를 지정한 경우, L-type의 JCL로 취급한다.
데이터 셋을 지정한 경우, 함께 지정한 CAT 또는 VOL 파라미터를 참조하여 조회하나, 만약 둘 다 지정하지 않았다면 master 카탈로그와 default 볼륨에서 조회한다.
JCL 이름으로 설정하면 OpenFrame 환경설정에 tjes 서브젝트, PROCLIB 섹션의 JCLLIB, USERLIB 키의 VALUE 항목에 설정된 데이터셋에서 JCL을 찾는다. 단, 데이터셋 이름이 JOBnnnnn과 같이 JOBID의 형식과 일치되는 JCL은 tjesmgr로 submit할 수 없다.
[NODE=<node-name>]
-
node-name을 지정한 경우 : 지정한 노드에서 JOB이 수행되도록 submit 할 수 있다.
-
node-name을 지정하지 않은 경우 : OpenFrame 환경설정에 tjesmgr 서브젝트, DEFAULT_OPTION 섹션의 DEFAULT_RUNNING_NODE 키의 VAULE 항목에 설정된 값에 따라서 현재 노드에서만 JOB을 수행할 수 있도록 할지 아니면, 전체 노드 중 아무 노드에서나 JOB을 수행할 수 있도록 할지를 결정한다.
[STEP=<restart-step>]
restart-step을 지정하게 되면 JCL에 지정된 STEP부터 JOB이 실행된다. IF 문 분기처 내부 STEP은 restart-step으로 지정할 수 없다.
[CAT=<catalog-name>]
JCLFILE을 DATASET 형식으로 설정할 때, 데이터셋이 사용자 카탈로그에 등록되어 있다면 CAT=<catalog-name>를 지정한다.
[VOL=<volume-serial>]
JCLFILE을 DATASET 형식으로 설정할 때, 데이터셋이 특정 볼륨에서 찾길 원한다면 VOL=<volume-serial>를 지정한다. CAT 파라미터와 같이 사용되는 경우, VOL 파라미터만 적용된다.
-
2.13. SCAN
입력 JCLFILE에 대하여 문법 검사를 실행한다. 문법이 이상이 없으면 DONE 상태로 JOBQ에 쌓인다.
-
사용법
SCAN(SCN) <JCLFILE> [CAT=<catalog-name>] [VOL=<volume-serial>]
다음은 항목에 대한 설명이다.
항목 설명 <JCLFILE>
JCL 이름 또는 UNIX 파일경로를 지정하거나 DATASET 형식으로 지정할 수 있다.
파일 경로를 지정한 경우, L-type의 JCL로 취급한다.
데이터 셋을 지정한 경우, 함께 지정한 CAT 또는 VOL 파라미터를 참조하여 조회하나, 만약 둘 다 지정하지 않았다면 master 카탈로그와 default 볼륨에서 조회한다.
JCL 이름으로 설정하면 OpenFrame 환경설정에 tjes 서브젝트, PROCLIB 섹션의 JCLLIB, USERLIB 키의 VALUE 항목에 설정된 데이터셋에서 JCL을 찾는다. 단, 데이터셋 이름이 JOBnnnnn과 같이 JOBID의 형식과 일치되는 JCL은 사용할 수 없다.
[CAT=<catalog-name>]
JCLFILE을 DATASET 형식으로 설정할 때 데이터셋이 사용자 카탈로그에 등록되어 있다면 CAT=<catalog-name>를 지정한다.
[VOL=<volume-serial>]
JCLFILE을 DATASET형식으로 설정할 때, 데이터셋이 특정 볼륨에서 찾길 원한다면 VOL=<volume-serial>를 지정한다. CAT 파라미터와 같이 사용되는 경우, VOL 파라미터만 적용된다.
2.14. START
입력된 job-ID 또는 job-name에 해당하는 JOB들의 상태를 HOLD 상태에서 START 상태로 바꾼다. HOLD 상태의 JOB에 대해서만 START 명령어가 유효하다.
-
사용법
START {<job-ID>|N=<job-name>}
3. JOB/OUTPUT 명령어
JOB/OUTPUT 명령어는 JOB을 submit한 후의 JOB 진행 상태와 결과 그리고 OUTPUT 관련 정보를 볼 수 있는 명령어이다. 본 절에서 해당 명령어의 사용법에 대해서 설명한다.
3.1. PO(Print Output status)
JOBID별 OUTPUT 상태를 보여준다.
-
사용법
PO
-
디스플레이 정보
JOBID별 OUTPUT 상태에 대한 디스플레이 정보는 다음과 같다.
정보 설명 JOBID
디스플레이 대상 JOBID이다.
OUTPUT STATUS
디스플레이 대상 OUTPUT 상태이다.
3.2. PODD(Print Output DD Information)
입력된 job-ID의 dd-index 또는 dd-name에 SPOOL을 OpenFrame 환경설정에 tjesmgr 서브젝트, DEFAULT_OPTION 섹션의 VIEWER 키의 VALUE 항목에 설정한 뷰어로 열어준다. PODD 명령어를 사용하기 위해서는 tjesmgr 내의 셸에서 실행되는 PSJOB이나 POSPOOL 명령이 선행되어야 한다.
-
사용법
PODD <job-ID> { DI=<dd-index> | DN=<dd-name> }
관련 환경설정
SPOOL을 열수 있는 뷰어를 확인한다.
$ ofconfig list -n NODE1 -s tjesmgr -sec DEFAULT_OPTION -k VIEWER -l ====================================================================================== SUBJECT : tjesmgr SECTION : DEFAULT_OPTION KEY : VIEWER TYPE : 2 DEFAULT_VALUE : vi &FILEPATH VALUE(M)* : vim -w&ROWCOUNT -R &FILEPATH VALUE(D) : vim -w&ROWCOUNT -R &FILEPATH AVAIL_VALUE : DESCRIPTION : Viewing program name for tjesmgr command PODD. &ROWCOUNT will be replaced window size. &FILEPATH will be replaced viewing filepath. -w&ROWCOUNT option is valid only for `old vi' not `vim'. ======================================================================================
3.3. POJOB(Print Output of JOB)
입력된 job-ID에 해당하는 JOB의 OUTPUT 정보를 보여준다.
-
사용법
POJOB(POJ) <job-ID>
다음은 입력 항목에 대한 설명이다.
항목 설명 <job-ID>
입력된 job-ID에 해당하는 JOB의 OUTPUT 정보이다.
-
디스플레이 정보
JOB의 OUTPUT에 대한 디스플레이 정보는 다음과 같다.
정보 설명 OUTPUTID
디스플레이 대상 OUTPUT ID이다.
DDID
디스플레이 대상 DD에 부여된 ID이다.
DDNAME
JCL에 기술되었던 DD 이름이다.
CLS
디스플레이 대상 OUTPUT CLASS이다.
ST
OUTPUT 상태이다.
FORMS
디스플레이 대상 JOB의 프린트 관련 옵션 정보이다.
CHARS
디스플레이 대상 JOB의 프린트 관련 옵션 정보이다.
FORMDEF
디스플레이 대상 JOB의 프린트 관련 옵션 정보이다.
PAGEDEF
디스플레이 대상 JOB의 프린트 관련 옵션 정보이다.
WRITER
디스플레이 대상 JOB의 프린트 관련 옵션 정보이다.
POJOB의 디스플레이 정보는 POLIST의 디스플레이 정보와 동일하다.
3.4. POLIST(Print Output detail LIST)
OUTPUT 리스트들의 상세 정보를 보여준다.
-
사용법
POLIST [<job-id>] [N=<job-name>] [S=<output-status>] [C=<outclass>]
-
디스플레이 정보
OUTPUT 리스트에 대한 디스플레이 정보는 다음과 같다.
정보 설명 OUTPUTID
디스플레이 대상 OUTPUT ID이다.
JOBID
디스플레이 대상 JOBID이다.
JOBNAME
디스플레이 대상 JOB 이름이다.
DDID
디스플레이 대상 DD에 부여된 ID이다.
DDNAME
JCL에 기술되었던 DD 이름이다.
CLS(OUTPUT CLASS)
디스플레이 대상 OUTPUT CLASS이다.
ST(OUTPUT STATUS)
OUTPUT 상태이다.
FORMS
디스플레이 대상 JOB의 프린트 관련 옵션 정보이다.
CHARS
디스플레이 대상 JOB의 프린트 관련 옵션 정보이다.
FORMDEF
디스플레이 대상 JOB의 프린트 관련 옵션 정보이다.
PAGEDEF
디스플레이 대상 JOB의 프린트 관련 옵션 정보이다.
WRITER
디스플레이 대상 JOB의 프린트 관련 옵션 정보이다.
DDID, FORMS, CHARS, FORMDEF, PAGEDEF, WRITER들은 PRINT 관련 정보들이다. 이에 대한 자세한 내용은 OUTPUT Processing과 SPOOL를 참고한다. |
3.5. POSPOOL(Print Output SPOOL of JOB)
입력된 JOBID에 해당하는 JOB의 SPOOL 정보를 보여준다.
-
사용법
POSPOOL <job-ID>
다음은 입력 항목에 대한 설명이다.
항목 설명 <job-ID>
입력된 job-ID에 해당하는 JOB의 SPOOL 정보이다.
-
디스플레이 정보
SPOOL에 대한 디스플레이 정보는 다음과 같다.
정보 설명 NO
DDINDEX로 PODD 명령을 실행하는 경우 입력 파라미터로 사용된다.
STEP
해당 SPOOL이 생성된 STEP 이름이다.
DDNAME
해당 SPOOL의 DD 이름이다.
SIZE
해당 SPOOL의 크기이다.
DSNAME
해당 SPOOL의 데이터셋 이름이다.
관련 환경설정
SPOOL_LIST는 SPOOL을 보여줄 조건을 설정한다.
$ ofconfig list -n NODE1 -s tjesmgr -sec DEFAULT_OPTION -k SPOOL_LIST -l
======================================================================================
SUBJECT : tjesmgr
SECTION : DEFAULT_OPTION
KEY : SPOOL_LIST
TYPE : 2
DEFAULT_VALUE : ALL
VALUE(M)* : ALL
VALUE(D) : ALL
AVAIL_VALUE : ALL,EXIST,GTZERO
DESCRIPTION : tjesmgr command(POSPOOL) display option.
ALL : display all spool list.
EXIST : display existing spool list.
GTZERO : display spool list whose size are greater than zero.
======================================================================================
3.6. PS(Print Screen)
입력 파라미터의 조건에 해당하는 JOBQ에 있는 JOB들에 대한 JOBNAME, JOBID, CLASS, STATUS, RC, NODE, JCL 리스트를 보여준다.
-
사용법
PS [{ N=<job-name> | [C=<class>] [S=<job-status>] [RC=<return-code>] [NODE=<node-name>] | [SUBM=<submit_date>|<submit_date(from)-submit_date(to)>] | <from-job-ID> [C=<class>] [S=<job-status>] [RC=<return-code>] [NODE=<node-name] | <job-status> | DESC N=<job-name>|RC=<return-code> }]
-
디스플레이 정보
JOBQ의 JOB에 대한 디스플레이 정보는 다음과 같다.
정보 설명 JOBNAME
디스플레이 대상 JOB의 JOBNAME이다.
JOBID
디스플레이 대상 JOB의 JOBID이다.
CLASS
디스플레이 대상 JOB CLASS이다.
STATUS
디스플레이 대상 JOB의 현재 상태이다. 1바이트의 문자로 상태를 나타내며, 각 문자가 의미하는 상태는 다음과 같다.
-
W : Working
-
D : Done
-
E : Error
-
F : Flush
-
S : Start
-
H : Hold
-
P : Suspend
-
T : Stop
RC
디스플레이 대상 JOB의 리턴코드이다.
NODE
JOB이 실행된 노드명이다.
SUBMIT-TIME
JOB이 submit된 시간이다. SUBM 옵션을 사용하는 경우에만 출력된다.
START-TIME
JOB이 실행된 시간이다.
END-TIME
JOB이 종료된 시간이다.
JCL
JOB이 기술되어있는 JCL 이름이다.
-
-
예제
CLASS, STATUS, RETCODE, NODENAME과 같은 순서로 조건을 주어야 한다.
-
올바른 예)
PS c=A s=W rc=0
-
틀린 예)
PS s=W c=A → 파싱 에러 발생
DESC Command는 화면에 JOB List를 역순으로 출력한다.
-
사용 예)
PS DESC
-
3.7. PSHISTORY(PSH)
Job history를 출력하는 명령이다.
명령을 실행하면 PSHISTORY 조건 검색창이 나타나고 사용자로부터 입력 받은 조건에 해당하는 Job history Log가 출력된다.
-
사용법
PSHISTORY(PSH)
-
입력 파라미터
다음은 입력 파라미터에 대한 설명이다.
파라미터 설명 USERID
Log에서 검색될 USERID를 지정한다.
DATE
Log에서 검색될 날짜를 지정한다.
OPERATION
Log에서 검색될 동작을 지정한다.
JOBID
Log에서 검색될 JOBID를 지정한다.
3.8. PSIO(Print Screen Input/Output information)
입력된 job-ID에 해당하는 JOB의 데이터셋 I/O 횟수를 보여준다.
-
사용법
PSIO <job-ID>
다음은 입력 항목에 대한 설명이다.
항목 설명 <job-ID>
입력된 job-ID에 해당하는 JOB의 데이터셋 I/O 횟수를 보여준다.
-
디스플레이 정보
데이터셋 I/O 디스플레이 정보는 다음과 같다.
정보 설명 [STEP]
해당 STEP의 이름이다.
DDNAME
JCL에 기술된 DD 이름이다.
DSNAME
데이터셋 이름이다.
RTV(Retrieved count)
STEP별 데이터셋의 검색된 횟수이다.
INS(Inserted count)
STEP별 데이터셋의 추가된 횟수이다.
UPD(Updated count)
STEP별 데이터셋의 업데이트된 횟수이다.
DEL(Deleted count)
STEP별 데이터셋의 삭제된 횟수이다.
3.9. PSJOB(Print Screen JOB detail information)
입력된 job-ID에 해당하는 JOB에 대한 상세 정보를 출력한다. 만약, 대상 JOB의 상태가 WORKING인 경우에는 상세 정보를 1초 단위로 업데이트해서 출력한다.
-
사용법
PSJOB(PSJ) <job-ID>
-
디스플레이 정보
PSJOB 디스플레이 정보는 다음과 같다.
정보 설명 JOBID
디스플레이 대상 JOB의 JOBID이다.
NODE NAME
JOB이 실행된 노드명이다.
JOB NAME
디스플레이 대상 JOB의 JOB 이름이다.
JOB CLASS
디스플레이 대상 JOB CLASS이다.
JOB STATUS
디스플레이 대상 JOB의 현재 STATUS이다.
DONE, ERROR, FLUSH인 경우 괄호( )안에 JOB의 리턴 값이 들어간다.
JOB PRTY
디스플레이 대상 JOB의 우선순위이다.
JCLRUNNER INDEX
JOB이 실행된 Runner index이다. Runner Slot에 대한 정보는 PSJCLRUN에서 확인할 수 있다.
JOB WAIT
디스플레이 대상인 JOB의 상태가 WORKING 중에 WAIT하고 있는 이유이다.
-
ALREADY LOCK : JCL이 할당하려는 데이터셋이 이미 Lock이 걸려 있을 경우이다.
-
JOBNAME DUP : 동일한 이름의 JOB이 현재 작업 중인 경우이다. 이와 관련된 설정은 OpenFrame 환경설정에 tjes 서브젝트, SCHEDULING 섹션의 DUPL_JOBNAME 키에 VALUE 항목에 한다.
-
JCLHOLD : JCL 내에서 해당 JOB에 대해서 JCLHOLD를 설정해 놓은 경우이다.
JOB USER
디스플레이 대상 JOB을 submit한 USER이다.
JCL PATH
디스플레이 대상 JOB의 JCL 경로를 나타낸다.
TIME STAMP
JOB의 submit, start, end 시간을 나타낸다.
RES USAGE
해당 JOB의 리소스 사용량을 나타낸다.
-
PROCESS : 프로세스 총 사용시간이다.
-
CPU : WORKING 중인 프로세스들의 CPU 이용 합계시간으로 해당 JOB 상태가 WORKING 중인 경우에는 tjclrun과 현재 WORKING 중인 프로세스들의 CPU 이용 합계시간을 보여주고, 해당 JOB 상태가 WORKING이 아닌 경우에는 JOB의 총 CPU 이용시간을 보여준다.
-
CPU ?% : WORKING 중인 프로세스의 CPU 점유율이다.
-
MEM ?Kb : WORKING 중인 프로세스의 메모리 크기로, 해당 JOB 상태가 WORKING인 경우만 나타난다.
STEP LIST
디스플레이 대상 JOB의 STEP별 정보를 보여준다.
-
[???]: STEP name
-
START : STEP 시작시간
-
RC : STEP의 리턴코드
-
CPU : STEP에서 CPU 이용시간
-
/ ??s : STEP의 총 소요시간
SPOOL LIST
디스플레이 대상 JOB의 SPOOL LIST를 보여준다.
POSPOOL의 디스플레이 정보와 동일하다.
OUTPUT PROCESS-ING STATUS
대상 JOB의 OUTPUT 처리에 대한 내용을 나타낸다.
WORKING 중인 JOB의 경우의 디스플레이 정보는 다음과 같다.
정보 설명 [STEPNAME] CURRENT PROCESSING
현재 처리하고 있는 STEP을 나타낸다.
DDNAME JOBID(DSNAME) R:? W:?
-
R : 해당 데이터셋의 읽기 시도 횟수이다.
-
W : 해당 데이터셋의 쓰기 시도 횟수이다.
-
3.10. PSSTEP(Print Screen STEP)
입력된 job-ID에 해당하는 JOB의 STEP 정보를 출력한다. 만약 대상 JOB의 상태가 WORKING인 경우에는 현재 처리 중인 STEP 정보를 1초 단위로 업데이트해서 출력한다.
-
사용법
PSSTEP <job-ID>
-
디스플레이 정보
PSSTEP의 디스플레이 정보는 다음과 같다.
정보 설명 STEP LIST
디스플레이 대상 JOB의 STEP별 정보를 보여준다.
-
[???] : STEP name
-
START : STEP 시작시간
-
RC : STEP의 리턴코드
-
CPU : STEP에서 CPU 이용시간
-
??s : STEP의 총 소요시간
-
4. INITIATOR 명령어
INITIATOR 명령어는 JOB의 실행을 위한 TJES 환경에 관련된 명령어들이다. 본 절에서 해당 명령어의 사용법에 대해서 설명한다.
4.1. BOOT
전체 노드의 TJES를 Boot한다. Boot가 된 노드에서는 JOB을 실행할 수 있다. Runner Slot에 JOB을 할당할 수 있게 된다.
-
사용법
BOOT [NODE=<node-name>]
다음은 입력 항목에 대한 설명이다.
항목 설명 [NODE=<node-name>]
node-name을 준 경우 대상 노드만을 Boot한다.
4.2. CHANGECLASS(CC)
해당 클래스의 상태를 변경한다.
-
사용법
CHANGECLASS(CC) C=<class> HOLD = {Y|N}
관련 환경설정
클래스 상태의 초기값을 지정한다. OpenFrame 환경설정에 지정하지 않으면 기본값은 START이며, CHANGECLASS 명령어를 출력할 때 N에 해당하는 값이다.
$ ofconfig list -n NODE1 -s tjes -sec JOBCLASS -l
======================================================================================
SUBJECT : tjes
SECTION : JOBCLASS
KEY : A
TYPE : 2
DEFAULT_VALUE : START
VALUE(M)* : START
VALUE(D) : START
AVAIL_VALUE : START,HOLD
DESCRIPTION : Specifies the properties of JOB CLASS.
--------------------------------------------------------------------------------------
SUBJECT : tjes
SECTION : JOBCLASS
KEY : B
TYPE : 2
DEFAULT_VALUE : START
VALUE(M)* : START
VALUE(D) : START
AVAIL_VALUE : START,HOLD
DESCRIPTION : Specifies the properties of JOB CLASS.
======================================================================================
4.3. JCLRUNACTIVE(RA)/JCLRUNINACTIVE(RI)
명령어 라인에서 입력받은 Runner Slot의 상태를 Active에서 Inactive로 또는 Inactive에서 Active로 변경한다. 바뀐 정보는 PSJCLRUN을 통해 확인할 수 있다.
-
사용법
JCLRUNACTIVE(RA)/JCLRUNACTIVE(RI) I=<index>,,, [NODE=<node-name>]
다음은 입력 항목에 대한 설명이다.
항목 설명 I=<index>
인덱스는 여러 개를 지정하거나 또는 범위를 지정할 수도 있다.
-
형식
I=<index>,,,
[NODE=<node-name>]
node-name을 지정하지 않은 경우 자기 노드의 Runner Slot 상태를 변경한다.
-
-
예제
다음은 JCLRUNACTIVE, JCLRUNINACTIVE 명령어를 사용하는 경우 범위 값을 지정하는 방법에 대한 예를 보여준다.
$ RA I=0,1,2,3 $ RI I=0-9
관련 환경설정
현재 노드를 찾을 때 사용된다.
$ ofconfig list -n NODE1 -s tjes -sec NODEINFO -k NODENAME -l
======================================================================================
SUBJECT : tjes
SECTION : NODEINFO
KEY : NODENAME
TYPE : 2
DEFAULT_VALUE : NODE1
VALUE(M)* : NODE1
VALUE(D) : NODE1
AVAIL_VALUE :
DESCRIPTION : TMAX node name. (recommend to use HOSTNAME)
======================================================================================
4.4. JCLRUNCLASS(RC)
해당 Runner Slot의 클래스를 입력으로 받은 클래스로 변경한다.
-
사용법
JCLRUNCLASS(RC) I=index,,, CS=<classes> [NODE=<node-name>]
다음은 입력 항목에 대한 설명이다.
항목 설명 I=<index>
인덱스는 여러 개를 지정하거나 또는 범위를 지정할 수도 있다.
-
형식
I=<index>,,,
[NODE=<node-name>]
node-name을 지정하지 않은 경우 자기 노드의 클래스 설정을 변경한다.
-
-
예제
다음은 JCLRUNCLASS 명령을 사용하여 범위 값과 클래스를 지정하는 방법에 대한 예를 보여준다.
$ JCLRUNCLASS I=0,1,2,3 CS=A $ RC I=0-9 CS=AB
관련 환경설정
현재 노드를 찾을 때 사용된다.
$ ofconfig list -n NODE1 -s tjes -sec NODEINFO -k NODENAME -l
======================================================================================
SUBJECT : tjes
SECTION : NODEINFO
KEY : NODENAME
TYPE : 2
DEFAULT_VALUE : NODE1
VALUE(M)* : NODE1
VALUE(D) : NODE1
AVAIL_VALUE :
DESCRIPTION : TMAX node name. (recommend to use HOSTNAME)
======================================================================================
4.5. NODECLEAR
해당 노드의 모든 JOB을 STOP시킨다. 보통 해당 노드가 비정상적으로 되어서 해당 노드에 있는 JOB을 더 이상 컨트롤할 수 없을 때 사용한다.
-
사용법
NODECLEAR NODE=<node-name>
4.6. NODESTATUS(NODEST)
전체 노드의 상태를 보여준다.
-
사용법
NODESTATUS(NODEST)
-
디스플레이 정보
전체 노드에 대한 상태 디스플레이 정보는 다음과 같다.
정보 설명 NODENAME
노드명이다.
OBMJINIT_STATUS
obmjinit 서버의 상태이다.
-
Active
-
Downed
BOOT_STATUS
TJES의 Boot 상태이다.
-
Booted
-
Not booted
-
4.7. PSCLASS(PSC)
클래스별로 JOB들의 상태 카운트를 보여준다. 클래스별로 JOB들의 NODE, CLASS, HOLD, START, WORIKING, SUSPEND, DONE, STOP, ERROR, FLUSH 카운트를 보여준다.
-
사용법
PSCLASS(PSC)
4.8. PSJCLRUN(PSR)
해당 노드의 Runner Slot 상태를 보여준다.
-
사용법
PSJCLRUN(PSR) [NODE=<node-name>]
다음은 입력 항목에 대한 설명이다.
항목 설명 [NODE=<node-name>]
node-name을 주지 않은 경우 자기 노드의 Runner Slot 상태를 보여준다.
-
디스플레이 정보
Runner Slot에 대한 디스플레이 정보는 다음과 같다.
정보 설명 IDX
Runner 인덱스로 다음에서 사용된다.
-
JCLRUNACTIVE(RA)
-
JCLRUNINACTIVE(RI)
-
JCLRUNclass(RC)
SLOTNAME
OpenFrame 환경설정에 tjes 서브젝트, INITDEF 섹션의 INIT{nnnn} 키에 정의된 Runner Slot 이름이다. 자세한 내용은 OpenFrame Batch "환경설정 안내서"를 참고한다.
STATUS
Runner Slot의 상태이다.
-
Active
-
Inactive
-
Downed
class
Runner Slot에 할당되어있는 클래스들이다.
JOBID,
JOBNAME,
JOBclass,
PID
Runner Slot에 할당된 JOB에 대한 정보들이다.
해당 Runner Slot의 클래스나 STATUS를 RA, RI, RC나 SHUTDOWN 등의 명령으로 바꾸는 경우 대상 Runner Slot에 JOB이 할당되어있으면 나중에 바뀔 것이라는 메시지가 나타난다.
STATUS will be [DOWNED] after JOB finished
-
관련 환경설정
해당 정보는 현재 노드를 찾을 때 사용된다.
$ ofconfig list -n NODE1 -s tjes -sec NODEINFO -k NODENAME -l
======================================================================================
SUBJECT : tjes
SECTION : NODEINFO
KEY : NODENAME
TYPE : 2
DEFAULT_VALUE : NODE1
VALUE(M)* : NODE1
VALUE(D) : NODE1
AVAIL_VALUE :
DESCRIPTION : TMAX node name. (recommend to use HOSTNAME)
======================================================================================
Runner Slot들의 기초설정을 한다. 현재 노드를 찾을 때 사용된다.
$ ofconfig list -n NODE1 -s tjes -sec INITDEF -l
====================================================================================
SUBJECT : tjes
SECTION : INITDEF
KEY : INIT0000
TYPE : 2
DEFAULT_VALUE : INITA,A,ACTIVE
VALUE(M)* : INITA,A,ACTIVE
VALUE(D) : INITA,A,ACTIVE
AVAIL_VALUE :
DESCRIPTION : INITXXXX= name, multi class, ACTIVE/INACTIVE
------------------------------------------------------------------------------------
SUBJECT : tjes
SECTION : INITDEF
KEY : INIT0001
TYPE : 2
DEFAULT_VALUE : INITB,B,ACTIVE
VALUE(M)* : INITB,B,ACTIVE
VALUE(D) : INITB,B,ACTIVE
AVAIL_VALUE :
DESCRIPTION : INITXXXX= name, multi class, ACTIVE/INACTIVE
------------------------------------------------------------------------------------
..
..
중략
..
..
====================================================================================
4.9. SHUTDOWN
전체 노드의 TJES를 다운(down)시킨다. 다운을 하게 되면 비어있는 Runner Slot들을 모두 다운 상태로 변경하여 추가적인 JOB의 스케줄링을 제한하고 WORKING 중인 Runner Slot들은 JOB이 끝나는 대로 다운 상태로 변경한다.
-
사용법
SHUTDOWN [NODE=<node-name>]
다음은 입력 항목에 대한 설명이다.
항목 설명 [NODE=<node-name>]
node-name을 준 경우 대상 노드만을 다운시킨다.
명령어에 대한 자세한 사항은 PSJCLRUN(PSR)을 참고한다. |
4.10. SHOWCLASS(SC)
클래스의 상태를 보여준다. 클래스가 HOLD로 되어있으면 해당 클래스로 submit하는 JOB은 항상 HOLD 상태로 가게 된다.
-
사용법
SHOWCLASS(SC)
-
디스플레이 정보
클래스에 대한 디스플레이 정보는 다음과 같다.
정보 설명 CLASS
클래스 이름이다.
HOLD
클래스가 HOLD로 되어 있는지 여부를 보여준다. (Y,N)
관련 환경설정
클래스 상태의 초기값을 설정한다. OpenFrame 환경설정에 지정하지 않으면 기본값은 START이며, SHOWCLASS 명령어를 출력할 때 N에 해당하는 값이다.
$ ofconfig list -n NODE1 -s tjes -sec JOBCLASS -l
=====================================================================================
SUBJECT : tjes
SECTION : JOBCLASS
KEY : A
TYPE : 2
DEFAULT_VALUE : START
VALUE(M)* : START
VALUE(D) : START
AVAIL_VALUE : START,HOLD
DESCRIPTION : Specifies the properties of JOB CLASS.
-------------------------------------------------------------------------------------
SUBJECT : tjes
SECTION : JOBCLASS
KEY : B
TYPE : 2
DEFAULT_VALUE : START
VALUE(M)* : START
VALUE(D) : START
AVAIL_VALUE : START,HOLD
DESCRIPTION : Specifies the properties of JOB CLASS.
=====================================================================================
5. 데이터셋 명령어
본 절에서는 데이터셋을 조회하거나 생성, 삭제 또는 복사하기 위한 명령어에 대해서 설명한다.
USERCATALOG와 관련해서는 tjesmgr의 "SETCATALOG(SETCAT) 명령어" 및 "OpenFrame 데이터셋 안내서"의 "제4장 통합 카달로그"를 참고한다. |
5.1. DATASETCOPY(DSCOPY)
입력에 해당하는 from-dataset-name을 to-dataset-name으로 복사하고 from-dataset-name 을 검색하기 위한 카탈로그와 볼륨 정보, to-dataset-name이 위치할 볼륨과 등록될 카탈로그를 옵션으로 지정할 수 있다.
-
사용법
DATASETCOPY(DSCOPY) <from-dataset-name> [CAT=<from-catalog-name>] [VOL=<from-volume-serial>] <to-dataset-name> [TOV=<to-volume-serial> [TOC=<to-catalog-name>] [FORCE]
다음은 입력 항목에 대한 설명이다.
항목 설명 <from-dataset-name>
소스 데이터셋의 이름이다.
[CAT=<from-catalog-name>]
사용자 카탈로그를 지정한다. 지정하지 않은 경우 ALIAS, 마스터 카탈로그, VOLUME의 순서로 데이터셋을 검색한다.
[VOL=<from-volume-serial>]
to-dataset-name의 볼륨 정보를 지정한다. 지정되지 않은 경우 디폴트 볼륨을 검색한다.
<to-dataset-name>
타깃 데이터셋의 이름을 지정한다. <to-dataset-name>, TOV=<to-volume-serial> 두 인자 중 적어도 하나는 지정해야 한다.
TOV=<to-volume-serial>
복사된 데이터셋이 위치할 볼륨 시리얼을 지정한다. 이 옵션을 지정하지 않을 경우 기본 볼륨에 데이터셋을 복사한다.
TOC=<to-catalog-name>
복사된 데이터셋이 위치할 카탈로그를 지정한다.
[FORCE]
PDS 멤버를 복사할 때 복사된 데이터셋이 이미 존재할 경우 강제로 덮어쓴다. 이 옵션을 지정하지 않을 경우 덮어쓰지 않고 건너 뛰게 된다. 이 옵션은 소스 데이터셋이 PDS 멤버일 경우에만 적용된다.
기본 카탈로그에 대한 내용은 SETCATALOG(SETCAT) 명령어를 참고한다. |
5.2. DATASETCREATE(DSCREATE)
명령을 실행하면 사용자 입력 화면이 나타나고 사용자로부터 입력 받은 조건에 해당하는 Non-VSAM 데이터셋을 생성한다.
-
사용법
DATASETCREATE(DSCREATE)
-
입력 파라미터
다음은 입력 파라미터에 대한 설명이다.
파라미터 설명 NAME
생성할 Non-VSAM 데이터셋의 이름으로 반드시 입력해야 하는 필수항목이다.
MEMBER
생성할 PDS 멤버 이름이다.
VOLUME
Non-VSAM 데이터셋이 저장될 볼륨의 위치이다.
기본값은 UNIT에 따르거나 SMS 규칙을 따른다. 아무 값도 지정되지 않은 경우 기본값으로 설정된 볼륨에 따른다.
UNIT
데이터셋의 UNIT을 지정한다. 기본값은 VOLUME에 따른다.
입력을 받은 UNIT과 VOLUME이 서로 일치하지 않는 경우 에러가 발생한다.
DSORG
데이터셋의 DSORG를 지정한다.
RECFM
데이터셋의 레코드 포맷을 지정한다.
KEYLEN
데이터셋의 키 길이를 지정한다. ISAM 데이터셋의 경우에 지정할 수 있다.
LRECL
데이터셋의 최대 레코드 길이를 지정한다.
KEYPOS
데이터셋의 키 위치를 지정한다. ISAM 데이터셋의 경우에 지정할 수 있다.
BLKSIZE
데이터셋의 블록 크기를 지정한다. (기본값: 4096)
TRK/CYL/blklgth
트랙, 실린더 혹은 블록의 길이를 지정한다.
설정 가능한 값은 TRK, CYL 또는 블록의 길이에 해당하는 자연수 값이다. 내부적으로 TRK는 48KB로 CYL는 768KB로 처리된다.
PRIMARY
데이터셋을 할당(allocation)할 때 최초 할당 크기를 지정한다. (단위: KB)
PRIMARY 기본값 할당 규칙은 아래와 같다.
-
PRIMARY와 TRK/CYL/blklgth 모두 입력하지 않은 경우 : 해당 데이터셋의 Device의 SpaceLimit 값 설정을 따른다.
-
PRIMARY는 입력하고 TRK/CYL/blklgth는 생략한 경우 : TRK/CYL/blklgth를 기본값 1024byte로 간주하여 PRIMARY에 곱한다.
-
PRIMARY를 생략하고 TRK/CYL/blklgth는 입력한 경우 : PRIMARY를 기본값 4096byte로 간주하여 TRK/CYL/blklgth값에 곱한다.
SECONDARY
데이터셋의 다음 할당 크기를 지정한다. (단위: KB)
EXPIRATION
데이터셋의 만기일을 지정한다. (기본값: 99991231)
CATALOG
사용자 카탈로그를 지정한다.
사용자 카탈로그를 지정하지 않는 경우 마스터 카탈로그 또는 ALIAS에 따른 카탈로그로 한다. 생성 관련 명령은 tjesmgr의 SETCATALOG 명령어의 옵션을 따르지 않는다.
NOCATALOG
데이터셋의 생성만을 하고 카탈로깅을 하지 않을 경우에 지정한다.
DATA CLASS
sms의 Data class를 지정한다.
MGMT CLASS
sms의 Management class를 지정한다.
STOR CLASS
sms의 Storage class를 지정한다.
-
VSAM 데이터셋을 생성에 관한 자세한 내용은 OpenFrame Batch "유틸리티 참조 안내서"를 참고한다. |
5.3. DATASETDELETE(DSDELETE)
입력에 해당하는 Non-VSAM 데이터셋들을 삭제한다.
-
사용법
DATASETDELETE(DSDELETE) [FORCE] <dataset-name> [CAT=<catalog-name] [VOL=<volume-serial>]
다음은 입력 항목에 대한 설명이다.
항목 설명 [FORCE]
삭제하고자 하는 Non-VSAM 데이터셋의 실제 파일이 존재하지 않는 경우에도 에러를 발생시키지 않고 카탈로그에 있는 정보만을 삭제한다.
<dataset-name>
삭제 대상 데이터셋 이름을 입력한다.
[CAT=<catalog-name>]
카탈로그에 등록되어있는 경우 catalog-name을 지정한다.
[VOL=<volume-serial>]
카탈로그에 등록되어 있지 않은 데이터셋을 삭제할 경우 volume-serial를 지정한다.
5.4. DATASETEXPORT(DSEXPORT)
입력에 해당하는 Non-VSAM 데이터셋을 외부로 반출한다.
-
사용법
DATASETEXPORT(DSEXPORT) <from-dataset-name> <to-filepath> [CAT=<catalog-name>]
다음은 입력 항목에 대한 설명이다.
항목 설명 <from-dataset-name>
외부로 반출한 Non-VSAM 데이터셋을 입력한다.
<to-filepath>
Non-VSAM 데이터셋을 반출할 UNIX 절대 파일경로를 입력한다.
[CAT=<catalog-name>]
<from-dataset-name>이 기본 카탈로그에 등록이 되어 있지 않은 경우 지정한다.
5.5. DATASETIMPORT(DSIMPORT)
외부로 반출한 파일을 읽어서 데이터셋으로 복원한다. 명령을 실행하면 사용자 입력 화면이 나타나고 사용자로부터 입력받은 조건에 해당하는 Non-VSAM 데이터셋으로 복원한다.
-
사용법
DATASETIMPORT(DSIMPORT) <from-filepath>
다음은 입력 항목에 대한 설명이다.
항목 설명 <from-filepath>
Non-VSAM 데이터셋이 저장되어 있는 UNIX 절대 파일경로를 입력한다.
-
입력 파라미터
다음은 입력 파라미터에 대한 설명이다. 입력 파라미터들로 외부로 반출할 때의 데이터셋 이름과 형식을 바꿀 수 있다. 이미 등록이 되어있으면 기존의 데이터셋을 덮어쓰기 한다.
파라미터 설명 NAME
변경할 Non-VSAM 데이터셋의 이름이다.
VOLUME
Non-VSAM 데이터셋이 저장될 볼륨의 위치이다.
RECFM
데이터셋의 레코드 포맷을 지정한다.
LRECL
데이터셋의 최대 레코드 길이를 지정한다. (기본값: 80)
BLKSIZE
데이터셋의 블록 크기를 지정한다. (기본값: 4096)
EXPIRATION
데이터셋의 만기일을 지정한다. (기본값: 99991231)
CATALOG
사용자 카탈로그를 지정한다.
사용자 카탈로그를 지정하지 않는 경우 마스터 카탈로그 또는 ALIAS에 따른 카탈로그로 한다. 생성 관련 명령은 tjesmgr의 SETCATALOG(SETCAT) 명령어의 옵션을 따르지 않는다.
5.6. DATASETLIST(DSLIST)
입력 조건에 해당하는 VTOC에 등록되어있는 데이터셋 리스트를 보여준다. VTOC에 등록되어 있는 데이터셋들은 전부 Non-VSAM 데이터셋이다.
-
사용법
DATASETLIST(DSLIST) [<dataset-prefix>] [VOL=<volume-serial>]
다음은 입력 항목에 대한 설명이다.
항목 설명 [<dataset-prefix>]
dataset-prefix로 시작하는 모든 데이터셋이 디스플레이 대상이 된다.
[VOL=<volume-serial>]
지정한 볼륨에 있는 데이터셋이 디스플레이 대상이 된다.
-
디스플레이 정보
VTOC에 등록되어 있는 데이터셋 디스플레이 정보는 다음과 같다.
정보 설명 VTOC name
검색한 데이터셋이다.
VOLUME
디스플레이 대상 데이터셋이 들어있는 볼륨이다.
DSORG
디스플레이 대상 데이터셋의 구조이다.
RECFM
디스플레이 대상 데이터셋의 레코드 포맷이다.
LRECL
디스플레이 대상 데이터셋의 레코드 길이이다.
5.7. DATASETMOVE(DSMOVE)
데이터셋의 이름을 변경하거나 볼륨을 변경, 또는 두 작업을 모두 수행한다. 입력에 해당하는 from-dataset-name을 to-dataset-name으로 이동하거나 to-volume-serial 볼륨으로 이동한다.
-
사용법
DATASETMOVE(DSMOVE) <from-dataset-name> [CAT=<catalog-name>] [VOL=<from-volume-serial>] {<to-dataset-name> | TOV=<to-volume-serial>}
다음은 입력 항목에 대한 설명이다.
항목 설명 <from-dataset-name>
소스 데이터셋의 이름이다.
[CAT=<catalog-name>]
사용자 카탈로그를 지정한다. 지정하지 않은 경우 ALIAS, 마스터 카탈로그, VOLUME의 순서로 데이터셋을 검색한다.
[VOL=<from-volume-serial>]
to-dataset-name의 볼륨 정보로, 지정되지 않은 경우 디폴트 볼륨을 검색한다.
<to-dataset-name>
타깃 데이터셋의 이름이다. <to-dataset-name>, TOV=<to-volume-serial> 두 인자 중 적어도 하나는 지정해야 한다.
TOV=<to-volume-serial>
소스 데이터셋이 복사될 볼륨의 정보로, <to-dataset-name>, TOV=<to-volume-serial> 두 인자 중 적어도 하나는 지정해야 한다.
5.8. DATASETRECATALOG(DSRECAT)
명령을 실행하면 사용자 입력 화면이 나타나고 입력 조건에 해당하는 Non-VSAM 데이터셋을 리카탈로그한다. 실제 파일만 존재하고 카탈로그에 등록되어있지 않은 Non-VSAM 데이터셋을 카탈로그에 등록하거나 이미 카탈로그에 등록되어있는 Non-VSAM 데이터셋의 카탈로그 내용을 바꾸고 싶을 때 사용한다.
-
사용법
DATASETRECATALOG(DSRECAT)
-
입력 파라미터
다음은 입력 파라미터에 대한 설명이다.
파라미터 설명 NAME
리카탈로그할 Non-VSAM 데이터셋의 이름으로 반드시 입력해야 하는 필수항목이다.
CATALOG(S)
리카탈로그할 데이터셋의 현재 등록되어있는 카탈로그이다.
(기본값: 마스터 카탈로그)
VOLUME
리카탈로그할 Non-VSAM 데이터셋이 있는 볼륨의 위치이다.
DSORG
데이터셋의 DSORG를 지정한다.
RECFM
데이터셋의 레코드 포맷을 지정한다.
KEYLEN
데이터셋의 키 길이를 지정한다. ISAM 데이터셋의 경우에 지정할 수 있다.
LRECL
데이터셋의 최대 레코드 길이를 지정한다.
KEYPOS
데이터셋의 키 위치를 지정한다. ISAM 데이터셋의 경우에 지정할 수 있다.
BLKSIZE
데이터셋의 블록 크기를 지정한다. (기본값: 4096)
EXPIRATION
데이터셋의 만기일을 지정한다. (기본값: 99991231)
CATALOG
사용자 카탈로그를 지정한다.
사용자 카탈로그를 지정하지 않는 경우 마스터 카탈로그 또는 ALIAS에 따른 카탈로그로 한다.
5.9. DATASETUNCATALOG(DSUNCAT)
입력에 해당하는 데이터셋들을 카탈로그에서 삭제한다.
-
사용법
DATASETUNCATALOG(DSUNCAT) <dataset-name> [CAT=<catalog-name>]
다음은 입력 항목에 대한 설명이다.
항목 설명 <dataset-name>
카탈로그에서 삭제할 데이터셋의 이름을 지정한다.
[CAT=<catalog-name>]
대상 데이터셋이 등록되어 있는 카탈로그를 지정한다.
5.10. DATATOUCH(DSTOUCH)
입력에 해당하는 Non-VSAM 데이터셋의 마지막 수정 날짜를 변경한다.
-
사용법
DATATOUCH(DSTOUCH) <dataset-name> [VOL=<volume-serial>] [CAT=<catalog-name>] [DATE=<yyyymmdd>]
다음은 입력 항목에 대한 설명이다.
항목 설명 <dataset-name>
수정날짜를 변경할 Non-VSAM 데이터셋을 입력한다.
VOL=<volume-serial>
Non-VSAM 데이터셋이 위치한 볼륨이다.
[CAT=<catalog-name>]
사용자 카탈로그를 지정한다.
[DATE=<yyyymmdd>]
수정날짜를 지정한다.
5.11. GDGCREATE
명령을 실행하면 입력을 받을 창이 뜨고 입력 조건에 맞게 GDG 데이터셋을 생성한다.
-
사용법
GDGCREATE
-
입력 파라미터
다음은 입력 파라미터에 대한 설명이다.
파라미터 설명 NAME
생성할 GDG 데이터셋의 이름으로 반드시 입력해야 하는 필수항목이다.
LIMIT
GDS 데이터셋의 제한이다. (기본값: 255)
EXPIRATION
생성할 GDG 데이터셋의 만기일을 지정한다.
CATALOG
GDG 데이터셋이 등록될 사용자 카탈로그를 지정한다.
사용자 카탈로그를 지정을 하지 않는 경우 마스터 카탈로그 또는 ALIAS에 따른 카탈로그에 등록된다.
생성 관련 명령은 tjesmgr의 SETCATALOG 명령어의 옵션을 따르지 않는다.
EMPTY
GDS 생성 시 GDG의 LIMIT 값을 초과할 때 카탈로그의 GDG 엔트리에서 GDS Association 정보를 제거하는 범위를 지정한다.
-
0 : NOEMPTY, GDG 엔트리에서 가장 오래된 GDS Association 정보만 제거한다. (기본값)
-
1 : EMPTY, GDG 엔트리에서 가장 최근에 생성한 GDS를 제외한 나머지 GDS Association 정보를 제거한다.
SCRATCH
EMPTY/NOEMPTY 옵션 처리에 의해 카탈로그의 GDG 엔트리에서 Association 정보가 제거된 GDS에 대해 수행할 조치를 지정한다.
-
0 : NOSCRATCH : GDS를 일반 Non-VSAM 데이터셋으로 취급하여 다시 카탈로그에 등록한다. (기본값)
-
1 : SCRATCH : GDS를 물리적으로 삭제한다.
-
5.12. GDGDELETE
입력에 해당하는 GDG 데이터셋을 삭제한다. GDG 멤버가 있는 경우에는 에러가 발생한다. 이런 경우 GDG 멤버를 먼저 삭제해야 한다.
-
사용법
GDGDELETE <dataset-name> [CAT=<catalog-name>] [FORCE]
다음은 입력 항목에 대한 설명이다.
항목 설명 <dataset-name>
삭제할 GDG 데이터셋을 입력한다.
[CAT=<catalog-name>]
GDG 데이터셋이 등록되어있는 카탈로그를 지정한다.
[FORCE]
연관된 GDS가 있는 경우 함께 삭제한다.
5.13. PSCATALOG(PSCAT)
입력 조건에 해당하는 카탈로그에 등록되어있는 데이터셋 리스트를 보여준다.
-
사용법
PSCATALOG(PSCAT) <entry-prefix> [CAT=<catalog-name>]
다음은 입력 항목에 대한 설명이다.
항목 설명 <entry-prefix>
entry-prefix로 시작하는 모든 데이터셋이 디스플레이 대상이 된다.
[CAT=<catalog-name>]
사용자 카탈로그에 등록되어 있는 데이터셋을 찾아서 보여준다.
-
디스플레이 정보
카탈로그에 등록되어 있는 데이터셋 디스플레이 정보는 다음과 같다.
정보 설명 CATALOG NAME
검색한 데이터셋이다.
VOLUME
디스플레이 대상 데이터셋이 들어있는 볼륨이다.
ENTTYPE
디스플레이 대상 데이터셋의 타입이다.
데이터셋의 타입에는 NON-VSAM, CLUSTER, AIX, PATH, GDG, UCAT, ALIAS 등이 있다.
VSAM
디스플레이 대상 데이터셋의 종류이다.
VSAM 데이터셋인 경우만 KSDS, RRDS 등의 데이터셋 종류를 나타낸다.
NVSM
디스플레이 대상 데이터셋의 종류이다.
Non-VSAM 데이터셋인 경우만 PDS, SDS, GDS 등의 데이터셋 종류를 나타낸다.
5.14. PSDATASET(PSDS)
입력에 해당하는 데이터셋의 상세정보를 보여준다.
-
사용법
PSDATASET(PSDS) <dataset-name> [CAT=<catalog-name>] [MEM=<member-prefix>] [VOL=<volume-serial>]
다음은 입력 항목에 대한 설명이다.
항목 설명 <dataset-name>
상세정보를 조회하고자 하는 데이터셋 이름을 입력한다.
[CAT=<catalog-name>]
catalog-name에 등록되어있는 데이터셋을 찾아서 보여준다.
[MEM=<member-prefix>]
멤버가 있는 데이터셋의 경우 MEM을 지정한 경우 해당 멤버를 검색해서 보여준다.
[VOL=<volume-serial>]
카탈로그 되어있지 않은 데이터셋의 상세정보를 보고 싶은 경우에 사용되며, VOL을 지정한 곳에서 데이터셋을 찾아서 보여준다.
-
디스플레이 정보
데이터셋에 대한 상세한 디스플레이 정보는 다음과 같다. ( ) 안의 정보는 데이터셋이 VSAM type인 경우이다.
정보 설명 Data Set Name
디스플레이 대상 데이터셋 이름이다.
Data Set Type
디스플레이 대상 데이터셋의 타입이다.
Catalog Name
디스플레이 대상 데이터셋이 등록되어 있는 카탈로그 이름이다.
Management Class
디스플레이 대상 데이터셋 을 생성하는 경우 참고한 Management 클래스이다.
Creation Date
디스플레이 대상 데이터셋의 생성일자이다.
Data Set Owner
디스플레이 대상 데이터셋의 실제 파일의 소유자이다.
Expiration Date
디스플레이 대상 데이터셋의 만료일자이다.
Storage Class
디스플레이 대상 데이터셋 을 생성하는 경우 참고한 스토리지 클래스이다.
Volume Serial
디스플레이 대상 데이터셋이 들어있는 볼륨이다.
Device Type
디스플레이 대상 데이터셋의 디바이스 타입이다.
테이프 데이터셋인 경우 ‘TAPE Device’라고 나타난다.
Data Class
디스플레이 대상 데이터셋 을 생성하는 경우 참고한 Data 클래스이다.
Organization
디스플레이 대상 데이터셋의 DSORG이다.
Record Format(AVGLRECL)
디스플레이 대상 데이터셋의 RECFM이다(디스플레이 대상 데이터셋의 평균 길이이다).
KEYLEN
디스플레이 대상 데이터셋의 키 길이이다.
Record Length(MAXLRECL)
디스플레이 대상 데이터셋의 길이이다(디스플레이 대상 데이터셋의 최대 길이이다).
KEYPOS
디스플레이 대상 데이터셋의 키 위치이다.
BLKSIZE(CISIZE)
디스플레이 대상 데이터셋의 블록 크기이다(디스플레이 대상 데이터셋의 CISIZE이다).
(AIXRKP)
디스플레이 대상 데이터셋의 AIX의 KEYPOS이다.
Primary Space
디스플레이 대상 데이터셋의 할당하는 경우 최초 할당 크기이다.
Number of Extents
디스플레이 대상 데이터셋의 할당하는 경우 확장횟수이다.
Secondary Space
디스플레이 대상 데이터셋의 할당하는 경우 다음 할당 크기이다.
Data Set Size
디스플레이 대상 데이터셋의 실제 크기이다.
테이프 데이터셋의 경우 압축 상태로 되어있는데, DATASIZE 크기는 압축이 되지 않았을 때의 크기이다.
Last Access Date
디스플레이 대상 데이터셋을 마지막으로 조회하거나 수정한 날짜이다.
Last Access Time
디스플레이 대상 데이터셋을 마지막으로 조회하거나 수정한 시간이다.
Associations
디스플레이 대상 데이터셋과 관련된 데이터셋들을 조회한다.
주로 VSAM 데이터셋의 정보를 조회할 때 나타난다.
다음은 멤버가 있는 데이터셋의 경우 해당 멤버에 대한 디스플레이 정보이다.
정보 설명 Name
디스플레이 대상 멤버의 이름이다.
Owner
디스플레이 대상 멤버의 실제 파일의 소유자이다.
Size
디스플레이 대상 멤버의 실제 파일크기이다.
Last Access Date
디스플레이 대상 멤버를 마지막으로 조회하거나 수정한 날짜 및 시간이다.
5.15. PSENTRY(PSENT)
입력에 해당하는 엔트리의 상세정보를 보여준다. PSDATASET와 다른 점은 GDG, PATH, ALIAS와 같이 실제 데이터셋은 아니지만 카탈로그에 등록되어 있는 엔트리들에 대한 정보도 보여준다.
-
사용법
PSENTRY(PSENT) <entry-name> [CAT=<catalog-name>]
다음은 입력 항목에 대한 설명이다.
항목 설명 <entry-name>
상세정보를 조회하고자 하는 엔트리 이름을 입력한다.
[CAT=<catalog-name>]
catalog-name에 등록되어 있는 엔트리를 찾아서 보여준다.
-
디스플레이 정보
엔트리에 대한 상세한 디스플레이 정보는 다음과 같다.
정보 설명 Entry Name
디스플레이 대상 엔트리 이름이다.
Entry Type
디스플레이 대상 엔트리의 타입이다.
Catalog Name
디스플레이 대상 엔트리가 등록되어 있는 카탈로그 이름이다.
Creation Date
디스플레이 대상 엔트리의 생성일자이다.
Entry Owner
디스플레이 대상 엔트리의 소유자이다.
Expiration Date
디스플레이 대상 엔트리의 만료일자이다.
GDG Limit
디스플레이 대상 엔트리가 GDG일 때 GDS의 생성 한계 개수이다.
Associations
디스플레이 대상 엔트리와 관련된 엔트리들을 보여준다.
5.16. PSLOCK(PSL)
입력에 해당하는 데이터셋의 Lock 정보를 보여준다.
-
사용법
PSLOCK(PSL) [<job-ID> | DSN=<dataset-prefix> [CAT=<catalog-name>]]
다음은 입력 항목에 대한 설명이다.
항목 설명 <job-ID>
지정한 job-ID로 Lock이 걸린 리스트를 보여준다.
DSN=<dataset-prefix>
데이터셋의 전체 이름 또는 prefix를 입력한다. 해당 데이터셋이나 prefix로 시작하는 모든 Lock이 걸린 데이터셋의 리스트를 보여준다.
[CAT=<catalog-name>]
검색하고자 하는 데이터셋이 카탈로그가 되어있을 때 지정한다.
-
디스플레이 정보
다음은 디스플레이 정보에 대한 설명이다.
항목 설명 옵션(1,2 컬럼)
-
1 : Lock을 요청하고 있는 상태이면 R이 보여진다.
-
2 : Lock을 설정한 또는 요청한 프로세스가 실행 중이면 애스터리스크(*) 가 보인다. 프로세스의 노드가 다른 경우는 보이지 않는다.
PID
Lock을 설정하거나 요청한 프로세스 ID이다.
JOBID
Lock을 설정하거나 요청한 JOBID이다.
NODEID
Lock을 설정하거나 요청한 노드이다.
LOCKTYPE
요청한 Lock의 타입이다.
-
Exclusive : 대상 데이터셋을 수정하기 위해서 사용하는 타입으로 다른 JOB에서 Lock을 공유할 수 없다.
-
Shared : 대상 데이터셋을 조회하기 위해서 사용하는 타입으로 다른 곳과 Lock을 공유할 수 있다.
CATALOG_DSN
요청한 Lock의 이름이다.
Lock 이름은 “USERCATALOG_NAME:DATASET_NAME”으로 구성된다.
-
5.17. PSVOLUME(PSV)
명령을 실행하면 볼륨에 대한 정보를 보여준다.
-
사용법
PSVOLUME(PSV)
-
디스플레이 정보
볼륨에 대한 디스플레이 정보는 다음과 같다.
정보 설명 Volume
볼륨 시리얼 이름이다.
Total(MB)
전체 볼륨 크기이다.
Usage(%)
현재 볼륨 사용률이다.
Free(MB)
사용할 수 있는 볼륨 크기이다.
Tablespace
볼륨 시리얼에 해당하는 데이터베이스 상의 테이블스페이스 이름이다.
Volume Path
볼륨의 UNIX 파일경로이다.
5.18. SETCATALOG(SETCAT)
입력받은 카탈로그를 기본 카탈로그로 하여 데이터셋 관련 명령어에서 사용한다.
-
사용법
SETCATALOG(SETCAT) [<catalog-name>]
다음은 입력 항목에 대한 설명이다.
항목 설명 [<catalog-name>]
입력받은 catalog-name을 기본 카탈로그로 하여 데이터셋 관련 명령어에서 사용한다. catalog-name를 설정하지 않은 경우 기본 카탈로그를 빈 스트링으로 바꾼다.
다음은 카탈로그의 지정 순위이다.
-
CAT 파라미터로 지정된 user catalog
-
SETCAT으로 지정된 user catalog
-
Dataset alias에 따른 user catalog
-
master catalog
-
-
예제
다음과 같이 지정하고 PSCAT, PSDS 등을 실행했을 때 CAT 파라미터를 지정하지 않은 경우 TAPECAT을 기본 카탈로그로 해서 정보를 보여준다.
$ SETCAT TAPECAT
6. SPOOL 백업 명령어
본 절에서는 SPOOL을 백업하기 위해 사용하는 명령어의 사용법에 대해서 설명한다.
6.1. SPOOLBACKUP(SPBA)
입력에 해당하는 SPOOL을 백업한다. 백업을 하고 나면 SPOOL은 OpenFrame 환경설정에 tjes 서브젝트, SPOOL 섹션의 SPOOL_BACKUP_DIR 키의 VALUE 항목에 설정된 디렉터리에 압축 파일로 저장된다. 백업 명령을 수행하는 경우 백업을 담당하는 obmjspbk 서버는 백업을 수행하며, 이미 현재 백업이 진행 중인 경우에는 SPBA 명령이 수행되지 않는다.
SPOOL을 백업할 수 있는 JOB의 상태는 DONE, ERROR, STOP, FLUSH이며, JOB의 상태가 이에 해당되지 않는 경우에는 이를 건너뛰고 다음 JOB에 대한 백업을 수행한다.
-
사용법
SPOOLBACKUP(SPBA) { DT=<yyyymmddhhmiss> | <start-job-ID>,<end-job-ID> }
다음은 입력 항목에 대한 설명이다.
항목 설명 DT=<yyyymmddhhmiss>
JOB을 submit한 시간을 입력한다. 주어진 시간 이전에 submit된 JOB의 SPOOL에 대해서 백업한다.
<start-job-ID>,<end-job-ID>
백업하려는 JOBID의 범위를 입력한다.
-
디스플레이 정보
SPBA 명령을 입력한 경우 상황에 따라 아래와 같은 메시지가 출력된다.
정보 설명 Spool backup command submitted.
백업 명령이 정상적으로 수행됨을 의미한다.
Spool backup server is busy!
현재는 백업이 진행 중이기 때문에 명령을 받아들일 수 없음을 의미한다.
관련 환경설정
백업한 SPOOL들을 저장할 디렉터리이다.
$ ofconfig list -n NODE1 -s tjes -sec SPOOL -k SPOOL_BACKUP_DIR -l =================================================================================== SUBJECT : tjes SECTION : SPOOL KEY : SPOOL_BACKUP_DIR TYPE : 2 DEFAULT_VALUE : $(OPENFRAME_HOME)/spbackup VALUE(M)* : $(OPENFRAME_HOME)/spbackup VALUE(D) : $(OPENFRAME_HOME)/spbackup AVAIL_VALUE : DESCRIPTION : Directory where spool archive. ===================================================================================
백업한 SPOOL의 내용을 조회하는 경우 복원할 디렉터리이다.
$ ofconfig list -n NODE1 -s tjes -sec SPOOL -k SPOOL_UNPACK_DIR -l =================================================================================== SUBJECT : tjes SECTION : SPOOL KEY : SPOOL_UNPACK_DIR TYPE : 2 DEFAULT_VALUE : $(OPENFRAME_HOME)/spunpack VALUE(M)* : $(OPENFRAME_HOME)/spunpack VALUE(D) : $(OPENFRAME_HOME)/spunpack AVAIL_VALUE : DESCRIPTION : Directory where archived spool is extracted temporarily. ===================================================================================
6.2. SPOOLBACKUPLIST(SPBL)
입력 조건에 해당하는 연/월에 백업된 날짜들을 보여준다.
-
사용법
SPOOLBACKUPLIST(SPBL) DATE={ <yyyymm>|<yyyy> }
다음은 입력 항목에 대한 설명이다.
항목 설명 DATE={ <yyyymm>|<yyyy> }
검색할 연/월이다.
-
디스플레이 정보
SPOOLBACKUPLIST에 대한 디스플레이 정보는 다음과 같다.
정보 설명 BACKUP_DATE
SPOOL이 백업된 날짜를 보여준다.
6.3. SPOOLBACKUPSTATUS(SPBASTAT)
백업 작업의 진행 및 완료 상태를 확인 한다.
-
사용법
SPOOLBACKUPSTATUS(SPBASTAT)
-
디스플레이 정보
현재 진행 중이거나 가장 마지막에 수행한 백업 작업 상태를 하단의 정보와 함께 보여준다.
server state:<state>, attempt:<count>, done:<count>, success rate:<percent>
정보 설명 server state:<state>
현재 서버의 상태를 표시한다.
-
WORKING : 백업이 진행 중일 경우
-
IDLE : WORKING 외의 상태
attempt:<count>
최근까지 수행한 SPOOL 백업 시도 수를 표시한다.
done:<count>
최근까지 수행한 SPOOL 백업 성공 수를 표시한다.
success rate:<percent>
백업 시도 대비 성공 수를 백분율로 표시한다.
-
6.4. SPOOLBACKUPSTOP(SPBASTOP)
현재 수행 중인 백업을 종료한다. 백업을 수행하지 않고 있는 경우에는 아무 동작도 수행하지 않는다.
-
사용법
SPOOLBACKUPSTOP(SPBASTOP)
6.5. SPOOLCLEAR(SPCL)
입력 조건에 해당하는 임시 디렉터리에 복원된 SPOOL을 제거한다. 즉, SPOOLRESTORE을 통해서 복원되었던 SPOOL들을 제거한다.
-
사용법
SPOOLCLEAR(SPCL) I=<index>
다음은 입력 항목에 대한 설명이다.
항목 설명 I=<index>
SPOOLPS에서 출력된 디스플레이 대상 SPOOL 인덱스 번호이다.
6.6. SPOOLPODD(SPPODD)
입력 조건에 해당하는 복원된 JOB의 SPOOL을 설정한 뷰어로 열어준다.
-
사용법
SPOOLPODD(SPPODD) I=<index> SPDI=<dd-index>
다음은 입력 항목에 대한 설명이다.
항목 설명 I=<index>
SPOOLPS에서 나온 번호이다.
SPDI=<dd-index>
보고자 하는 dd-index를 지정한다.
SPOOLPODD 명령은 PODD 명령과 동일하므로 자세한 내용은 PODD(Print Output DD Information) 명령을 참고한다.
6.7. SPOOLPOSPOOL(SPPOSPOOL)
입력 조건에 해당하는 복원된 JOB의 SPOOL 정보를 보여준다. SPOOLPS과 SPOOLRESTORE 명령어를 우선 실행해야 SPOOLPOSPOOL 명령어의 결과를 볼 수 있다.
-
사용법
SPOOLPOSPOOL(SPPOSPOOL) I=<index>
다음은 입력 항목에 대한 설명이다.
항목 설명 I=<index>
SPOOLPS에서 출력된 디스플레이 대상 SPOOL 인덱스 번호이다.
-
디스플레이 정보
POSPOOL의 정보와 동일하다.
6.8. SPOOLPS(SPPS)
입력 조건에 해당하는 날짜에 백업된 SPOOL 리스트를 보여준다.
-
사용법
SPOOLPS(SPPS) { DATE=<yyyymmdd> [N=<job-name-prefix>] | N=<job-name-prefix> }
다음은 입력 항목에 대한 설명이다.
항목 설명 DATE=<yyyymmdd>
백업된 날짜이다.
N=<job-name-prefix>
백업된 JOB에서 찾고자 하는 job-name의 prefix를 지정한다.
-
디스플레이 정보
SPOOLPS에 대한 디스플레이 정보는 다음과 같다.
정보 설명 NO
디스플레이 대상 SPOOL 리스트 번호이다.
SPOOL 리스트 번호는 SPOOLRESTORE, SPOOLPSJOB, SPOOLPSIO 등에서 사용된다.
JOBNAME
디스플레이 대상 JOB 이름이다.
JOBID
디스플레이 대상 JOB ID이다.
submit_TIME
디스플레이 대상 JOB이 submit되었던 날짜이다.
BACKUP_DATE
디스플레이 대상 JOB이 백업되었던 날짜이다.
6.9. SPOOLPSJOB(SPPSJ)
입력 조건에 해당하는 복원된 JOB의 상세 정보를 보여준다. SPOOLPS과 SPOOLRESTORE 명령어를 우선 실행해야 SPOOLPSJOB 명령어의 결과를 볼 수 있다.
-
사용법
SPOOLPSJOB(SPPSJ) I=<index>
다음은 입력 항목에 대한 설명이다.
항목 설명 I=<index>
SPOOLPSJOB에서 출력될 디스플레이 대상 SPOOL의 인덱스 번호이다.
-
디스플레이 정보
PSJOB의 JOB이 끝났을 때의 정보와 동일하다. 단, OUTPUT에 대한 정보는 출력되지 않는다.
6.10. SPOOLPSIO(SPPSIO)
입력 조건에 해당하는 복원된 JOB의 I/O 정보를 보여준다. SPOOLPS과 SPOOLRESTORE 명령어를 우선 실행해야 SPOOLPSIO 명령어의 결과를 볼 수 있다.
-
사용법
SPOOLPSIO(SPPSIO) I=<index>
다음은 입력 항목에 대한 설명이다.
항목 설명 I=<index>
SPOOLPS에서 출력된 디스플레이 대상 SPOOL 인덱스 번호이다.
-
디스플레이 정보
STEP별 데이터셋들의 읽기/쓰기 횟수를 보여준다.
6.11. SPOOLRESTORE(SPRE)
입력 조건에 해당하는 백업된 SPOOL의 내용을 조회할 수 있게 임시 디렉터리에 복원한다. SPOOLRESOTRE를 하기 위해서는 SPOOLPS를 먼저 실행해야 한다.
-
사용법
SPOOLRESTORE(SPRE) I=<index>
다음은 입력 항목에 대한 설명이다.
항목 설명 I=<index>
SPOOLPS에서 출력된 디스플레이 대상 SPOOL 인덱스 번호이다.
관련 환경설정
SPOOL이 백업될 디렉터리를 설정한다.
$ ofconfig list -n NODE1 -s tjes -sec SPOOL -k SPOOL_BACKUP_DIR -l
===================================================================================
SUBJECT : tjes
SECTION : SPOOL
KEY : SPOOL_BACKUP_DIR
TYPE : 2
DEFAULT_VALUE : $(OPENFRAME_HOME)/spbackup
VALUE(M)* : $(OPENFRAME_HOME)/spbackup
VALUE(D) : $(OPENFRAME_HOME)/spbackup
AVAIL_VALUE :
DESCRIPTION : Directory where spool archive.
===================================================================================
SPOOL의 내용을 보기 위해 임시로 복원하게 될 디렉터리를 설정한다.
$ ofconfig list -n NODE1 -s tjes -sec SPOOL -k SPOOL_UNPACK_DIR -l
===================================================================================
SUBJECT : tjes
SECTION : SPOOL
KEY : SPOOL_UNPACK_DIR
TYPE : 2
DEFAULT_VALUE : $(OPENFRAME_HOME)/spunpack
VALUE(M)* : $(OPENFRAME_HOME)/spunpack
VALUE(D) : $(OPENFRAME_HOME)/spunpack
AVAIL_VALUE :
DESCRIPTION : Directory where archived spool is extracted temporarily.
===================================================================================
7. 기타 명령어
본 절에서는 기타 명령어의 사용법에 대해서 설명한다.
7.3. EDIT
입력한 filepath을 지정한 에디터로 열어준다.
-
사용법
EDIT <filepath>
다음은 입력 항목에 대한 설명이다.
항목 설명 <filepath>
절대 경로를 입력한다.
관련 환경설정
파일을 열수 있는 에디터를 지정한다.
$ ofconfig list -n NODE1 -s tjesmgr -sec DEFAULT_OPTION -k EDITOR -l ==================================================================================== SUBJECT : tjesmgr SECTION : DEFAULT_OPTION KEY : EDITOR TYPE : 2 DEFAULT_VALUE : vi &FILEPATH VALUE(M)* : vim -w&ROWCOUNT &FILEPATH VALUE(D) : vim -w&ROWCOUNT &FILEPATH AVAIL_VALUE : DESCRIPTION : Editing program name for tjesmgr command EDIT. &ROWCOUNT will be replaced window size. &FILEPATH will be replaced editing filepath. -w&ROWCOUNT option is valid only for `old vi' not `vim'. ====================================================================================
7.6. LICENSE
입력에 해당하는 라이선스 파일의 정보를 보여준다.
-
사용법
LICENSE { <product> | <abs-filepath> | <filename> }
다음은 입력 항목에 대한 설명이다.
항목 설명 <product>
PRODUCT로는 현재 TJES, TACF, HIDB, OSC, OSI가 있다.
<abs-filepath >
라이선스 파일의 절대경로를 입력한 경우 해당 절대경로의 파일을 찾아 정보를 조회한다.
<filename>
라이선스 파일의 이름만을 입력한 경우 OpenFrame 환경설정에 등록되어 있는 라이선스 디렉터리에서 해당 라이선스 파일을 찾아서 정보를 보여준다.
관련 환경설정
라이선스 디렉터리이다.
$ ofconfig list -n NODE1 -s ofsys -sec DIRECTORY -k LICENSE_DIR -l
===================================================================================
SUBJECT : ofsys
SECTION : DIRECTORY
KEY : LICENSE_DIR
TYPE : 2
DEFAULT_VALUE : ${OPENFRAME_HOME}/license
VALUE(M)* : ${OPENFRAME_HOME}/license
VALUE(D) : ${OPENFRAME_HOME}/license
AVAIL_VALUE :
DESCRIPTION :
===================================================================================
7.7. NOTIFY(N)
현재 로그인된 USERID로 NOTIFY 처리시킨 JOB의 실행 정보를 보여준다. JOB문이나 JES JCL문(MSP) / JES2 JCL문(MVS)에 NOTIFY 파라미터에 특정 USERID를 지정하고 JOB을 실행하면, JOB 종료 후 해당 USERID에게 메시지를 남긴다. 해당 USERID로 tjesmgr에 접속한 사용자는 tjesmgr 실행 화면에서 명령 사이에 메시지를 확인하거나, NOTIFY 명령어를 통해 메시지를 남긴 모든 JOB의 실행 정보(JOBNAME, JOBID, JOB의 종료 상태)를 확인할 수 있다.
-
사용법
NOTIFY(N)
-
디스플레이 정보
NOTIFY 명령어의 디스플레이 정보는 다음과 같다.
정보 설명 DATE
NOTIFY를 남긴 날짜다.
TIME
NOTIFY를 남긴 시간이다.
MESSAGE
NOTIFY를 남긴 JOB의 실행 정보이다.
7.8. PSPRINT(PSP)
OpenFrame 환경설정에 등록되어 있는 프린터의 정보를 보여준다.
-
사용법
PSPRINT(PSP)
-
디스플레이 정보
OpenFrame 환경설정에 등록되어 있는 프린터에 대한 디스플레이 정보는 다음과 같다.
정보 설명 PRINTER_NAME
프린터 이름이다.
CLASS
OUTPUT CLASS들이다.
PRINTER_COMMAND
프린터를 실행할 명령어이다.
DRIVER_PATH
프린터 라이브러리가 있는 경로이다.
관련 환경설정
프린터를 설정한다. [source,XML}
$ ofconfig list -n NODE1 -s print -sec PRINTER1 -l =================================================================================== SUBJECT : print SECTION : PRINTER1 KEY : CLASS TYPE : 2 DEFAULT_VALUE : AB VALUE(M)* : AB VALUE(D) : AB AVAIL_VALUE : DESCRIPTION : Output class used for this printer. --------------------------------------------------------------------------------- SUBJECT : print SECTION : PRINTER1 KEY : COMMAND TYPE : 2 DEFAULT_VALUE : cat VALUE(M)* : cat VALUE(D) : cat AVAIL_VALUE : DESCRIPTION : Printer's command. --------------------------------------------------------------------------------- SUBJECT : print SECTION : PRINTER1 KEY : DRIVER_PATH TYPE : 2 DEFAULT_VALUE : ${OPENFRAME_HOME}/lib/libdfltprt.so VALUE(M)* : ${OPENFRAME_HOME}/lib/liblrsprt.so VALUE(D) : ${OPENFRAME_HOME}/lib/liblrsprt.so AVAIL_VALUE : DESCRIPTION : Dynamic loading library path for printer. ===================================================================================
7.9. SWITCHUSER
사용자 입력화면이 나타나고 사용자로부터 입력 받은 ID에 해당하는 사용자로 로그인된다.
-
사용법
SWITCHUSER(SU)
-
입력 파라미터
다음은 입력 파라미터에 대한 설명이다.
파라미터 설명 ID
로그인할 사용자 ID를 입력한다.
GROUP NAME
로그인할 사용자의 그룹을 입력한다.
PASSWORD
로그인할 사용자의 패스워드를 입력한다.