Configuring › External Printing › EXTERNAL Printing–Dynamic Program Call Interface › Sample Definitions

Sample Definitions

A sample program is provided in CVDEOPTN, member SARXPDSK. This sample prints a report to a dynamically allocated file.

The following list describes the requirements of the sample.

• Assemble and link the program into an authorized load library which is available to the online and batch tasks (XMS, TSO, and so on).

  Link the module with the following attributes:

  AC=1,AMODE=31,RMODE=ANY ¶
  

• Define an external device to the CA View database.

  From the CA View Primary Menu, enter the define device command:

CA View ALL -- Primary Selection for ...db_hlq... ------
Command ===> define device

From the Device Definition Selection List panel, enter a "select" command; disk is used as a sample value. This value is used in the DEST reprint attribute. Any eight-character string can be selected:

CA View ALL -- Device Definition Selection List --------
Command ===> select disk                Scroll ===> PAGE 

     Device

Sel Synonym              Type     Real Device Name
  ****************** Bottom of Data *********************

Create a device with the selected name.

Define the type of 'external':

CA View ALL -- Device Definition Selection List --------
Command ===>                            Scroll ===> PAGE
    
    Device       
Sel Synonym                Type     Real Device Name  
    DISK                   external        
****************** Bottom of Data *********************

Define a three character 'external print initialization' printer ID (the value DSK is used as an example, this value is used in one of three EXTPRTn initialization parameters. Use any 3 character value):

CA View ALL ---- External Print Device Attribute Panel --       
Command ===>          

Device Synonym            ---> DISK          

External Print Parameter  ===> dsk       
(Real Device Name)

This completes the external print device definition.

CA View ALL ---- Device Definition Selection List ----------       
Command ===>                                Scroll ===> PAGE    
    Device       
Sel Synonym                   Type        Real Device Name       
    DISK                      EXTERNAL    DSK        
****************** Bottom of Data *********************       

• Assign the three character 'printer id' to the sample program using the EXTPRTn Initialization parameter as follows (this assumes EXTPRT1, and a 'printer id' of 'DSK'):

  EXTPRT1=DSK/PGM/SARXPDSK/WKDISK
  

  Note: The fourth positional parameter is passed to the sample program and is used as the default unit esoteric name when allocating DASD datasets. If this parameter is left blank, the sample program uses 'SYSDA' as the default unit esoteric name.

• After these definitions have been completed and all on-line tasks have been recycled (XMS, TSO User, and so on) the print-to-disk function can be used.