OpenFrame AIM 시스템 툴
본 장에서는 OpenFrame AIM 온라인 시스템에서 사용하는 툴 프로그램 사용법에 대해 기술한다.
1. 개요
다음은 OpenFrame AIM 온라인 시스템의 운영 편의를 위한 툴 목록이다.
툴 | 설명 |
---|---|
애플리케이션에서 ABEND가 발생한 경우 화면에 출력할 메시지를 테이블에 등록, 조회 및 제거하기 위해 사용된다. |
|
ACP JCL 작성 내용을 테이블에 등록, 조회 및 제거하기 위해 사용된다. |
|
커맨드 라인에서 OpenFrame AIM 커맨드를 수행하기 위해 사용된다. |
|
CTL 테이블의 내용을 조회하기 위해 사용된다. |
|
CTL 테이블을 초기화 하는데 사용된다. |
|
ADL 정보를 등록하는 테이블을 생성하고 삭제하기 위해 사용된다. |
|
ONLINE PRINT 정보를 조회, 삭제 및 재전송을 위해 사용된다. |
|
SMR에서 MENU 화면을 구성할 때 필요한 정보들을 입력하기 위해 사용된다. |
|
트랜잭션 리포트를 위한 툴이다. |
|
ADL 정보를 테이블에 등록하기 위해 사용된다. |
|
포맷 정의 소스를 컴파일하기 위해 사용된다. |
2. aimabegen
aimabegen은 애플리케이션에서 ABEND가 발생한 경우 화면에 출력할 메시지를 테이블에 등록, 조회 및 제거하는 툴이다.
사용법
aimabegen 프로그램을 실행하는 방법은 다음과 같다.
Usage : aimabegen <command> [options]
<command>:
store|s : Store USER ABEND Message
options:
-c : specify code
-m : specify message
delete|d : Delete USER ABEND Message
options:
-c : specify code
-i : executes immedidately
load|l : Load USER ABEND Message
options:
-c : specify code
Example:
aimabegen s -c 01 -m "USER ABEND Message"
-
입력 항목
항목 설명 <command>
-
store (s) : 애플리케이션에서 ABEND 메시지 정보를 테이블에 등록한다. 축약어 s 옵션으로 명령을 실행할 수 있다.
-
delete (d) : 애플리케이션에서 ABEND 메시지 정보를 테이블에서 삭제한다. 축약어 d 옵션으로 명령을 실행할 수 있다.
-
load (l) : 애플리케이션에서 ABEND 메시지 정보를 조회한다. 축약어 l 옵션으로 명령을 실행할 수 있다.
다음은 command에 설정한 각 명령어별 옵션에 대한 설명이다.
-
store (s)
항목 설명 [-c]
애플리케이션에서 ABEND 메시지 정보를 등록할 코드 값을 지정한다. 코드 값은 8자리를 초과할 수 없다. [-m] 옵션과 함께 사용될 수 있다.
[-m]
애플리케이션에서 ABEND 메시지 정보를 등록할 메시지를 지정한다. 메시지는 80byte 를 초과할 수 없다. [-c] 옵션과 함께 사용될 수 있다.
-
delete (d)
항목 설명 [-c]
애플리케이션에서 ABEND 메시지 정보를 삭제할 코드 값을 지정한다.
[-i]
애플리케이션에서 ABEND 메시지 정보를 즉시 삭제한다.
-
load (l)
항목 설명 [-c]
애플리케이션에서 ABEND 메시지 정보를 검색할 코드 값을 지정한다.
-
사용예제
다음은 애플리케이션에서 ABEND 메시지 정보를 테이블에 등록하는 예이다.
$ aimabegen s -c 1 -m "USER ABEND Massage 1"
다음은 명령을 수행한 결과이다.
store success.
다음은 등록된 애플리케이션에서 ABEND 메시지 정보를 삭제하는 예이다.
$ aimabegen d
다음은 명령을 수행한 결과이다.
Do you want to delete all? [Y/N] : Y delete success.
다음은 애플리케이션에서 ABEND 메시지 정보를 조회하는 예이다.
$ aimabegen l
다음은 명령을 수행한 결과이다.
o USER ABEND Message ----------------------------------------------------------------------------------------- CODE MSG ----------------------------------------------------------------------------------------- 1 USER ABEND Massage 1 load success.
3. aimacpgen
aimacpgen은 ACP JCL(Application Control Program Job Control Language) 작성 내용을 테이블에 등록, 조회 및 제거하는 툴이다.
사용법
aimacpgen 프로그램을 실행하는 방법은 다음과 같다.
Usage : aimacpgen <command> [options]
<command>:
store|s : Store ACP JCL
options:
-p : specify ACP JCL file path
-P : specify procedure file path
-a : specify AIMACPIN file path
-f : overwrite if already exists in AIMDIR
load|l : Load ACP JCL
options:
-d : specify AIMDIR ID
-n : specify ACP JOB name
-l : specify for ACP JOB list display
delete|d : Delete ACP JCL
options:
-d : specify AIMDIR ID
-n : specify ACP JOB name
-
입력 항목
항목 설명 <command>
-
store (s) : ACP JCL을 분석하고 테이블에 등록한다. 그리고 Tmax config를 출력한다. 축약어 s 옵션으로 명령을 실행할 수 있다.
-
load (l) : ACP JCL 정보를 조회한다. 축약어 l 옵션으로 명령을 실행할 수 있다.
-
delete (d) : ACP JCL을 테이블에서 삭제한다. 축약어 d 옵션으로 명령을 실행할 수 있다.
다음은 command에 설정한 각 명령어별 옵션에 대한 설명이다.
-
store (s)
항목 설명 [-p]
ACP JCL 파일 경로를 지정한다.
[-P], [-a], [-f] 옵션과 함께 사용될 수 있다.
[-P]
ACP JCL의 프러시저 파일 경로를 지정한다.
[-p], [-a], [-f] 옵션과 함께 사용될 수 있다.
[-a]
ACP JCL에서 AIMACPIN 구문이 따로 작성된 경우 파일 경로를 지정한다.
[-p], [-P], [-f] 옵션과 함께 사용될 수 있다.
[-f]
ACP JCL 테이블이 이미 존재하는 ACP JCL인 경우 덮어쓰기를 수행한다.
[-p], [-P], [-a] 옵션과 함께 사용될 수 있다.
-
load (l)
항목 설명 [-d]
JCL 정보를 등록할 AIM 디렉터리의 ID를 지정한다. (기본값: 00)
[-n], [-l] 옵션과 함께 사용될 수 있다.
[-n]
ACP JOB 이름을 지정한다. [-d] 옵션과 함께 사용될 수 있다.
[-l]
등록된 ACP JCL 리스트를 출력한다.
-
delete (d)
항목 설명 [-d]
JCL 정보를 삭제할 AIM 디렉터리의 ID를 지정한다. (기본값: 00)
[-n] 옵션과 함께 사용될 수 있다.
[-n]
ACP JOB 이름을 지정한다.
-
사용예제
다음과 같은 내용의 JCL 파일 TESTMSP.jcl 이 있는 경우 명령어를 사용하는 예이다.
//OIVPJOB JOB //STEP1 EXEC PGM=JXGIJSM //AIMPED DD SUBSYS=(AIM,OIVPPED,OIVPAPG0,00) //AIMPGM DD DSN=SYS1.PGMLIB,DISP=SHR //SYSOUT DD SYSOUT=* //AIMACPIN DD * JOB NAME=OIVPJOB,DUMPL=1 MQN NAME=OIVPMQN APL NAME=OIVPAP00 APL NAME=OIVPAP01 APL NAME=OIVPAP02 APL NAME=OIVPAP03 APL NAME=OIVPAP04 APL NAME=OIVPAP05 APL NAME=OIVPAP06 /* //
다음은 JCL 파일 TESTMSP.jcl을 테이블에 등록하는 예이다.
$ aimacpgen s -p TESTMSP.jcl
다음은 명령을 수행한 결과이다.
[2020-12-15T12:36:48.988521] [(13191) ] [M] [AIM1001M] Parsing was successful. [2020-12-15T12:36:48.000589] [(13191) ] [M] [AIM1003M] The store was successful. OIVPMQN SVGNAME = svg_domain, TARGET = aimapsvr, MIN = 0, MAX = 10, SVRTYPE=UCS, RESTART=Y, CLOPT="-o $(SVR)$(DATE).out -e $(SVR)$(DATE).err" [2020-12-15T12:36:48.000626] [(13191) ] [M] [AIM1005M] Tmax config generation success.
JCL을 등록할 때 aimacpgen에서 출력하는 Tmax 서버 설정의 항목 중 MAX와 RESTART 설정은 사용자 환경에 맞게 수정할 수 있다. 각 항목에 대한 자세한 설명은 "Tmax 운영 안내서"를 참고한다. |
다음은 등록된 ACP JCL 리스트 정보를 조회하는 예이다.
$ aimacpgen l -l
다음은 명령을 수행한 결과이다.
o ACP (Total : 1) ------------------------------ JOB_NAME DID PED_NAME APG_NAME ------------------------------ OIVPJOB 00 OIVPPED OIVPAPG0 [2020-12-15T12:37:13.466902] [(13197) ] [M] [AIM1007M] The load was successful.
다음은 JOB 이름으로 ACP JCL 정보를 조회하는 예이다.
$ aimacpgen l -n OIVPJOB
다음은 명령을 수행한 결과이다.
-----------aimacp script tree start------------------ ACP statement NAME=OIVPJOB DID=00 PED=OIVPPED APG=OIVPAPG0 MSGCLASS= DD statement [0] SUB_SEQ=1 DDNAME=AIMPGM DSN=SYS1.PGMLIB DISP_STATUS=SHR DISP_NORMAL=KEEP DISP_ABNORMAL=KEEP SYSOUT_STATUS= SYSOUT_CLASS= DCB= DD statement [1] SUB_SEQ=2 DDNAME=SYSOUT DSN= DISP_STATUS= DISP_NORMAL= DISP_ABNORMAL= SYSOUT_STATUS=USED SYSOUT_CLASS=* DCB= -----------aimacp script tree end-------------------- -----------aimacpin script tree start------------------ JOB statement NAME=OIVPJOB SOUT=A DUMPL=1 CBLDBG=0 INITEX= TERMEX= SYSAPL= ABENDEX= EXPARM= MQN statement [0] NAME=OIVPMQN INITTNO=0 INITEX= TERMEX= OPENTYPE=0 APLTYPE=1 TRNMSG=0 NRMLAPL= DLAPL= ERRAPL= ABENDEX= APLABEND=0 SQL=0 MULTICON=0 APL statement [0] SEQ=1 NAME=OIVPAP00 APLTYPE=1 LOADMODE=0 LOCALTC=1 RENAME=OIVPAP00 APL statement [1] SEQ=2 NAME=OIVPAP01 APLTYPE=1 LOADMODE=0 LOCALTC=1 RENAME=OIVPAP01 APL statement [2] SEQ=3 NAME=OIVPAP02 APLTYPE=1 LOADMODE=0 LOCALTC=1 RENAME=OIVPAP02 APL statement [3] SEQ=4 NAME=OIVPAP03 APLTYPE=1 LOADMODE=0 LOCALTC=1 RENAME=OIVPAP03 APL statement [4] SEQ=5 NAME=OIVPAP04 APLTYPE=1 LOADMODE=0 LOCALTC=1 RENAME=OIVPAP04 APL statement [5] SEQ=6 NAME=OIVPAP05 APLTYPE=1 LOADMODE=0 LOCALTC=1 RENAME=OIVPAP05 APL statement [6] SEQ=7 NAME=OIVPAP06 APLTYPE=1 LOADMODE=0 LOCALTC=1 RENAME=OIVPAP06 -----------aimacpin script tree end--------------------
다음은 ACP JCL 테이블에서 삭제하는 예이다.
$ aimacpgen d -n OIVPJOB
다음은 명령을 수행한 결과이다.
[2020-12-15T12:37:42.123345] [(13213) ] [M] [AIM1009M] The delete was successful.
4. aimcmd
aimcmd는 커맨드 라인에서 OpenFrame AIM 커맨드를 수행하도록 제공하는 프로그램이다.
커맨드를 수행할 때 정보를 관리하는 DCMS 및 기본 유저의 환경설정은 설정파일의 DCMS 섹션을 참고하고, 커맨드 수행 기록은 설정파일의 LOG_DIR 설정을 참고하여 확인 가능하다. 설정파일에 대한 자세한 사항은 OpenFrame AIM "환경설정 안내서"를 참고한다. |
사용법
aimcmd 프로그램을 실행하는 방법은 다음과 같다.
Usage: aimcmd [-u <userid>/<passwd>] -c <command>
| aimcmd [-h | -v]
Options:
-u <userid>/<passwd> Specify TACF user id and password
-c <command> Specify AIM command and options
-h Display this information and exit
-v Display version information and exit
Example:
aimcmd -c 'DISPLAY WS,WS=WS000001'
-
입력항목
항목 설명 [-u <userid>/<passwd>]
OpenFrame TACF에 로그인되어 있지 않는 경우 커맨드를 사용할 사용자 ID와 패스워드를 지정한다.
커맨드 수행 권한을 확인하는 경우 우선순위는 다음과 같다.
-
OpenFrame TACF 로그인 정보
-
[-u] 옵션으로 입력받은 ID/PW 정보
-
openframe_aim.conf에 지정되어 있는 DEFAULT_USER 정보
[-u] 옵션은 [-c] 옵션 또는 [-s] 및 [-l] 옵션과 함께 사용될 수 있다.
-c <command>
수행할 AIM 커맨드를 입력한다.
커맨드는 single quotation mark로 감싸서 전달한다. 커맨드 종류나 형식에 대한 자세한 내용은 OpenFrame AIM "명령어 참조 안내서"를 참고한다.
[-c] 옵션은 [-u] 옵션과 같이 사용될 수 있지만 [-s] 및 [-l] 옵션과 함께 사용될 수는 없다.
-h
aimcmd의 사용방법을 보여준다.
-v
프로그램의 버전 정보를 출력한다.
-
사용예제
aimcmd 툴로 AIM 커맨드 'DISPLAY SMQN’을 수행한 결과이다.
$ aimcmd -c 'D SMQN'
aimcmd: command [D SMQN] input
SMQN NAME MQN NAME DID PRC NAME STATE Q CNT
OIVPAP00 OIVPMQN 00 OPENED 0
OIVPAP01 OIVPMQN 00 OPENED 0
OIVPAP02 OIVPMQN 00 OPENED 0
OIVPAP03 OIVPMQN 00 OPENED 0
OIVPAP04 OIVPMQN 00 OPENED 0
OIVPAP05 OIVPMQN 00 OPENED 0
OIVPAP06 OIVPMQN 00 OPENED 0
[2020-12-15T12:35:30.839580] [AIMCMD(13123) ] [M] [CMD0001M] The command execution was successful, CMD = [D SMQN]
5. aimctlcheck
aimctlcheck은 OpenFrame AIM 시스템 운영 중에 사용되는 실시간 정보 테이블의 내용을 조회하는 툴이다.
사용법
aimctlcheck 프로그램을 실행하는 방법은 다음과 같다. 별도의 옵션이 존재하지 않는다.
Usage : aimctlcheck [options]
Options:
-d <did> Specify AIM DID
-
[options]
항목 설명 [-d <did>]
DID를 지정하여 초기화한다. (기본값: 00)
사용예제
다음은 aimctlcheck 실행 예이다.
$ aimctlcheck -d 00
다음은 명령을 수행한 결과이다.
o APG (Total : 1) ------------------------------------ DID NAME RCVR_LVL OPEN_TYPE ------------------------------------ 00 OIVPAPG0 DWN,FW,CAN 0 (NONE) o JOB (Total : 1) --------------------------------------- DID APG JOB PED ACP_TYPE --------------------------------------- 00 OIVPAPG0 OIVPJOB OIVPPED 1 (YES) o PROCEDURE (Total : 1) ------------------------------------------------- DID NAME TYPE STATE FID SMQN ------------------------------------------------- 00 OIVPPROC 2 (PF) 1 (OPENED) OIVPFID0 o MQN (Total : 1) ----------------------------------------------------------------- DID NAME PROCEDURE JOBNAME TYPE STATE AP_TYPE ----------------------------------------------------------------- 00 OIVPMQN OIVPJOB 2 (PFACP) 1 (OPENED) 0 (DRVN) o SMQN (Total : 7) --------------------------------------------------------------- DID NAME MQN APL JOBNAME STATE AP_TYPE --------------------------------------------------------------- 00 OIVPAP00 OIVPMQN OIVPAP00 OIVPJOB 1 (OPENED) 0 (DRVN) 00 OIVPAP01 OIVPMQN OIVPAP01 OIVPJOB 1 (OPENED) 0 (DRVN) 00 OIVPAP02 OIVPMQN OIVPAP02 OIVPJOB 1 (OPENED) 0 (DRVN) 00 OIVPAP03 OIVPMQN OIVPAP03 OIVPJOB 1 (OPENED) 0 (DRVN) 00 OIVPAP04 OIVPMQN OIVPAP04 OIVPJOB 1 (OPENED) 0 (DRVN) 00 OIVPAP05 OIVPMQN OIVPAP05 OIVPJOB 1 (OPENED) 0 (DRVN) 00 OIVPAP06 OIVPMQN OIVPAP06 OIVPJOB 1 (OPENED) 0 (DRVN) o WORKSTATION (Total : 1) ---------------------------------------------------- DID NAME PROCEDURE MQN SMQN WS_STATE ---------------------------------------------------- 00 UGSSSC00 OIVPPROC OIVPMQN OIVPAP00 1 (IDLE)
다음은 명령어의 출력 항목에 대한 설명이다.
-
APG
항목 설명 DID
AIM 디렉터리의 ID를 보여준다.
NAME
APG 이름을 보여준다.
RCVR_LVL
APG에 지정된 리커버리 레벨을 보여준다.
-
NON : 리커버리 기능을 사용하지 않음
-
DWN : 다운 리커버리 기능
-
CAN : 캔슬 리커버리 기능
-
FW : 포워드 리커버리 기능
-
BW : 백워드 리커버리 기능
OPEN_TYPE
APG가 속하는 애플리케이션을 기동할 때 NDB 혹은 데이터셋에 에러가 발생하는 경우 무시하고 계속 기동시킬지에 대한 설정을 보여준다.
-
NONE : 에러가 발생하는 경우 이상종료
-
OPEN : 에러가 발생하는 경우 무시하고 계속 기동
-
-
JOB
항목 설명 DID
AIM 디렉터리의 ID를 보여준다.
APG
JOB에 포함된 APG 이름을 보여준다.
JOB
JOB 이름을 보여준다.
PED
JOB에 포함된 PED 이름을 보여준다.
ACP_TYPE
ACP JOB인지 보여준다.
-
YES : ACP JOB임
-
NO : ACP JOB이 아님
-
-
PROCEDURE
항목 설명 DID
AIM 디렉터리의 ID를 보여준다.
NAME
프러시저명을 보여준다.
TYPE
프러시저에서 사용되는 메시지 파일 타입을 보여준다.
-
MF(Message File) : 메시지 파일 타입
-
PF(Presentation File) : 표시 파일 타입
STATE
프러시저 상태를 보여준다.
-
OPENED : 지정된 프러시저 오픈 처리 상태
-
CLOSING : 지정된 프러시저 폐쇄 처리 상태
FID
프러시저에 접속하는 경우 출력될 포맷 정의체를 보여준다.
SMQN
프러시저에 접속하는 경우 실행할 애플리케이션을 보여준다.
-
-
MQN
항목 설명 DID
AIM 디렉터리의 ID를 보여준다.
NAME
MQN 이름을 보여준다.
PROCEDURE
MQN과 연결된 프러시저 이름을 보여준다.
JOBNAME
실행한 JOB 이름을 보여준다.
TYPE
MQN 타입을 보여준다.
-
MF : 메시지 파일 타입
-
PFACP : 표시 파일 타입의 ACP
-
PF : 표시 파일 타입
STATE
MQN 상태을 보여준다.
-
OPENED : MQN이 동작 중임
AP_TYPE
애플리케이션 프로그램 활성화 모드를 보여준다.
-
DRVN : 메시지 기동형의 응용 프로그램
-
WAIT : 메시지 대기형의 응용 프로그램
-
-
SMQN
항목 설명 DID
AIM 디렉터리의 ID를 보여준다.
NAME
SMQN 이름을 보여준다.
MQN
SMQN이 포함하는 MQN 이름을 보여준다.
APL
SMQN과 연결된 애플리케이션 이름을 보여준다.
JOBNAME
실행한 JOB 이름을 보여준다.
STATE
SMQN 상태을 보여준다.
-
OPENED : 동작 중
-
INH_T : 일시 폐색 상태
-
INH_F : 동기 폐색 상태
-
INH_E : 긴급 폐색 상태
AP_TYPE
애플리케이션 프로그램 활성화 모드를 보여준다.
-
DRVN : 메시지 기동형의 응용 프로그램
-
WAIT : 메시지 대기형의 응용 프로그램
-
-
WORKSTATION
항목 설명 DID
AIM 디렉터리의 ID를 보여준다.
NAME
워크스테이션 이름을 보여준다.
PROCEDURE
단말에서 접속한 프러시저 이름을 보여준다.
MQN
단말을 실행한 MQN 이름을 보여준다.
SMQN
단말을 실행한 SMQN 이름을 보여준다.
WS_STATE
단말의 상태를 보여준다.
-
IDLE : 대기 상태
-
BUSY : MQN과 통신 중
-
6. aimctlinit
aimctlinit은 OpenFrame AIM 시스템 운영 중에 사용되는 CTL 테이블을 초기화하는 툴이다.
시스템 운영 중에 사용하게 되면, 시스템을 재기동해야 하므로 비정상적인 상황을 제외하고는 사용을 권장하지 않는다. |
사용법
aimctlinit 프로그램을 실행하는 방법은 다음과 같다.
aimctlinit
Usage : aimctlinit [options]
Options:
-i Executes immedidately
-d <did> Specify AIM DID
-
[options]
항목 설명 [-i]
사용자 확인 없이 바로 초기화한다.
[-d <did>]
DID를 지정하여 초기화한다. (기본값: 00)
[-i] 옵션과 함께 사용될 수 있다.
사용예제
다음은 초기화 명령 실행 예이다.
$ aimctlinit
다음은 명령을 수행한 결과이다.
Do you want to execute aimctlinit? [Y/N] : Y AIMINITCTL successed
다음은 초기화 실행하는 경우 확인 없이 실행되는 예이다.
$ aimctlinit -i
다음은 명령을 수행한 결과이다.
AIMINITCTL successed
다음은 DID를 지정하여 초기화하는 예이다.
$ aimctlinit -d 00
다음은 명령을 수행한 결과이다.
Do you want to execute aimctlinit? [Y/N] : Y AIMINITCTL successed
7. aiminit
aiminit은 OpenFrame AIM의 ADL 정보 및 운영할 때 사용하는 런타임 정보와 로그 정보를 관리하는 테이블과 인덱스를 생성하고 삭제하는 툴이다.
사용법
aiminit 프로그램을 실행하는 방법은 다음과 같다.
Usage : aiminit <command> [options]
Command :
create Create AIM System Tables/Indices
remove Remove AIM System Tables/Indices
list Display AIM System Table/Indices List
Options:
-t <table/index name> Specify AIM System Table/Index to be created or removed
-st <tablespace> Specify AIM system tablespace name
-lt <tablespace> Specify AIM log tablespace name
-
입력항목
항목 설명 <command>
-
create : OpenFrame AIM의 시스템 테이블을 생성한다.
-
remove : OpenFrame AIM의 시스템 테이블을 삭제한다.
-
list : OpenFrame AIM의 시스템 테이블 목록을 조회한다.
-
-
[options]
항목 설명 [-t <table/index name>]
생성/삭제할 테이블이나 인덱스명을 지정한다. 미지정한 경우 전체 테이블을 생성/삭제한다.
[-st <tablespace>]
OpenFrame AIM 시스템 테이블 스페이스 이름을 지정한다. 테이블을 생성하는 경우에만 유효하다.
[-lt <tablespace>]
OpenFrame AIM 로그 테이블 스페이스 이름을 지정한다. 테이블을 생성하는 경우에만 유효하다.
사용예제
다음은 테이블을 생성하는 예이다.
$ aiminit create -st OFM_REPOSITORY -lt OFM_LOG
다음은 테이블을 삭제하는 예이다.
$ aiminit remove
명령을 수행 시 다음과 같은 확인 문구가 출력된다.
Removing the DB table may affect the system. Do you want to remove the DB table? [Y/N] :
다음은 테이블 구조를 확인하는 예이다.
$ aiminit list
출력 결과는 다음과 같다.
No Table ---------------------------------------------- 1 OFM_AIM_ADL_MASTER 2 |-OFM_AIM_ADL_SIS 3 |-OFM_AIM_ADL_APG 4 |-OFM_AIM_ADL_SG 5 |-OFM_AIM_ADL_WS 6 |-OFM_AIM_ADL_WS_TERM 7 |-OFM_AIM_ADL_PROC 8 |-OFM_AIM_ADL_SCHM 9 | '-OFM_AIM_ADL_SCHM_DS 10 | '-OFM_AIM_ADL_SCHM_DS_VOLUME 11 |-OFM_AIM_ADL_MQN 12 | |-OFM_AIM_ADL_SMQN 13 | |-OFM_AIM_ADL_MQN_DD 14 | '-OFM_AIM_ADL_MQN_SPECIAL 15 '-OFM_AIM_ADL_PED 16 '-OFM_AIM_ADL_PED_AP 17 |-OFM_AIM_ADL_PED_DB 18 | '-OFM_AIM_ADL_PED_DB_DETAIL 19 |-OFM_AIM_ADL_PED_DS 20 | '-OFM_AIM_ADL_PED_DS_DETAIL 21 |-OFM_AIM_ADL_PED_MQN 22 '-OFM_AIM_ADL_PED_RDB 23 '-OFM_AIM_ADL_PED_RDB_DETAIL 24 OFM_AIM_CTL_APG 25 OFM_AIM_CTL_JOB 26 OFM_AIM_CTL_PROC 27 OFM_AIM_CTL_MQN 28 OFM_AIM_CTL_SMQN 29 OFM_AIM_CTL_WS 30 OFM_AIM_ACP_MASTER 31 |-OFM_AIM_ACP_DD 32 |-OFM_AIM_ACP_DD_IDX1 33 '-OFM_AIM_ACPIN_JOB 34 |-OFM_AIM_ACPIN_DEST 35 '-OFM_AIM_ACPIN_MQN 36 |-OFM_AIM_ACPIN_MQN_APL 37 |-OFM_AIM_ACPIN_MQN_APL_IDX1 38 |-OFM_AIM_ACPIN_MQN_FILE 39 '-OFM_AIM_ACPIN_MQN_FILE_IDX1 40 OFM_AIM_ABEND_MSG 41 OFM_AIM_POST_TIME 42 OFM_AIM_TX_LOG 43 OFM_AIM_TX_LOG_IDX1 44 OFM_AIM_PRT 45 OFM_AIM_PRT_SEQ 46 OFM_AIM_PRT_BIR
8. aimprtview
aimprtview는 ONLINE PRINT을 위한 정보 조회, 삭제 및 재전송을 위한 툴이다.
사용법
aimprtview 프로그램을 실행하는 방법은 다음과 같다.
Usage : aimprtview <command> [options]
<command>:
load|l : Load print information
options:
-d : specify PRT ID
-n : specify DEST NAME
-f : specify FORMAT ID
delete|d : Delete print information
options:
-d : specify PRT ID
-i : executes immedidately
resend|r : Resend print information
-d : specify PRT ID
-
입력 항목
항목 설명 <command>
-
load (l) : ONLINE PRINT 정보를 조회한다. 축약어 l 옵션으로 명령을 실행할 수 있다.
-
delete (d) : ONLINE PRINT 정보를 테이블에서 삭제한다. 축약어 d 옵션으로 명령을 실행할 수 있다.
-
resend (r) : ONLINE PRINT 정보를 재전송한다. 축약어 r 옵션으로 명령을 실행할 수 있다.
다음은 command에 설정한 각 명령어별 옵션에 대한 설명이다.
-
load (l)
항목 설명 [-d]
ONLINE PRINT 정보를 조회할 SEQ를 지정한다.
[-n]
ONLINE PRINT 정보를 조회할 DEST NAME을 지정한다.
[-f]
ONLINE PRINT 정보를 조회할 FORMAT ID를 지정한다.
-
delete (d)
항목 설명 [-d]
ONLINE PRINT 정보를 삭제할 SEQ를 지정한다.
[-i]
ONLINE PRINT 정보를 즉시 삭제한다.
-
resend (r)
항목 설명 [-d]
ONLINE PRINT 정보를 재전송하기 위한 SEQ를 지정한다.
-
-
출력 항목
다음은 load 기능에서 테이블 타입으로 출력되는 항목에 대한 설명이다.
항목 설명 SEQ
장표 데이터를 전달하는 처리의 ID를 보여준다.
DESTNAME
장표 데이터가 전달되는 PRINT 단말 목적지를 보여준다.
FORMATID
장표 데이터를 생성하기 위한 장표 이름을 보여준다.
SEND
장표 데이터를 PRINT 단말로 전송 성공한 횟수를 보여준다.
FAIL
장표 데이터를 PRINT 단말로 전송 실패한 횟수를 보여준다.
NOTIFY
장표 데이터를 PRINT 단말로 전송 여부를 보여준다.
ISSUE TIME
장표 데이터를 DB에 저장한 시간을 보여준다.
PRINT_TIME
장표 데이터를 PRINT 단말로 전송한 시간을 보여준다.
사용예제
다음은 ONLINE PRINT 정보를 조회하는 예이다.
$ aimprtview l
다음은 명령을 수행한 결과이다.
o Print Information ---------------------------------------------------------------------------------------------- SEQ DESTNAME FORMATID SEND FAIL NOTIFY ISSUE_TIME PRINT_TIME ---------------------------------------------------------------------------------------------- 1 UGSSSC00 OIVPFID5 1 0 N 2024/01/19 01:01:10 2024/01/19 01:01:30 2 UGSSSC00 OIVPFID5 1 0 N 2024/02/01 00:43:19 2024/02/01 00:44:28
다음은 등록된 ONLINE PRINT 정보를 삭제하는 예이다.
$ aimprtview d -d 1
다음은 명령을 수행한 결과이다.
Removing the DB table may affect the system. Do you want to remove the DB table? [Y/N] : Y delete success.
다음은 ONLINE PRINT 정보를 재전송하는 예이다.
$ aimprtview r -d 2
다음은 명령을 수행한 결과이다.
resend success.
9. aimsmradm
aimsmradm은 SMR에서 MENU 화면을 구성할 때 필요한 정보들을 입력받기 위해 사용하는 툴이다.
사용법
aimsmradm 프로그램을 실행하는 방법은 다음과 같다.
Usage : aimsmradm [-p <tablename|all>]
| aimsmradm [-r smrmenu]
| aimsmradm [-h | -v | -i]
options:
-v : Show version
-h : Show help
-i : Input commands
[Press Ctrl-d for quit]
-p <tablename|all> : Display SMR DB table
<tablename> : smrutrm, smruwrk, smrwrk
-r smrmenu : Reflect SMR MENU immediately
-
입력 항목
항목 설명 [-v]
aimsmradm의 버전 정보를 보여준다.
[-h]
aimsmradm의 사용방법을 보여준다.
[-i]
단말, 사용자, 업무 정보들을 등록 및 삭제하기 위한 명령어를 입력하기 위해 사용된다.
Ctrl-d를 누르면 입력모드가 종료된다.
[-p <tablename 또는 all>]
SMR DB에 저장된 내용을 보여준다.
tablename으로 smrutrm, smruwrk, smrwrk을 입력할 수 있으며, all을 입력하면 전체 정보를 조회할 수 있다.
[-r smrmenu]
메모리에 캐싱되어 있는 SMR MENU를 업데이트 한다.
접속된 사용자가 있을 경우에는 동작하지 않는다.
사용예제
다음은 SMR DB에 등록된 정보를 조회하는 예이다.
$ aimsmradm -p smrwrk
다음은 명령을 수행한 결과이다.
====================================================================== * TABLE NAME : OFM_AIM_SMRWRK NO | WORK | PROC | PASSWD | ORDER | DLANG NAME | DNAME DESC ---------------------------------------------------------------------- 1 TSTMENU - NO 0 JAPANESE TEST ONLINE
다음은 SMR 명령어 입력을 위한 입력 대기화면이다. 다음과 같은 화면에서 SMR 명령어를 입력하여 MENU 화면을 구성하기 위한 정보를 입력한다.
$ aimsmradm -i
Enter the Command [Ctrl-d to quit] :
command에 대한 자세한 설명은 OpenFrame AIM "운영자 안내서"의 부록 'SMR 명령어’를 참고한다. |
다음은 SMR MENU를 업데이트하는 예이다. aimsmradm -r smrmenu command를 사용했을 때는 아래와 같이 command 확인을 요청한다.
$ aimsmradm -r smrmenu
Confirm command?(y/n):
다음은 성공적으로 SMR MENU를 업데이트했을 때 결과이다.
[2023-05-12T12:35:43.075706] [aimsmradm(143606) ] [M] [ATM0300M] Successfully done - Dynamic reflect for SMR MENU
10. aimtxview
aimtxview은 트랜잭션 리포트를 위한 툴이다. 트랜잭션 시작 시간과 종료 시간, JOD 이름, MQN 이름, SMQN 이름, Q 카운트 등의 정보를 출력하고 삭제 기능을 제공한다.
OpenFrame AIM 설정 파일의 TXLOG_TYPE 이 DB 또는 BOTH로 설정되어 있어야 사용 가능하다. AIM 설정 파일에 대한 자세한 사항은 OpenFrame AIM "환경설정 안내서"를 참고한다. |
사용법
aimtxview 프로그램을 실행하는 방법은 다음과 같다. 모든 옵션은 결합하여 사용 가능하다.
Usage : aimtxview <command> [options] [-r] <tran date> [tran date]
<command>:
display|d : Display transaction information
options:
-a : Full table information output
-f <t|c> : Specify output format
t : Table type
c : CSV type
-o <a|d> : Specify output ordering
a : Ascending order
d : Descending order
remove|r : Remove transaction information
options:
-i : Executes immediately
[options]:
-r : Specify a transaction date range
-h : Display tool information and exit
-v : Display version information
Example:
aimtxview d 20190101
aimtxview d -a 20190101
aimtxview d -o d 20190101
aimtxview d -f c 20190101
aimtxview d -r 20190101 20191231
aimtxview r 20190101
aimtxview r -i 20190101
aimtxview r -r 20190101 20191231
-
입력항목
항목 설명 <command>
-
display (d) : 트랜잭션 정보를 출력한다. 축약어 d 옵션으로 명령을 실행할 수 있다.
-
remove (r) : 트랜잭션 정보를 삭제한다. 축약어 r 옵션으로 명령을 실행할 수 있다.
tran date
검색할 트랜잭션 날짜를 YYYYMMDD 형식으로 입력한다.
다음은 command에 입력한 각 명령어별 옵션에 대한 설명이다.
-
display (d)
트랜잭션 정보를 출력한다. 축약어 d 옵션으로 명령을 실행할 수 있다.
항목 설명 [-a]
전체 정보를 출력한다. 옵션이 생략되면 기본 정보를 출력한다.
[-f <t|c>]
출력 포맷을 지정한다.
-
t : 테이블 타입 (기본값)
-
c : CSV 타입
[-o <a|d>]
정렬 방식을 지정한다.
-
a : 오름차순 정렬 (기본값)
-
d : 내림차순 정렬
-
-
remove (r)
트랜잭션 정보를 삭제한다. 축약어 r 옵션으로 명령을 실행할 수 있다.
항목 설명 [-i]
사용자 확인 없이 바로 삭제한다.
-
-
[options]
항목 설명 [-r]
검색 혹은 삭제할 트랜잭션 기간을 지정하기 위한 옵션이다.
[-h]
aimtxview의 사용방법을 보여준다.
[-v]
aimtxview의 버전 정보를 보여준다.
사용예제
다음은 기본 출력의 예이다.
$ aimtxview -a -r 20190101 20191231
다음은 명령을 수행한 결과와 항목에 대한 설명이다.
TRANS_DATE TRANS_TIME TRANS_END_TIME JOB_NAME MQN_NAME SMQN_NAME TRANS_SVC_TIME TRANS_CPU_TIME WS_NAME IP_ADDR Q_CNT ------------------------------------------------------------------------------------------------------------------------------------ 2019/01/01 19:42:32.761 19:42:32.764 OIVPJOB OIVPMQN OIVPAP00 0.003 0.002 UGSSSC00 127.0.0.1 0 2019/01/01 19:42:34.453 19:42:34.456 OIVPJOB OIVPMQN OIVPAP01 0.003 0.002 UGSSSC00 127.0.0.1 0 2019/01/01 19:42:35.370 19:42:35.373 OIVPJOB OIVPMQN OIVPAP05 0.003 0.002 UGSSSC00 127.0.0.1 0 2019/01/01 19:42:35.628 19:42:35.631 OIVPJOB OIVPMQN OIVPAP01 0.003 0.002 UGSSSC00 127.0.0.1 0
항목 | 설명 |
---|---|
TRANS_DATE |
트랜잭션 수행 날짜를 보여준다. |
TRANS_TIME |
트랜잭션 수행 시작 시간을 보여준다. |
TRANS_END_TIME |
트랜잭션 수행 종료 시간을 보여준다. |
JOB_NAME |
JOD 이름을 보여준다. |
MQN_NAME |
MQN 이름을 보여준다. |
SMQN_NAME |
SMQN 이름을 보여준다. |
TRANS_SVC_TIME |
트랜잭션 수행 시간을 보여준다. |
TRANS_CPU_TIME |
CPU 시간을 보여준다. 전체 정보 출력 옵션 [-a]를 사용하는 경우 출력된다. |
WS_NAME |
WS 이름을 보여준다. 전체 정보 출력 옵션 [-a]를 사용하는 경우 출력된다. |
IP_ADDR |
트랜잭션 수행한 IP 주소을 보여준다. 전체 정보 출력 옵션 [-a]를 사용하는 경우 출력된다. |
Q_CNT |
해당 트랜잭션에서 대기중인 메시지 개수을 보여준다. |
다음은 전체 정보를 출력한 예이다.
$ aimtxview d -a 20190101
다음은 명령을 수행한 결과이다.
TRANS_DATE TRANS_TIME TRANS_END_TIME JOB_NAME MQN_NAME SMQN_NAME TRANS_SVC_TIME TRANS_CPU_TIME WS_NAME IP_ADDR Q_CNT ------------------------------------------------------------------------------------------------------------------------------------ 2019/01/01 19:42:32.761 19:42:32.764 OIVPJOB OIVPMQN OIVPAP00 0.003 0.002 UGSSSC00 127.0.0.1 0 2019/01/01 19:42:34.453 19:42:34.456 OIVPJOB OIVPMQN OIVPAP01 0.003 0.002 UGSSSC00 127.0.0.1 0 2019/01/01 19:42:35.370 19:42:35.373 OIVPJOB OIVPMQN OIVPAP05 0.003 0.002 UGSSSC00 127.0.0.1 0 2019/01/01 19:42:35.628 19:42:35.631 OIVPJOB OIVPMQN OIVPAP01 0.003 0.002 UGSSSC00 127.0.0.1 0
다음은 CSV 타입으로 출력한 예이다.
$ aimtxview d -f c 20190101
다음은 명령을 수행한 결과이다.
2019/01/01,19:42:32.761,19:42:32.764,OIVPJOB ,OIVPMQN ,OIVPAP00,0.003,0 2019/01/01,19:42:34.453,19:42:34.456,OIVPJOB ,OIVPMQN ,OIVPAP01,0.003,0 2019/01/01,19:42:35.370,19:42:35.373,OIVPJOB ,OIVPMQN ,OIVPAP05,0.003,0 2019/01/01,19:42:35.628,19:42:35.631,OIVPJOB ,OIVPMQN ,OIVPAP01,0.003,0
다음은 내림차순으로 출력한 예이다.
$ aimtxview d -o d 20190101
다음은 명령을 수행한 결과이다.
TRANS_DATE TRANS_TIME TRANS_END_TIME JOB_NAME MQN_NAME SMQN_NAME TRANS_SVC_TIME Q_CNT --------------------------------------------------------------------------------------------------------------- 2019/01/01 19:42:35.628 19:42:35.631 OIVPJOB OIVPMQN OIVPAP01 0.003 0 2019/01/01 19:42:35.370 19:42:35.373 OIVPJOB OIVPMQN OIVPAP05 0.003 0 2019/01/01 19:42:34.453 19:42:34.456 OIVPJOB OIVPMQN OIVPAP01 0.003 0 2019/01/01 19:42:32.761 19:42:32.764 OIVPJOB OIVPMQN OIVPAP00 0.003 0
다음은 기간을 지정하고 출력한 예이다.
aimtxview d -r 20190101 20191231
다음은 명령을 수행한 결과이다.
TRANS_DATE TRANS_TIME TRANS_END_TIME JOB_NAME MQN_NAME SMQN_NAME TRANS_SVC_TIME Q_CNT --------------------------------------------------------------------------------------------------------------- 2019/01/01 19:42:32.761 19:42:32.764 OIVPJOB OIVPMQN OIVPAP00 0.003 0 2019/01/01 19:42:34.453 19:42:34.456 OIVPJOB OIVPMQN OIVPAP01 0.003 0 2019/01/01 19:42:35.370 19:42:35.373 OIVPJOB OIVPMQN OIVPAP05 0.003 0 2019/01/01 19:42:35.628 19:42:35.631 OIVPJOB OIVPMQN OIVPAP01 0.003 0 2019/01/02 09:00:38.531 09:00:38.533 OIVPJOB OIVPMQN OIVPAP00 0.002 0 2019/01/02 09:00:39.680 09:00:39.683 OIVPJOB OIVPMQN OIVPAP01 0.003 0 2019/01/02 09:00:41.998 09:00:42.000 OIVPJOB OIVPMQN OIVPAP05 0.002 0 2019/01/02 09:00:43.414 09:00:43.416 OIVPJOB OIVPMQN OIVPAP01 0.002 0
다음은 삭제 명령을 수행한 예이다.
$ aimtxview r 20190101
다음은 명령을 수행한 결과이다.
Do you want to remove? [Y/N] : Y Transaction date : 2019/01/01 Removed count : 4 Remove successed
다음은 기간을 지정하고 삭제 명령을 수행한 예이다.
$ aimtxview r -r 20190101 20191231
다음은 명령을 수행한 결과이다.
Do you want to remove? [Y/N] : Y Transaction date : 2019/01/01 - 2019/12/31 Removed count : 8 Remove successed
11. jxdddms
jxdddms는 ADL 정보를 테이블에 등록하는 툴이다. ADL(AIM Description Language)을 이용하여 OpenFrame AIM의 온라인 시스템, 데이터베이스, 데이터셋, 애플리케이션 등의 환경을 정의할 수 있다.
사용법
jxdddms 프로그램을 실행하는 방법은 다음과 같다.
Usage : jxdddms <command> [options]
<command>:
parse|p : Parse ADL (Parsing test)
options:
-p : specify adl file path
store|s : Store ADL
options:
-d : specify AIMDIR ID
-p : specify adl file path
-f : overwrite if already exists in AIMDIR
load|l : Load ADL
options:
-d : specify AIMDIR ID
-a : specify adl name
-t : specify adl type
-f <a|t> : specify adl output format
a : ADL type
t : Table type
delete|d : Delete ADL
options:
-d : specify AIMDIR ID
-a : specify adl name
* ADL type:
SIS, APG, SG, WS, PROC, DSCH, MQN, PED, ALL
-
입력 항목
항목 설명 <command>
-
parse (p) : ADL을 분석한다. 축약어 p 옵션으로 명령을 실행할 수 있다.
-
store (s) : ADL을 분석하고 테이블에 등록한다. 축약어 s 옵션으로 명령을 실행할 수 있다.
-
load (l) : ADL 정보를 조회한다. 축약어 l 옵션으로 명령을 실행할 수 있다.
-
delete (d) : ADL을 테이블에서 삭제한다. 축약어 d 옵션으로 명령을 실행할 수 있다.
다음은 command에 설정한 각 명령어별 옵션에 대한 설명이다.
-
parse (p)
항목 설명 [-p]
ADL 매크로 파일에 설정된 ADL 파일 경로에 있는 ADL을 분석한다.
-
store (s)
항목 설명 [-d]
ADL 정보를 등록할 AIM 디렉터리의 ID를 지정한다. (기본값: 00)
[-p] 옵션과 함께 사용될 수 있다.
[-p]
ADL 매크로 파일에 설정된 ADL 파일 경로에 있는 ADL을 분석하고 정보를 테이블에 등록한다.
[-f]
ADL 테이블이 이미 존재하는 ADL 커맨드인 경우 덮어쓰기를 수행한다.
[-p] 옵션과 함께 사용될 수 있다.
-
load (l)
항목 설명 [-d]
ADL 정보를 등록할 AIM 디렉터리의 ID를 지정한다. (기본값: 00)
[-a], [-t], [-f ] 옵션과 함께 사용될 수 있다.
[-a]
ADL 이름을 지정한다.
[-a], [-t] 옵션은 필수로 지정되어야 하며, 둘 중 하나만 사용될 수 있다.
[-t]
ADL 타입을 지정한다.
-
SIS
-
APG
-
SG
-
WS
-
PROC
-
DSCH
-
MQN
-
PED
-
ALL
[-a], [-t] 옵션은 필수로 지정되어야 하며, 둘 중 하나만 사용될 수 있다.
[-f <a|t>]
ADL 출력 형태를 지정한다.
-
a : ADL 형식 (기본값)
-
t : 테이블 형식
-
-
delete (d)
항목 설명 [-d]
ADL 정보를 등록할 AIM 디렉터리의 ID를 지정한다. (기본값: 00)
[-a] 옵션과 함께 사용될 수 있다.
[-a]
ADL 이름을 지정한다.
-
-
출력 항목
다음은 load 기능에서 테이블 타입으로 출력되는 항목에 대한 설명이다.
-
SIS
항목 설명 DID
AIM 디렉터리의 ID를 보여준다.
NAME
SIS 이름을 보여준다.
-
APG
항목 설명 DID
AIM 디렉터리의 ID를 보여준다.
NAME
APG 이름을 보여준다.
SIS_NAME
SIS 이름을 보여준다.
RCVR
APG에 지정된 리커버리 레벨을 보여준다.
-
NON : 리커버리 기능을 사용하지 않음
-
DWN : 다운 리커버리 기능
-
CAN : 캔슬 리커버리 기능
-
FW : 포워드 리커버리 기능
-
BW : 백워드 리커버리 기능
EXCL_KEY
APG에 속하는 배타 제어 기능을 사용하는 경우의 키 값을 보여준다.
-
-
SG
항목 설명 DID
AIM 디렉터리의 ID를 보여준다.
NAME
스키마 그룹 이름을 보여준다.
SIS_NAME
SIS 이름을 보여준다.
RCVR
스키마 그룹에 지정된 리커버리 레벨을 보여준다.
-
NON : 리커버리 기능을 사용하지 않음
-
DWN : 다운 리커버리 기능
-
CAN : 캔슬 리커버리 기능
-
FW : 포워드 리커버리 기능
-
BW : 백워드 리커버리 기능
SCHEMA_ATTR
스키마 그룹 안의 스키마 자원 속성을 보여준다.
-
LOCAL : 고유 자원 속성
-
GLOBAL : 광역 자원 속성
-
-
WS
항목 설명 DID
AIM 디렉터리의 ID를 보여준다.
NAME
워크스테이션 이름을 보여준다.
WS_GROUP_NAME
워크스테이션 그룹명을 보여준다.
WS_TYPE_NAME
워크스테이션 타입명을 보여준다.
TERM_NAME
워크스테이션에 지정된 터미널명을 보여준다.
-
PROC
항목 설명 DID
AIM 디렉터리의 ID를 보여준다.
NAME
프러시저명을 보여준다.
RROC_TYPE
프러시저에서 사용되는 메시지 파일 타입을 보여준다.
-
MF : 메시지 파일 타입
-
PF : 표시 파일 타입
SCHD_TYPE
워크스테이션이 사용하는 스케줄러명을 보여준다.
COMM_TYPE
프러시저 세션 타입을 보여준다.
-
MULTI : 복수 세션형
-
SINGLE : 단일 세션형
COMD_TYPE
프러시저와 워크스테이션 간의 운영 방법을 보여준다.
COMD_SMQN
프러시저와 워크스테이션 간의 운영 방법에 따라 지정된 SMQN 이름을 보여준다.
COMD_DID
프러시저와 워크스테이션 간의 운영 방법에 따라 지정된 DID를 보여준다.
ABEND_MSG_TYPE
프러시저에 연결된 애플리케이션이 비정상 종료되면 연결 중인 워크스테이션 종료 여부를 보여준다.
-
Y : 종료함
-
N : 종료하지 않음
REPLY_TIMER_TYPE
특정 상황에서 응답 대기 상태 시간을 관리할지 여부를 보여준다.
-
Y : 응답 대기 시간을 관리함
-
N : 응답 대기 시간을 관리 하지 않음
PASS_ON_MESSAGE
외부 세션에서 들어오는 메시지를 애플리케이션으로 전송될지 여부를 보여준다.
-
Y : 전송됨
-
N : 정송되지 않음
TOP_MENU_FLD
워크스테이션에 자동 송출되는 프러시저의 선두 메뉴의 포맷 정의체를 보여준다.
TOP_MENU_ELD
워크스테이션에 자동 송출되는 프러시저의 선두 메뉴의 포맷 정의체가 속하는 편집 프로그램 라이브러이 그룹의 ID를 보여준다.
ON_OUTSESSION_SMQN
해당 터미널 세션 외에서 전달받은 첫 번째 메시지를 통지하는 SMQN 이름을 보여준다.
ON_OUTSESSION_DID
해당 터미널 세션 외에서 전달받은 첫 번째 메시지를 통지할 때 지정된 SMQN이 속하는 MQN의 DID를 보여준다.
INITIAL_FLO_TYPE
프러시저 첫 화면 및 유저 첫 화면을 자동 송출하지 않고, 오퍼레이터로부터의 첫 화면 요구 커멘드의 입력하는 경우에 송출하는 경우를 보여준다.
-
Y : 오퍼레이터 요구 커멘드 입력 시 송출
-
N : 오퍼레이터 요구 커멘드 입력 시 미송출
INITIAL_FLO
OFM 기능으로 사용하는 첫 화면의 포맷 정의체를 보여준다.
-
-
DSCH
항목 설명 DID
AIM 디렉터리의 ID를 보여준다.
NAME
스키마 이름을 보여준다.
SCHM_GROUP_NAME
스키마 그룹명을 보여준다.
SCHM_TYPE
스키마 타입을 보여준다.
-
DATASET
-
R-LDF
-
W-LDF
-
MSF
-
XRF
-
MUKF
-
LDEF
-
ACM
-
VSAM
CAT_NAME
VSAM 데이터셋을 지정하는 VSAM 카탈로그를 보여준다.
-
-
MQN
항목 설명 DID
AIM 디렉터리의 ID를 보여준다.
NAME
MQN 이름을 보여준다.
MQN_TYPE
MQN에서 사용되는 메시지 파일 타입을 보여준다.
-
MF : 메시지 파일 타입
-
PF : 표시 파일 타입
ON_OBST_TYPE
응용 프로그램으로부터 워크스테이션에 메시지를 송신하는 경우에 송신 결과를 통지하는 조건을 보여준다.
SPF_TYPE
애플리케이션에서 사용되는 SPF(scratch-pad file)의 저장매체 타입을 보여준다.
-
MEMORY
-
DASD
SPF
사용자 지정 SPF 타입을 보여준다.
CONN_MODE_TYPE
응용 프로그램 다중 통신 멀티태스킹 처리 모드를 보여준다.
-
DEPENDENT : 단독 태스크로 처리
-
INDEPENDENT : 복수의 태스크로 처리
CONV_SVC_TYPE
응용 프로그램이 통신 처리를 할지 여부를 보여준다.
-
Y : 통신 처리를 하는 경우
-
N : 통신 처리를 하지 않는 경우
AP_CONTROL_YN
응용 프로그램이 시스템 ACP를 사용하는 경우를 보여준다.
-
Y : ACP 사용
-
N : ACP 미사용
PRSNT_LIB_NAME
MQN에 대해 사용하는 편집 프로그램 라이브러리명을 보여준다.
MSG_TYPE
특정 프로그램 간 통신 메시지의 복구 기능 사용 여부를 보여준다.
-
RCV : 메시지 파일 타입
-
NRCV : 표시 파일 타입
-
-
PED
항목 설명 DID
AIM 디렉터리의 ID를 보여준다.
NAME
PED 이름을 보여준다.
ACP_NAME
PED에 속한 애플리케이션을 제어하기 위해 사용되는 ACP 이름을 보여준다.
SWAP_POINT_TYPE
PED의 응용 프로그램과 job을 교체하기 위한 타이밍을 지정한 타입을 보여준다.
-
SESSION
-
MESSAGE
-
NOTHING
-
-
사용예제
다음과 같은 내용의 ADL 파일 TESTADL1.adl이 있는 경우 명령어를 사용하는 예이다.
PROCEDURE NAME IS TESTADL ; SCHEDULE TYPE IS SCHTYPE1 ; COMMUNICATION TYPE IS MULTI SESSION ; TOP MENU IS TESTMENU ; ABEND MESSAGE IS SYSTEM. END.
다음은 ADL 파일 TESTADL1.adl을 분석하는 예이다.
$ jxdddms p -p TESTADL1.adl
다음은 명령을 수행한 결과이다.
[ADL] |[PROCEDURE] | |[PROCEDURE] | | |[PROCEDURE] | | | |[PROCEDURE] | | | | |[NAME] | | | | | |[TESTPROC] | | | |[SCHEDULE TYPE] | | | | |[SCHTYPE1] | | | |[COMMUNICATION TYPE] | | | | |[MULTI SESSION] | | | |[TOP MENU] | | | | |[NAME] | | | | | |[TESTMENU] | | | |[ABEND] | | | | |[SYSTEM]
다음은 ADL 파일 TESTADL1.adl을 테이블에 등록하는 예이다.
$ jxdddms s -p TESTADL1.adl
다음은 명령을 수행한 결과이다.
[TESTADL1.adl] store success.
다음은 ADL 타입으로 정보를 조회하는 예이다.
$ jxdddms l -t PROC
다음은 명령을 수행한 결과이다.
o PROC (Total : 2 ) OIVPPROC TESTADL [PROC] load success.
다음은 ADL 이름으로 ADL 타입으로 정보를 조회하는 예이다.
$ jxdddms l -a TESTADL
다음은 명령을 수행한 결과이다.
PROCEDURE NAME IS TESTADL ;SCHEDULE TYPE IS SCHTYPE1 ;COMMUNICATION TYPE MULTI SESSION ;ABEND MESSAGE IS SYSTEM ;TOP MENU IS TESTMENU. END. [TESTADL] load success.
다음은 ADL 이름으로 Table 타입으로 정보를 조회하는 예이다.
$ jxdddms l -f t -a TESTADL
다음은 명령을 수행한 결과이다.
o PROCEDURE ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- DID NAME RROC_TYPE SCHD_TYPE COMM_TYPE COMD_TYPE COMD_SMQN COMD_DID ABEND_MSG_TYPE REPLY_TIMER_TYPE PASS_ON_MESSAGE TOP_MENU_FLD TOP_MENU_ELD ON_OUTSESSION_SMQN ON_OUTSESSION_DID INITIAL_FLO_TYPE INITIAL_FLO ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 00 TESTADL SCHTYPE1 MULTI 0 Y N N TESTMENU N [TESTADL] load success.
다음은 ADL을 테이블에서 삭제하는 예이다.
$ jxdddms d -a TESTPROC
다음은 명령을 수행한 결과이다.
[TESTPROC] delete success.
12. jybfg000
jybfg000는 포맷 정의 소스를 OpenFrame AIM에서 사용할 수 있는 형태로 컴파일하는 툴이다.
jybfg000를 이용하여 포맷 정의 소스를 컴파일하면, 표시 서비스 프로그램에서 사용하는 포맷 정보체와 COBOL 프로그램에서 사용할 포맷 정의 Copybook이 생성된다.
PSAM 섹션에 대한 자세한 내용은 OpenFrame AIM "환경설정 안내서"를 참고한다. |
사용법
jybfg000 프로그램을 실행하는 방법은 다음과 같다.
Usage: jybfg000 [-p | -p -n] [-f] [-v] [-l record_length] [-d] fmt_file_path
-
입력 항목
항목 설명 [-h]
jybfg000 의 사용방법을 보여준다.
[-p | -p -n]
포맷 정의 소스에서 정의하는 화면 레이아웃을 텍스트 기반으로 보여준다.
-n 옵션을 함께 사용할 시, 표시되는 화면 레이아웃에서 필드의 속성 표시인 '@'를 없앤 화면 레이아웃을 보여준다. (-p 옵션과 함께 사용되어야 한다.)
(미리보기 기능)
[-f]
포맷 정의 소스가 고정 형식(fixed length record)임을 지정한다.
(기본값이므로 지정하지 않아도 됨)
[-v]
포맷 정의 소스가 가변 형식(variable length record)임을 지정한다.
[-l record_length]
포맷 정의 소스가 고정 형식일 경우에 레코드의 길이를 지정한다. (기본값: 80)
[-d]
포맷 정의 소스의 정보를 출력할 때 지정한다. (디버깅 용도)
fmt_file_path
컴파일하기 위한 포맷 정의 소스의 파일명을 지정한다.
사용예제
다음은 TESTFMT1.fmt는 고정 형식이며, 레코드의 길이가 80으로 설정한 포맷 정의 소스 파일 예이다.
PSAMLOGO FID TYPE=DSP TEST0000 RECORD TYPE=IN I000001 DATA NAME=AID01 USAGE=AID I000002 DATA NAME=LOGON USAGE=CTRL1 PIC=(X,30) TEST0001 RECORD O000001 DATA NAME=SYMD-O1 USAGE=CTRL1 PIC=(X,60) DEVICE DVK=DP10 FRAME PART SIZE=(24,80) FIELD POS=(17,38) ATTR=OUL VALUE='COPYRIGHT 2000-2006 TMAX SOFT CO.,LTD.' FIELD POS=(20,24) ATTR=OUL VALUE='LOGON COMMAND :' FIELD POS=(20,44) ATTR=(IUL CUR) DATAIN=I000002 FIELD POS=(2,2) ATTR=(OUL RED) VALUE=O000001 END
포맷 정의 소스 TESTFMT1.fmt를 컴파일하는 예이다.
$ jybfg000 -p -f -l 93 TESTFMT1.fmt
위의 명령은 옵션의 기본값에 의해 아래와 동일한 명령이다.
$ jybfg000 -p -l 93 TESTFMT1.fmt
실행 결과는 다음과 같다.
* preview : ---------------------------------------------------------------(begin)- MAP : [PSAMLOGO] 123456789+123456789+123456789+123456789+123456789+123456789+123456789+123456789+ ------------------------------------------------------------------------------>S 01| 02|@____________________________________________________________ 03| 04| 05| 06| 07| 08| 09| 10| 11| 12| 13| 14| 15| 16| 17| 18|@LOGON COMMAND :@____________________________________________________________@ 19| 20| 21| 22| 23| @COPYRIGHT 2000-2009 TMAX SOFT CO.,LTD. 24| ------------------------------------------------------------------------------<E * ---------------------------------------------------------------------------(end)- * copybook : [/home/user/cobcpy/psamcpy/TEST0000.cbl] create. [/home/user/cobcpy/psamcpy/TEST0001.cbl] create. * binary image : [/home/user/openframe/psambin/PSAMLOGO.BIN] create.