Z-PRI11G

This document covers the following topics:


Description

Format and print a Cnf or Int document. You can also use this subprogram to print a Txt document.

You must ensure that Con-form is available to the calling program.

This subprogram is the same as Z-PRI11F with the exception that additional parameters (i.e. the parameter From-page, To-page and Reset-buffer) have been introduced.

Note:
In previous versions of Con-nect the default value for the left margin was set to 5. As of Con-nect version 3.3.2, the value for the left margin is taken from the user profile.

When you mark the parameter Enclosures, all enclosures must be in a printable format (i.e. Txt, Cnf or Int). If one of the enclosures is not in a printable format, return code 88 is issued.

To reset the Con-form buffer after the formatted document has been printed, you must mark the parameter Reset-buffer.

When you access Con-nect from a PC, you can also print the formatted document on the printer with is connected to your PC.

The calling routine should contain a printer definition of the following form:

IF PRINTER-TID EQ 'PC'
   DEFINE PRINTER(#OUT=5)
ELSE
   DEFINE PRINTER(#OUT=5) OUTPUT PRINTER-TID
END-IF

The following rules apply:

  • If Printer-TID equals binary zero (format B8), DEFINE PRINTER is not executed.

  • If Printer-TID equals blank or PC, DEFINE PRINTER (5) is executed regardless of the current device. There is one exception: if Printer-TID equals PC and *DEVICE does not equal PC, return code 5 is issued and the routine ends.

  • Any other value of Printer-TID issues the following, regardless of the current device:

    DEFINE PRINTER (5) OUTPUT PRINTER-TID
    

When you print a document which is currently stored in the Inbasket file New, the corresponding address list is updated so that the reception status of the document indicates that it has been read. Additionally, the document is moved from the file New to the file Opened.

Successful termination of Z-PRI11G always results in an END TRANSACTION. You are not able to control transaction handling.

Parameters

Parameter Format In Out Remarks
Return-code N2   X  
Cabinet A8 R   The cabinet in which the document is to be printed.
Password A8 R   The password of the above cabinet.
Document-name A32 R*   The name of the document to be printed. Either Document-name or ISN, not both.
ISN P8 R*   The ISN of the document to be printed. Either ISN or Document-name, not both. You can invoke Z-DIS11 prior to this subprogram to obtain the ISN for the desired document.
Printer-TID A8 R   The terminal ID number, LU number or comparable terminal destination for the printer which is to be used.
From-page N3 O   When page breaks have been defined, you can specify at which page the formatted printout is to start.
To-page N3 O   When page breaks have been defined, you can specify at which page the formatted printout is to end.
Printer-profile A32 O   The name of the printer profile which is to be assigned to the printer. When you do not fill this parameter, a printer profile is not used.
Format-profile A32 O   The name of the formatting profile which is to be used. When you do not fill this parameter, a formatting profile is not used.
System-variables A1 O   If marked, the system variables are replaced with the appropriate values.
Enclosures A1 O   If marked, the enclosures are printed. The enclosures must have the format Cnf, Int or Txt.
Reset-buffer A1 O   If marked, the Con-form buffer is reset after all formatted documents have been printed.

Return Codes

00 Success
02 Invalid cabinet name
03 Password incorrect
04 ISN was not found
05 TID/LU device is not a personal computer
08 Supply either ISN or name, not both
09 ISN does not point to correct object
51 Invalid name
53 Requested object does not exist
81 Invalid formatting profile name
82 Requested formatting profile does not exist
83 Invalid printer profile name
84 Requested printer profile does not exist
85 Compiled version of printer profile not found
86 Printer driver module can not be loaded
87 System address record for system variables not found
88 Document is not in correct format for printing
90 Parameter From-page must not be greater than To-page

Subprograms

Z-105
Z-120
Z-122
Z-123
Z-165
Z-170
Z-175
Z-177
Z-194
Z-197
Z-222
Z-223
Z-400
Z-401
Z-1200&0