TJESMGR 명령어

본 장에서는 JOB 실행 명령어, JOB/OUTPUT 명령어, RUNNER SLOT 명령어, 데이터셋 명령어, 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]

    다음은 로그인 정보의 방법으로 우선순위가 높은 순으로 나열한 것이다.

    1. 사용자가 -i 옵션으로 입력하는 경우

    2. JCL 내에서 호출되는 PROGRAM이 SACEE 정보를 이용하는 경우(JCL 내의 PGM 파라미터에 의해 해당 툴이 호출되거나 셸 스크립트 등의 간접적인 방법으로 호출될 경우)

    3. tacflogin 정보를 이용하는 경우

    4. 환경설정에서 가져오는 경우

    5. 사용자로부터 키보드 입력을 받는 경우

  • 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 FD Information 명령어를 참고한다.

명령어 목록

다음은 각 명령어의 목록이다.

  • JOB 실행 명령어

    명령어 설명

    CANCEL

    입력된 job-ID 또는 job-name에 해당하는 JOB들을 제거(purge)한다.

    HOLD

    입력된 job-ID 또는 job-name에 해당하는 JOB들의 상태를 START 상태에서 HOLD 상태로 바꾼다.

    JOBGCTL(JGC)

    입력된 jobgroup-name의 상태를 파라미터의 조건에 따라서 변경한다.

    JOBGDEL(JGD)

    입력된 jobgroup-name을 JOB Group에서 삭제한다.

    JOBGREG(JGR)

    입력된 jobgroup-name을 파라미터의 조건을 적용하여 JOB Group으로 등록한다.

    JOBGSHOW(JGS)

    등록되어 있는 JOB Group의 상태를 보여준다.

    MACRORUN(MR)

    입력 파라미터에 따라서 MACRO를 실행하여 JOB을 submit한다.

    OUTQUEUEPURGE(OR)

    입력된 job-ID 또는 out-number에 해당하는 JOB들의 OUTPUT들을 OUTPUTQ에서 제거한다.

    OUTQUEUERELEASE(OL)

    입력된 job-ID 또는 out-number에 해당하는 JOB들의 OUTPUT에 대한 DISPOSITION을 HOLD에서 WRITE로 바꾼다.

    REMOVE

    입력된 job-ID 또는 job-name에 해당하는 JOB들을 제거한다.

    RESUME

    입력된 job-ID 또는 job-name에 해당하는 JOB들의 상태를 SUSPEND 상태에서 RESUME 상태로 바꾼다.

    RUN

    입력 파라미터에 따라서 JOB을 submit한다.

    SCAN

    입력 JCLFILE에 대하여 문법 검사를 실행한다. 문법이 이상이 없으면 DONE 상태로 JOBQ에 쌓인다.

    START

    입력된 job-ID 또는 job-name에 해당하는 JOB들의 상태를 HOLD 상태에서 START 상태로 바꾼다.

    STOP

    입력된 job-ID 또는 job-name에 해당하는 JOB들의 상태를 WORKING 상태에서 STOP 상태로 바꾼다.

    SUSPEND

    입력된 job-ID 또는 job-name에 해당하는 JOB들의 상태를 WORKING 상태에서 SUSPEND 상태로 바꾼다.

  • JOB/OUTPUT 명령어

    명령어 설명

    PO

    JOBID별 OUTPUT 상태를 보여준다.

    PODD

    입력된 job-ID의 dd-index 또는 dd-name에 SPOOL을 OpenFrame 환경설정에 tjesmgr 서브젝트, DEFAULT_OPTION 섹션의 VIEWER 키의 VALUE 항목에 설정한 뷰어로 열어준다.

    POJOB

    입력된 job-ID에 해당하는 JOB의 OUTPUT 정보를 보여준다.

    POLIST

    OUTPUT 리스트들의 상세 정보를 보여준다.

    POSPOOL

    입력된 JOBID에 해당하는 JOB의 SPOOL 정보를 보여준다.

    PS

    입력 파라미터의 조건에 해당하는 JOBQ에 있는 JOB들에 대한 JOBNAME, JOBID, CLASS, STATUS, RC, NODE, JCL 리스트를 보여준다.

    PSHISTORY

    PSHISTORY 명령을 실행하면 입력 창이 뜨고, 사용자로부터 입력 받은 조건에 해당하는 내용을 찾아 뷰어로 보여준다.

    PSIO

    입력된 job-ID에 해당하는 JOB의 데이터셋 I/O 횟수를 보여준다.

    PSJOB

    입력된 job-ID에 해당하는 JOB에 대한 상세 정보를 출력한다.

  • INITIATOR 명령어

    명령어 설명

    BOOT

    전체 노드의 TJES를 Boot한다.

    JCLRUNACTIVE(RA) / JCLRUNINACTIVE(RI)

    명령어 라인에서 입력받은 Runner Slot의 상태를 Active에서 Inactive로 또는 Inactive에서 Active로 변경한다.

    NODECLEAR

    해당 노드의 모든 JOB을 STOP시킨다.

    NODESTATUS(NODEST)

    전체 노드의 상태를 보여준다.

    PSJCLRUN(PSR)

    해당 노드의 Runner Slot 상태를 보여준다.

    SHUTDOWN

    전체 노드의 TJES를 다운(down)시킨다.

  • 데이터셋 명령어

    명령어 설명

    DATASETCOPY(DSCOPY)

    입력에 해당하는 from-dataset-name을 to-dataset-name으로 복사하거나 to-volume-serial 볼륨으로 복사한다.

    DATASETCREATE(DSCREATE)

    명령을 실행하면 사용자 입력 화면이 나타나고 사용자로부터 입력 받은 조건에 해당하는 Non-VSAM 데이터셋을 생성한다.

    DATASETDELETE(DSDELETE)

    입력에 해당하는 Non-VSAM 데이터셋들을 삭제한다.

    DATASETEXPORT(DSEXPORT)

    입력에 해당하는 Non-VSAM 데이터셋을 외부로 반출한다.

    DATASETIMPORT(DSIMPORT)

    외부로 반출한 파일을 읽어서 데이터셋으로 복원한다.

    DATASETLIST(DSLIST)

    입력 조건에 해당하는 VTOC에 등록되어있는 데이터셋 리스트를 보여준다.

    DATASETMOVE(DSMOVE)

    데이터셋의 이름을 변경하거나 볼륨을 변경 또는 두 작업을 모두 수행한다.

    DATASETRECATALOG(DSRECAT)

    명령을 실행하면 사용자 입력 화면이 나타나고 입력조건에 해당하는 Non-VSAM 데이터셋을 리카탈로그한다.

    DATASETUNCATALOG(DSUNCAT)

    입력에 해당하는 데이터셋들을 카탈로그에서 삭제한다.

    DATATOUCH(DSTOUCH)

    입력에 해당하는 Non-VSAM 데이터셋의 마지막 수정 날짜를 변경한다.

    GDGCREATE

    명령을 실행하면 입력을 받을 창이 뜨고 입력 조건에 맞게 GDG 데이터셋을 생성한다.

    GDGDELETE

    입력에 해당하는 GDG 데이터셋을 삭제한다.

    PSCATALOG(PSCAT)

    입력 조건에 해당하는 카탈로그에 등록되어있는 데이터셋 리스트를 보여준다.

    PSDATASET(PSDS)

    입력에 해당하는 데이터셋의 상세정보를 보여준다.

    PSENTRY(PSENT)

    입력에 해당하는 엔트리의 상세정보를 보여준다.

    PSLOCK(PSL)

    입력에 해당하는 데이터셋의 Lock 정보를 보여준다.

    PSVOLUME(PSV)

    명령을 실행하면 볼륨에 대한 정보를 보여준다.

    SETCATALOG(SETCAT)

    입력받은 카탈로그를 기본 카탈로그로 하여 데이터셋 관련 명령어에서 사용한다.

  • SPOOL 백업 명령어

    명령어 설명

    SPOOLBACKUP(SPBA)

    입력에 해당하는 SPOOL을 백업한다.

    SPOOLBACKUPLIST(SPBL)

    입력 조건에 해당하는 년/월에 백업된 날짜들을 보여준다.

    SPOOLCLEAR(SPCL)

    입력조건에 해당하는 임시 디렉터리에 복원된 SPOOL을 제거한다.

    SPOOLPODD(SPPODD)

    입력조건에 해당하는 복원된 JOB의 SPOOL을 설정한 뷰어로 열어준다.

    SPOOLPOSPOOL(SPPOSPOOL)

    입력조건에 해당하는 복원된 JOB의 SPOOL 정보를 보여준다.

    SPOOLPS(SPPS)

    입력 조건에 해당하는 날짜에 백업된 SPOOL 리스트를 보여준다.

    SPOOLPSJOB(SPPSJ)

    입력조건에 해당하는 복원된 JOB의 상세 정보를 보여준다.

    SPOOLPSIO(SPPSIO)

    입력조건에 해당하는 복원된 JOB의 I/O 정보를 보여준다.

    SPOOLRESTORE(SPRE)

    입력 조건에 해당하는 백업된 SPOOL의 내용을 조회할 수 있게 임시 디렉터리에 복원한다.

  • 기타 명령어

    명령어 설명

    CLS

    명령을 실행하면 tjesmgr의 화면을 제거한다.

    CURRENTUSER(CU)

    현재 로그인된 사용자의 ID를 조회한다.

    SWITCHUSER(SU)

    명령을 실행하면 사용자 입력화면이 나타나고 사용자로부터 입력 받은 ID에 해당하는 사용자로 로그인된다.

    EDIT

    입력한 filepath을 지정한 에디터로 열어준다.

    ERROR

    입력한 error-number에 해당하는 에러 메시지를 보여준다.

    HELP

    입력 명령어에 해당하는 명령어 사용법을 보여준다. 명령어를 주지 않은 경우 모든 명령어의 사용법을 보여준다.

    LICENSE

    입력에 해당하는 라이선스 파일의 정보를 보여준다.

    PSPRINT(PSP)

    명령을 실행하면 환경 파일에 등록되어 있는 프린터의 정보를 보여준다.

    TSOLIST(TSL)

    명령을 실행하면 현재 터미널을 통해 TSO에 접속한 사용자 리스트를 보여준다.

    VERSION

    명령을 실행하면 TJES의 버전정보를 보여준다.

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. JOBGCTL

입력된 jobgroup-name의 상태를 파라미터의 조건에 따라서 변경한다.

  • 사용법

    JOBGCTL(JGC) <jobgroup-name> {HOLD|RELS|M=<multi-count>}

    다음은 입력 항목에 대한 설명이다.

    항목 설명

    <jobgroup-name>

    상태를 변경하고자 하는 JOB GROUP의 이름을 지정한다.

    HOLD

    대상 JOB GROUP에 대해 스케줄링을 중지한다.

    RELS

    대상 JOB GROUP에 대해 스케줄링을 시작한다.

    M=<multi-count>

    대상 JOB GROUP 내에서 동시에 실행 가능한 JOB의 수를 JCL 실행 중에 변경한다. 지정 가능한 숫자는 0 ~ 999이며 기본값은 1이다.

2.4. JOBGDEL

입력된 jobgroup-name을 JOB Group에서 삭제한다. 이때 대상 JOB Group에 등록된 JOB이 있으면 삭제되지 않는다.

  • 사용법

    JOBGDEL(JGD) <jobgroup-name>

2.5. JOBGREG

입력된 jobgroup-name을 파라미터의 조건을 적용하여 JOB Group으로 등록한다.

  • 사용법

    JOBGREG(JGR) <jobgroup-name> [REL] [M=<multi-count>] [P=<priority>]
                 [W={GO|DATA|<hh.mm>|<jobgroup-names>}]

    다음은 입력 항목에 대한 설명이다.

    항목 설명

    <jobgroup-name>

    신규로 등록하고자 하는 JOB Group의 이름을 지정한다.

    [REL]

    REL 설정을 한 경우 신규 JOB Group내의 JOB들은 순차처리를 한다.

    [M=<multi-count>]

    JOB Group 내의 JOB들의 동시실행 가능한 숫자이다.

    지정 가능한 범위는 0부터 999까지이다. (기본값: 1)

    [P=<priority>]

    JOB Group의 우선순위를 설정한다.

    지정 가능한 범위는 0부터 3까지이다. (기본값: 1)

    [W={GO|DATA |

    <hh.mm> |

    <jobgroup-names>}]

    JOB Group을 HOLD 상태로 등록되게 하며, 지정한 type의 조건이 맞을때 JOB Group의 스케줄링이 시작된다.

    • GO : 오퍼레이터가 JOBGCTL을 통해 RELS를 해야 한다.

    • DATA : DATA의 이벤트를 받아야 한다.

    • <hh.mm> : 지정한 시간이 되어야 한다.

    • jobgroup-names : 지정한 group-names들이 모두 끝나야 한다.

    위의 모든 타입은 JOBGCTL을 통해 스케줄링을 시작하게 할 수 있다.

2.6. JOBGSHOW

등록되어 있는 JOB Group의 상태를 보여준다.

  • 사용법

    JOBGSHOW(JGS)
  • 디스플레이 정보

    JOB Group의 디스플레이 정보는 다음과 같다.

    정보 설명

    JOBGNAME

    등록된 JOB GROUP NAME이다.

    STATUS

    JOB GROUP의 상태를 나타낸다. (NORMAL, RESERVED, DELETING)

    REL

    JOB들의 순차처리 여부이다.

    MULTI

    JOB들의 동시 실행 가능 숫자이다.

    PRTY

    JOB GROUP의 우선순위이다.

    WAIT

    JOB GROUP의 wait type이다.

2.7. MACRORUN

입력 파라미터에 따라서 MACRO를 실행하여 JOB을 submit한다. submit을 하게 되면 JOB은 START 상태로 JOBQ에 쌓이고 PS 명령어를 통해서 JOBQ에 쌓인 JOB을 확인할 수 있다.

  • 사용법

    MACRORUN(MR) <macro-name> [NODE=<node-name>] [CAT=<catalog-name>]
                [<macro-parameters>]

    다음은 입력 항목에 대한 설명이다.

    항목 설명

    <macro-name>

    MACRO 이름 또는 UNIX 파일경로를 지정해 주거나 DATASET(member) 형식으로 지정할 수 있다.

    MACRO 이름으로 설정하면 OpenFrame 환경 설정의 tjes 서브젝트, PROCLIB 섹션의 JCLLIB과 USERLIB에 설정된 DATASET에서 MACRO을 찾는다.

    [NODE=<node-name>]

    • node-name을 지정한 경우 : 지정한 노드에서 JOB이 수행되도록 submit할 수 있다.

    • node-name을 지정하지 않은 경우 : OpenFrame 환경 설정의 tjesmgr 서브젝트, DEFAULT_OPTION 섹션의 DEFAULT_RUNNING_NODE에 설정된 값에 따라서 현재 노드에서만 JOB을 수행할 수 있도록 할지 아니면, 전체 노드 중 아무 노드에서나 JOB을 수행할 수 있도록 할지를 결정한다.

    [CAT=<catalog-name>]

    macro 이름을 DATASET(member) 형식으로 설정할 때 데이터셋이 사용자 카탈로그에 등록되어 있다면 CAT=<catalog-name>를 지정한다.

    [<macro-parameters>]

    MACRO에서 사용하게 될 파라미터들의 값들을 지정한다. 파라미터 값은 작은 따옴표 내부에 기술할 수도 있으며 따옴표 내부의 공백도 파라미터 값으로 전달된다.

2.8. OUTQUEUEPURGE

입력된 job-ID 또는 out-number에 해당하는 JOB들의 OUTPUT들을 OUTPUTQ에서 제거한다.

  • 사용법

    OUTQUEUEPURGE(OR)  {<job-ID>|ON=<out-number>}

    다음은 입력 항목에 대한 설명이다.

    항목 설명

    <job-ID>

    JOB ID이다.

    <out-number>

    POLISTPOJOB 명령어로 출력되는 OUTPUTID의 숫자를 말한다. OUTPUT에 대한 자세한 내용은 OUTPUT을 참고한다.

2.9. OUTQUEUERELEASE

입력된 job-ID 또는 out-number에 해당하는 JOB들의 OUTPUT들의 DISPOSITION을 HOLD에서 WRITE로 전환한다.

  • 사용법

    OUTQUEUERELEASE(OL)  {<job-ID>|ON=<out-number>}

    다음은 입력 항목에 대한 설명이다.

    항목 설명

    <job-ID>

    JOB ID이다.

    <out-number>

    POLISTPOJOB 명령어로 출력되는 OUTPUTID의 숫자를 말한다. OUTPUT에 대한 자세한 내용은 OUTPUT을 참고한다.

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>]

    다음은 입력 항목에 대한 설명이다.

    항목 설명

    <JCLFILE>

    JCL 이름 또는 UNIX 파일경로를 지정해 주거나 PDS DATASET(member) 형식으로 지정할 수 있다.

    JCL 이름으로 설정하면 OpenFrame 환경설정의 tjes 서브젝트, PROCLIB 섹션의 JCLLIBUSERLIB 키에 설정된 DATASET에서 JCL을 찾는다.

    [NODE=<node-name>]

    • node-name을 지정한 경우 : 지정한 노드에서 JOB이 수행되도록 submit 할 수 있다.

    • node-name을 지정하지 않은 경우 : OpenFrame 환경 설정의 tjesmgr 서브젝트, DEFAULT_OPTION 섹션의 DEFAULT_RUNNING_NODE 키에 설정된 값에 따라서 현재 노드에서만 JOB을 수행할 수 있도록 할지 아니면, 전체 노드 중 아무 노드에서나 JOB을 수행할 수 있도록 할지를 결정한다.

    [STEP=<restart-step>]

    restart-step을 지정하게 되면 JCL에 지정된 STEP부터 JOB이 실행된다.

    [CAT=<catalog-name>]

    JCLFILE을 DATASET(member) 형식으로 설정할 때 데이터셋이 사용자 카탈로그에 등록되어 있다면 CAT=<catalog-name>를 지정한다.

2.13. SCAN

입력 JCLFILE에 대하여 문법 검사를 실행한다. 문법이 이상이 없으면 DONE 상태로 JOBQ에 쌓인다.

  • 사용법

    SCAN(SCN) <JCLFILE>  [CAT=<catalog-name>]

    다음은 입력 항목에 대한 설명이다.

    항목 설명

    <JCLFILE>

    JCL 이름 또는 UNIX 파일경로를 지정해 주거나 PDS DATASET(member) 형식으로 지정할 수 있다.

    JCL 이름으로 설정하면 OpenFrame 환경설정의 tjes 서브젝트, PROCLIB 섹션의 JCLLIBUSERLIB 키에 설정된 DATASET에서 JCL을 찾는다.

    [CAT=<catalog-name>]

    JCLFILE을 DATASET(member) 형식으로 설정할 때 데이터셋이 사용자 카탈로그에 등록되어 있다면 CAT=<catalog-name>를 지정한다.

2.14. START

입력된 job-ID 또는 job-name에 해당하는 JOB들의 상태를 HOLD 상태에서 START 상태로 바꾼다. HOLD 상태의 JOB에 대해서만 START 명령어가 유효하다.

  • 사용법

    START  {<job-ID>|N=<job-name>}

2.15. STOP

입력된 job-ID 또는 job-name에 해당하는 JOB들의 상태를 WORKING 상태에서 STOP 상태로 바꾼다. 즉, 실행 중인 JOB을 중지시킨다. WORKING 상태이거나 SUSPEND 상태의 JOB들에 대해서만 유효하다.

  • 사용법

    STOP  {<job-ID>|N=<job-name>}

2.16. SUSPEND

입력된 job-ID 또는 job-name에 해당하는 JOB들의 상태를 WORKING 상태에서 SUSPEND 상태로 바꾼다. 즉, 실행 중인 JOB을 일시정지시킨다. WORKING 상태의 JOB들에 대해서만 유효하다.

  • 사용법

    SUSPEND  {<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 FD Information)

입력된 job-ID의 dd-index 또는 dd-name (dd-index는 POSPOOL의 NO, dd-name은 POSPOOL의 FDNAME을 의미한다)에 SPOOL을 OpenFrame 환경 설정의 tjesmgr 서브젝트, DEFAULT_OPTION 섹션의 'VIEWER’에서 설정한 뷰어로 열어준다.

PODD 명령어를 사용하기 위해서는 PSJOB이나 POSPOOL 명령이 선행되어야 한다.

  • 사용법

    PODD <job-ID> { DI=<dd-index> | DN=<dd-name> }

선행 명령어 없이 실행이 될 경우 아래와 같은 메시지가 출력된다.

Usage: You can use PODD command after using PSJOB or POSPOOL command.
관련 환경설정

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)

입력된 JOBID에 해당하는 JOB의 OUTPUT 정보를 보여준다.

  • 사용법

    POJOB(POJ)  <job-ID>

    다음은 입력 항목에 대한 설명이다.

    항목 설명

    <job-ID>

    입력된 job-ID에 해당하는 JOB의 OUTPUT 정보를 보여준다.

  • 디스플레이 정보

    JOB의 OUTPUT에 대한 디스플레이 정보는 다음과 같다.

    정보 설명

    OUTPUTID

    디스플레이 대상 OUTPUT ID이다.

    FDID

    디스플레이 대상 FD에 부여된 ID이다.

    FDNAME

    JCL에 기술되었던 FD 이름이다.

    CLS (OUTPUT class)

    디스플레이 대상 OUTPUT CLASS이다.

    ST (OUTPUT STATUS)

    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>]

    다음은 입력 항목에 대한 설명이다.

    항목 설명

    <job-ID>

    입력된 job-ID에 해당하는 JOB의 OUTPUT 상세 정보를 보여준다.

    N=<job-name>

    입력된 job-name에 해당하는 JOB의 OUTPUT 상세 정보를 보여준다.

    S=<output-status>

    입력된 output-status에 해당하는 JOB의 OUTPUT 상세 정보를 보여준다.

    C=<outclass>

    입력된 outclass에 해당하는 JOB의 OUTPUT 상세 정보를 보여준다.

  • 디스플레이 정보

    OUTPUT 리스트에 대한 디스플레이 정보는 다음과 같다.

    정보 설명

    OUTPUTID

    디스플레이 대상 OUTPUT ID이다.

    JOBID

    디스플레이 대상 JOBID이다.

    JOBNAME

    디스플레이 대상 JOB 이름이다.

    FDID

    디스플레이 대상 FD에 부여된 ID이다.

    FDNAME

    JCL에 기술되었던 FD 이름이다.

    CLS (OUTPUT class)

    디스플레이 대상 OUTPUT의 CLASS이다.

    ST (OUTPUT STATUS)

    OUTPUT 상태이다.

    FORMS

    디스플레이 대상 JOB의 프린트 관련 옵션 정보이다.

    CHARS

    디스플레이 대상 JOB의 프린트 관련 옵션 정보이다.

    FORMDEF

    디스플레이 대상 JOB의 프린트 관련 옵션 정보이다.

    PAGEDEF

    디스플레이 대상 JOB의 프린트 관련 옵션 정보이다.

    WRITER

    디스플레이 대상 JOB의 프린트 관련 옵션 정보이다.

FDID, FORMS, CHARS, FORMDEF, PAGEDEF, WRITER들은 PRINT 관련 정보들이다. 이에 대한 자세한 내용은 SPOOLOUTPUT Processing을 참고한다.

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 이름이다.

    FDNAME

    해당 SPOOL의 FDNAME이다.

    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(Print Screen of JOB History)

PSHISTORY 명령을 실행하면 입력 창이 뜨고, 사용자로부터 입력 받은 조건에 해당하는 내용을 찾아 뷰어로 보여준다. 아무런 조건도 주지 않은 경우 전체 로그를 보여준다.

  • 사용법

    PSHISTORY(PSH)
  • 입력 파라미터

    사용자에게 다음의 파라미터에 대한 입력을 요구한다.

    파라미터 설명

    USERID

    JOB을 submit한 userid를 설정한다.

    DATE

    날짜의 범위를 지정한다.

    OPERATION

    SUBMIT, EXECUTE, SUSPEND, RESUME, FINISH, REMOVE 중에서 조건을 설정한다.

    JOBID

    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의 이름이다.

    FDNAME

    JCL에 기술된 FD 이름이다.

    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이 실행된 노드명이다.

    JOBG NAME

    디스플레이 대상 JOB의 GROUP NAME이다.

    JOB NAME

    디스플레이 대상 JOB의 JOBNAME이다.

    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하고 있는 이유이다.

    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을 나타낸다.

    FDNAME JOBID(DSNAME) R:? W:?

    • R: 해당 데이터셋의 읽기 시도 횟수이다.

    • W: 해당 데이터셋의 쓰기 시도이다.

PSJOB 명령은 UNIX command line으로는 실행을 할 수 없다.

4. INITIATOR 명령어

본 절에서는 JOB의 실행을 위한 TJES 환경에 관련된 명령어인 INITIATOR 명령어에 대해서 설명한다.

4.1. BOOT

전체 노드의 TJES를 Boot한다. Boot가 된 노드에서는 JOB을 실행할 수 있다. Runner Slot에 JOB을 할당할 수 있게 된다.

  • 사용법

    BOOT  [NODE=<node-name>]

    다음은 입력 항목에 대한 설명이다.

    항목 설명

    [NODE=<node-name>]

    node-name을 준 경우 대상 노드만을 Boot한다.

4.2. 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.3. NODECLEAR

해당 노드의 모든 JOB을 STOP시킨다. 보통 해당 노드가 비정상적으로 되어서 해당 노드에 있는 JOB을 더 이상 컨트롤할 수 없을 때 사용한다.

  • 사용법

    NODECLEAR NODE=<node-name>

4.4. NODESTATUS(NODEST)

전체 노드의 상태를 보여준다.

  • 사용법

    NODESTATUS(NODEST)
  • 디스플레이 정보

    전체 노드에 대한 상태 디스플레이 정보는 다음과 같다.

    정보 설명

    NODENAME

    노드명이다.

    OBMJINIT_STATUS

    obmjinit 서버의 상태이다.

    • Active

    • Downed

    BOOT_STATUS

    TJES의 Boot 상태이다.

    • Booted

    • Not booted

4.5. 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에 할당되어있는 class들이다.

    JOBID,

    JOBNAME,

    JOBclass,

    PID

    Runner Slot에 할당된 JOB에 대한 정보들이다.

    해당 Runner Slot의 class나 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.6. SHUTDOWN

전체 노드의 TJES를 Down시킨다. Down을 하게 되면 비어있는 Runner Slot들을 모두 Down 상태로 변경하여 추가적인 JOB의 스케줄링을 제한하고 WORKING 중인 Runner Slot들은 JOB이 끝나는 대로 Down 상태로 변경한다. Runner Slot들이 Down 상태로 변경되었는지는 PSR 명령어를 통해 확인할 수 있다.

  • 사용법

    SHUTDOWN   [NODE=<node-name>]
    항목 설명

    [NODE=<node-name>]

    node-name을 준 경우 대상 노드만을 Down시킨다.

PSR 명령어에 대한 자세한 사항은 PSJCLRUN(PSR)을 참고한다.

5. 데이터셋 명령어

데이터셋 명령어는 데이터셋을 조회하거나 생성, 삭제 또는 복사하기 위한 명령어들이다. 본 절에서는 데이터셋 명령어에 대한 사용법을 설명한다.

USERCATALOG와 관련해서는 tjesmgr의 "SETCATALOG(SETCAT) 명령어 및 OpenFrame Base "데이터셋 안내서"의 "통합 카달로그"를 참고한다.

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 데이터셋의 이름으로 반드시 입력해야 하는 필수항목이다.

    VOLUME

    Non-VSAM 데이터셋이 저장될 볼륨의 위치이다.

    기본값은 UNIT에 따르거나 SMS 규칙을 따른다. 아무런 값도 지정되지 않은 경우 기본값으로 설정된 볼륨에 따른다.

    UNIT

    데이터셋의 UNIT을 지정한다. 기본값은 VOLUME에 따른다.

    입력받은 UNIT과 VOLUME이 서로 일치하지 않는 경우 에러가 발생한다.

    DSORG

    데이터셋의 DSORG를 지정한다.

    RECFM

    데이터셋의 레코드 포맷을 지정한다.

    KEYLEN

    데이터셋의 Key의 길이를 지정한다.

    ISAM 데이터셋의 경우에 지정할 수 있다.

    LRECL

    데이터셋의 최대 레코드 길이를 지정한다.

    KEYPOS

    데이터셋의 Key의 위치를 지정한다.

    ISAM 데이터셋의 경우에 지정할 수 있다.

    BLKSIZE

    데이터셋의 블록 크기를 지정한다. (기본값: 4096)

    PRIMARY

    데이터셋의 allocation시의 최초 할당 크기를 지정한다. (단위: KB)

    SECONDARY

    데이터셋의 다음 할당 크기를 지정한다. (단위: KB)

    EXPIRATION

    데이터셋의 만기일을 지정한다. (기본값: 99991231)

    CATALOG

    사용자 카탈로그를 지정한다.

    사용자 카탈로그를 지정하지 않는 경우 마스터 카탈로그 또는 ALIAS에 따른 카탈로그로 한다. 생성 관련 명령은 tjesmgr의 SETCATALOG 명령어의 옵션을 따르지 않는다.

    NOCATALOG

    데이터셋의 생성만을 하고 카탈로깅을 하지 않을 경우에 지정한다.

VSAM 데이터셋을 생성하기 위해서는 KQCAMS 유틸리티를 사용해야 하며, 이에 대한 자세한 내용은 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 데이터셋의 limit로 반드시 입력해야 하는 필수항목이다.

    EXPIRATION

    생성할 GDG 데이터셋의 만기일을 지정한다.

    CATALOG

    GDG 데이터셋이 등록될 사용자 카탈로그를 지정한다.

    사용자 카탈로그를 지정을 하지 않는 경우 마스터 카탈로그 또는 ALIAS에 따른 카탈로그에 등록된다. 생성 관련 명령은 tjesmgr의 SETCATALOG 명령어의 옵션을 따르지 않는다.

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>]

    검색하고자 하는 데이터셋이 카탈로그가 되어있을 때 지정한다.

  • 디스플레이 정보

    다음은 PSLOCK 디스플레이 정보에 대한 설명이다.

    항목 설명

    옵션(1,2 컬럼)

    1. Lock을 요청하고 있는 상태이면 R이 보여진다.

    2.Lock을 설정/요청한 프로세스가 실행 중이면 애스터리스크(*)가 보여진다. 프로세스의 NODE가 다른 경우는 보여지지 않는다.

    PID

    Lock을 설정/요청한 프로세스 아이디이다.

    JOBID

    Lock을 설정/요청한 JOBID이다.

    NODEID

    Lock을 설정/요청한 노드이다.

    LOCKTYPE

    요청한 Lock의 타입이다.

    • Exclusive : 대상 데이터셋을 수정하기 위해서 사용하는 타입으로 다른 JOB에서 Lock을 공유할 수 없다.

    • Shared : 대상 데이터셋을 조회하기 위해서 사용하는 타입으로 다른 곳과 Lock을 공유할 수 있다.

    CATALOG_DSN

    요청한 Lock의 이름이다.

    Lock 이름은 다음 중에 하나로 구성된다.

    • USERCATALOG_NAME:DATASET_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>] [UPDATE]

    다음은 입력 항목에 대한 설명이다.

    항목 설명

    [<catalog-name>]

    입력으로 받은 catalog-name을 기본 카탈로그로 하여 데이터셋 관련 명령어에서 사용한다. catalog-name를 주지 않은 경우 마스터 카탈로그를 기본 카탈로그로 한다.

    다음은 카탈로그의 지정 순위이다.

    1. CAT 파라미터로 지정된 user catalog

    2. SETCAT으로 지정된 user catalog

    3. Dataset alias에 따른 user catalog

    4. master catalog

    [UPDATE]

    입력받은 catalog-name을 OpenFrame 환경설정의 ofsys 서브젝트, DIRECTORY 섹션 PROFILE_DIR 키에 지정된 경로에 생성되는 사용자별 프로파일에 등록한다.

    해당 파일에 정보가 있으면 OpenFrame Studio나 tjesmgr에 로그인하는 경우에 기본 카탈로그를 해당 프로파일에 있는 카탈로그로 이용한다. 프로파일 정보가 없으면 마스터 카탈로그를 기본 카탈로그로 사용한다.

  • 예제

    다음과 같이 지정하고 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 FD 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.1. CLS

명령을 실행하면 tjesmgr의 화면을 제거한다.

  • 사용법

    CLS

7.2. CURRENTUSER

현재 로그인된 사용자의 ID를 조회한다.

  • 사용법

    CURRENTUSER(CU)

7.3. SWITCHUSER

명령을 실행하면 사용자 입력화면이 나타나고 사용자로부터 입력 받은 ID에 해당하는 사용자로 로그인된다.

  • 사용법

    SWITCHUSER(SU)
  • 입력 파라미터

    다음은 입력 파라미터에 대한 설명이다.

    파라미터 설명

    ID

    로그인할 사용자 ID를 입력한다.

    GROUP NAME

    로그인할 사용자의 그룹을 입력한다.

    PASSWORD

    로그인할 사용자의 패스워드를 입력한다.

7.4. 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.5. ERROR

입력한 error-number에 해당하는 에러 메시지를 보여준다.

  • 사용법

    ERROR <error-number>

7.6. HELP

입력 명령어에 해당하는 명령어 사용법을 보여준다. 명령어를 주지 않은 경우 모든 명령어의 사용법을 보여준다.

  • 사용법

    HELP   [<tjesmgr_command>]

7.7. 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.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. TSOLIST(TSL)

현재 터미널을 통해 TSO에 접속한 사용자의 리스트를 출력한다.

  • 사용법

    TSOLIST(TSL)   [ID=<userid> | LU=<luname>]

    다음은 입력 항목에 대한 설명이다.

    항목 설명

    [ID=<userid>]

    userid를 준 경우 해당 userid로 접속한 사용자의 리스트만을 출력한다.

    [LU=<luname>]

    luname을 준 경우 해당 luname과 일치하는 사용자의 리스트만을 출력한다.

  • 디스플레이 정보

    TSOLIST로 출력하는 사용자 리스트에 대한 디스플레이 정보는 다음과 같다.

    정보 설명

    USER_ID

    접속한 사용자의 TACF 아이디이다.

    LU_NAME

    접속한 터미널의 LU명이다.

    JOBID

    TSO가 실행된 JOB의 JOBID이다.

    LOGIN_TIME

    TSO로 최초 접속한 시간을 YYYYMMDDHHSS의 형식으로 출력한다.

7.10. VERSION

TJES의 버전정보를 보여준다.

  • 사용법

    VERSION