PSM Interface › $PSCALL OPT=PUT

$PSCALL OPT=PUT

Adds output (data that is to be printed) to a print request.

&CONTROL SHRVARS=($PS)
-EXEC $PSCALL   OPT=PUT
                REQ=n
              [ SKIP={ 0 | 1 | 2 | 3 | NEWPAGE } ]
              [ USCORE={ 1 | 2 }]
              [ ALIGN={ LEFT | RIGHT | CENTER } ]
              [ BOLD={ YES | NO } ]
              [ TOTAL=n ]

Adds output to an open print request. The output is added to the spool for the specified print request number.

Operands:

OPT=PUT

Specifies that lines of output are to be added to a print request.

REQ=n

Specifies the number of the print request to which the output is to be added.

SKIP={ 0 | 1 | 2 | 3 | NEWPAGE }

Specifies the number of lines to be advanced before printing each line of output. NEWPAGE specifies advance to a new page before printing each line of output. The default is 1.

USCORE={ 1 | 2 }

Specifies whether the text in each line of output is to be underlined:

1

Specifies that text excluding the blanks between words is underlined.

2

Specifies that text including the blanks between words is underlined.

{ LEFT | RIGHT | CENTER }

Specifies whether the text in each line of output is to be aligned. The length used to align the text is the value defined in the Columns per Page field (width) for the printer.

BOLD={ YES | NO }

Specifies whether the text in each line of output is to be bolded. The default is NO.

TOTAL=n

Specifies the number of variables containing lines of output that are to be printed. Range is 1 to 99999. The default is 1.

Variables:

&$PSDATAn

Must be set to the line of output to be printed. n must be in the range 1 to 99999. If the length of this variable is greater than the value defined in the Columns per Page field (width) for the printer, the line of output is truncated.

Return Codes:

&RETCODE = 0

$PSCALL completed successfully.

&RETCODE = 4

$PSCALL completed successfully. The request was denied. &SYSMSG is set to an error message and &$PSFDBK is set to the following value:

17 Print request not open

&RETCODE = 8

An error occurred. &SYSMSG is set to an error message.

Examples: OPT=PUT

&CONTROL SHRVARS=($PS) 
&$PSDATA1 = &STR This is a line of print data 
&$PSDATA2 = &STR This is another line of data 
-EXEC $PSCALL OPT=PUT REQ=5 TOTAL=2

&CONTROL SHRVARS=($PS)  
&$PSDATA1 = &STR This is the report heading 
-EXEC $PSCALL OPT=PUT REQ=150 SKIP=NEWPAGE ALIGN=CENTER +
         BOLD=YES

&CONTROL SHRVARS=($PS)
&$PSDATA1 = &STR Date:&DATE4 
-EXEC $PSCALL OPT=PUT REQ=5678 SKIP=2 ALIGN=RIGHT

&CONTROL SHRVARS=($PS)
&$PSDATA1 = &ASISTR  Name Description
-EXEC $PSCALL OPT=PUT REQ=2323 SKIP=3 USCORE=1