Z-GET04

This document covers the following topics:


Description

Return an object which is contained in a specific bulletin board.

This subprogram requires that you specify the ISN of the wanted object. To get the ISN, you must first invoke Z-DIS04A.

When you leave the parameter All-objects blank, an object other than a document is ignored. In this case, the document text, including cover notes and enclosed documents, is returned in the parameter Text-array.

When you mark the parameter All-objects, an object other than a document (for example, a reference document or application) is also returned. In this case, only the cover note of the object is returned in the parameter Text-array.

This subprogram should be invoked iteratively until the return code 77 indicates the end of text. The type of text which is currently being processed is returned by the parameter Text-type.

Parameters

Parameter Format In Out Remarks
Return-code N2   X  
ISN P8 R   The ISN of the object to be returned. Z-DIS04A returns the ISN for each object on a specific bulletin board.
All-objects A1 O   If blank, only documents are returned. If marked, all objects are returned.
Subject A60   X The subject of the object which has been sent to the bulletin board.
Document-format A1   X Any value other than 0 to 9 indicates that the object is not a document. See Document Formats.
Text-type A1   X C=cover note, T=document text, E=enclosed document.
Text-type-total P3   X The total number of cover notes and enclosures. 0 for type T.
Text-type-current P3   X The sequence number of the currently processed cover note or enclosure. 0 for type T.
Text-array A251/1:20   X The text of the document, cover note or enclosure.
Work-parameter-1 A240     For internal use. See The Work Parameter.
Work-parameter-2 A79     For internal use. See The Work Parameter.

Return Codes

00 Success
04 ISN was not found
09 ISN does not point to correct object
77 End of object (cover note, document, enclosures)
90 ISN does not point to bulletin board object

Subprograms

None