Use the converseVar.printerAssociation system variable to specify, at run time, the output destination when you print a form.For some file types, multiple print files can be open simultaneously.
converseVar.printerAssociation is initialized to the system resource name specified during generation or for debugging. If a program passes control to another program, the value of converseVar.printerAssociation is set to the default value for the receiving program.
| Platform | Issue |
|---|---|
| Java™ generation | For Java generation,
you set converseVar.printerAssociation to
a two-part string with an intervening colon:
|
| CICS® | On CICS,
the value of the printDestination build
descriptor option determines the initial value of converseVar.printerAssociation or
interacts with the vgLib.startTransaction() system
function to determine the initial value:
If a CICS batch program was not started by the vgLib.startTransaction() function, converseVar.printerAssociation defaults to the CICS EIBTRMID, as appropriate to a program that is started at a terminal. Only the following
file types are supported:
|
| IMS™ BMP | The support for converseVar.printerAssociation in
an EGL-generated IMS BMP combines
the support for that variable on the following platforms:
|
| IMS/VS | Files of type SMSGQ are supported for output, but multiple files cannot be open simultaneously. The value (an 8-byte logical terminal name or transaction code) is defined to the IMS system and must be associated with a message queue that accepts single-segment messages. In the resource association part that is used at generation time, the file name must be associated with a modifiable alternate PCB or with a modifiable express alternate PCB. The value in converseVar.printerAssociation is not folded to uppercase. |
| iSeries® COBOL | In relation to iSeries COBOL, set the converseVar.printerAssociation system variable to the value of the fileName property in the resource associations part that is used at generation time. The file type must be of type SEQ and not of type SPOOL. Multiple print jobs are not supported for COBOL programs that are generated for iSeries, and when converseVar.printerAssociation is set, the EGL runtime closes the old file (to complete the previous output of data); uses the iSeries command OVRPRTF to override the file name; and opens the new file. Prior to its use, the value in converseVar.printerAssociation is folded to uppercase; but the value in the system variable itself remains unchanged. The value of converseVar.printerAssociation tests TRUE when compared against a lowercase version if the system variable was initialized with a lowercase version. The value set in converseVar.printerAssociation is propagated from the call level and changed to all the subordinate call levels. The value is not propagated, however if the program opened the file previously. |
| z/OS batch | You can set the converseVar.printerAssociation system variable only when referring to a file of type SEQRS. For a program generated as a z/OS batch program, the value of the variable is either a 54-byte data set name or an 8-byte DD name; and multiple files can be open simultaneously. The variable's initial value is the name of the file allocated to DD name EZEPRINT or (in the absence of that DD name) is the system resource name specified for file name printer at generation time. When you set converseVar.printerAssociation, the file is connected by way of SVC99 dynamic allocation. The DISP option on the SVC99 is set to SHR, which means that the data set is rewritten each time it is opened for output. Prior to its use, the value in converseVar.printerAssociation is folded to uppercase; but the value in the system variable itself remains unchanged. The value of converseVar.printerAssociation tests TRUE when compared against a lowercase version if the system variable was initialized with a lowercase version. |