wsadmin 스크립트를 사용하는 AdminTask 오브젝트의 AdministrativeJobs 명령 그룹
wsadmin 도구를 통해 관리 작업을 구성하고 관리하는 데 Jython 스크립트 언어를 사용할 수 있습니다.
deleteJob
deleteJob 명령은 작업 관리자에서 기존 작업을 삭제합니다. 명령 호출 시 작업이 실행 중인 경우, 시스템은 작업의 삭제 여부와 관계 없이 작업 결과를 계속 리턴합니다.
대상 오브젝트
없음.
필수 매개변수
- -jobToken
- 삭제할 작업의 고유 ID를 지정합니다. (문자열, 필수)
리턴값
명령은 출력을 리턴하지 않습니다.
일괄처리 모드 사용 예제
- Jython 문자열 사용:
AdminTask.deleteJob('-jobToken myToken')
- Jython 목록 사용:
AdminTask.deleteJob('-jobToken', 'myToken')
대화식 모드 사용법 예제
- Jython 사용:
AdminTask.deleteJob('-interactive')
getJobTargets
getJobTargets 명령은 원하는 작업의 대상을 표시합니다. 명령이 리턴하는 작업 대상은 등록 취소되었거나 삭제되었을 수 있습니다.
대상 오브젝트
없음.
필수 매개변수
- -jobToken
- 원하는 작업의 고유 ID를 지정합니다. (문자열, 필수)
리턴값
명령은 원하는 작업의 대상에 대한 노드 이름을 리턴합니다.
일괄처리 모드 사용법 예제
- Jython 문자열 사용:
AdminTask.getJobTargets('-jobToken myToken')
- Jython 목록 사용:
AdminTask.getJobTargets('-jobToken', 'myToken')
대화식 모드 사용법 예제
- Jython 사용:
AdminTask.getJobTargets('-interactive')
getJobTargetStatus
getJobTargetStatus 명령은 원하는 작업에 대한 최신 작업 대상 상태를 표시합니다.
대상 오브젝트
없음.
필수 매개변수
- -jobToken
- 원하는 작업의 고유 ID를 지정합니다. (문자열, 필수)
선택적 매개변수
- -targetList
- 대상 노드 이름 목록을 지정합니다. (String [ ], 선택사항)
리턴값
명령은 대상에 대한 최신 작업 상태를 리턴합니다. 해당 상태는 NOT_ATTEMPTED, DISTRIBUTED, ASYNC_IN_PROGRESS, SUCCEEDED, PARTIALLY_SUCCEEDED, FAILED, DELAYED 또는 REJECTED입니다.
일괄처리 모드 사용법 예제
- Jython 문자열 사용:
AdminTask.getJobTargetStatus('-jobToken myToken')
- Jython 목록 사용:
AdminTask.getJobTargetStatus('-jobToken', 'myToken')
대화식 모드 사용법 예제
- Jython 사용:
AdminTask.getJobTargetStatus('-interactive')
getJobTargetHistory
getJobTargetHistory 명령은 원하는 작업에 대한 작업 대상 히스토리를 표시합니다.
대상 오브젝트
없음.
필수 매개변수
- -jobToken
- 원하는 작업의 고유 ID를 지정합니다. (문자열, 필수)
- -target
- 원하는 대상의 노드 이름을 지정합니다. (문자열, 필수)
- -maxReturn
- 리턴할 최대 결과 수를 지정합니다. (정수, 필수).
선택적 매개변수
- -startingTime
- 명령이 작업 대상 히스토리 리턴을 시작하는 시간을 지정합니다. (문자열, 선택적)
- -endingTime
- 명령이 작업 대상 히스토리 리턴을 중지하는 시간을 지정합니다. (문자열, 선택적)
- -ascending
- 결과를 오름차순으로 리턴할지 또는 내림차순으로 리턴할지 여부를 지정합니다. 결과를 오름차순으로 표시하려면 true를 지정하고, 내림차순으로 표시하려면 false를 지정하십시오. (부울, 선택적)
리턴값
명령은 속성 목록을 리턴합니다. 여기서, 첫 번째 속성은 일치하는 수를 지정하며 두 번째 속성은 대상에 있는 작업의 히스토리를 지정합니다. 각 목록은 시간소인, 상태, 메시지 및 결과 속성을 포함합니다.
일괄처리 모드 사용법 예제
- Jython 문자열 사용:
AdminTask.getJobTargetHistory('-jobToken 2846493472984754 -target 3820J37H3017N294 -maxReturn 20')
- Jython 목록 사용:
AdminTask.getJobTargetHistory('-jobToken', '2846493472984754', '-target', '3820J37H3017N294', '-maxReturn', '20')
대화식 모드 사용법 예제
- Jython 사용:
AdminTask.getJobTargetHistory('-interactive')
getJobTypes
getJobTypes 명령은 원하는 엔드포인트에 대한 지원되는 작업 유형을 표시합니다.
대상 오브젝트
없음.
선택적 매개변수
- -targetList
- 대상에 대한 노드 이름 목록을 지정합니다. (String [ ], 선택사항)
- -group
- 대상에 대한 그룹 이름을 지정합니다. (문자열, 선택적)
리턴값
이 명령은 각 지정된 대상이 지원하는 작업 유형 목록을 리턴합니다.
일괄처리 모드 사용법 예제
- Jython 문자열 사용:
AdminTask.getJobTypes('-target myProfileKey')
- Jython 목록 사용:
AdminTask.getJobTypes('-target', 'myProfileKey')
대화식 모드 사용법 예제
- Jython 사용:
AdminTask.getJobTypes('-interactive')
getJobTypeMetadata
getJobTypeMetadata 명령은 특정 작업 유형과 연관된 메타데이터를 표시합니다.
대상 오브젝트
없음.
필수 매개변수
- -jobTypeList
- 원하는 작업 유형 목록을 지정합니다. (String [ ], 선택사항)
리턴값
명령은 name, label, description, job-properties 및 job-parameters 속성을 포함하여 속성 목록을 리턴합니다.
일괄처리 모드 사용법 예제
- Jython 문자열 사용:
AdminTask.getJobTypeMetadata('-jobTypeList inventory')
- Jython 목록 사용:
AdminTask.getJobTypeMetadata('-jobTypeList', 'inventory')
대화식 모드 사용법 예제
- Jython 사용:
AdminTask.getJobTypeMetadata('-interactive')
getOverallJobStatus
getOverallJobStatus 명령은 원하는 작업 목록이나 특정 작업에 대한 전체 작업 상태를 표시합니다.
대상 오브젝트
없음.
선택적 매개변수
- -jobTokenList
- 원하는 작업의 고유 ID를 하나 이상 지정합니다. (String [ ], 선택사항)
리턴값
- STATE 속성은 현재 작업 상태를 지정합니다.
- TOTAL_RESULTS 속성은 전체 작업 수를 지정합니다.
- DISTRIBUTED 속성은 분배된 작업 수를 지정합니다.
- ASYNC_IN_PROGRESS 속성은 진행 중인 비동기 작업 수를 지정합니다.
- SUCCEEDED 속성은 성공한 작업 수를 지정합니다.
- PARTIALLY_SUCCEEDED 속성은 부분적으로 완료된 작업 수를 지정합니다. 예를 들어, 부분적 성공은 한 개의 노드가 여러 서버를 나타내고 노드에 있는 일부 서버만 작업을 완료한 경우에 발생할 수 있습니다.
- FAILED 속성은 실패한 작업 수를 지정합니다.
- NOT_ATTEMPTED 속성은 시스템이 시도하지 않은 작업 수를 지정합니다.
일괄처리 모드 사용법 예제
- Jython 문자열 사용:
AdminTask.getOverallJobStatus('-jobTokenList myJobToken')
- Jython 목록 사용:
AdminTask.getOverallJobStatus('-jobTokenList', 'myJobToken')
대화식 모드 사용법 예제
- Jython 사용:
AdminTask.getOverallJobStatus('-interactive')
queryJobs
queryJobs 명령은 작업 관리자에서 각 제출된 작업을 조회합니다.
대상 오브젝트
없음.
필수 매개변수
- -query
- 작업을 조회하는 데 사용할 검색 표현식을 지정합니다.
(문자열, 필수)작업 조회 작성 시 다음 지침을 사용하십시오.
- 조회는 키, 연산자 및 값이나 값 목록으로 구성됩니다. 한 개의 값이나 쉼표로 구분된 값 목록을 지정할 수 있습니다.
- 여러 개의 표현식을 공백 및 AND 연산자로 구분하십시오.
- 다음 대소문자 구분 키가 지원됩니다.
- jobToken
- 조회할 특정 작업에 대한 작업 토큰을 지정합니다.
- group
- 조회할 노드 그룹 이름을 지정합니다.
- description
- 조회할 작업 설명을 지정합니다. 설명에 여러 단어가 포함되어 있는 경우, 작은따옴표 또는 큰따옴표를 사용하여 설명을 형식화하십시오(예: description = "작업 설명").
- activationDateTime
- 시스템이 작업을 활성화하는 날짜 및 시간을 지정합니다(예: 2006-05-03T10:30:45-0000). activationDateTime 키 값의 -0000 섹션은 RFC 822 형식을 나타냅니다. 그리니치 표준시(GMT)의 단축키로 Z를 지정할 수 있습니다(예: 2006-05-03T10:30:45Z). 시간대를 지정하지 않으면 시스템이 서버의 시간대를 사용합니다.
- expirationDateTime
- 작업이 만료되는 날짜 및 시간을 지정합니다(예: 2006-05-03T10:30:45-0000). activationDateTime 키 값의 -0000 섹션은 RFC 822 형식을 나타냅니다. 그리니치 표준시(GMT)의 단축키로 Z를 지정할 수 있습니다(예: 2006-05-03T10:30:45Z). 시간대를 지정하지 않으면 시스템이 서버의 시간대를 사용합니다.
- state
- 작업 상태를 지정합니다. 올바른 값은 ASYNC_IN_PROGRESS, SUCCEEDED, PARTIALLY_SUCCEEDED, FAILED, DELAYED, REJECTED 및 NOT_ATTEMPTED입니다.
- 대상
- 작업의 대상 노드를 지정합니다. 특정 노드에 대한 작업을 리턴하려면 이 키를 사용하십시오. 명령은 노드가 속하는 특정 노드 및 노드 그룹에 대한 작업을 리턴합니다. 조회당 하나의 targetID만 지정할 수 있습니다.
- 지원되는 연산자는 다음과 같습니다.
표 1. queryJobs -query 연산자. 조회 시 연산자를 사용합니다. 문자 값 = 같음. = NULL을 사용하여 값이 널임을 지정하십시오. != 같지 않음. != NULL을 사용하여 값이 널이 아님을 지정하십시오. > 초과 < 미만 >= 보다 크거나 같음 <= 이하
- -maxReturn
- 리턴할 최대 일치 수를 지정합니다. (정수, 필수).
리턴값
[ [result [{activationDateTime=2008-03-11T11:56:48-0500,
expirationDateTime=2008-05-10T11:56:48-0500, jobToken=120525460839085191,
description=testSubmitJobToValidBaseTargetList}{activationDateTime=2008-03-11T14:05:33-0500,
expirationDateTime=2008-05-10T14:05:33-0500, jobToken=120526233387582472,
description=testSubmitJobToValidBaseTargetList}]] [size 2] ]
일괄처리 모드 사용법 예제
- Jython 문자열 사용:
print AdminTask.queryJobs('-query activationDateTime>= "2006-01-01" activationDateTime<= "2007-01-01" -maxReturn 20')
print AdminTask.queryJobs('[-query "target = node3" -maxReturn 2]')
- Jython 목록 사용:
AdminTask.queryJobs('-query', 'activationDateTime>= "2006-01-01" activationDateTime<= "2007-01-01"', '-maxReturn', '20')
print AdminTask.queryJobs(['-query', '"target = node3"', '-maxReturn', '2'])
대화식 모드 사용법 예제
- Jython 문자열 사용:
AdminTask.queryJobs('-interactive')
resumeJob
resumeJob 명령은 이전에 시작되었거나 일시중단된 작업을 재개합니다.
대상 오브젝트
없음.
필수 매개변수
- -jobToken
- 원하는 작업의 고유 ID를 지정합니다. (문자열, 필수)
리턴값
명령은 출력을 리턴하지 않습니다.
일괄처리 모드 사용 예제
- Jython 문자열 사용:
AdminTask.resumeJob('-jobToken myToken')
- Jython 목록 사용:
AdminTask.resumeJob('-jobToken', 'myToken')
대화식 모드 사용법 예제
- Jython 사용:
AdminTask.resumeJob('-interactive')
submitJob
submitJob 명령은 새 관리 작업을 작업 관리자에 제출합니다.
대상 오브젝트
없음.
필수 매개변수
- -jobType
- 제출할 작업 유형을 지정합니다. (문자열, 필수)
선택적 매개변수
- -group
- 대상에 대한 그룹 이름을 지정합니다. (문자열, 선택적)
- -targetList
- 대상에 대한 노드 목록을 지정합니다. (String [ ], 선택사항)
- -jobParams
- 제출할 작업의 필수 매개변수를 지정합니다. (특성, 선택사항)
- -username
- 보안이 사용 가능한 경우, 작업을 제출하는 데 사용할 사용자 이름을 지정합니다. (문자열, 선택적)
- -password
- 보안이 사용 가능한 경우, 작업을 제출하는 데 사용할 사용자 이름의 비밀번호를 지정합니다. (문자열, 선택적)
- -description
- 작업에 대한 설명을 지정합니다. (문자열, 선택적)
- -activationDateTime
- 작업을 활성화할 날짜 및 시간을 "2006-05-03T10:30:45-0000" 형식으로 지정합니다. activationDateTime 매개변수 값의 "-0000" 섹션은 RFC 822 형식을 나타냅니다. 그리니치 표준시(GMT)의 단축키로 "Z"를 지정할 수 있습니다(예: "2006-05-03T10:30:45Z"). 시간대를 지정하지 않으면 시스템이 서버의 시간대를 사용합니다. (문자열, 선택적)
- -expirationDateTime
- 작업의 만기 날짜를 지정합니다. (문자열, 선택적)
- -executionWindow
- 작업의 반복 간격을 지정합니다. (문자열, 선택적)
- -executionWindowUnit
- executionWindow 매개변수로 설정된 값에 대한 반복 간격 측정 단위를 지정합니다. 작업을 매일 실행하려면 DAILY, 매주 실행하려면 WEEKLY, 매월 실행하려면 MONTHLY, 매년 실행하려면 YEARLY를 지정하십시오. 또한 노드가 작업을 폴링할 작업 관리자에 연결할 때마다 작업을 실행하려면 CONNECTION을 지정할 수 있습니다. CONNECTION을 지정한 경우, executionWindow 매개변수를 설정하지 마십시오. (문자열, 선택적)
- 시스템이 작업 알림을 전송하는 이메일 주소를 지정합니다. (문자열, 선택적)
리턴값
명령은 새로 제출된 작업에 대한 작업 토큰을 리턴합니다.
일괄처리 모드 사용법 예제
- Jython 문자열 사용:
AdminTask.submitJob('[-jobType createApplicationServer -target profileKey -jobParams "[serverName myServer]" ]')
- Jython 목록 사용:
AdminTask.submitJob(['-jobType', 'createApplicationServer', '-target', 'profileKey', '-jobParams', '"[serverName myServer]"'])
대화식 모드 사용법 예제
- Jython 사용:
AdminTask.submitJob('-interactive')
suspendJob
suspendJob 명령은 이전에 제출된 작업을 일시중단합니다.
대상 오브젝트
없음.
필수 매개변수
- -jobToken
- 일시중단할 작업의 고유 ID를 지정합니다. (문자열, 필수)
리턴값
명령은 출력을 리턴하지 않습니다.
일괄처리 모드 사용 예제
- Jython 문자열 사용:
AdminTask.suspendJob('-jobToken myToken')
- Jython 목록 사용:
AdminTask.suspendJob('-jobToken', 'myToken')
대화식 모드 사용법 예제
- Jython 사용:
AdminTask.suspendJob('-interactive')