Syntax and Parameters

Applications can invoke ICQCPC15 with the following syntax. All the parameters are optional keyword parameters. These invocation parameters override any conflicting parameters in the print definition table. 
%ICQCPC15 + 
           NOTABLE + 
           DSNAME(dsname(member),dsname(member),…)/
               DDNAME(ddname) + 
           PLOC(loc) + 
           PFORM(form) + 
           BIND(columns)/LMARGIN(columns) + 
           BMARGIN(lines) + 
           BURST/NOBURST + 
           CCHAR/SINGLE/DOUBLE/TRIPLE + 
           CHARS('set1 set2 … setn') + 
           COLUMNS('start1:end1,start2:end2,…') + 
           COPIES(number) + 
           DCF/NODCF + 
           DEST('destination.userid') + 
           FCB('image-id[,ALIGN,VERIFY]') + 
           FLASH('overlay-name[,count]') + 
           FOLD(width)/TRUNCATE(width) + 
           FORMS(forms name) + 
           HOLD/NOHOLD + 
           LINES(line-num1:line-num2) + 
           MEMBERS/DIRECTORY/ALL + 
           MODIFY('module-name[,trc]') + 
           NUM('loc,len')/SNUM('loc,len')/NONUM + 
           OUTDES(name) + 
           PAGELEN(lines) + 
           SYSOUT(class)/CLASS(class)
           TITLE/NOTITLE + 
           TMARGIN(lines) + 
           TODATASET(dsname)/TODSNAME(dsname) + 
           TRC/NOTRC + 
           UCS(ucs name) + 
           WRITER(external writer name)
NOTABLE
specifies that ICQCPC15 will not retrieve ALLOCATE parameters from the temporary table created by printer selection. NOTABLE is required if the calling application invokes ICQCPC15 without printer selection and without PLOC and PFORM coded to specify a print definition. In that case, (NOTABLE required), a printer must be identified by an entry in the SYSOUT parameter.
DSNAME(dsname(member),+ dsname(member),…)
specifies one or more data sets or members to be printed. DSNAME overrides any data set named in the temporary table from the printer selection CLIST, ICQCPC00. DATASET can be specified as an alias of DSNAME.
To specify a fully-qualified data set name, enclose it in three sets of single quotes. For example, to print ‘userid.CLIST’, specify: 
DSNAME('userid.CLIST'')
DDNAME(ddname)
specifies the file to be printed. Specifying DDNAME causes the data sets in the file concatenation to be printed in the same way as specifying DSNAME followed by a list of the data set names that make up the file. This overrides any data set named in the temporary table from the printer selection CLIST, ICQCPC00. FILE can be specified as an alias of DDNAME.
PLOC(loc) | PLOC((lo c))
specifies printer location. Use double parentheses if the location contains embedded blanks. The location must match the LOCATION field of the desired print definition. If you specify PLOC, you must also specify PFORM to identify a unique print definition. NOTABLE is assumed.
PFORM(form)
specifies print format or style. Must match the PRINT FORMAT field of the desired print definition. If you specify PFORM, you must also specify PLOC to identify a unique print definition. NOTABLE is assumed.
BIND(columns) | LMARGIN(columns)
specifies the number of columns to the right that the output should be shifted on the paper.
BMARGIN(lines)
specifies the number of blank lines to be left at the bottom of each printed page.
BURST | NOBURST
specifies whether output from the 3800 printer is to be burst, trimmed, and stacked. Specify BURST or NOBURST. NOBURST is the default.
CCHAR | SINGLE | DOUBLE | TRIPLE
CCHAR specifies that ANSI or machine code spacing control characters in the data set should be used for inter-record spacing. SINGLE, DOUBLE and TRIPLE specify that all non-blank lines in the data set should be printed with single, double and triple spacing, respectively.
CHARS(‘set1 set2’) | CHARS(set)
specifies the character sets (fonts) to be used.
COLUMNS(‘start1:end1,start2:end2,…’)
specifies the columns of the data set to be printed. Specify the columns to be printed as pairs of numbers in the format "start-column:end column".
COPIES(n) | COPIES(‘,(n,n,n,n)’)
specifies the number of printed copies or copy groups (for the 3800).
DCF | NODCF
specifies that if the data set being printed has been formatted by DCF, the font information in the first line of the data set should be extracted. This font information is used when the data set is printed. NODCF specifies that font information should not be extracted from the data set. DCF is the default.
DEST(destination) | DEST(‘destination.userid’)
specifies the destination to which the output is to be sent.
FCB(‘image-id[,ALIGN,VERIFY]’)
specifies a forms-control buffer. You can specify the ID of the forms control image and, optionally, specify that the operator align the printer forms and verify that the image displayed on the printer is the correct one.
FLASH(‘overlay-name[,count]’)
specifies a forms overlay for use on the 3800 printer and the number of copies to be printed with the overlay.
FOLD(width) | TRUNCATE(width)
specifies the maximum length of the printed line. FOLD indicates that lines longer than the maximum length should be wrapped onto the following line. TRUNCATE indicates that lines longer than the maximum length should be truncated to fit on the line.
FORMS(forms name)
specifies that the output data set should be printed on a special output form.
HOLD | NOHOLD
specifies whether the data set is to be placed on a HOLD queue before printing. NOHOLD is the default.
LINES(line-num1:line-num2)
specifies the range of lines to be printed, either in terms of embedded line-number fields (NUM and SNUM parameters) or relative records (NONUM parameter).
MEMBERS | DIRECTORY | ALL
specifies what portion of a partitioned data set is to be printed. MEMBERS indicates that only the data contained in the members of the partitioned data set should be printed. DIRECTORY indicates that only a list of the members should be printed. ALL indicates that the data contained in the members should be printed, followed by a list of the members in the partitioned data set. ALL is the default.
MODIFY(‘module-name[,trc]’)
specifies a copy modification module for the 3800 printer. The module contains data, such as headings, and information specifying where and on which copies to print them. The Table Reference Character (TRC) specifies character sets for use with the module. TRC corresponds to fonts specified in CHARS, which is required for use of TRC.
NUM(‘loc,len’)+ /SNUM(‘loc,len’)/NONUM
specifies whether line numbers should assumed to be embedded.
NUM
Indicates that the data set contains a line-number field that is to be printed. The first value indicates the column location of the beginning of the line-number field. The second value indicates the number of columns that the line-number field occupies.
SNUM
Indicates that the data set contains a line-number field that is not to be printed. The first value indicates the column location of the beginning of the line-number field. The second value indicates the number of columns that the line-number field occupies.
NONUM
Indicates that the records should be treated as though there are no embedded line-numbers.
OUTDES(name) | OUTDES(‘name,name,…’)
specifies that the output be printed using an output statement or statements named in the users logon procedure.
PAGELEN(lines)
specifies the number of lines in a printed page.
SYSOUT(class)/CLASS(class)
specifies the system output data set class. Required if you specify NOTABLE without PLOC and PFORM.
TITLE | NOTITLE
TITLE specifies that a title, including the name of the data set being printed and the page number, should appear on every page of printed output. NOTITLE specifies that the title should be suppressed.
TMARGIN(lines)
specifies the number of blank lines to be left at the top of every printed page.
TODATASET(dsname) | TODSNAME(dsname)
specifies the name of the data set into which the formatted data is to be copied. If this operand is specified, a SYSOUT data set is not created. If the indicated data set does not exist, the TSO/E PRINTDS command creates the data set.
To specify a fully-qualified data set name, enclose it in three sets of single quotes. For example, to copy the formatted output into ‘userid.OUTPUT’, specify: 
TODSNAME('userid.OUTPUT'')
TRC | NOTRC
specifies whether the data records contain TRC codes that identify the font to be used for printing each record.
UCS(name)
specifies a universal character set to be used in printing the output.
WRITER(name)
specifies a name for use in processing or selecting a SYSOUT data set. The writer name can contain 1 to 8 alphanumeric or special characters #, $, or @.
Parent topic: Print CLIST, ICQCPC15