Batch Processing › SARBCH Control Statements › PRINT

PRINT

The PRINT control statement outputs a SYSOUT group to spool or data set for printing. Overrides to the print attributes can be specified as operands.

Syntax:

/PRINT  ACIFRES=Y|N
ADDRESS=('text'...)        
        BANNER=name
        BUILDING='text'
        BURST=Y|N
        CHARS=(xxxx xxxx xxxx xxxx)
        CKPTLINE=nnnnn
        CKPTPAGE=nnnnn
        CKPTSEC=nnnnn
        CLASS=x
        COLORMAP=xxxxxxxx
        COMPACT=xxxxxxxx
        COMSETUP=xxxxxxxx
        CONTROL=PROGRAM|SINGLE|DOUBLE|TRIPLE
        COPIES=nnn
        COPYG=(nnn nnn nnn nnn nnn nnn nnn nnn)
        DATACK=BLOCK|UNBLOCK|BLKCHAR|BLKPOS
        DDNAME=xxxxxxxx
        DEPT='text'
        DEST={destid.userid|subsysid.destid}
        DPAGELBL=Y|N
	DSLIST=(ddname,stepname,proc_stepname)
        DUPLEX=NO|NORMAL|TUMBLE
        FCB=xxxx
        FLASH=(xxxx nnn)
        FORM=xxxxxxxx
        FORMDEF=xxxxxx
        FORMLEN=nn[.mmm]IN|CM
        FSSDATA='data'
        GEN=nnnnn
        HOLD=Y|N
        ID=id
        INTRAY=nnn
        IPDEST=ipdest
        LINECT=nnn
        MODIFY=(xxxx n)
        NAME='text'
        NOTIFY=(node.userid …)
        OFFSETXB=mmm[.nnn]IN|CM|MM|PELS|POINTS
        OFFSETXF=mmm[.nnn]IN|CM|MM|PELS|POINTS
        OFFSETYB=mmm[.nnn]IN|CM|MM|PELS|POINTS
        OFFSETYF=mmm[.nnn]IN|CM|MM|PELS|POINTS
        OPTCDJ=Y|N
        OUTBIN=nnnnn
        OUTDISP=(ndisp,adisp)
        OUTPUT=name
        OVERLAYB=xxxxxxxx
        OVERLAYF=xxxxxxxx
        PAGE=(nnn nnn nnn nnn nnn nnn nnn nnn nnn)
        PAGEDEF=xxxxxx
        PIMSG=(Y|N,nnn)
        PORTNO=nnnnn
        PRMODE=xxxxxxxx
        PRTERROR=DEFAULT|QUIT|HOLD
        PRTOPTNS=xxxxxxxxxxxxxxxx
        PRTQUEUE='queue'
        PRTY=nnn
        RECORD=(nnn nnn nnn nnn nnn nnn nnn nnn nnn)
        RESFMT=P240|P300        
        RETAINF=hhhh:mm:ss|FOREVER
        RETAINS=hhhh:mm:ss|FOREVER
        RETRYL=nnn
        RETRYT=hhhh:mm:ss
        ROOM='text'
        SELECT=xxxxxxxx
        SEQ=nnnnn
        SYSAREA=Y|N
        THRESHLD=nnnnnnnn
        TITLE='text'       
        UCS=xxxx
        USERDATA=('text' …)
        USERLIB=(lib …)
        VIEW=(nnn,viewid,userid)
        WRITER=xxxxxxxx

where:

ACIFRES=Y|N

Specifies whether to include ACIF APF resources when reprinting.

If not specified, this parameter defaults to the value set in SARINIT.

ADDRESS=
('text' …)

Specifies deliver address lines for the SYSOUT.

You can specify one to four deliver address lines containing up to 60 text characters separated by blanks and/or commas and enclosed in parentheses.

BANNER=name

Specifies the name of the model banner page to be used for producing beginning and ending banner pages for the report.

If omitted, the user's default banner page is used.

You can specify * for name to bypass printing of banner page data.

BUILDING=
'text'

Specifies the building identification for the SYSOUT.

You can specify up to 60 text characters for building identification.

BURST=Y|N

Specifies an optional burst value for the 3800 printer to override the one used to print the SYSOUT.

Valid values are Y and N.

CHARS=(xxxx xxxx xxxx xxxx)

Specifies an optional set of character arrangement table names for the 3800 printer to override the ones used to print the SYSOUT.

A value of one to four names separated by one or more blanks and/or commas and enclosed in parentheses can be specified.

CKPTLINE=
nnnnn

Specifies the maximum lines in a logical page.

A range of 0 to 32767 can be specified.

CKPTPAGE=
nnnnn

Specifies the number of logical pages before JES checkpoints data.

A range of 1 to 32767 can be specified.

CKPTSEC=
nnnnn

Specifies the number of logical pages before JES checkpoints data.

A range of 1 to 32767 can be specified.

CLASS=x

Specifies an optional class to override the one used to print the SYSOUT.

COLORMAP=
xxxxxxxx

Specifies the color translation resource object.

COMPACT=
xxxxxxxx

Specifies the compaction table for sending SYSOUT to SNA terminal.

COMSETUP=
xxxxxxxx

Specifies the microfiche setup resource.

CONTROL=
value

Specifies line spacing.

Valid values are:

PROGRAM

Indicates each logical record contains a carriage control character.

SINGLE

Indicates single spacing.

DOUBLE

Indicates double spacing.

TRIPLE

Indicates triple spacing.

COPIES=nnn

Specifies an optional number of copies to override the one used to print the SYSOUT.

A range of 1 to 255 can be specified.

COPYG=(nnn nnn nnn nnn nnn nnn nnn nnn)

Specifies an optional set of copy groups for the 3800 printer to override the ones used to print the SYSOUT.

A range of one to eight copy groups separated by one or more blanks and/or commas and enclosed in parentheses can be specified. Each copy group value must be in the range of 1 to 255.

DATACK=value

Specifies how printer errors are to be handled.

Valid values are:

BLOCK

Indicates errors are not reported.

UNBLOCK

Indicates errors are reported.

BLKCHAR

Indicates print errors are blocked.

BLKPOS

Indicates data errors are blocked.

DDNAME=
xxxxxxxx

Specifies the DD statement name to which the SYSOUT group is printed.

If the DCB attributes for the DD statement are omitted, the following values are used:

• A record format of VBM
• A record size of the SYSOUT group record size plus 4 but not less than 137
• A block size of 32760

DEPT='text'

Indicates department identification for the SYSOUT.

You can specify up to 60 text characters for department identification.

DEST={destid.userid|subsysid.destid}

Specifies the destination to which to print the index data, using one of these formats:

• destid.userid: 1-8 characters destination ID followed by 1-8 characters for the optional user ID. The destination can be a synonym created using the DEFDEV define device command.
• subsysid.destid: 4-character subsysid of an alternate CA Spool subsystem followed by a 1-8 character destination in it.

Note: For details about printing to CA Spool, see the “Printing Output” chapter in the User Guide.

DPAGELBL=Y|N

Specifies whether security label is to be output.

DSLIST=(ddname,stepname,proc_stepname)

Specifies the qualified data definition name within the SYSOUT group to be printed, where:

ddname

Specifies the DD statement that produced the SYSOUT data.

stepname

Specifies the name of the step that produced the SYSOUT data.

proc_stepname

Specifies the stepname in the procedure that produced the SYSOUT data.

The ddname, stepname, and/or proc_stepname can be specified as a specific or generic name. If a field is omitted, all occurrences of that name are assumed.

Examples:

• DSLIST=JES* prints job log, JCL listing, message data set, and any other DD statements that start with JES
• DSLIST-SYSPRINT prints all SYSPRINT data sets contained in the SYSOUT group
• DSLIST=(SYSPRINT,STEP1) prints the SYSPRINT data set for step STEP1
• DSLIST=(*,STEP1) or DSLIST=(,STEP1) prints all data sets produced by STEP1

FCB=xxxx

Specifies an optional forms control image to override the one used to print the SYSOUT.

FLASH=
(xxxx nnn)

Specifies an optional forms flash overlay name and flash count for the 3800 printer to override those used to print the SYSOUT.

The forms flash overlay name and copy count are separated by one or more blanks and/or commas and are enclosed in parentheses.

FORM=
xxxxxxxx

Specifies an optional forms name to override the one used to print the SYSOUT.

FORMDEF=
xxxxxx

Specifies a library member containing statements to control printing of the SYSOUT data on the 3800 printer.

The statements can specify overlay forms, page location for overlays, and page format suppressions that can be activated.

FORMLEN=nn
[.mmm]IN|CM

Specifies length and unit of measurement of the form.

FSSDATA='data'

Specifies Functional Subsystem data.

You can specify up to 127 characters for functional subsystem data.

GEN=nnnnn

Specifies the absolute or relative number of the generation for which SYSOUT is printed.

If omitted, the most recently archived SYSOUT group for the ID is printed.

HOLD=Y|N

Specifies either Y or N to indicate whether the SYSOUT is to be placed on the hold queue for printing.

If omitted, HOLD=N is assumed.

ID=id

Specifies the SYSOUT ID of the group to be printed.

You can specify 1 to 32 characters for ID. This parameter is required.

Note: If the id contains embedded blanks, commas, equal signs, parentheses, or quotes, it must be enclosed in quotes (single or double). Any quotes in Report-id must be entered as a pair of quotes because a non-paired quote ends the ID. For example, if the value is JIM’S REPORT, it must be entered as ‘JIM’’S REPORT’ or "JIM’S REPORT".

INTRAY=nnn

Specifies the printer input tray.

A range of 1 to 255 can be specified.

IPDEST=ipdest

Specifies the TCP/IP routing designation.

You can specify up to 124 characters of TCP/IP routing information.

LINECT=nnn

Specifies the maximum number of lines to print on each output page.

MODIFY=
(xxxx n)

Specifies an optional copy modification module name and table reference character for the 3800 printer to override those used to print the SYSOUT.

The copy modification module name and table reference character are separated by one or more blanks and/or commas and are enclosed in parentheses.

The table reference character can have a value of 0 to 3.

NAME='text'

Specifies the name to be printed on output separator pages.

You can specify up to 60 text characters for the name.

NOTIFY=
(node.userid …)

Specifies a print notification message destination.

You can specify up to four destinations for the print notification message.

OFFSETXB=
mmm[.nnn]IN|
CM|MM|
PELS|POINTS

Specifies X offset of logical page origin for back side of paper.

OFFSETXF=
mmm[.nnn]IN|
CM|MM|
PELS|POINTS

Specifies X offset of logical page origin for back side of paper.

OFFSETYB=
mmm[.nnn]IN|
CM|MM|
PELS|POINTS

Specifies Y offset of logical page origin for back side of paper.

OFFSETYF=
mmm[.nnn]IN|
CM|MM|
PELS|POINTS

Specifies Y offset of logical page origin for front side of paper.

OPTCDJ=Y|N

Specifies an optional override as to whether the SYSOUT records contain table reference characters for the 3800 printer.

Valid values are Y or N.

OUTBIN=nnnnn

Specifies output bin ID.

A range of 1 to 65535 can be specified.

OUTDISP=
(ndisp,adisp)

Specifies the normal and abnormal output disposition.

Valid values are:

HOLD

Indicates SYSOUT is not printed until it is released.

KEEP

Indicates SYSOUT is printed but not immediately purged.

LEAVE

Indicates SYSOUT is not printed until it is released and not immediately purged once printed.

PURGE

Indicates SYSOUT is deleted without printing.

WRITE

Indicates SYSOUT is printed and purged.

OUTPUT=
xxxxxxxx

Specifies the name of the //OUTPUT statement to be used for printing the SYSOUT group.

This parameter overrides the specifications of the FORMDEF, LINECT, PAGEDEF, PRMODE, and possibly, FORM parameters. The parameter (xxxxxxxx) data is specified as follows:

• name
• stepname.name
• stepname.procstepname.name
• An asterisk can precede the parameter data to match the JCL specification of the OUTPUT parameter.

OVERLAYB=xxxxxxxx

Specifies medium overlay for back side of paper.

OVERLAYF=xxxxxxxx

Specifies medium overlay for front side of paper.

PAGE=(nnn nnn nnn nnn nnn nnn nnn nnn nnn)

Specifies one to nine page numbers and/or ranges of pages to be printed.

The page numbers and/or ranges of pages are separated by one or more blanks and/or commas and are enclosed in parentheses. A range of pages is specified as two page numbers separated by a colon.

If both PAGE and RECORD are omitted, the entire SYSOUT group is printed.

PAGEDEF=xxxxxx

Specifies a library member containing statements to control the printing of the SYSOUT data on the 3800 printer.

The statements can specify logical page length, width, fonts, and page segments.

PIMSG=(Y|N,nnn)

Specifies whether messages from a functional subsystem are to be printed and the message threshold at which the system is to cancel printing.

PORTNO=nnnnn

Specifies TCP port number at which FSS connects to the printer.

A range of 1 to 65535 can be specified.

PRMODE=xxxxxxxx

Specifies the process mode required for printing the SYSOUT group.

PRTERROR=value

Specifies an action for print error.

Valid values are:

DEFAULT

Indicates a standard action is taken when terminating error occurs during printing.

QUIT

Indicates the SYSOUT is released when terminating error occurs during printing.

HOLD

Indicates the SYSOUT is placed in held status when terminating error occurs during printing.

PRTOPTNS=xxxxxxxxxxxxxxxx

Specifies named entity of print options for FSS.

PRTQUEUE='queue'

Specifies a target print queue for FSS.

You can specify up to 127 characters for print queue.

PRTY=nnn

Specifies the priority to assign to this print request.

RECORD=(nnn nnn nnn nnn nnn nnn nnn nnn nnn)

Specifies one to nine record numbers and/or ranges of records to be printed.

The record numbers and/or ranges of records are separated by one or more blanks and/or commas and are enclosed in parentheses. A range of records is specified as two record numbers separated by a colon.

If both PAGE and RECORD are omitted, the entire SYSOUT group is printed.

RESFMT=P240|P300

Specifies the resolution used to format the print.

Valid values are:

P240

Indicates 240 pels per inch resolution.

P300

Indicates 300 pels per inch resolution.

RETAINF=hhhh:mm:ss|FOREVER

Specifies the failed transmission retain time.

RETAINS=hhhh:mm:ss|FOREVER

Specifies the successful transmission retain time.

RETRYL=nnn

Specifies the maximum number of transmission retries.

RETRYT=hhhh:mm:ss

Specifies the length of time to wait between retries.

ROOM='text'

Specifies a room identification.

You can specify up to 60 text characters for room identification.

SELECT=xxxxxxxx

Specifies the page separation index value for selecting pages to print.

If the value contains any of the special characters: blank, comma, or single quote, the index value must be enclosed within single quotes. A single quote must be represented as two single quotes.

SEQ=nnnnn

Specifies the absolute or relative SYSOUT sequence number of the SYSOUT group to be printed.

• If omitted, the most recently archived SYSOUT group for the ID and generation specified is printed.
• If GEN is omitted and SEQ is specified as a negative relative number, the SYSOUT relative to the most recently archived SYSOUT is processed.
• If GEN is omitted and SEQ is specified as a positive number, SEQ number is ignored and the most current SYSOUT is processed.

EX: SEQ=-1

The second most recently archived SYSOUT is processed regardless of its generation and sequence number.

EX: SEQ=-2

The third most recently archived SYSOUT is processed regardless of its generation and sequence number.

SYSAREA=Y|N

Specifies whether the system is to reserve a system area on each page of output.

THRESHLD=
nnnnnnnn

Specifies the maximum size of a SYSOUT data set.

A range of 1 to 99999999 can be specified.

TITLE='text'

Specifies a title identification.

You can specify up to 60 text characters for text identification.

UCS=xxxx

Specifies an optional, special character set name to override the one used to print the SYSOUT.

USERDATA=
('text' …)

Specifies user data for the SYSOUT.

You can specify 1 to 16 user data lines containing up to 60 text characters separated by blanks and/or commas and enclosed in parentheses.

USERLIB=(lib …)

Specifies up to eight libraries containing APF resources.

VIEW=(nnn, viewid,userid)

Specifies a view format in which report is printed,

Where:

Nnn

Views numbers (1 to 255).

Viewed

Specifies (Optionally) the ID of a public, private, or global view.

Note: If the id contains embedded blanks, commas, equal signs, parentheses, or quotes, it must be enclosed in quotes (single or double). Any quotes in Report-id must be entered as a pair of quotes because a non-paired quote ends the ID. For example, if the value is JIM’S REPORT, it must be entered as ‘JIM’’S REPORT’ or "JIM’S REPORT".

Userid

Optionally specifies the user ID for private view.

WRITER=
xxxxxxxx

Specifies the external writer name to be used for printing the SYSOUT group.

Note: The number of printed lines can be limited by the CA View OUTLIM initialization parameter. See the Initialization Parameters chapter for more information.