명령 태스크 파일 작성

이 주제에서는 IBM Director와 타사 관리 소프트웨어 및 기타 프로그램을 통합할 때 사용하는 CMDTask 파일을 작성하는 방법을 설명합니다.

CMDTask 파일은 director_install_dir\classes\extensions 디렉토리에 있어야 하며 파일 확장자는 ".CMDExt"여야 합니다. .CMDExt 확장자는 대소문자를 구분하지 않지만 .CMDExt 파일 이름의 접두부는 모두 대문자여야 합니다(예: TELNET.CMDExt).

IBM Director 콘솔을 시작하면 director_install_dir\classes\extensions 디렉토리에서 확장자가 .CMDExt인 모든 파일이 처리되고 제목 매개변수를 사용하여 파일에 지정된 각 태스크의 제목이 태스크 분할창에 외장형 응용 프로그램 실행 태스크의 서브태스크로 표시됩니다.

예를 들어 IBM Director Server에 상주하는 TELNET.CMDExt(제목 = telnet 명령) 파일이 director_install_dir\classes\extensions 디렉토리에 있는 경우 태스크 레이블 telnet 명령외장형 응용 프로그램 실행 태스크의 서브태스크로 표시됩니다.

Windows 플랫폼에서는 관련 태스크 그룹(하위 트리를 포함하는 하나의 상위)도 작성할 수 있습니다. 예를 들어 다음 그룹을 작성할 수 있습니다.
  1. 파일 이름이 FILESYSTEM.CMDExt이고 제목 = File System 명령인 상위 태스크
  2. 파일 이름이 FILESYSTEM_1.CMDExt("_1"을 지정해야 함)이고 a) 제목 = Volume 명령 및 b) ParentTaskFilename = FILESYSTEM인 하위 태스크
  3. 파일 이름이 FILESYSTEM_1.CMDExt("_2"를 지정해야 함)이고 a) 제목 = Dir 명령 및 b) ParentTaskFilename = FILESYSTEM인 하위 태스크
  4. 파일 이름이 FILESYSTEM_1.CMDExt("_3"을 지정해야 함)이고 a) 제목 = DiskCopy 명령 및 b) ParentTaskFilename = FILESYSTEM인 하위 태스크

예를 참고하여 각 하위 태스크 파일 이름에 _n을 추가하고 각 파일에 제목 및 ParentTaskFilename 매개변수를 포함시켜야 합니다. 상위 태스크를 실행할 때 상위 태스크 아래의 하위 태스크는 실행되지 않는다는 점을 참고하십시오. 상위-하위 관계는 표시 모드에서만 적용될 뿐, 실행 모드에서는 적용되지 않습니다.

태스크 제목은 그룹 안에서 정렬됩니다. 예를 들어 예에 지정된 태스크는 다음 순서로 표시됩니다.

외장형 응용 프로그램 실행
    File System 명령
        Dir 명령
        DiskCopy 명령
        Volume 명령
    telnet 명령

서브태스크 목록을 새로 고치려면 외장형 응용 프로그램 실행 태스크를 마우스 오른쪽 단추로 누른 후 새로 고침을 누르십시오.

서브태스크 사용을 특정 사용자로 제한하려면 사용자 관리 아래의 태스크 액세스 메뉴 옵션을 사용하십시오.

.CMDExt 파일 매개변수:

주: 별표(*)는 설정을 적극 권장하는 매개변수임을 표시합니다. 매개변수 및 값에서는 대소문자를 구분합니다.
매개변수 이름 설명 값 정보
제목* 태스크 제목 또는 외장형 응용 프로그램 실행의 서브태스크로 표시되는 제목의 NLS 키 이 매개변수를 설정하는 것이 좋습니다. 설정하지 않으면 .CMDExt 파일의 기본 파일 이름이 사용됩니다.
ResourceBundle 제목에 사용되는 NLS 번들  
ParentTaskFilename 하위 태스크 파일 작성 시 상위 태스크 파일 이름

하위 태스크를 작성하는 경우에만 이 매개변수를 지정하십시오.

.CMDExt 확장자 없이 상위 태스크의 파일 이름을 지정하십시오. 예를 들어,

ParentTaskFilename=FILESYSTEM

하위 태스크의 태스크 레이블은 상위 태스크의 태스크 레이블 아래 표시됩니다. ParentTaskFilename의 존재 여부를 확인합니다.

CommandString.Windows* Windows 시스템에서 실행할 명령 스트링

중요: .CMDExt 파일은 java properties 파일 형식을 사용합니다. 따라서 백슬래시는 두 개의 백슬래시로 코드해야 합니다. 환경 변수 값은 백슬래시 하나만 사용해야 합니다. 예를 들어,

dir c:\\*exe /s

CommandString.Unix* UNIX/Linux 시스템에서 실행할 명령 스트링

중요: .CMDExt 파일은 java properties 파일 형식을 사용합니다. 따라서 백슬래시는 두 개의 백슬래시로 코드해야 합니다. 환경 변수 값은 백슬래시 하나만 사용해야 합니다.

Cwd.Windows Windows 시스템에서 현재 작업 디렉토리의 경로 이름 명령을 특정 디렉토리에서 시작해야 하는 경우에만 지정하십시오.
Cwd.Unix UNIX/Linux 시스템에서 현재 작업 디렉토리의 경로 이름 명령을 특정 디렉토리에서 시작해야 하는 경우에만 지정하십시오.
CheckFileExists 명령을 실행하는 데 반드시 필요한 파일 이름

이 파일은 선택사항이며 현재 작업 디렉토리(Cwd)에 있다고 가정합니다.

명심: 모든 백슬래시는 두 개의 백슬래시로 코드해야 합니다.

ShellRequired 쉘 창이 필요한지 여부를 표시합니다.

다음 값 중 하나를 지정하십시오.

true
쉘 창이 필요합니다.
false
쉘 창이 필요하지 않습니다(기본값).
Icon.Small CMDTask의 소형 아이콘 경로(외장형 응용 프로그램 실행 아래 서브태스크 목록의 태스크 레이블 옆에 표시됨)

이 경로에서는 사용자 현재 위치가 director_install_dir/classes라고 가정합니다.

경로 이름을 입력하기 전에 먼저 경로를 슬래시(/)로 시작하십시오. 예를 들어 아이콘이 director_install_dir/classes/icondir 아래 있는 경우 매개변수 값은 다음과 같습니다.

Icon.Small=/icondir/iconname.gif

Icon.Large CMDTask의 대형 아이콘(Director 콘솔의 태스크 분할창에 표시됨) 경로

이 경로에서는 사용자 현재 위치가 director_install_dir/classes라고 가정합니다.

경로 이름을 입력하기 전에 먼저 경로를 슬래시(/)로 시작하십시오. 예를 들어 아이콘이 director_install_dir/classes/icondir 아래 있는 경우 매개변수 값은 다음과 같습니다.

##Icon.Large=/icondir/iconname.gif

Targeted CMDTask를 대상 시스템에 끌어 놓아야 하는지 여부를 표시

다음 값 중 하나를 지정하십시오.

none
두 번 누르거나 마우스 오른쪽 단추를 눌러 태스크를 열 수 있음
one
대상 시스템에 태스크를 끌어 놓아야 합니다(기본값).
none|one
태스크를 열 수 있거나 태스크를 대상 시스템에 끌어 놓을 수 있습니다.
Timeout 태스크 명령에서 실행 후 리턴을 대기하는 초 수 1 - 60 사이의 숫자 값을 지정하십시오. 기본값은 5초입니다. 허용된 최대값은 60초입니다.

CommandString.Windows 및 CommandString.Unix에 대한 예:

이 예는 구문이 혼동되지 않도록 돕기 위해 공통 사용법으로 제공됩니다. 명령 스트링 작성 시 이 예를 지침으로 사용하십시오.

예 1:

Telnet 세션을 열고 사용자가 사용자 ID 및 암호를 입력하는 동안 창을 열어 두십시오. -hold 옵션을 사용하면 Telnet 명령이 올바르게 실행되지 않는 경우 오류 메시지를 수신합니다.

UNIX/Linux의 경우

CommandString.Unix = xterm -e -hold telnet $CMDTASK_IP_ADDRESS0

Windows의 경우

CommandString.Windows = telnet %CMDTASK_IP_ADDRESS0%

예 2:

시스템에서 net 사용

CommandString.Windows = net use * \\\\%CMDTASK_COMPUTERNAME%\\c$ /u:userid pwd

(C) Copyright IBM Corporation 1999,2005. All Rights Reserved.