OpenFrame AIM 시스템 툴

본 장에서는 OpenFrame AIM 온라인 시스템에서 사용하는 툴 프로그램 사용법에 대해 기술한다.

1. 개요

다음은 OpenFrame AIM 온라인 시스템의 운영 편의를 위한 툴 목록이다.

설명

aimabegen

애플리케이션에서 ABEND가 발생한 경우 화면에 출력할 메시지를 테이블에 등록, 조회 및 제거하기 위해 사용된다.

aimacpgen

ACP JCL 작성 내용을 테이블에 등록, 조회 및 제거하기 위해 사용된다.

aimcmd

커맨드 라인에서 OpenFrame AIM 커맨드를 수행하기 위해 사용된다.

aimctlcheck

CTL 테이블의 내용을 조회하기 위해 사용된다.

aimctlinit

CTL 테이블을 초기화 하는데 사용된다.

aiminit

ADL 정보를 등록하는 테이블을 생성하고 삭제하기 위해 사용된다.

aimprtview

ONLINE PRINT 정보를 조회, 삭제 및 재전송을 위해 사용된다.

aimsmradm

SMR에서 MENU 화면을 구성할 때 필요한 정보들을 입력하기 위해 사용된다.

aimtxview

트랜잭션 리포트를 위한 툴이다.

jxdddms

ADL 정보를 테이블에 등록하기 위해 사용된다.

jybfg000

포맷 정의 소스를 컴파일하기 위해 사용된다.

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와 패스워드를 지정한다.

    커맨드 수행 권한을 확인하는 경우 우선순위는 다음과 같다.

    1. OpenFrame TACF 로그인 정보

    2. [-u] 옵션으로 입력받은 ID/PW 정보

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