클라이언트 리턴 코드

백업 아카이브 명령행 인터페이스 및 스케줄러 종료가 이제 클라이언트 조작의 성공 또는 실패를 정확하게 반영하는 리턴 코드와 함께 종료됩니다.

스크립트, 배치 파일 및 기타 자동화 기능은 명령 인터페이스의 리턴 코드를 사용할 수 있습니다. IBM® Storage Protect 스케줄러를 사용하는 조작의 경우, 리턴 코드가 QUERY EVENT 관리 명령의 출력에 표시됩니다.

일반적으로 클라이언트 조작 중에 리턴 코드는 가장 높은 심각도 메시지와 관련이 있습니다.

가장 높은 심각도의 메시지가 정보 제공용이면(ANSnnnnI) 리턴 코드가 0입니다.
가장 높은 심각도의 메시지가 경고이면(ANSnnnnW) 리턴 코드가 8입니다.
가장 높은 심각도의 메시지가 오류이면(ANSnnnnE 또는 ANSnnnnS) 리턴 코드가 12입니다.

경고 또는 오류 메시지가 개별 파일을 처리할 수 없음을 표시하면 해당 규칙에 대한 예외가 작성됩니다. 처리할 수 없는 파일의 경우 리턴 코드는 4입니다. dsmerror.log 파일을 검사하여 클라이언트 조작 중에 발생하는 오류의 원인을 판별하십시오. 스케줄된 이벤트 중에 발생하는 오류는 dsmsched.log 파일에 기록됩니다.

표 1 은 리턴 코드 및 해당 의미를 설명합니다.

표 1. 클라이언트 리턴 코드 및 의미
코드	설명
0	모든 조작이 정상적으로 완료되었습니다.
4	조작을 성공적으로 완료했지만, 몇몇 파일은 처리되지 않았습니다. 다른 오류나 경고는 없습니다. 이 리턴 코드는 일반적입니다. 여러 이유로 인해 파일이 처리되지 않습니다. 가장 일반적인 이유는 다음과 같습니다. 파일이 제외 목록에 있는 항목을 충족합니다. 제외되는 파일은 선택적 백업 동안에만 로그 항목을 생성합니다. 파일을 다른 애플리케이션에서 사용 중이어서 클라이언트가 파일에 액세스할 수 없었습니다. 조작하는 동안 파일이 복사 직렬화 속성에 의해 금지되는 범위까지 변경되었습니다. 사본 직렬화 속성을 참조하십시오.
8	조작이 하나 이상의 경고 메시지와 함께 완료되었습니다. 스케줄된 이벤트의 경우 상태는 `Completed`입니다. dsmerror.log 파일(및 스케줄된 이벤트의 경우 dsmsched.log)을 검토하여 발행된 경고 메시지를 판별하고 조작에 미치는 영향을 평가하십시오.
12	적어도 하나의 오류 메시지(생략한 파일에 대한 오류 메시지는 제외)와 함께 조작이 완료되었습니다. 스케줄된 이벤트의 경우 상태는 `Failed`입니다. dsmerror.log 파일(및 스케줄된 이벤트의 경우 dsmsched.log)을 검토하여 발행된 오류 메시지를 판별하고 조작에 미치는 영향을 평가하십시오. 일반적으로 이 리턴 코드는 오류가 조작의 완료를 방해할 만큼 심각함을 의미합니다. 예를 들어, 전체 드라이브를 처리하지 못하는 오류가 리턴 코드 12를 생성합니다.
12	조작이 하나 이상의 오류 메시지와 함께 완료되었습니다 (건너뛴 파일에 대한 오류 메시지 제외). 스케줄된 이벤트의 경우 상태는 `Failed`입니다. dsmerror.log 파일(및 스케줄된 이벤트의 경우 dsmsched.log)을 검토하여 발행된 오류 메시지를 판별하고 조작에 미치는 영향을 평가하십시오. 일반적으로 이 리턴 코드는 오류가 조작의 완료를 방해할 만큼 심각함을 의미합니다. 예를 들어, 전체 파일 시스템 또는 파일 스펙을 처리하지 못하게 되는 오류는 리턴 코드 12를 생성합니다.
`기타`	스케줄 조치가 COMMAND인 스케줄된 조작의 경우 리턴 코드는 실행된 명령의 리턴 코드입니다. 리턴 코드가 0이면 스케줄된 조작의 상태는 다음과 같습니다.`Completed`. 리턴 코드가 0이 아닌 경우 상태는 다음과 같습니다.`Failed`. 일부 명령은 성공을 표시하기 위해 0이 아닌 리턴 코드를 발행할 수도 있습니다. 이 명령의 경우, 다음을 피할 수 있습니다.`Failed`명령을 시작하고 결과를 해석한 후 종료하는 스크립트에서 명령을 랩핑하여 상태를 표시합니다. 이 스크립트는 명령에 성공한 경우 리턴 코드 0을 작성하고 명령에 실패하면 0이 아닌 리턴 코드를 작성해야 합니다. 그런 다음 IBM Storage Protect 서버 관리자에게 명령 대신 스크립트를 실행하도록 스케줄 정의를 수정하도록 요청하십시오.

클라이언트 매크로의 리턴 코드는 매크로를 구성하는 개별 명령 중에서 발행되는 가장 높은 리턴 코드입니다. 예를 들어, 매크로가 다음과 같은 명령으로 구성되어 있다고 가정합니다.

selective "/home/devel/*" -subdir=yes
incremental "/home/devel/TestDriver/*" -subdir=yes
archive "/home/plan/proj1/*" -subdir=yes

selective c:\MyTools\* -subdir=yes
incremental c:\MyPrograms\TestDriver\* -subdir=yes
archive e:\TSM\* -subdir=yes

첫 번째 명령이 리턴 코드 0으로 완료하고 두 번째 명령이 리턴 코드 8로 완료하며 세 번째 명령이 리턴 코드 4로 완료하면 매크로의 리턴 코드는 8입니다.

QUERY EVENT 명령에 대한 자세한 정보는 IBM Storage Protect 서버 문서를 참조하십시오.