startReport()

textReport.startReport() 함수는 텍스트 보고서 핸들러에서 Java™ 보고서 엔진으로 인쇄의 제어를 전달합니다. 모든 인수에 대해 값을 제공해야 합니다. 기본값을 승인하려는 임의의 위치에서 null 키워드를 사용하십시오. 이러한 인수는 기본값 또는 생성자 함수에서 설정된 값을 대체합니다(TextReport 변수 작성 참조).

엔진은 textReport.startReport() 함수의 결과로 핸들러에서 임의의 함수를 호출하지 않습니다. 머리글은 textReport.outputToReport() 함수를 호출한 결과로 인쇄됩니다(outputToReport() 참조).

함수의 서명은 COBOL 생성 및 Java 생성 간에 약간 다릅니다. COBOL 생성의 경우 COBOL에 대해 생성 시 프린터에 직접 보고서를 보낼 수 없으므로 topOfForm 인수가 사용되지 않습니다.

구문

  textReport.startReport(
     fileName STRING? in, 
     topMargin INT? in, 
     bottomMargin INT? in,
     leftMargin INT? in,
     rightMargin INT? in, 
     pageLength INT? in, 
     topOfForm STRING? in)
textReport
TextReport 외부 유형에 기반한 변수의 이름입니다.
fileName
인용 표시로 묶인 파일의 이름입니다. 이 매개변수에 null 값이 있는 경우 출력이 표준 출력(STDOUT)으로 지시됩니다.
COBOL 생성의 경우 파일 이름이 출력 대상을 지정하는데, 이는 생성 중인 대상 플랫폼에 따라 다릅니다.
표 1. startReport()의 대상
플랫폼 대상
z/OS® Batch, IMS™ BMP JCL에 정의된 DD 이름
CICS® 전이(transition) 파일 이름
IMS/VS 큐 이름
topMargin
각 페이지의 맨 위에서 빈 행의 수를 나타내는 정수입니다. 이 매개변수에 null 값이 있는 경우 보고서가 기본값 3을 사용합니다.
bottomMargin
각 페이지의 맨 아래에서 빈 행의 수를 나타내는 정수입니다. 이 매개변수에 null 값이 있는 경우 보고서가 기본값 3을 사용합니다.
leftMargin
각 행의 왼쪽으로 공간의 수를 나타내는 정수입니다. 이 매개변수에 null 값이 있는 경우 보고서가 기본값 5를 사용합니다.
rightMargin
자동 줄 바꾸기 조작에 대해 오른쪽 기본 여백을 나타내는 정수입니다. 이 매개변수에 null 값이 있는 경우 보고서가 기본값 132를 사용합니다.
pageLength
맨 위 여백, 머리글, 작업의 끝 표시 페이지 및 맨 아래 여백을 포함하여 각 페이지에서 행의 수를 나타내는 정수입니다. 이 매개변수에 null 값이 있는 경우 보고서가 기본값 66을 사용합니다.
topOfForm
이 인수는 Java 생성용으로만 사용 가능합니다. 이 문자열의 첫 번째 문자는 프린터에 용지 넘김을 실행하는 데 사용됩니다. 이 매개변수의 기본값이 없습니다. 탑-오브-폼 문자를 원하는 경우 이를 지정해야 합니다.

예제

다음 예제는 탑-오브-폼 문자 및 출력 파일의 이름을 제외하고 모든 항목에 대해 기본값을 사용하여 보고서 생성 프로세스를 시작합니다(표준 ASCII 용지 넘김 문자 지정, 0x0C). Windows의 디렉토리 구분 기호 문자가 EGL의 이스케이프 문자와 동일하므로 디렉토리 이름을 분리하는 데 더블 백슬래시를 사용하거나 포워드 슬래시를 사용해야 하는데, 이는 Java가 로컬 플랫폼에 대해 적합한 구분 기호로 변환합니다.

myReport TextReport = new TextReport();
...
myReport.startReport("C:/temp/reportFile.txt", 
  null, null, null, null, null, "\u000C");